Gatilhos de saude de templates do WhatsApp e canal desconectado

Reaja automaticamente quando a Meta aprova, rejeita ou pausa um template, a qualidade do seu WABA cai ou um canal fica offline.

Jun 26, 2026

Veja este passo no vídeo · Modelo de WhatsApp e a janela de 24 horas

O que sao os gatilhos de saude da plataforma

O WhatsApp (Meta) toma decisoes sobre seus templates e seu numero sem avisar com antecedencia: aprova um template, rejeita, pausa por baixa interacao ou rebaixa a qualidade do seu WABA. Se voce descobrir tarde, suas transmissoes comecam a falhar. O Omnifox escuta esses eventos via webhook e os transforma em gatilhos de workflow para que sua equipe reaja em segundos, e nao no dia seguinte.

Esses gatilhos ficam na categoria Sistema do editor e sao ideais para alertas internos (avisar um canal do Team, criar uma tarefa) e para acoes defensivas (pausar transmissoes quando a qualidade cai para RED).

Gatilhos disponiveis

  • Template aprovado (whatsapp.template_approved): a Meta validou seu template e ele ja pode ser enviado. Util para avisar o marketing de que a campanha esta pronta.
  • Template rejeitado (whatsapp.template_rejected): a Meta rejeitou o template. Expoe $template.rejection_reason para voce saber o motivo.
  • Template pausado (whatsapp.template_paused): por baixa qualidade ou muitas denuncias, a Meta parou os envios desse template. Expoe $template.paused_reason.
  • Qualidade do WABA mudou (whatsapp.quality_rating_changed): a qualidade do seu numero passou entre GREEN / YELLOW / RED. Critico para se defender.
  • Canal desconectado (channel.disconnected): um canal de qualquer tipo (WhatsApp, Instagram, Messenger e os demais) perdeu a sessão ou o token expirou e parou de enviar/receber. Para o mesmo canal, não se repete durante 1 hora. Veja Gatilho: Canal desconectado.

Requisitos

  • Disponível em todos os planos (a partir do Lite), com uma cota mensal de execuções de workflows conforme o seu plano.
  • Pelo menos um canal de WhatsApp conectado via Embedded Signup.

Passos para criar o workflow

  1. Vá em Configurações → Fluxos de trabalho e clique em Criar workflow.
  2. Na paleta a esquerda, abra a categoria Sistema e arraste o gatilho que precisa (por exemplo Template rejeitado).
  3. No inspetor do gatilho, use o filtro Canal especifico se so te interessa um numero, ou deixe vazio para todos. Em Template aprovado/rejeitado tambem da para filtrar por Categoria do template (AUTHENTICATION / MARKETING / UTILITY).
  4. Conecte uma acao. As mais usadas: Publicar no Team para avisar a equipe, Criar tarefa para acompanhamento ou Enviar email.
  5. Insira variaveis do gatilho na mensagem com o botao Inserir variavel: $template.name, $template.rejection_reason, $channel.name, etc.
  6. Ative o workflow no botao superior e Salve.

Receita defensiva recomendada (qualidade RED)

Com Qualidade do WABA mudou, configure o filtro Nova qualidade = RED e conecte uma acao que pause suas transmissoes ou avise o responsavel na hora. Assim voce evita continuar queimando a reputacao do numero.

Como verificar

Como sao eventos de plataforma, voce nao consegue provoca-los a vontade. Use o botao Testar do editor: esses gatilhos sao sinteticos e pedem que voce preencha dados de teste (ID do template, canal, motivo) para simular o disparo e confirmar que suas acoes rodam. Apos um evento real, confira o historico de execucoes do workflow.

Se nao funcionar

  • Nada dispara: confirme que o workflow esta ativo (botao verde) e que o filtro de Canal especifico corresponde ao canal afetado.
  • So recebo alguns eventos: a Meta nao reenvia eventos historicos; so chegam os que ocorrem com o webhook ja conectado.
  • Template rejeitado sem motivo: as vezes a Meta nao envia o motivo; $template.rejection_reason pode vir vazio.

Dicas

  • Combine Template pausado + Qualidade do WABA mudou em workflows separados para ter um painel completo de saude do numero.
  • Se tiver varios canais, crie um workflow por canal com seu filtro para encaminhar o alerta a equipe certa.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp