Gerenciamento de Webhooks - Integrações de Webhooks


Gerenciamento de Webhooks - Integrações de Webhooks


📘 Recurso: Gerenciamento de Webhooks — Automação e Sincronização Instantânea com o Chat-Bot

O recurso de Webhooks do Chat-Bot permite que sistemas externos recebam notificações em tempo real sempre que eventos importantes acontecerem dentro da plataforma.
Com isso, sua aplicação não precisa ficar consultando manualmente — ela é notificada automaticamente assim que algo ocorre.
⚡🔄📡

Esse mecanismo permite criar integrações extremamente rápidas, inteligentes e eficientes, garantindo sincronização imediata entre o Chat-Bot e sistemas como:

  • CRMs

  • ERPs

  • Plataformas de vendas

  • Automações internas

  • Sistemas personalizados


🚀 Por que usar Webhooks no Chat-Bot?

Através dos webhooks, seu sistema pode:

🔁 Sincronizar dados em tempo real

Sempre atualizado, sem consultas manuais.

Reagir instantaneamente a mudanças

Processar atualizações no momento exato em que acontecem.

🧠 Criar fluxos de trabalho mais inteligentes

Acionar automações, registrar atividades, atualizar cadastros e muito mais.

📡 Eliminar sondagens (polling)

Seu sistema não precisa "ficar perguntando" o tempo todo.


🎯 Exemplo prático de uso

Quando um contato é atualizado no Chat-Bot, sua aplicação recebe imediatamente uma notificação contendo todos os dados. Assim, seu CRM, ERP ou fluxo de automação pode:

  • sincronizar informações

  • criar tarefas

  • disparar notificações internas

  • atualizar fichas de clientes

Tudo sem qualquer ação manual.
💼⚙️📲


🌟 Principais Benefícios do Webhook

  • 🔔 Atualizações instantâneas sem polling

  • ⚙️ Automação mais ágil e precisa

  • 🧩 Integrações profundas e escaláveis

  • ⏱️ Atraso mínimo para acionamento de fluxos externos

  • 🚀 Operações integradas de forma contínua e automática

Basta definir o URL do seu webhook, escolher os eventos desejados e o Chat-Bot faz todo o trabalho.


🛠️ Gerenciamento de Webhooks

📍 1. Habilitar Acesso ao Webhook

No topo do painel do recurso, você encontrará a opção para ativar ou desativar o envio de webhooks.

🔛 Quando ativado:

O Chat-Bot enviará todos os eventos selecionados para o URL configurado.

🔴 Quando desativado:

Nenhum webhook será enviado — mesmo se houver um URL cadastrado.


🌐 2. Configurar o URL do Webhook

Insira o endereço (endpoint) para onde o Chat-Bot enviará as notificações.

Este URL deve:

  • 🌍 ser acessível publicamente

  • 📩 aceitar requisições HTTP POST

  • 🧾 receber payloads JSON

  • 🔐 possuir mecanismos de validação e segurança (ex.: tokens, cabeçalhos personalizados)

❗ Sem um URL válido:

  • nenhum evento será enviado

  • sua plataforma não receberá atualizações

📌 Exemplo de URL válido:

https://seu-dominio.com/webhook

📦 3. Habilidades de Webhook (Eventos Disponíveis)

Você pode escolher exatamente quais eventos deseja receber — garantindo controle total sobre as integrações.

Os eventos estão organizados em três grandes categorias:

📁 A. Eventos de Contatos

EventoDisparoDescrição
Criar contatosquando um novo contato é adicionadoEnvia o objeto completo do contato recém-criado.
Atualizar contatosquando um contato é editadoNotifica atualizações como nome, número, etiquetas, etc.
Excluir contatosquando um contato é removidoAlerta sobre remoção definitiva.

📌 B. Eventos de Status

EventoDisparoDescrição
Criar statusnovo status cadastradoEx.: criação de status de lead.
Atualização de statusstatus existente é alteradoNome, atributos ou configurações modificadas.
Excluir statusstatus removidoEnvia a informação ao sistema externo.

🧭 C. Eventos de Fontes

EventoDisparoDescrição
Criar fontenova fonte adicionadaEx.: canal de campanha, origem do lead.
Atualização de fonteedição de uma fonte existenteNome, tipo e parâmetros.
Excluir fonteremoção de uma fonteInforma a exclusão ao sistema externo.

💡 Dica estratégica:

Ative apenas os eventos necessários para evitar sobrecarga em seu servidor.


💾 4. Salvando as Configurações

Após inserir o URL e selecionar os eventos desejados:

  1. Verifique todas as permissões configuradas.

  2. Clique no botão Salvar alterações.

  3. O Chat-Bot começará imediatamente a enviar eventos conforme sua definição.
    💾✨


⚠️ Notas Técnicas Importantes

  • O URL precisa estar publicamente acessível.

  • O webhook só envia POST + JSON.

  • Garanta que seu servidor valide a origem das requisições.

  • Você pode ativar qualquer combinação de eventos.

  • Webhooks permitem sincronização automática e contínua com outros sistemas.


📚 Navegação

◀️ Página anterior: Gerenciamento de API
▶️ Próxima página: Gestão de Pessoal e Funções



** O tempo é base no fuso horário America/New_York