Como integrar a API de ligação ao seu CRM, n8n ou sistema
Passo a passo para integrar uma API de ligação com IA ao seu CRM, n8n, Make ou sistema próprio: chave de API, chamada HTTP e webhook com o resultado.
A integração de uma API de ligação tem duas pontas: o seu sistema pede a ligação, e o resultado volta para ele quando a ligação termina. Funciona igual para um CRM, uma ferramenta de automação como n8n e Make, ou um sistema próprio.
1. Crie a chave de API
No painel, em API, gere uma chave. Ela começa com rsp_ e vai no cabeçalho Authorization: Bearer de cada chamada. Guarde com cuidado: ela só aparece uma vez.
2. Peça a ligação
Uma chamada POST /v1/ligacoes com o agente, o telefone e as variáveis do contato. A resposta traz o identificador da ligação, que você guarda no seu sistema para ligar o resultado ao contato certo.
3. Receba o resultado no webhook
No pedido da ligação, informe no campo webhook_url o endereço que vai receber o resultado. Quando a ligação termina, esse endereço recebe um POST com:
- se a pessoa atendeu, a duração e o código SIP da operadora;
- o resumo e a transcrição da conversa;
- o link da gravação.
Cada entrega fica registrada no painel, em Webhook, com o que foi enviado e a resposta do seu servidor, para você conferir se chegou.
4. Use o resultado no fluxo
- no CRM, mova o card conforme o resultado;
- no n8n ou Make, decida o próximo passo: mandar uma mensagem, criar uma tarefa, agendar outra ligação;
- no seu sistema, grave o resumo no histórico do cliente.
5. Deixe a IA consultar o seu sistema durante a ligação
Além do webhook, as ferramentas permitem que a IA chame endereços do seu sistema enquanto conversa: consultar um pedido, verificar horários, registrar um interesse. A pessoa nem percebe que houve uma consulta.
Todas as rotas, campos e erros estão na documentação da API, com exemplos prontos para copiar.
Faça sua primeira ligação com IA hoje
Entre com o Google, coloque crédito por Pix e ligue pelo painel ou pela API.