Solução de Problemas

WhatsApp desconectou — como reconectar

Estados de conexão, como gerar novo QR Code e o que evita queda futura.

Atualizado em 17 de maio de 20262 min de leitura

A integração WhatsApp via Evolution API cai com mais frequência do que ninguém gostaria. O motivo é arquitetural — Evolution roda em cima do WhatsApp Web, que tem limites. Boa notícia: reconectar é rápido.

Como saber se caiu

Em /configuracoes/whatsapp o estado aparece. Possibilidades:

  • open — está funcionando.
  • connecting — em processo de pareamento.
  • close — caiu. Cliente não recebe mensagem.
  • unknown — o PetShop Flow não conseguiu consultar o servidor Evolution.

Sintomas práticos: clientes deixam de receber QR Code de Pix, lembretes não chegam.

Reconectar — passo a passo

  1. Vá em /configuracoes/whatsapp.
  2. Clique em Gerar QR Code.
  3. O PetShop Flow chama o Evolution e devolve o QR em base64.
  4. Abra o WhatsApp no celular do número usado → Aparelhos conectados → Conectar um aparelho.
  5. Aponte a câmera.
  6. O estado muda pra connecting e depois open. Recarregue a página depois de uns segundos pra confirmar.

[SCREENSHOT: Botão Gerar QR Code e estado close → open]

Quando o estado for unknown

Significa que o PetShop Flow não conseguiu falar com seu servidor Evolution. Possíveis causas:

  • Servidor fora do ar: confira se o Evolution está rodando.
  • URL mudou: revise em /configuracoes/whatsapp se o serverUrl ainda está correto.
  • API key revogada: gere outra no painel Evolution e atualize aqui (cole e salve).

Quando o erro é "Chave inválida"

A API key salva no banco está corrompida ou foi revogada. Solução:

  1. Vá em /configuracoes/whatsapp.
  2. Cole a chave Evolution de novo (mesmo se for igual à antiga).
  3. Salve.
  4. O PetShop Flow testa via pingEvolution antes de gravar — se a nova chave passar, fica.

Como prevenir queda

  1. Número dedicado: não use o mesmo número que você usa pessoalmente.
  2. WhatsApp atualizado no celular pareado.
  3. Não use o WhatsApp Web em outro navegador simultaneamente com a Evolution.
  4. Internet estável no celular pareado. Cair Wi-Fi por horas derruba.
  5. Servidor Evolution monitorado com restart automático em caso de falha.

Quando chamar o suporte

Se você seguiu os passos acima e:

  • O QR Code não aparece (estado fica em connecting por muito tempo).
  • A integração funciona mas mensagens não saem.
  • O webhook do PetShop Flow não recebe callback.

Fala com a gente: suporte@petshopflow.com, com o nome da pet shop, hora do problema e prints.

Perguntas frequentes

Trocar de número quebra a integração?

Sim — o pareamento é por número. Pra trocar, desconecte (botão Desconectar) e pareie de novo com o novo número.

Posso ter dois números no mesmo PetShop Flow?

Hoje, um número por pet shop. Pra mais, fala com o suporte.

A Evolution API é da Anthropic?

Não — é projeto open-source independente. O PetShop Flow integra com qualquer servidor compatível.

Artigos relacionados