Os webhooks permitem que o Smartsupp envie notificações em tempo real para qualquer URL à sua escolha — no momento em que uma conversa é aberta, um contacto é criado ou uma mensagem é entregue, o seu sistema fica a saber. Este artigo explica o que são webhooks, como configurá-los no painel e como ligá-los a plataformas de automação como o Make e o n8n.

Dividimos o artigo em algumas secções:

Para que servem os webhooks?

Um webhook é uma mensagem HTTP automática que o Smartsupp envia para um URL à sua escolha sempre que ocorre um evento selecionado. Em vez de consultar constantemente as alterações, as suas ferramentas recebem os dados no momento em que algo acontece.

Casos de uso típicos:

Plataformas de automação — acione fluxos de trabalho no Make, no n8n ou em ferramentas semelhantes: adicionar contactos a um CRM, publicar notificações no Slack, registar leads numa folha de cálculo
Sistemas internos — envie dados de conversas e contactos em tempo real para dashboards, armazéns de dados ou sistemas de tickets
Notificações — alerte a sua equipa quando uma conversa é avaliada ou quando a entrega de uma mensagem falha

Dica: Os webhooks estão disponíveis a partir do plano Plus — o Plus inclui 1 webhook, o Expert 3 e o Ultimate oferece um limite personalizado. Compare os planos →

Criar um webhook

Configurar um webhook demora apenas alguns passos no painel do Smartsupp:

1. Abra as Settings e vá à secção Webhooks.
2. Clique para adicionar um novo webhook e introduza o seu endpoint URL — o endereço para onde o Smartsupp enviará os dados dos eventos.
3. Selecione os eventos que quer receber (lista completa na secção seguinte).
4. Guarde o webhook. A partir desse momento, os eventos selecionados são entregues como pedidos HTTP POST com conteúdo JSON.

Nota: Os webhooks configurados anteriormente continuam a funcionar normalmente. Estamos a trabalhar para que todos os webhooks existentes fiquem visíveis e geríveis na nova secção do painel.

Eventos disponíveis

O Smartsupp pode notificar o seu endpoint sobre eventos em três categorias. Selecione apenas os eventos de que o seu fluxo de trabalho realmente precisa — assim o endpoint mantém-se leve e evita tráfego desnecessário.

Contactos

contact.created
contact.updated
contact.acquired
contact.banned
contact.unbanned

Conversas

conversation.opened
conversation.closed
conversation.closed_by_contact
conversation.rated
conversation.agent_assigned
conversation.agent_unassigned
conversation.agent_joined
conversation.agent_left
conversation.agent_replied
conversation.bot_replied
conversation.contact_replied
conversation.message_delivered
conversation.message_delivery_failed

Visitantes

visitor.connected
visitor.disconnected
visitor.updated
visitor.typing
visitor.triggered
visitor.replied

Recursos relacionados: Documentação para programadores do Smartsupp — esquemas JSON completos do payload para cada tipo de evento.

Teste o seu webhook

Antes de entrar em produção, use a função de teste integrada para verificar que o endpoint está acessível e que o seu cenário no Make ou no n8n está corretamente configurado.

Nas definições do webhook no painel, clique em Send test. O Smartsupp enviará um payload de exemplo para o seu endpoint URL. Verifique no serviço recetor que os dados chegaram no formato esperado.

Dica: No Make, o cenário tem de estar ativo e à escuta antes de enviar o teste. No n8n, mude o nó Webhook para o URL de produção e confirme que o fluxo de trabalho está ativo.

Entrega, novas tentativas e segurança

O Smartsupp foi concebido para entregar eventos de webhook de forma fiável, mesmo quando o seu endpoint está temporariamente indisponível.

Formato — todos os eventos são enviados como pedidos HTTP POST com um corpo JSON que descreve o evento e os seus dados
Resposta — o seu endpoint deve responder com um código de estado HTTP 2xx o mais depressa possível; respostas lentas podem atrasar as novas tentativas
Novas tentativas — se a entrega falhar, o Smartsupp tenta novamente com intervalos crescentes durante até 3 dias
Desativação automática — endpoints que falham persistentemente são desativados automaticamente; pode reativá-los no painel a qualquer momento
Segurança — cada pedido de webhook é assinado para que possa verificar que veio realmente do Smartsupp; consulte docs.smartsupp.com para os detalhes da verificação da assinatura

Nota: Se o seu endpoint for desativado devido a falhas repetidas, reative-o em Settings → Webhooks depois de corrigir o problema. O Smartsupp retoma imediatamente o envio de eventos.

Ligue o Smartsupp ao Make ou ao n8n

Ligar o Smartsupp a uma plataforma de automação demora quatro passos. O processo é igual para o Make e o n8n — apenas o nó de trigger difere.

1. No Make, adicione um trigger Webhooks → Custom webhook e copie o URL gerado. No n8n, adicione um nó de trigger Webhook e copie o seu URL de produção.
2. No Smartsupp, vá a Settings → Webhooks, crie um novo webhook e cole o URL copiado.
3. Selecione os eventos de que precisa e guarde o webhook.
4. Clique em Send test para que o Make ou o n8n capture a estrutura dos dados — depois construa o resto do cenário sobre ela.

Dica: No Make, ative o cenário antes de enviar o teste — caso contrário, os dados do webhook não serão capturados. No n8n, use o URL de produção (não o de teste) ao configurar o webhook do Smartsupp.

E a seguir?

Smartsupp REST API — explore a API completa para ler e escrever dados do Smartsupp programaticamente.
Automatizações — configure automatizações baseadas em regras que são acionadas diretamente no Smartsupp sem ferramenta externa.
Visão geral das integrações — veja todas as integrações nativas disponíveis com CRMs, plataformas de e-commerce e mais.

💡 Precisa de mais ajuda? Contacte a nossa equipa de suporte — teremos todo o gosto em ajudar!

Webhooks — ligue o Smartsupp ao Make, ao n8n e às suas próprias ferramentas