Logs das automações e webhooks do CRM
Quando uma automação não fez o que você esperava, é aqui que se descobre por quê - com o evento, o resultado, a mensagem de erro e o botão de tentar de novo. E é aqui que se cadastra o endereço de outro sistema que deve receber os eventos do CRM.
Quando usar
Use quando precisar executar a rotina de Configurações no ERP.
Antes de começar
- Módulo CRM liberado
- Ao menos uma automação criada (senão não há execução para ver)
Visão geral
Automação que funciona é invisível. Quando alguma não funciona, você precisa de duas respostas: ela rodou? e, se rodou, o que aconteceu? As duas estão em CRM > Configurações > Logs e histórico.
Lendo uma execução
Cada cartão da lista é uma passagem da automação por um card. Ele traz:
| Informação | Como usar |
|---|---|
| Nome da automação | Confirma que foi a regra que você esperava - e não outra parecida |
| Situação | Pendente, concluída ou falhou |
| Evento | Qual gatilho disparou aquela execução |
| Tentativa | Quantas vezes já foi tentada |
| Registro relacionado | Em que card isso aconteceu |
| Resumo do log | A mensagem que o sistema recebeu. É a linha que diz o motivo |
O filtro de situação no topo é o caminho mais rápido: filtre por falhou e você vê só o que precisa de atenção.
Tentar de novo
A execução que falhou ganha o botão Retry. Ele repete aquela execução - a mesma automação, no mesmo card.
Use assim:
- 1
Leia o resumo do log e descubra a causa.
- 2
Corrija a causa (preencher o e-mail do contato, reativar o template, ajustar a condição).
- 3
Só então clique em Retry.
O botão Processar fila agora adianta o robô: em vez de esperar a próxima passagem, ele processa o que está pendente na hora. É útil enquanto você está testando uma automação nova.
Webhooks: avisar outro sistema
Webhook é o caminho para o CRM avisar um sistema seu quando algo acontece - um ERP paralelo, uma planilha, um painel, um grupo interno.
- 1
Abra CRM > Configurações > Integrações.
- 2
Clique para criar e informe:
Nome, URL, método, segredo e a chave de ativo
| Campo | O que informar |
|---|---|
| Nome | Como você reconhece esse destino na lista |
| URL | O endereço que vai receber, começando com https:// |
| Método | Normalmente POST |
| Segredo HMAC | Opcional, mas recomendado: com ele, o seu sistema confere que a chamada veio do Hap |
| Ativo | Desligue para pausar sem apagar o cadastro |
- 1
Salve e use o botão de teste: ele dispara uma chamada e mostra a resposta que o seu endereço devolveu. É assim que se descobre erro de endereço ou de certificado antes de depender do webhook em produção.
Na automação, a ação Chamar webhook é a que dispara. Você escolhe o destino cadastrado aqui, e o CRM manda os dados do card.
Problemas comuns
- A execução está FALHOU e não sei por quê - leia o resumo do log no próprio cartão: ele traz a mensagem que o sistema recebeu. A causa mais comum é contato sem o canal da ação.
- Fiz o retry e falhou de novo - o retry repete a mesma execução. Se a causa era o cadastro (contato sem e-mail, template apagado), corrija a causa antes de tentar.
- A automação disparou mas não há execução na lista - confira o filtro de status e atualize. Execução recém-criada aparece como pendente até o robô passar.
- O webhook não chega ao meu sistema - use o botão de teste da própria tela; ele mostra a resposta que o seu endereço devolveu.
- Não sei validar se o webhook é do Hap - cadastre um segredo HMAC e confira a assinatura do corpo no seu lado.