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

Dividimos o artigo em algumas seções:

Para que servem os webhooks?

Um webhook é uma mensagem HTTP automática que o Smartsupp envia para uma URL de sua escolha sempre que ocorre um evento selecionado. Em vez de consultar constantemente as alterações, 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 contatos a um CRM, publicar notificações no Slack, registrar leads em uma planilha
Sistemas internos — envie dados de conversas e contatos em tempo real para dashboards, data warehouses ou sistemas de tickets
Notificações — alerte sua equipe quando uma conversa for avaliada ou quando a entrega de uma mensagem falhar

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 leva apenas alguns passos no painel do Smartsupp:

1. Abra as Settings e vá até a seção Webhooks.
2. Clique para adicionar um novo webhook e insira a sua URL de endpoint — o endereço para onde o Smartsupp enviará os dados dos eventos.
3. Selecione os eventos que deseja receber (lista completa na próxima seção).
4. Salve o webhook. A partir desse momento, os eventos selecionados são entregues como requisições HTTP POST com conteúdo JSON.

Observação: Os webhooks configurados anteriormente continuam funcionando normalmente. Estamos trabalhando para que todos os webhooks existentes fiquem visíveis e gerenciáveis na nova seçã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 fica leve e você evita tráfego desnecessário.

Contatos

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 desenvolvedores 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 se o endpoint está acessível e se o seu cenário no Make ou no n8n está configurado corretamente.

Nas configurações do webhook no painel, clique em Send test. O Smartsupp enviará um payload de exemplo para a sua URL de endpoint. Verifique no serviço receptor se os dados chegaram no formato esperado.

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

Entrega, novas tentativas e segurança

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

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

Observação: Se o seu endpoint for desativado por falhas repetidas, reative-o em Settings → Webhooks depois de corrigir o problema. O Smartsupp retoma o envio de eventos imediatamente.

Conecte o Smartsupp ao Make ou ao n8n

Conectar o Smartsupp a uma plataforma de automação leva quatro passos. O processo é o mesmo para o Make e o n8n — apenas o nó de trigger é diferente.

1. No Make, adicione um trigger Webhooks → Custom webhook e copie a URL gerada. No n8n, adicione um nó de trigger Webhook e copie a sua URL de produção.
2. No Smartsupp, vá em Settings → Webhooks, crie um novo webhook e cole a URL copiada.
3. Selecione os eventos de que você precisa e salve 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 em cima dela.

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 a URL de produção (não a de teste) ao configurar o webhook do Smartsupp.

E agora?

Smartsupp REST API — explore a API completa para ler e gravar dados do Smartsupp programaticamente.
Automações — configure automaçõ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? Fale com a nossa equipe de suporte — teremos prazer em ajudar!

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