Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ajuda.attende.online/llms.txt

Use this file to discover all available pages before exploring further.

Um webhook é uma notificação que o Attende envia automaticamente para um endereço de sua escolha sempre que um evento acontece — uma conversa criada, uma mensagem enviada, um contato atualizado. Você registra a URL do seu sistema, define quais eventos quer receber, e o Attende cuida do envio. Simples e poderoso. É a base para conectar o Attende a automações, sistemas de terceiros, integrações customizadas e ferramentas como Make, n8n, Zapier ou qualquer backend próprio.

​
Eventos disponíveis

Você escolhe quais eventos disparam notificações para cada webhook cadastrado. Os eventos disponíveis são:
EventoQuando é disparado
conversation_createdUma nova conversa é aberta no Attende
conversation_status_changedStatus da conversa muda (aberto → resolvido, etc.)
conversation_updatedDados da conversa são atualizados
message_createdUma nova mensagem é recebida ou enviada
message_updatedUma mensagem existente é alterada
contact_createdUm novo contato é criado
contact_updatedDados de um contato são atualizados
webwidget_triggeredUm visitante interage com o widget do site
conversation_typing_onO cliente começa a digitar
conversation_typing_offO cliente para de digitar
Selecione apenas os eventos que o seu sistema realmente precisa processar. Receber eventos desnecessários gera carga na sua URL sem benefício.

​
Criando um webhook

1

Acesse os Webhooks

Vá para Configurações → Integrações → Webhooks.
2

Adicione um novo webhook

Clique em Adicionar Webhook.
3

Informe a URL

Cole o endereço que deve receber as notificações. Precisa ser uma URL válida e acessível publicamente — o Attende vai fazer chamadas HTTP POST para esse endereço.
4

Dê um nome (opcional)

Adicione um nome para identificar o webhook na lista — por exemplo: Make - Pipeline de Vendas ou n8n - Notificação Slack. Facilita a gestão quando você tem vários webhooks.
5

Selecione os eventos

Marque pelo menos um evento. Você pode marcar quantos precisar — cada evento marcado gera uma chamada separada para a URL quando ocorrer.
6

Salve e guarde o secret

Clique em Criar. O Attende gera automaticamente um secret (chave secreta). Esse secret aparece uma única vez — copie e guarde agora. Você vai usá-lo para validar a autenticidade das chamadas no seu sistema.
O secret só é exibido uma vez, no momento da criação. Se você não copiou, não é possível recuperá-lo — será necessário deletar e recriar o webhook.

​
Validando o secret

O secret serve para garantir que as chamadas recebidas na sua URL vieram de fato do Attende. Em cada requisição POST, o Attende envia o header X-Hub-Signature com uma assinatura HMAC-SHA1 do payload usando o seu secret como chave. No seu sistema, valide assim: 
HMAC-SHA1(secret, payload) === X-Hub-Signature
Se a assinatura não bater, descarte a requisição — ela não veio do Attende.

​
Gerenciando webhooks

Na lista de webhooks você vê todos os registrados, com nome, URL e os eventos subscritos.
AçãoComo fazer
EditarClique no ícone de lápis para alterar URL, nome ou eventos
ExcluirClique no ícone de lixeira — a exclusão é imediata e permanente
Ao editar um webhook, o secret não é alterado nem exibido novamente. Se precisar de um novo secret, delete e recrie o webhook.

​
Estrutura do payload

Cada evento envia um payload JSON com dados sobre o que aconteceu. A estrutura varia por tipo de evento, mas todos incluem:
  • event — nome do evento (ex: conversation_created)
  • account — dados da conta Attende
  • id — identificador único do objeto
  • Dados específicos do evento (conversa, mensagem, contato, etc.)

​
Dúvidas comuns

Sim. Você pode ter vários webhooks cadastrados, cada um apontando para URLs e eventos diferentes. Útil quando você conecta o Attende a mais de um sistema ou automação.
O Attende tenta entregar a notificação, mas não garante reenvio automático em caso de falha. Mantenha sua URL disponível e monitore eventuais perdas.
Não há limite documentado por conta. O volume de chamadas depende da quantidade de eventos que acontecem no Attende.
Sim. Use ferramentas como webhook.site ou smee.io para receber e inspecionar as chamadas durante o desenvolvimento, sem precisar de um servidor próprio.
O Attende envia as notificações via HTTP POST com o payload em JSON no corpo da requisição.
Com um webhook configurado, o Attende passa a ser o ponto de origem de qualquer automação que você quiser construir. Cada conversa, mensagem ou contato atualizado pode disparar um fluxo no seu sistema. Ponto.
Outros artigos desta seção: ▸ Dashboard de apps ▸ Slack