WhatsApp (Evolution API)

Mandando uma mensagem de teste pelo WhatsApp

Como validar que sua integração Evolution funciona antes de soltar pros clientes.

Atualizado em 17 de maio de 20262 min de leitura

Depois de conectar e parear sua linha, a primeira coisa a fazer é mandar uma mensagem de teste. Se ela chega, sua integração tá ok.

Pré-requisitos

  • Evolution já conectada (estado open). Se não está, veja Conectar Evolution.
  • Permissão manage_messaging (administrador).
  • Um número de celular pra receber o teste (de preferência o seu).

Passo a passo

  1. Vá em /configuracoes/whatsapp.
  2. Na seção Teste de envio, digite o número no campo Telefone (mínimo 10 dígitos com DDD).
  3. Clique em Enviar teste.
  4. Aguarde alguns segundos e olhe o celular.

[SCREENSHOT: Botão de envio de teste]

A mensagem enviada

O PetShop Flow dispara exatamente:

Olá! Configuração concluída ✅ — sua integração WhatsApp está funcionando.

O que o servidor faz

  1. Confere se o Evolution está configurado (messagingProvider === "evolution").
  2. Descriptografa a API key e cria um cliente provider.
  3. Chama o provider.send() com o número e o corpo da mensagem.
  4. Se falhar, retorna o erro do Evolution (formato <código>: <mensagem>).

Erros comuns

  • "Chave inválida" → API key corrompida no banco. Reconecte (cole de novo em /configuracoes/whatsapp).
  • "Evolution não configurado" → você ainda não rodou o fluxo de conectar.
  • Mensagem com erro do Evolution → veja WhatsApp desconectou.

E pra mandar mensagens de verdade?

Depois do teste, o PetShop Flow passa a usar o canal pra:

  • Notificações de cobrança Pix ao tutor (link copia-cola + QR Code).
  • Lembretes de agendamento (em breve, depende de configuração).
  • Disparos manuais em campanhas (em breve).

Boas práticas

  • Use número dedicado se possível.
  • Não pareie em outro dispositivo ao mesmo tempo — pode derrubar.
  • Monitore o estado da conexão. Se cair, refaça o pareamento o quanto antes.

Perguntas frequentes

A mensagem chegou pra outra pessoa. Por quê?

Confira o número que você digitou. O PetShop Flow só remove formatação — se você digitar o DDD errado, manda pra outro número.

O WhatsApp considera a Evolution um robô?

Tecnicamente, sim. O WhatsApp pode banir números que enviam spam ou volume alto demais. Use com bom senso: lembrete pra cliente real, não cold list comprada.

Tem suporte ao WhatsApp Cloud API oficial?

Está no roadmap. Hoje, só Evolution.

Artigos relacionados