Os webhooks permitem ao Smartsupp enviar notificações em tempo real para qualquer URL à sua escolha — assim 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 de controlo 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 consultarem periodicamente as alterações, as suas ferramentas recebem os dados assim que algo acontece.

Os casos de utilização mais comuns incluem:

Plataformas de automação — acionar fluxos de trabalho no Make, no n8n ou em ferramentas semelhantes para adicionar contactos a um CRM, publicar notificações no Slack ou registar leads numa folha de cálculo
Sistemas internos — fornecer dados de conversas e contactos a painéis de controlo, armazéns de dados ou sistemas de gestão de pedidos de suporte em tempo real
Notificações — alertar a sua equipa quando as conversas são avaliadas ou quando a entrega de mensagens falha

Dica: Os webhooks estão disponíveis no plano Plus e nos planos superiores — o Plus inclui 1 webhook, o Expert inclui 3 e o Ultimate oferece um limite personalizado. Comparar planos →

Criar um webhook

Configurar um webhook requer apenas alguns passos no painel de controlo do Smartsupp:

1. Abra Definições e aceda à secção Webhooks .
2. Clique para adicionar um novo webhook e introduza o URL do endpoint — o endereço para onde o Smartsupp enviará os dados dos eventos.
3. Selecione os eventos que pretende receber (consulte a 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 dados em JSON.

Nota: Os webhooks configurados anteriormente continuam a funcionar normalmente. Estão em curso esforços para tornar todos os webhooks existentes visíveis e geríveis a partir da nova secção do painel de controlo.

⚠️ Já criou webhooks anteriormente? Os webhooks mais antigos ainda não aparecem nesta secção — continuam a funcionar como antes. Estamos a unificar o sistema antigo e o novo para que tudo possa ser gerido num único local.

Eventos disponíveis

O Smartsupp pode notificar o seu endpoint sobre eventos de três categorias. Selecione apenas os eventos de que o seu fluxo de trabalho realmente precisa — isto mantém o seu endpoint 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 completos dos dados em JSON para cada tipo de evento.

Testar o seu webhook

Antes de colocar o webhook em produção, utilize a funcionalidade de teste integrada para verificar se o seu endpoint está acessível e se o seu cenário no Make ou no n8n está configurado corretamente.

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

Dica: No Make, o seu cenário deve estar ativo e à escuta antes de enviar o teste. No n8n, altere o nó Webhook para o respetivo URL de produção e certifique-se de 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 respetivos dados
Resposta — o seu endpoint deve responder com um código de estado HTTP 2xx o mais rapidamente possível; respostas lentas podem atrasar as novas tentativas
Novas tentativas — se a entrega falhar, o Smartsupp volta a tentar com intervalos crescentes durante um máximo de 3 dias
Desativação automática — os endpoints que falham persistentemente são desativados automaticamente; pode reativá-los no painel de controlo a qualquer momento
Segurança — cada pedido de webhook é assinado para que possa verificar se veio realmente do Smartsupp; consulte docs.smartsupp.com para obter detalhes sobre a verificação da assinatura

Nota: Se o seu endpoint for desativado devido a falhas repetidas, reative-o em Definições → Webhooks depois de corrigir o problema subjacente. O Smartsupp retomará imediatamente o envio de eventos.

Ligar o Smartsupp ao Make ou ao n8n

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

1. No Make, adicione um acionador Webhooks → Webhook personalizado e copie o URL gerado. No n8n, adicione um nó de acionamento Webhook e copie o respetivo URL de produção.
2. No Smartsupp, aceda a Definições → Webhooks, crie um novo webhook e cole o URL copiado.
3. Selecione os eventos de que precisa e guarde o webhook.
4. Clique em Enviar teste para que o Make ou o n8n capte a estrutura dos dados — depois, construa o resto do seu cenário ou fluxo de trabalho com base nela.

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

O que se segue?

API REST do Smartsupp — explore a API completa para ler e escrever dados do Smartsupp de forma programática.
Automações — configure automações baseadas em regras que são acionadas diretamente no Smartsupp sem uma ferramenta externa.
Visão geral das integrações — consulte todas as integrações nativas disponíveis com CRMs, plataformas de comércio eletrónico e muito 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