Histórico de execuções

Cada automação no Syncro registra estatísticas básicas de execução (quantas vezes rodou, última execução) e logs detalhados na timeline de cada lead afetado. Esse histórico é fundamental pra:

• Diagnosticar automações que não funcionam.
• Auditar ações que aconteceram automaticamente.
• Otimizar — quais automações rodam muito (boas) ou nunca (problemáticas).

Estatísticas na lista de automações

Acesse Configurações → Automações. A tabela mostra:

Olhe run_count regularmente:

• run_count = 0 há semanas: automação nunca disparou. Investigue:
• Gatilho está sendo acionado?
• Condições estão muito restritivas?
• Toggle está ativo?
• run_count alto: automação está muito ativa. Pode ser bom (uso saudável) ou ruim (excesso de trigger).

Eventos na timeline do lead

Cada execução cria evento na timeline do lead afetado (e na conversa, quando aplicável). Pra ver:

1. Abra um lead.
2. Vá em Timeline ou Histórico.
3. Procure eventos com tipos:

• webhook_sent / webhook_failed
• ai_extracted / ai_extract_skipped / ai_extract_failed
• tag_added / tag_removed
• stage_changed (quando automação moveu)
• task_created (quando automação criou)
• note_added (quando automação adicionou)
• automation_executed (genérico)

Detalhamento dos eventos

webhook_sent (sucesso)

Mostra:

• URL chamada.
• Método HTTP.
• Status retornado (200, 201, etc).
• Duration em ms.
• (Opcional) Resposta resumida.

webhook_failed

Mostra:

• URL, Método.
• Erro (timeout, 4xx, 5xx, SSRF, DNS, etc).
• Tentativas feitas (após 3 retries, desiste).

ai_extracted

Mostra:

• Campos preenchidos: lista (ex: name, email, company).
• Tokens consumidos.
• Modelo usado (ex: gpt-4o-mini).

ai_extract_skipped

Mostra motivo:

• "Cota de tokens esgotada".
• "Sem mensagens na conversa".
• "Lead não tem conversa WhatsApp".

ai_extract_failed

Após 3 tentativas falhadas. Mostra erro do LLM (rate limit, JSON inválido, etc).

Analisar performance de automações

Top automações por execução

Identifique quais rodam mais. Ordene a tabela por Execuções decrescente.

• Top runners (>1.000 execuções/mês): geralmente message_received sem condições.
• Verifique se vale o custo (tokens, webhooks).
• Médios (100-1.000): saudáveis pra maioria.
• Baixos (<100): podem ser nicho específico (ex: aniversário) — normal.

Ratio de sucesso/falha (webhooks)

Pra automações com send_webhook, conte na timeline dos leads:

• webhook_sent: sucesso.
• webhook_failed: falha.

Se ratio de falha > 5%, há problema:

• URL externa instável.
• Autenticação errada (token expirou).
• SSRF blocker.

Investigue.

Tempo desde última execução

last_run_at indica a última vez que rodou:

• Atual (hoje, ontem): operacional, OK.
• Semanas atrás: gatilho não está disparando ou condições muito restritivas.
• Meses atrás: provavelmente quebrada — investigar urgente.

Logs do servidor (avançado)

Pra debug avançado, acesse logs do servidor (apenas time Syncro tem):

storage/logs/laravel-YYYY-MM-DD.log
storage/logs/whatsapp-YYYY-MM-DD.log

Lá ficam:

• Stack trace de erros.
• Payloads completos de webhooks.
• Tokens e respostas LLM.

Contate suporte se precisa investigar.

Casos comuns de diagnóstico

"Automação não dispara nunca"

Verifique:

1. Toggle ativo ✅?
2. Gatilho está acontecendo no sistema?

• Pra lead_created: você criou lead recentemente?
• Pra message_received: chegou mensagem?

3. Condições estão bloqueando? Tente temporariamente remover condições e ver se dispara.
4. trigger_config restritivo demais? (ex: filtro de pipeline específico que não bate).

"Automação dispara mas não executa todas as ações"

Algumas ações falham mas outras passam. Verifique timeline:

• Cada ação independente — se uma falha, próximas continuam.
• Olhe eventos detalhados (webhook_failed, ai_extract_failed).

"Automação dispara MUITO — preciso reduzir"

• Adicione mais condições.
• Use trigger_config mais restritivo.
• Considere mudar gatilho (message_received → conversation_created, que dispara só 1× por conversa).

"Run_count incrementa mas nada aparece no lead"

Possíveis causas:

• Lead errado sendo afetado.
• Action falha silenciosamente (raro, mas possível em ações async).
• Bug. Contate suporte com ID do lead + ID da automação.

Limpar histórico

Você não consegue zerar run_count ou last_run_at pela UI hoje. Pra reset:

• Excluir e recriar a automação (perde estatísticas mas nasce limpa).
• Contatar suporte pra reset manual.

Não há dashboard agregado

Hoje a UI não tem dashboard tipo "métricas de automação":

• ❌ Sem gráfico de execuções ao longo do tempo.
• ❌ Sem ratio de sucesso/falha agregado.
• ❌ Sem comparativo entre automações.

Pra análises avançadas, considere:

• Exportar via API REST v1 dados de LeadEvent.
• Webhook → BI pra agregar externamente.
• Pedir relatório customizado ao suporte.

Eventos não geram em todas as ações

Algumas ações não criam evento explícito:

• add_tag_lead cria evento se a tag é nova; não cria se já existia.
• move_to_stage cria stage_changed, mas não cria automation_executed redundante.
• Ações simples (set_lead_source) atualizam silenciosamente.

Pra rastrear todas as execuções, prefira ações com webhook ou nota — esses sempre criam evento.

Auditar uso de IA (consumo de tokens)

Tokens consumidos por automações IA são registrados em ai_usage_logs. Visíveis em:

• IA → Agentes sidebar — agregado mensal.
• Audit Log se tiver acesso.

Veja Quota de tokens.

Boas práticas

1. Revisão mensal

Reserve 30 min/mês pra:

• Abrir lista de automações.
• Olhar run_count e last_run_at.
• Identificar automações inativas ou estouradas.
• Pausar ou ajustar.

2. Naming convention

Use nomes que facilitem identificação depois:

• ❌ Automação 1, Tagging, Webhook
• ✅ Boas-vindas WA B2B, Webhook ao ganho → ERP, Aniversário cliente VIP

3. Use prefixos pra grupos

Em contas com muitas automações:

• [BOAS-VINDAS] Lead novo WhatsApp
• [BOAS-VINDAS] Lead novo Site
• [FOLLOWUP] Aniversário
• [WEBHOOK] Lead ganho →

Filtragem visual fica fácil.

4. Documente complexas

Pra automações com muitas ações (5+) ou lógica de negócio crítica, considere:

• Adicionar nota como primeira ação:

add_note: "Automação de boas-vindas executada. Versão 2.3."

• Cria registro auditável da versão da automação que rodou.

Próximos passos

• Pra ver todas as ações suportadas, veja Ações principais.
• Pra entender condições, veja Condições e filtros.

Artigos relacionados

• Criar automação
• Gatilhos disponíveis
• Condições e filtros
• Quota de tokens IA