Checklist de testes para chatbot no WhatsApp

Um chatbot no WhatsApp deve ser testado como uma conversa completa: mensagem recebida, resposta adequada, alternativa quando não entende, encaminhamento para uma pessoa e confirmação do status de entrega. Antes de ativar um fluxo, simule perguntas comuns, erros de digitação, pedidos fora do escopo, mensagens fora do horário e solicitações para parar.

O checklist abaixo organiza os testes por cenário e evidência. A ideia é descobrir onde a experiência falha usando contatos de teste e exemplos fictícios, corrigir o fluxo e repetir a simulação. A documentação do Twilio mostra como acompanhar atualizações de status por callback; a política do WhatsApp Business também define regras para contato, automação e escalonamento humano.

O que um teste precisa provar

O objetivo não é demonstrar que o bot responde a uma pergunta preparada pelo próprio time. Ele precisa conduzir uma conversa possível sem inventar informação, expor dados de outra pessoa ou deixar o cliente sem saída. Para cada caso, registre o que foi enviado, o comportamento esperado, o que ocorreu e quem revisará qualquer diferença.

Comece com uma pergunta que o negócio de fato recebe e depois percorra as alternativas: uma mensagem curta, uma frase com erro de digitação e uma pergunta relacionada, mas que não pertence ao atendimento automatizado. O resultado aceitável pode ser uma resposta útil ou uma orientação clara para falar com alguém. Uma resposta que apenas repete a pergunta não encerra o teste.

A automação também precisa ter um limite reconhecível. Se o cliente pede uma pessoa, descreve uma exceção ou demonstra que não entendeu as opções, o atendimento deve apresentar um caminho de escalonamento. Na Plataforma WhatsApp Business, a política permite automação durante a janela de atendimento, mas exige caminhos de escalonamento claros e diretos, como transferência para atendente, telefone, e-mail, suporte no site ou formulário. Consulte o texto vigente da política de mensagens do WhatsApp Business.

O guia de como automatizar o atendimento no WhatsApp descreve como mapear tarefas e limites antes da automação. Use esse mapa como ponto de partida para a planilha de testes, não como prova de que o fluxo já funciona.

Monte uma matriz de cenários

Uma matriz curta evita que a equipe teste só o caminho mais simples. Escreva cada cenário como uma entrada que uma pessoa realmente poderia enviar. Ao lado, anote a resposta esperada e a evidência que precisa aparecer, como o texto recebido, o destino da transferência ou o evento de status do provedor.

| Cenário | O que observar | |---|---| | Pergunta conhecida | Resposta corresponde ao conteúdo aprovado | | Mensagem ambígua | Bot pede esclarecimento ou oferece opções | | Texto fora do escopo | Limite informado sem resposta inventada | | Pedido de atendente | Caminho humano aparece e chega à equipe | | Pedido para parar | Solicitação é reconhecida e respeitada | | Mensagem de saída | Status e eventual código de erro são registrados |

Mantenha a lista objetiva: cenário, conta usada, data do teste, resultado observado, responsável pela correção e situação da nova rodada. Se o negócio atende mais de um assunto, separe os fluxos por intenção, como horário, disponibilidade, orçamento ou suporte. Assim, uma mudança em um roteiro não esconde que outro roteiro deixou de funcionar.

Use um número e um ambiente de teste que a equipe controla. Evite copiar conversas reais para uma planilha aberta ou usar dados pessoais de clientes só para produzir um exemplo. A política do WhatsApp atribui ao negócio a responsabilidade por obter permissões e consentimentos para coletar, usar e compartilhar informações; planejar com dados fictícios reduz exposição desnecessária. Anote apenas o identificador de teste que ajude a localizar a execução.

Teste respostas previstas e mensagens inesperadas

Para cada assunto automatizado, prepare pelo menos uma pergunta direta e uma variação de linguagem. Uma pessoa pode escrever “qual o horário?”, “abre hoje?” ou apenas “horário”. Não presuma que a mesma resposta será acionada em todos os produtos: o comportamento depende de como o fluxo foi configurado. O teste verifica a experiência do seu próprio canal.

Depois, experimente entradas incompletas ou inesperadas. Envie uma frase com erro de digitação, uma mensagem sem contexto e uma solicitação que o negócio não consegue resolver pelo bot. O fluxo deve pedir um dado que realmente destrave a conversa ou explicar como prosseguir. Não deve criar preço, prazo, disponibilidade ou condição que a empresa não confirmou.

Confira se o cliente consegue corrigir uma escolha anterior. Se um menu oferece opções, teste voltar, escolher outra opção e escrever uma resposta fora da lista. Verifique se a conversa continua compreensível, se a seleção anterior não é tratada como definitiva por engano e se uma pessoa consegue assumir quando o caminho automatizado não serve.

