Atualizado em 25/10/2026
Para fazer NPS pelo WhatsApp sem incomodar, envie uma única pesquisa curta depois que o cliente recebeu o pedido ou concluiu o atendimento, citando aquele pedido específico, com resposta em um toque (botões ou WhatsApp Flows) e um limite de frequência por cliente. Na API oficial, essa mensagem só pode ser template de utilidade se estiver ligada a uma compra ou interação concreta; pesquisa genérica a Meta classifica como marketing.
Este guia mostra o fluxo de pós-venda, a regra de categoria da Meta para pesquisas, três formatos de coleta (botão, lista e Flow), um exemplo de Flow de NPS e como ler as respostas no webhook.
Pesquisa no WhatsApp: o que a Meta permite
A documentação de categorização de templates tem uma linha específica para pesquisas de satisfação. Elas são utilidade quando coletam feedback sobre um pedido, transação ou interação anterior, e a especificidade é obrigatória: “uma pesquisa ou pedido de feedback geral ou genérico não será aprovado como utilidade”.
Na prática:
| Texto | Categoria provável |
|---|---|
| “Seu pedido {{1}} foi entregue. Como foi a sua experiência? Toque abaixo para responder uma pesquisa curta.” | Utilidade |
| “Você falou com nosso suporte sobre o pedido {{1}}. Como foi o atendimento?” | Utilidade |
| “Queremos saber sua opinião sobre a nossa marca!” | Marketing (genérica) |
| “Avalie seu pedido {{1}} e ganhe 10% na próxima compra.” | Marketing (conteúdo misto com oferta) |
O último exemplo é o erro mais comum. Cupom como incentivo à resposta transforma a pesquisa em marketing, porque templates com conteúdo de utilidade e de marketing são classificados como marketing. Para entender as três categorias, veja como a Meta classifica seu template.
Há ainda um segundo caminho: se o cliente mandou mensagem nas últimas 24 horas, a janela de atendimento está aberta e você pode enviar a pesquisa como mensagem livre (botões, lista ou Flow), sem template. Veja janela de 24 horas do WhatsApp.
Quando enviar: o fluxo de pós-venda
O gatilho certo é um evento do seu sistema, não uma data fixa no calendário. Um fluxo enxuto:
- Confirmação do pedido (utilidade).
- Atualizações de envio (utilidade).
- Entrega confirmada: o sistema registra a entrega pela transportadora ou pelo seu app.
- Espera curta: dê tempo para o cliente usar o produto. Para comida, minutos; para um eletrônico, alguns dias. Defina por tipo de produto.
- Pesquisa de NPS, citando o pedido.
- Resposta conforme a nota: agradecimento para quem deu nota alta, contato humano para quem deu nota baixa.
Para atendimento (suporte, SAC), o gatilho é o encerramento do ticket. Mesmo princípio: cite a interação e pergunte uma coisa só. Métricas como CSAT e tempo de resposta estão em métricas de atendimento no WhatsApp.
Quer testar enquanto lê? Crie sua conta na Vectalk e envie a primeira mensagem pela API oficial. Criar conta grátis →
Frequência: o que segura a reclamação
A Meta não define um número máximo de pesquisas por cliente. O que ela mede é o feedback: bloqueios, denúncias e silenciamentos derrubam a qualidade do número. Pesquisa demais é um caminho curto para isso. Regras que funcionam bem no seu próprio sistema:
- Uma pesquisa por pedido, nunca mais de uma por evento.
- Teto por cliente: por exemplo, no máximo uma pesquisa a cada 30 ou 60 dias, mesmo para quem compra toda semana. Escolha o teto conforme a sua frequência de compra.
- Sem lembrete: se o cliente não respondeu, não insista.
- Respeite a saída: inclua um botão como “Não quero pesquisas” e marque a preferência no cadastro.
- Não pesquise depois de um problema não resolvido: se o pedido teve reclamação aberta, resolva primeiro.
Toda mensagem iniciada pela empresa exige opt-in. Se o cliente aceitou receber atualizações do pedido pelo WhatsApp, deixe claro no mesmo aceite que você pode pedir avaliação. Veja como montar uma lista opt-in.
Três formatos para coletar a nota
| Formato | Como funciona | Limite | Bom para |
|---|---|---|---|
| Botões de resposta rápida | Até 3 botões com rótulo de até 20 caracteres | 3 opções | CSAT simples (bom, regular, ruim) |
| Lista interativa | Menu com linhas selecionáveis | Até 10 linhas no total | Escalas de até 10 pontos |
| WhatsApp Flows | Formulário dentro da conversa, com telas e componentes | RadioButtonsGroup aceita até 20 opções | NPS de 0 a 10 com comentário |
Os limites são da Meta: botões de resposta, lista interativa e componentes de Flows.
Repare no detalhe: o NPS clássico vai de 0 a 10, ou seja, 11 opções. Não cabe numa lista interativa, que aceita até 10 linhas. As saídas são usar um Flow, pedir que o cliente digite o número (e validar a resposta) ou adotar outra escala. Os outros formatos de mensagem interativa estão em mensagens interativas na API do WhatsApp.
NPS com WhatsApp Flows
O WhatsApp Flows abre um formulário dentro da conversa. Para uma pesquisa, uma tela basta: a nota de 0 a 10 e um campo opcional de comentário. A própria Meta tem tutoriais de pesquisa com Flows na página de exemplos.
Um Flow JSON mínimo:
{
"version": "6.0",
"screens": [
{
"id": "NPS",
"title": "Avalie seu pedido",
"terminal": true,
"success": true,
"layout": {
"type": "SingleColumnLayout",
"children": [
{ "type": "TextBody", "text": "De 0 a 10, quanto você recomendaria nossa loja a um amigo?" },
{
"type": "RadioButtonsGroup",
"name": "nota",
"label": "Sua nota",
"required": true,
"data-source": [
{ "id": "0", "title": "0" }, { "id": "1", "title": "1" }, { "id": "2", "title": "2" },
{ "id": "3", "title": "3" }, { "id": "4", "title": "4" }, { "id": "5", "title": "5" },
{ "id": "6", "title": "6" }, { "id": "7", "title": "7" }, { "id": "8", "title": "8" },
{ "id": "9", "title": "9" }, { "id": "10", "title": "10" }
]
},
{ "type": "TextArea", "name": "comentario", "label": "Quer comentar?", "required": false },
{
"type": "Footer",
"label": "Enviar avaliação",
"on-click-action": {
"name": "complete",
"payload": { "nota": "${form.nota}", "comentario": "${form.comentario}" }
}
}
]
}
}
]
}
O Flow pode sair de duas formas, segundo a documentação de envio de Flows:
- Dentro da janela de atendimento: mensagem interativa do tipo
flow. - Fora da janela: template com botão do tipo
FLOW. A categoria segue a mesma regra: utilidade se o texto cita o pedido e não tem oferta.
Use o flow_token para identificar o pedido. A resposta do Flow não traz o ID do Flow, e a Meta recomenda colocar um identificador no flow_token ou no payload.
Lendo a resposta no webhook
Quando o cliente conclui o Flow, chega uma mensagem interactive do tipo nfm_reply. O campo response_json é uma string JSON com o payload que você definiu na ação complete, conforme a documentação de webhooks de Flows:
{
"from": "5511988887777",
"id": "wamid.HBgN...",
"type": "interactive",
"interactive": {
"type": "nfm_reply",
"nfm_reply": {
"name": "flow",
"body": "Sent",
"response_json": "{\"flow_token\": \"pedido-48213\", \"nota\": \"6\", \"comentario\": \"Chegou com atraso\"}"
}
}
}
Um tratamento em Node.js que classifica a nota e aciona o próximo passo:
export function tratarNps(msg, db, avisarTime) {
if (msg.type !== 'interactive' || msg.interactive.type !== 'nfm_reply') return;
const r = JSON.parse(msg.interactive.nfm_reply.response_json);
const nota = Number(r.nota);
const grupo = nota >= 9 ? 'promotor' : nota >= 7 ? 'neutro' : 'detrator';
db.salvarNps({ pedido: r.flow_token, wa_id: msg.from, nota, grupo, comentario: r.comentario });
if (grupo === 'detrator') avisarTime({ pedido: r.flow_token, wa_id: msg.from, nota, comentario: r.comentario });
}
A divisão em promotores (9 e 10), neutros (7 e 8) e detratores (0 a 6) é a convenção do NPS. O índice é o percentual de promotores menos o de detratores.
Se você usou botões de resposta rápida num template, o webhook chega com type: "button" e o texto em button.text. Em mensagens interativas livres, o tipo é button_reply ou list_reply. Para cruzar a pesquisa com a entrega da mensagem, use o webhook de status.
O que fazer com a nota
- Detrator (0 a 6): abra um atendimento humano em minutos, enquanto a janela de 24 horas está aberta pela resposta do cliente. Resolver o problema ali vale mais que o número.
- Neutro (7 e 8): agradeça e pergunte o que faltou, só se o comentário veio vazio.
- Promotor (9 e 10): agradeça. Se quiser pedir avaliação pública (Google, marketplace), faça na mesma conversa, dentro da janela aberta pela resposta, sem novo template.
Esse último ponto evita uma segunda mensagem iniciada pela empresa: a resposta do cliente abriu a janela de atendimento, e a mensagem livre de agradecimento entra como serviço.
Como fazer com a Vectalk
A Vectalk usa os mesmos payloads e webhooks da Cloud API:
- Template da pesquisa: crie com
POST /api/templatese categoriaUTILITY(documentação). - Flow: crie com
POST /api/flowse publique comPOST /api/flows/{flowId}/publish(documentação de Flows). - Envio:
POST /api/messages, comtype: "template"outype: "interactive"einteractive.type: "flow"(exemplos). - Respostas: registre a URL com
POST /api/webhookse tratenfm_replycomo no exemplo acima.
O custo das mensagens entra na fatura da Vectalk, e a Vectalk paga a Meta. Para o contexto geral, veja o guia da API oficial do WhatsApp e o artigo sobre WhatsApp para e-commerce. Crie sua conta em apps.vectalk.com.br/register.
Perguntas frequentes
Pesquisa de NPS é template de utilidade ou marketing?
Utilidade, quando o texto cita um pedido, uma visita ou um atendimento específico e não tem oferta. Pesquisa genérica sobre a marca, ou pesquisa com cupom como incentivo, é marketing.
Posso oferecer desconto para quem responder?
Pode, mas a mensagem passa a ser marketing, com preço e regras de marketing, e exige opt-in para esse tipo de mensagem. Se quiser manter a pesquisa como utilidade, deixe a oferta de fora.
Quanto tempo depois da entrega devo enviar?
Não há regra da Meta. O ideal é quando o cliente já teve tempo de usar o produto ou serviço. Defina o atraso por tipo de produto e teste.
Dá para fazer NPS de 0 a 10 com lista interativa?
Não numa lista só, porque ela aceita até 10 linhas e a escala de 0 a 10 tem 11 opções. Use um Flow, peça a nota por texto ou adote outra escala.
Preciso de opt-in para mandar pesquisa?
Sim. A Meta exige opt-in antes de a empresa iniciar contato pelo WhatsApp. Deixe claro no aceite que a empresa pode enviar atualizações do pedido e pedidos de avaliação.
Fontes oficiais consultadas em 25/10/2026: Categorização de templates, Mensagens com botões de resposta, Mensagens de lista, Componentes de Flows, Envio de Flows, Webhooks de Flows, Exemplos de Flows, Webhook de botões, Obter opt-in, Vectalk: Flows.
Coloque o WhatsApp oficial da sua empresa para funcionar
Crie sua conta, conecte seu número à API oficial (dá para manter o app com coexistência) e comece a atender e enviar mensagens.
