Solucao de Problemas

Esta pagina e a primeira parada para diagnosticar problemas com Engage.

Envios nao saem

Campanha presa em queued

Caminho de diagnostico:

1. Abra Diagnostico. Veja status do cron engage-dispatch.
2. Ultimo run >5 min atras? Cron pausado/falhando. Contate suporte.
3. Cron ok? Verifique contagem do segmento. Se zero, nada e enfileirado.
4. Todos suprimidos? Contagem alta, entregaveis zero.

Teste a seco mostra zero envios

Quase sempre problema de consent ou supressao.

• Seu segmento inclui marketing_email_consent = true?
• Audiencia ja cancelou em massa?
• Configuracoes > Lista de Supressao muito grande?

Campanha enviada mas nenhum destinatario recebeu

Funil:

• Suppressed > 0
• Bounced > 0
• Delivered = 0 sem bounces - provedor pode estar pausado

Problemas de Jornada

Publicada mas sem runs

Gatilho de entrada nao casa. Verifique:

• Expressao de filtro muito restritiva?
• Regra de re-entrada never e condutor ja esteve nela?
• Evento gatilho - engage-event-ingest realmente dispara?

Teste: jornada com customer.created sem filtro, cadastre cliente teste. Run aparece em 5 min.

Run preso em wait

next_step_due_at na linha:

• Passado? Cron engage-journey parado.
• Futuro? Espera ainda em vigor.
• until_event e evento nunca dispara? Adicionar duracao fallback.

Mesmo modelo disparou duas vezes

1. Regra de re-entrada incompativel. every_trigger + gatilho frequente. Mudar para after_cooldown.
2. Janela dedup 24h expirou.

Ramificacao avaliou caminho errado

• Sintaxe do predicado casa nome de campo real?
• Operador correto?
• Tipo de valor casa?

Problemas de Entregabilidade

Emails caindo no spam

Em ordem:

1. DKIM/SPF/DMARC mal configurado.
2. Politica DMARC e p=none.
3. Alta taxa de queixa recente afundou reputacao.
4. Subject ou body parece spam.
5. Problema de qualidade de lista.

Veja Configuracao de Dominio e Lista de Supressao.

Alta taxa de bounce

Spike >2% significa dados sujos:

• Imports recentes sem verificacao?
• Segmento antigo nao limpado?
• Dados teste em prod?

Queixas de spam acima de 0,1%

Engage pausa stream em 0,3%. Antes disso, alerta.

Substituicao de Variaveis

Variaveis aparecem literalmente

Payload sem wrapper. Reabra, confirme chaves duplas, salve.

Variavel resolve em branco/null

Campo e null. Sempre use filtro default:

{{customer.first_name | default:"voce"}}

{{ride.last_at}} mostra timestamp ao inves de data

Filtro date:

{{ride.last_at | date:"D MMM"}}

{{wallet.balance}} mostra numero, nao moeda

Filtro currency:

{{wallet.balance | currency}}

Problemas de Webhook

Analise congelada

Ingest de webhook atrasado. Verificar Diagnostico > Webhook Lag.

Webhooks Postmark nao disparam

No Postmark, URL = https://[seu-dominio]/api/engage/webhooks/postmark e eventos Delivery, Bounce, SpamComplaint, Open, Click, SubscriptionChange marcados.

STOP Telnyx nao honrado

URL = https://[seu-dominio]/api/engage/webhooks/telnyx. Perfil de mensagens com eventos de entrada.

Validacoes de Conformidade

"Nao pode publicar: modelo sem variavel de cancelamento"

Body sem {{unsubscribe.url}} no rodape.

"Nao pode publicar: endereco legal de subconta ausente"

Configuracoes > Detalhes Comerciais > Endereco Legal preencher.

"Nao pode publicar: modelo SMS sem dica STOP"

Modelos SMS pre-construidos incluem "Reply STOP to unsubscribe". Personalizados devem incluir similar.

Performance

Pre-visualizacao de segmento mais de 10 segundos

Definicao complexa ou view rollup lenta. Contate suporte.

Pipeline de envio atolada com milhares enfileirados

Limites de taxa em Configuracoes > Limites. Padroes: 1000 emails / 5 min, 100 SMS / min, 5000 push / min.

Conta / Provisionamento

Aba Engage nao na barra lateral

Engage so em Pro e Enterprise. Configuracoes > Faturamento verificar.

Aba Modelos > Levy Recommended vazia

Seed nao rodou. Clique Carregar Modelos.

Dominio personalizado preso em pending apos semana

DNS nao propagando. dig TXT confirmar.

Logs e Diagnostico

1. Diagnostico mostra saude ao vivo.
2. Analise > Exportar Audit Log trilha de eventos.
3. Console DevTools mostra erros API.

Ao contatar suporte, inclua:

• ID da campanha ou jornada
• Timestamp do problema
• Screenshot

---