Introdução às integrações
Por Equipe BotConversa · Atualizado em 6 de setembro de 2026
Integração ativa e passiva: a única distinção que importa
Antes de escolher a ferramenta, decida a direção. Todo o resto decorre disso.
- Integração ativa — o BotConversa começa. Alguém termina um fluxo e você quer gravar esse lead no seu CRM. O BotConversa sai daqui e vai bater na porta do outro sistema.
- Integração passiva — o outro sistema começa. Alguém compra na Hotmart e você quer que o BotConversa cadastre o contato e mande as boas-vindas. O outro sistema vem bater na nossa porta.
Muita gente trava aqui: tenta receber um pagamento usando a ferramenta de enviar dados, ou vice-versa. Se você identificar quem começa, a ferramenta certa fica óbvia.
Qual ferramenta usar?
| Você quer… | Direção | Ferramenta | Precisa programar? |
|---|---|---|---|
| Receber dados de um formulário, checkout ou CRM | Passiva | Webhook de entrada | Não — o mapeamento é por tela |
| Cadastrar contatos e disparar fluxos a partir do seu sistema | Passiva | API REST | Sim |
| Consultar um sistema no meio da conversa (CEP, boleto, estoque) | Ativa | Bloco de Integração | Um pouco — você monta a requisição |
| Ligar a uma ferramenta popular sem código | As duas | Zapier | Não |
Webhook de entrada
Gera uma URL fixa. Você entrega essa URL ao sistema de fora, ele manda um POST, e você mapeia por tela quais campos daquele JSON viram telefone, nome e demais dados do contato. É o caminho de quem não quer escrever código. Passo a passo em Configurando webhooks.
API REST
Controle total: criar contato, aplicar etiqueta, enviar mensagem, disparar fluxo, inscrever em sequência ou campanha — tudo comandado pelo seu código. É o caminho de quem tem um sistema próprio. Comece por API do BotConversa: primeiros passos.
Bloco de Integração
Vive dentro do fluxo. O robô pausa a conversa, chama a URL que você configurou, e pode usar a resposta nos blocos seguintes — é assim que o bot responde "seu pedido está a caminho" com dados que ele foi buscar no seu sistema na hora. Detalhes em Bloco Integração.
Zapier
Intermediário entre o BotConversa e milhares de aplicativos, nos dois sentidos, sem código. Tem chave própria em Configurações → Geral → Integrações, separada da chave da API. Veja Integrando com outras plataformas.
Como combino as duas direções?
As integrações mais úteis usam as duas pontas. Um exemplo completo, do jeito que costuma ser montado na prática:
- O cliente compra na sua loja. A loja envia um POST para o webhook de entrada com nome, telefone e número do pedido — passiva.
- O webhook cria o contato e dispara um fluxo de boas-vindas.
- No meio do fluxo, o cliente pergunta pelo status. O bloco de Integração consulta a sua API de pedidos e traz o código de rastreio — ativa.
- Ao fim do atendimento, o seu sistema usa a API REST para aplicar a etiqueta "compra concluída" no contato — passiva.