API e webhook conectam o atendimento a outros sistemas, mas fazem trabalhos diferentes. Pense na API como uma forma de um sistema pedir uma operação ao Chat Inteligente. Pense no webhook como um aviso enviado quando um evento acontece.
Essas integrações são úteis quando a equipe precisa manter informações entre ferramentas sem repetir toda a tarefa manualmente. Antes da configuração técnica, descreva o resultado desejado: qual informação deve sair, para onde vai e o que deverá acontecer ao chegar.
Como começar
- Defina qual informação precisa circular entre os sistemas.
- Confira a documentação e as opções de API e webhook disponíveis.
- Configure a integração e teste o fluxo com dados apropriados para teste.
Como escolher a integração certa
A API permite que outro sistema faça uma operação autorizada no Chat Inteligente. O webhook faz o caminho de notificação: envia dados quando ocorre um evento. A tela oferece acesso à documentação interativa da API e gerenciamento do token. Consulte o contrato da operação antes de executar uma chamada que altere dados.
Na opção Webhook + n8n, você pode informar a URL de destino e baixar o workflow para importar no n8n. Depois de publicar o fluxo, use a URL de produção apresentada pelo n8n e valide o recebimento de um evento. Os eventos disponíveis acompanham o catálogo do produto; consulte a descrição atual na interface em vez de depender de uma lista copiada.
A mesma área reúne Google Sheets, Meta Leads, rastreamento de anúncios, Instagram, Twilio e voz ElevenLabs. Algumas conexões de agenda e integrações específicas aparecem apenas conforme a configuração da conta. Escolha a integração pela finalidade: receber leads, consultar dados, registrar contatos ou acompanhar conversões são fluxos distintos.
Exemplo prático: do atendimento ao outro sistema
Exemplo ilustrativo. Uma empresa quer que seu sistema de gestão acompanhe um evento do atendimento. A equipe descreve a necessidade e o responsável técnico verifica se existe um webhook correspondente. Depois prepara o destino e testa o recebimento.
Se o sistema externo também precisar solicitar uma operação no Chat Inteligente, essa parte é avaliada pela API. O teste deve conferir os dois lados, porque receber um aviso não comprova que o destino concluiu sua tarefa.
Esquema ilustrativo do exemplo. As etapas estão explicadas no texto acima. Abrir imagem ampliada.
Como descrever a necessidade para a equipe técnica
Explique o acontecimento de origem, os dados necessários e a ação esperada no destino. Uma frase como “quando isso acontecer, quero atualizar aquilo” é um bom começo para conferir as operações disponíveis.
Evite tratar qualquer conexão como pronta apenas porque o endereço foi salvo. O responsável deve validar autenticação, formato dos dados e resultado. Para consultas externas feitas pela IA, veja funções personalizadas.
Antes de usar: Uma integração exige configuração no destino e validação técnica. Não compartilhe chaves de acesso em páginas públicas ou mensagens de atendimento.
Perguntas frequentes
API e webhook fazem a mesma coisa?
São complementares: a API atende solicitações feitas por uma integração; o webhook notifica o destino quando ocorre um evento configurado.
Salvar o endereço do webhook conclui a integração?
Não. O destino precisa receber e tratar os dados. Faça um teste do evento escolhido e confirme a ação no sistema que recebeu a notificação.
Continue explorando
Leve essa organização para o seu atendimento
Conheça o Chat Inteligente e explore os recursos para a rotina da sua equipe.
Conhecer o Chat Inteligente Explorar recursos avançados