Webhooks

Os eventos são organizados em grupos: Contatos, Conversas, Mensagens, Transferências para sua equipe, agente de AI, Reservas, Lembretes, Pedidos, Produtos, Chamadas, Campanhas, Formulários, Conta e canais, e Configurações do workspace. Abra um grupo e marque eventos individuais, ou pressione Selecionar tudo para pegar o grupo inteiro. Não sabe onde algo fica? Digite na busca, por exemplo "booking" ou "tag". Toque em qualquer evento para ver um exemplo exato do que o Entagl enviará. Alguns eventos também permitem escolher de onde eles vêm, então você pode receber só as reservas criadas pela sua AI e ignorar as que seu time digitou no calendário.

Mensagem recebida e Mensagem enviada são disparadas para cada mensagem. Em uma conta movimentada, isso pode ser milhares por dia. Por isso Selecionar tudo as ignora: você precisa marcar cada uma manualmente, ao lado de um aviso. Ative apenas se a ferramenta do outro lado conseguir lidar com esse volume. Se você só quer saber quando um chat começa ou termina, Conversa aberta e Conversa encerrada geram bem menos eventos.

Dois controles decidem quanta informação do cliente sai do Entagl. Incluir conteúdo da mensagem adiciona o que os clientes escrevem: mensagens, notas e resumos de chamadas. Incluir detalhes do contato adiciona o nome, telefone e email do cliente. Ambos começam desativados. Você ainda recebe todos os eventos sem eles, com um ID do contato no lugar dos detalhes. Só o dono do workspace ou um admin pode ativá-los, e apenas se a ferramenta que recebe os dados tiver permissão para armazenar informações de clientes. Em um workspace HIPAA, os dados do cliente nunca são enviados, independentemente dos controles.

Ferramentas e desenvolvedores podem registrar seus próprios webhooks pela API do Entagl, e eles aparecem sozinhos em Apps conectados. Para cada um, você vê quantos eventos ele monitora e quando recebeu o último. Você pode abrir as Entregas recentes dele, usar Pausar e Retomar, ou Remover. Os scenarios do Make têm uma página própria: Canais → Make.

Pressione Entregas recentes para ver os últimos 50 eventos que o Entagl tentou enviar, do mais recente para o mais antigo. Cada um mostra se chegou, a resposta que sua ferramenta deu (como 200 ou 500), quantas tentativas foram necessárias e quando ocorrerá a próxima tentativa. Quando uma entrega falha definitivamente, corrija o problema do seu lado e pressione Enviar novamente. O Entagl envia em alguns segundos.

Se sua ferramenta estiver fora do ar ou responder com erro, o Entagl tenta novamente após 30 segundos, 2 minutos, 10 minutos, 1 hora, 6 horas e 24 horas. São cerca de 31 horas até uma entrega ser marcada como falha. Se um app conectado continuar falhando por 3 dias seguidos, o Entagl o pausa e envia uma notificação ao owner do workspace. Corrija a ferramenta e depois pressione Retomar. Se o Make informar que o webhook de um cenário não existe mais, o Entagl para de enviar para ele imediatamente.

Toda solicitação carrega uma assinatura no header X-Entagl-Signature, criada com seu signing secret. Seu desenvolvedor usa isso para provar que a solicitação veio do Entagl e que ninguém a alterou no caminho.

• Apps conectados e webhooks criados pela API enviam t=1767225600,v1=5257a869…. A parte t é o momento do envio, em segundos. Cada v1 é um HMAC-SHA256 do texto timestamp.body (o valor t, um ponto e depois o corpo bruto da solicitação), feito com seu secret. Rejeite qualquer solicitação cujo t tenha mais de 5 minutos, para evitar que uma solicitação antiga seja reproduzida. Logo após uma troca de secret, você pode ver dois valores v1: aceite a solicitação se qualquer um deles corresponder.
• O webhook que você configurou nesta página envia sha256= seguido de um HMAC-SHA256 do corpo bruto da solicitação.