Use este conjunto para cada intenção relevante: - entrada exata prevista no roteiro; - variação curta, com sinônimo ou erro de digitação; - pergunta relacionada, mas sem resposta cadastrada; - pedido explícito de ajuda humana; - mensagem adicional depois da resposta automática.

No resultado, marque “aprovado” só quando a resposta tiver o conteúdo correto e a conversa apresentar o próximo passo. Caso a resposta fique incompleta, anote a frase recebida e a correção esperada. Evite concluir que o bot “entendeu” só porque enviou uma mensagem: a saída precisa responder à necessidade ou deixar claro o limite.

Simule passagem para a equipe e indisponibilidade

Faça um teste em que a pessoa pede atendente desde o início e outro em que a transferência acontece depois de uma tentativa sem sucesso. Confira se o canal mostra como pedir ajuda e se a equipe sabe onde acompanhar a conversa. A política oficial lista alternativas de escalonamento para a automação na Plataforma; o meio oferecido precisa estar visível e ser realmente atendido pelo negócio. Não anuncie telefone ou formulário que ninguém monitora.

Observe o contexto que chega à pessoa da equipe. Para esta pauta, o teste é verificar o que está disponível no seu produto e na sua configuração; não suponha que todo sistema gere um resumo automático. Se o atendente recebe apenas uma notificação, a equipe pode precisar consultar a conversa antes de responder. Simule essa passagem com alguém que não participou da criação do fluxo e pergunte se consegue entender o motivo do contato.

Teste também uma mensagem recebida fora do horário informado pelo negócio. O critério é que a resposta explique a próxima opção com clareza e não prometa retorno em um prazo que a operação não confirmou. Não é preciso repetir toda a configuração de ausência: este teste se concentra em garantir que a conversa tenha uma saída útil e que a mensagem represente o horário real da equipe.

Se o atendimento usa respostas prontas, confira se o texto continua coerente quando a pessoa adiciona uma pergunta ou pede para parar. O guia de respostas rápidas do WhatsApp Business pode ajudar a revisar textos recorrentes. Para os requisitos de conta e boas práticas, consulte também o artigo sobre como evitar problemas de conformidade no WhatsApp.

Revise consentimento, saída e status de entrega

A lista de teste deve conter pelo menos uma solicitação de saída, escrita de forma natural, como “não quero receber mais mensagens”. Não dependa de uma única palavra mágica: a equipe precisa conferir como o sistema reconhece o pedido e como impede novos contatos por WhatsApp. A política exige respeitar pedidos de bloqueio, interrupção ou saída feitos dentro ou fora do aplicativo. O teste deve registrar que a solicitação foi recebida e que a ação correspondente foi tomada.

Na Plataforma WhatsApp Business, conversas iniciadas pela empresa usam modelos de mensagem aprovados. A resposta sem modelo é permitida dentro da janela de atendimento de 24 horas contada a partir da mensagem mais recente da pessoa; fora dela, a política exige modelo aprovado. Inclua um caso de teste adequado à arquitetura contratada e peça ao fornecedor que mostre onde a equipe consulta essa condição. O detalhe varia entre a aplicação e cada integração, portanto não assuma que um teste no app valide uma integração de API.

Por fim, confira a entrega técnica. A documentação do Twilio explica que a URL de callback recebe atualizações quando o status da mensagem muda, incluindo o identificador, o status e, quando aplicável, um código de erro. Envie uma mensagem para o contato de teste, verifique se a atualização chega ao destino configurado e se a equipe consegue localizar a execução. A documentação de status de mensagens do Twilio para WhatsApp descreve o callback; outros provedores podem usar nomes e etapas próprios.

Fontes

• Twilio — visão geral da Plataforma WhatsApp e callbacks de status
• WhatsApp Business — política de mensagens

Perguntas frequentes

Quantos cenários devo testar antes de ativar o chatbot?

Cubra cada intenção que o fluxo atende e, para cada uma, teste a entrada prevista, uma variação, uma pergunta sem resposta cadastrada e o caminho para uma pessoa. Registre as exceções que poderiam deixar alguém sem próximo passo.

Preciso testar com clientes reais?

Para a primeira rodada, use contatos controlados pela equipe e dados fictícios. Se uma validação posterior envolver clientes, explique o teste, obtenha as permissões necessárias e não peça informações que não sejam necessárias para o atendimento.

Como sei se uma mensagem foi entregue?

Não trate o fato de o sistema ter aceitado o envio como confirmação de entrega. Consulte o evento de status documentado pelo seu provedor e confira se o callback está chegando ao destino configurado.

O que fazer quando uma pergunta não tem resposta cadastrada?

O resultado esperado é uma resposta de limite honesta e um próximo passo, como encaminhamento para a equipe ou um canal de suporte disponível. Registre a pergunta para revisar o conteúdo, sem inventar uma resposta durante o teste.

Este conteúdo pode conter links de afiliado: se você comprar por eles, o blog recebe uma comissão, sem custo extra para você.