Os webhooks permitem que o Smartsupp envie notificações em tempo real para qualquer URL que você escolher — no momento em que uma conversa é aberta, um contato é criado ou uma mensagem é entregue, seu sistema fica sabendo. Este artigo explica o que são webhooks, como configurá-los no seu painel de controle e como conectá-los a plataformas de automação como Make e 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 um evento selecionado acontece. Em vez de consultar periodicamente se há alterações, suas ferramentas recebem os dados no momento em que algo ocorre.

Os casos de uso típicos incluem:

Plataformas de automação — acione fluxos de trabalho no Make, no n8n ou em ferramentas semelhantes para adicionar contatos a um CRM, publicar notificações no Slack ou registrar leads em uma planilha
Sistemas internos — envie dados de conversas e contatos para painéis de controle, data warehouses ou sistemas de chamados em tempo real
Notificações — alerte sua equipe quando conversas forem avaliadas ou quando a entrega de mensagens falhar

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 exige apenas alguns passos no seu painel de controle do Smartsupp:

1. Abra Configurações e vá para a seção Webhooks .
2. Clique para adicionar um novo webhook e insira sua URL do endpoint — o endereço para o qual o Smartsupp enviará os dados dos eventos.
3. Selecione os eventos que você quer receber (veja a lista completa na próxima seção).
4. Salve o webhook. A partir desse momento, os eventos selecionados serão entregues como requisições HTTP POST com payloads JSON.

Observação: Os webhooks configurados anteriormente continuam funcionando normalmente. Estamos trabalhando para tornar todos os webhooks existentes visíveis e gerenciáveis na nova seção do painel de controle.

⚠️ Você já criou webhooks antes? Os webhooks antigos ainda não aparecem nesta seção — eles continuam funcionando como antes. Estamos unificando os sistemas antigo e novo para que tudo possa ser gerenciado em um só lugar.

Eventos disponíveis

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

Testar seu webhook

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

Nas configurações do seu webhook no painel de controle, clique em Enviar teste. O Smartsupp enviará um payload de exemplo para a URL do seu endpoint. Verifique seu serviço receptor para confirmar que os dados chegaram no formato esperado.

Dica: No Make, seu cenário deve estar ativo e aguardando dados antes de você enviar o teste. No n8n, mude o nó Webhook para a URL de produção e certifique-se de que o fluxo de trabalho esteja ativo.

Entrega, novas tentativas e segurança

O Smartsupp foi projetado para entregar eventos de webhook de forma confiável, mesmo quando 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 — 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 faz novas tentativas com intervalos cada vez maiores por até 3 dias
Desativação automática — endpoints que falham persistentemente são desativados automaticamente; você pode reativá-los no painel de controle a qualquer momento
Segurança — cada requisição de webhook é assinada para que você possa verificar se ela realmente veio do Smartsupp; consulte docs.smartsupp.com para ver os detalhes de verificação da assinatura

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

Conectar o Smartsupp ao Make ou ao n8n

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

1. No Make, adicione um gatilho Webhooks → Webhook personalizado e copie a URL gerada. No n8n, adicione um nó de gatilho Webhook e copie sua URL de produção.
2. No Smartsupp, vá para Configurações → 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 Enviar teste para que o Make ou o n8n capture a estrutura dos dados — depois, crie o restante do seu cenário ou fluxo de trabalho com base nela.

Dica: No Make, ative seu 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 URL de teste) ao configurar o webhook do Smartsupp.

Quais são os próximos passos?

API REST do Smartsupp — explore a API completa para ler e gravar 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 — veja todas as integrações nativas disponíveis com CRMs, plataformas de e-commerce e muito mais.

💡 Precisa de mais ajuda? Entre em contato com nossa Equipe de suporte — teremos prazer em ajudar!

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