Skip to main content
Se o Dashboard Apps serve para trazer informações de fora para dentro, os Webhooks fazem o caminho inverso. Eles permitem que o Attende “avise” outros sistemas (como o seu CRM, um grupo de alertas ou um sistema de logística) sempre que um evento específico ocorrer. Pense no Webhook como um mensageiro que corre para entregar uma nota toda vez que:
  • Uma nova conversa é criada.
  • Uma mensagem chega do cliente.
  • O status de um atendimento muda de “Aberto” para “Resolvido”.

​
Como configurar um Webhook

  1. Vá em Configurações → Integrações → Webhooks.
  2. Clique no botão “Configurar” e depois em “Adicionar novo Webhook”.
  3. No campo URL, insira o endereço do sistema que vai receber os dados (geralmente uma URL gerada pelo seu desenvolvedor ou por ferramentas de automação).
  4. Selecione os Eventos que você deseja monitorar. Isso evita que seu sistema receba informações desnecessárias.
  5. Clique em Criar.

​
Eventos que o Attende pode avisar

Você pode escolher ser notificado em diversas situações. As mais comuns são:
  • conversation_created: “Ei, alguém acabou de iniciar um chat agora!”
  • message_created: “Chegou uma nova mensagem (seja do cliente ou do atendente).”
  • conversation_status_changed: “Esta conversa acabou de ser marcada como resolvida (ou reaberta).”
  • webwidget_triggered: “O cliente apenas abriu a janelinha do chat no seu site, mas ainda não mandou nada.”
  • conversation_typing_on/off: Saiba exatamente quando o atendente começou ou parou de digitar.

​
O que vem dentro do aviso? (Para Desenvolvedores)

O Attende envia um pacote de dados (POST request) em formato JSON. Esse pacote contém tudo o que você precisa para identificar a ação. Veja um exemplo simplificado de uma mensagem recebida: JSON 
{
  "event": "message_created",
  "content": "Olá, qual o status do meu pedido?",
  "message_type": "incoming",
  "contact": {
    "name": "João Silva",
    "email": "joao@email.com"
  },
  "conversation": {
    "display_id": "150"
  }
}
Com esses dados, seu sistema pode, por exemplo, atualizar automaticamente um card no Trello ou enviar um e-mail de alerta para um gerente.

​
Casos de Uso Reais

  • Alerta de VIP: Se um Webhook detectar uma nova conversa de um e-mail que está na sua lista de clientes VIP, ele pode disparar um alerta urgente no celular do dono da empresa.
  • Registro de Vendas: Quando uma conversa for marcada como “Resolvida” e tiver a etiqueta “Venda”, o Webhook pode enviar os dados do cliente para sua planilha de controle financeiro.
  • Pesquisa Externa: Envie automaticamente um e-mail personalizado de pesquisa de satisfação assim que o status da conversa mudar para “Resolvido”.
Dica do Especialista: Use Webhooks para manter todos os seus sistemas em sincronia sem precisar de trabalho manual. É a base da verdadeira automação empresarial.