Gestor › Atendimentos

Webhooks

Avisar outro sistema automaticamente quando algo acontece no seu atendimento.

Um webhook é um aviso que a SM Click envia a outro sistema quando um evento acontece aqui — conversa criada, mensagem recebida, atendimento finalizado.

É o caminho para integrar a plataforma a um sistema que não está na lista de integrações nativas.

Como funciona

Você informa o endereço (URL) do sistema que vai receber o aviso.
Escolhe quais eventos disparam o envio.
Quando o evento acontece, a SM Click faz uma requisição POST para aquele endereço, com os dados do evento em JSON.

Do outro lado, alguém precisa ter preparado esse endereço para receber — normalmente quem cuida do sistema ou desenvolve para a sua empresa.

Isto exige apoio técnico

Diferente do resto da plataforma, webhook não se resolve só no painel: alguém precisa construir o que recebe do outro lado. Se você não tem quem faça isso, veja se a integração nativa já cobre o seu caso.

Onde configurar

No menu lateral, Atendimentos → Webhooks.

Campo	O que é
Nome	Como você identifica esse webhook na lista
URL	O endereço que vai receber a requisição POST
Ativo	Liga e desliga sem precisar apagar a configuração
Eventos	Quais acontecimentos disparam o envio

Há um Marcar/Desmarcar todos na lista de eventos — útil para testar, arriscado para deixar em produção.

Os eventos disponíveis

Ciclo da conversa

Evento	Quando dispara
`new-chat`	Uma conversa é criada
`chat-started`	O atendimento é iniciado
`chat-waiting`	A conversa entra em espera, aguardando atendente
`chat-transfered`	A conversa é transferida
`chat-finished`	A conversa é finalizada

Mensagens

Evento	Quando dispara
`new-chat-message`	Chega uma nova mensagem
`new-chat-message-processing`	Uma mensagem foi enviada e está em processamento
`new-chat-message-sent`	A mensagem foi propagada ao cliente

Os três formam o caminho de uma mensagem que sai: primeiro processando, depois enviada. Quem precisa confirmar entrega usa o sent.

Participantes

Evento	Quando dispara
`chat-participant-included`	Um atendente é incluído na conversa
`chat-participant-removed`	Um atendente é removido
`chat-participant-quited`	Um atendente sai da conversa por conta própria

Contatos e cadastro

Evento	Quando dispara
`new-contact`	Um contato novo é criado
`custom-field-updated`	Um campo personalizado é alterado
`contact-tags-updated`	As etiquetas do contato mudam
`attendant-archived`	Um atendente é arquivado

Dois eventos permitem escolher o que observar

Em campo personalizado alterado e etiquetas alteradas, você seleciona quais campos ou etiquetas disparam o aviso.

Sem isso, qualquer alteração em qualquer campo geraria uma requisição — e o sistema do outro lado receberia muito mais do que precisa.

O que chega no destino

Todo envio tem a mesma forma:

{
  "event": "chat-finished",
  "infos": { },
  "event_time": "2026-09-16T15:30:24.624-03:00"
}

event — o nome do evento, igual aos da tabela acima.

infos — os dados. Para eventos de conversa, traz o chat inteiro: contato (com telefone, etiquetas e campos de segmentação), instância, departamento, atendentes, protocolo, status e última mensagem. Para eventos de mensagem, traz o chat e a mensagem.

event_time — quando o evento foi disparado.

Cada evento tem exemplo na tela

A própria tela de configuração mostra um exemplo do conteúdo de cada evento, e um link para a documentação técnica detalhada.

É de lá que quem vai desenvolver do outro lado deve partir — não de suposição sobre o formato.

Webhook ou workflow?

Confunde, porque os dois reagem a eventos:

	Webhook	Workflow
O que faz	Avisa um sistema de fora	Executa ações dentro da plataforma
Quem trata	O sistema que recebe	A própria SM Click
Precisa de programação	Sim, do outro lado	Não

Se o que você quer é automatizar algo dentro da plataforma, use workflow. Se é avisar um sistema externo, webhook.

Vale saber que o workflow também tem um bloco de integração que chama APIs externas — para muitos casos, ele resolve sem precisar de webhook.

Cuidados

Comece por um evento. Marcar todos gera volume alto e dificulta descobrir o que quebrou.

O destino precisa aguentar. Cada mensagem trocada pode virar uma requisição. Em operação com volume, isso é bastante tráfego.

Desligue em vez de apagar. O campo Ativo existe para isso: parar o envio sem perder a configuração e a lista de eventos escolhidos.

Relacionado

Workflows

Automação sem sair da plataforma.

API pública

Para consultar e agir de fora.

Bloco de integração

Chamar outro sistema no meio da conversa.

Atualizado em 16/09/2026