Como integrar a API de ligação ao seu CRM, n8n ou sistema

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.