Pular para o conteúdo principal
Atualizado em Aug 4, 2026

Webhooks

O que você vai aprender
  • O que são webhooks e como funcionam no AutoTalk
  • O que cada entrega contém e como as entregas se comportam
  • Como criar e gerenciar endpoints de webhook

Webhooks enviam notificações em tempo real para serviços externos quando eventos acontecem no AutoTalk. Em vez de verificar repetidamente a API do AutoTalk em busca de novos dados, seu sistema externo recebe uma notificação automática no momento em que algo acontece, como uma nova mensagem chegando ou um contato sendo atualizado.

Você gerencia webhooks na página Webhooks em Integrações na barra lateral.

Como os webhooks funcionam​

  1. Você fornece uma URL do webhook (um endpoint no seu servidor ou um serviço de terceiros que pode receber requisições HTTP).
  2. Você escolhe um Modelo de dados e uma Operação (por exemplo, contacts + afterCreate) que devem acionar o webhook e, opcionalmente, um Filtro CEL para restringir quais alterações o disparam. Seus próprios Tipos Personalizados também funcionam — escolha a entrada ct:<slug> no dropdown de Modelo (para Tipos Personalizados, disparam as operações afterCreate, afterUpdate e afterDelete).
  3. Quando uma alteração correspondente ocorre no AutoTalk, a plataforma envia uma requisição HTTP POST para sua URL do webhook com os dados do evento no formato JSON.

Seu sistema externo recebe os dados e pode agir sobre eles como necessário, seja atualizando um banco de dados, enviando uma notificação ou disparando um workflow.

Payload da entrega​

Cada entrega é uma requisição HTTP POST com um corpo JSON em um formato estável:

{
  "id": "contacts:afterCreate:66a1b2c3d4e5f6a7b8c9d0e1:2026-07-02T14:03:07.512Z",
  "model": "contacts",
  "op": "afterCreate",
  "at": "2026-07-02T14:03:07.512Z",
  "companyId": "664a0f9eb1c2d3e4f5a6b7c8",
  "tenantId": "664a0f9eb1c2d3e4f5a6b7c8",
  "doc": {
    "_id": "66a1b2c3d4e5f6a7b8c9d0e1",
    "name": "Jane Doe",
    "createdAt": "2026-07-02T14:03:07.498Z",
    "updatedAt": "2026-07-02T14:03:07.498Z"
  },
  "prev": null
}
CampoSignificado
idUm identificador por evento que combina o modelo, a operação, o id do registro e o timestamp
modelO modelo de dados que foi alterado — um modelo integrado como contacts, ou ct:<slug> para um Tipo Personalizado
opA operação de ciclo de vida que disparou o webhook (por exemplo afterCreate, afterUpdate, afterDelete)
atQuando o evento foi disparado, como um timestamp ISO 8601
companyId / tenantIdO id da sua empresa (ambos os campos carregam o mesmo valor)
docO registro envolvido no evento (o exemplo acima está truncado — você recebe o registro completo)
prevA versão anterior do registro, quando existe (atualizações); null caso contrário (por exemplo, em criações)
observação

Para entregas de afterDelete de Tipo Personalizado (ct:), doc não é o registro excluído — é um objeto de resumo {filter, hardDelete, deletedCount} que descreve a exclusão, e prev é sempre null.

Semântica de entrega​

  • Cada evento recebe uma única tentativa de entrega por webhook — entregas que falham não são repetidas.
  • A requisição expira após 5 segundos, e redirecionamentos não são seguidos — aponte o webhook diretamente para um endpoint que responda rapidamente.
  • Responda com qualquer status 2xx para confirmar o recebimento; o corpo da resposta é ignorado, e uma resposta que não seja 2xx conta como uma entrega com falha.
  • Entregas com falha são registradas — use o botão Logs na página de detalhes do webhook para revisar as tentativas recentes.
  • As entregas não são assinadas. Se o seu receptor precisa verificar que uma requisição realmente veio do AutoTalk, inclua um token difícil de adivinhar na sua URL do webhook (por exemplo, um parâmetro de query secreto) e verifique-o do seu lado.

Gerenciando webhooks​

Visualizando webhooks existentes​

Navegue até Integrações > Webhooks. A página exibe uma lista intitulada Webhooks com todos os seus endpoints configurados. A lista segue o formato CRUD padrão do AutoTalk com opções para filtrar, visualizar, editar e excluir entradas.

Criando um novo webhook​

  1. Na página de Webhooks, clique no botão + (dica "Adicionar novos webhooks").
  2. Preencha os campos:
    • URL do webhook — O endpoint para onde o AutoTalk deve enviar os dados do evento (precisa ser uma URL HTTP/HTTPS pública)
    • Ativado — Se o webhook dispara (ativado por padrão)
    • Gatilho — Um Modelo, uma Operação e um Filtro CEL opcional que decidem quais alterações disparam o webhook
  3. Salve o webhook.

O AutoTalk agora enviará uma requisição HTTP POST para sua URL do webhook toda vez que uma alteração correspondente ocorrer.

Editando ou excluindo um webhook​

  • Clique em qualquer webhook na lista para visualizar seus detalhes e modificar sua configuração. A página de detalhes também tem um botão Logs que mostra as tentativas de entrega recentes.
  • Para parar as notificações para um endpoint específico, exclua o webhook da lista.

Próximos passos​

Última atualização em
Nesta página