WaflySoluções › Monitoramento

Como monitorar uma conexão de WhatsApp no n8n

Por Iago Velasco, fundador da Wafly · Workflow gratuito · alerta por webhook · sem banco externo

O template consulta a instância a cada cinco minutos, classifica o estado como online, degradado ou offline e envia um alerta apenas quando o estado muda. Quando a conexão volta, também envia a recuperação.
A cada 5 minutos
Status Wafly
Detectar mudança
Webhook de alerta

Por que checar dois estados

connected mostra se a sessão da API está ativa. smartphoneConnected informa se o telefone vinculado está alcançável. Uma sessão pode permanecer ativa enquanto o telefone está temporariamente indisponível; o template chama isso de estado degradado.

A última situação fica no armazenamento estático do próprio workflow. Se o número permanecer offline por uma hora, você recebe um alerta de queda — não doze mensagens iguais.

Como configurar

  1. Importe o JSON em um n8n self-hosted que possua o community node Wafly.
  2. Selecione sua credencial Wafly no node Get instance status.
  3. No Config, informe um rótulo para a instância e a URL de um webhook de alerta.
  4. Faça uma execução manual e confira o payload enviado ao canal externo.
  5. Ative o workflow e ajuste o intervalo se cinco minutos não combinar com sua operação.

Exemplo de alerta

{"text":"WhatsApp number \"suporte\" is OFFLINE.",
"state":"offline","previous":"online"}
Não dependa do mesmo número para avisar sobre a própria queda. Use Slack, Discord, Telegram, e-mail ou um segundo número conectado como canal de contingência.

Descubra a queda antes do cliente

Baixe o workflow e valide o monitoramento durante o trial da Wafly.

Perguntas frequentes

Preciso de Redis ou banco de dados?

Não para uma instância. O último estado fica no armazenamento estático do workflow. Para várias instâncias ou histórico de incidentes, vale gravar em banco.

Posso reiniciar automaticamente?

É possível adicionar um node de reinício no ramo offline, mas recomendamos primeiro alertar e limitar tentativas para evitar ciclos de reinício.

O workflow funciona no n8n Cloud?

A versão com community node exige self-hosted. No Cloud, faça a consulta de status com HTTP Request.

Monitoramento reduz tempo de descoberta, mas não garante disponibilidade contínua. A Wafly conecta por QR Code e não é a API oficial da Meta.