agente de voz na linha telefônica
Agente de voz com IA para telefone, disparado pelo seu sistema
Um agente de voz com IA para telefone liga para celular e fixo, conversa com o cliente do seu cliente, anota o que importa e devolve tudo ao seu SaaS por webhook, sem conexão de WhatsApp e com várias ligações em paralelo.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Liga para qualquer telefone
Pela linha telefônica o agente alcança celular e fixo, inclusive de quem não usa WhatsApp, sem conexão para manter.
Gatilho por HTTP
Uma URL pública por gatilho recebe o telefone e as variáveis e coloca a ligação na fila, com idempotência e assinatura.
Dados capturados por webhook
Ao fim da ligação, o evento voice_agent.call.ended traz status, motivo e os dados que o agente coletou.
Transcrição pela API
GET /api/v1/voice-agent-calls/{callId}/turns devolve a conversa paginada, turno a turno.
Um agente de voz com IA para telefone faz a ligação que hoje depende de alguém do time do seu cliente: retorna o lead que preencheu o formulário, confirma a consulta, lembra a parcela em atraso, pergunta por que o aluno sumiu. A diferença para a URA de menu é que a pessoa responde falando, e o agente entende, tira dúvidas com a base de conhecimento da empresa e decide o próximo passo. Na D-API, esse agente de voz com IA para telefone liga pela linha telefônica para celular e fixo, e o seu SaaS controla tudo por HTTP: dispara a ligação, recebe o resultado por webhook e busca a transcrição pela API.
Para quem constrói software, o ponto central é que o pipeline de voz (reconhecimento de fala, modelo de linguagem, síntese de voz, controle de turno) já está pronto. O seu time escreve a regra de negócio e a integração, e não a infraestrutura de áudio em tempo real.
O que o agente faz numa ligação
O agente é montado no painel a partir de um modelo, como Recepcionista ou SDR, ou em branco. Você descreve a empresa e o objetivo, escreve as regras, escolhe uma voz em português, inglês ou espanhol (ou clona uma) e faz uma ligação de teste para o próprio celular. Durante a conversa, ele pode:
- abrir a ligação chamando a pessoa pelo nome, a partir das variáveis enviadas no disparo;
- responder com a base de conhecimento e as regras que você definiu;
- capturar dados estruturados, como interesse, data combinada ou motivo da recusa;
- mandar link, boleto ou resumo por WhatsApp, usando uma conexão da sua conta que você escolhe;
- consultar ou registrar informações no seu sistema por webhook ou por servidores MCP;
- reconhecer caixa postal e desligar sem deixar recado.
No painel também ficam os ajustes de turno, como quanto o agente espera depois que a pessoa para de falar e quão fácil é interrompê-lo, o que faz diferença em ligação telefônica com ruído de fundo.
Telefone ou WhatsApp: o mesmo agente nos dois
O mesmo agente liga pelo WhatsApp ou pela linha telefônica, e o canal é escolhido em cada disparo, campanha ou gatilho. A comparação prática para o seu produto:
| Linha telefônica | ||
|---|---|---|
| Para quem liga | Qualquer celular ou fixo | Quem tem WhatsApp |
| O que precisa | Só a conta e saldo | Conexão de WhatsApp |
| Ligações em paralelo | Várias, numa fila de linhas | Uma por conexão |
| Atende ligações recebidas | Não, só liga | Sim |
| Número exibido | Um número da linha telefônica | O número conectado |
Para listas com fixos, campanhas de cobrança e base que não usa WhatsApp, a linha telefônica costuma ser o caminho. Para atender quem liga para a empresa, o canal é o agente de voz com IA no WhatsApp.
Disparando a ligação a partir do seu SaaS
A integração mais direta é o gatilho. No painel, você cria um gatilho para o agente com o canal ura e recebe uma URL pública; o token na URL é a credencial, sem API key. O seu sistema chama essa URL quando o evento de negócio acontece:
curl -X POST https://api.d-api.cloud/api/v1/hooks/va/SEU_TOKEN_DO_GATILHO \
-H "Content-Type: application/json" \
-H "Idempotency-Key: lead-90412" \
-d '{
"phone": "5511999999999",
"variables": { "nome": "Juliana", "produto": "Plano Clínica Pro" }
}'
A resposta é HTTP 202 com callId, status: "queued" e a posição na fila. Fora da janela de horário configurada no gatilho, a ligação é agendada para a próxima abertura, e a resposta volta com status: "scheduled" e scheduledFor. Detalhes que ajudam a integrar com segurança:
- Variáveis declaradas. Só as variáveis que o agente declarou são aceitas, até 30 por ligação e com valores de até 500 caracteres. Faltando uma obrigatória, a resposta é 400
missing_variables. - Idempotência. Com
Idempotency-Key, repetições em 24 horas recebem a mesma resposta. Sem ela, o mesmo telefone com as mesmas variáveis em 60 segundos também não gera ligação duplicada. - Assinatura opcional. Quando o gatilho exige, envie
X-DAPI-Signature: t=<unix>,v1=<hex>, com o HMAC-SHA256 do segredo sobret + "." + corpoe tolerância de 300 segundos. - Limites por gatilho. Você define ligações por minuto (até 600), por dia, por telefone em 24 horas, gasto máximo diário, janela de horário, dias da semana e países permitidos. Estourou, a resposta é 429
rate_limitedcomRetry-After, ou 402daily_cap_reached.
Para listas inteiras, o painel tem campanhas do agente, com o mesmo canal e as mesmas variáveis.
O resultado volta para o seu sistema
As ligações do agente geram dois eventos no webhook de conta do canal voice, o mesmo das ligações de URA: voice_agent.call.started e voice_agent.call.ended. O data traz o id da ligação, agentId, channel (ura para a linha telefônica), phone, status, endReason, billedSeconds, variables e capturedData, que são os dados que o agente anotou na conversa. É no capturedData que a ligação vira registro no seu banco: o lead ganha “interesse alto”, a consulta ganha “confirmada”, a dívida ganha “promessa para dia 15”.
A gravação e a transcrição ficam na API. GET /api/v1/voice-agent-calls/{callId} devolve a ligação com a gravação e o que foi debitado; GET /api/v1/voice-agent-calls/{callId}/turns devolve a conversa paginada, com afterSeq e limit de até 100 turnos, cada um marcado como fala da pessoa, do agente ou chamada de ferramenta. O tratamento seguro do webhook, com assinatura e idempotência, segue o padrão descrito em webhook de URA.
Exemplos por segmento
- CRM e plataforma de vendas: o lead entra pelo formulário, o CRM chama o gatilho com nome e produto, e o agente liga em segundos para qualificar. Se o lead está pronto, agenda a reunião via MCP e confirma por WhatsApp.
- Software de cobrança: a régua chama o gatilho para quem não respondeu ao WhatsApp. O agente negocia dentro das regras que o seu cliente definiu, e
capturedDataregistra a data prometida. - Software de clínicas: na véspera, o agente liga para quem não confirmou, entende “posso só à tarde” e consulta horários livres na agenda pelo servidor MCP do seu sistema.
- Edtech: aluno sem acesso há 15 dias recebe uma ligação que pergunta o motivo, e o motivo vira dado para o time de sucesso do cliente.
Quando montar o seu próprio agente
Se o seu produto já tem um pipeline de voz próprio, a D-API também entrega a ligação crua. Com a ligação telefônica por API no modo ao vivo, o seu servidor recebe e envia áudio PCM de 16 kHz pelo WebSocket e conduz a conversa com o modelo que quiser; o protocolo completo está na documentação da D-API. Para a maioria dos SaaS, o agente pronto encurta semanas de trabalho, e o uso de MCP para agir nos seus sistemas está explicado no artigo sobre agentes de IA no WhatsApp com MCP.
Time D-API. Atualizado em .
Perguntas frequentes
Preciso programar o agente?
Não. O agente é criado no painel da D-API a partir de um modelo (Recepcionista, SDR ou em branco): você descreve a empresa, o objetivo, as regras e a voz, faz uma ligação de teste para o seu celular e publica. O seu SaaS só dispara as ligações e consome os eventos.
O agente atende ligações recebidas pelo telefone?
Pela linha telefônica ele só faz ligações. Para atender quem liga, o mesmo agente pode ser vinculado a um número de WhatsApp conectado e atender as chamadas que chegam nele.
Quanto custa o agente de voz na linha telefônica?
O agente é cobrado por minuto de conversa, à parte da conexão, somado ao minuto de telefonia, com preço que cai com o volume. Os valores estão com o time comercial. Ligação não atendida não é cobrada. Caixa postal conta como atendida pela operadora, então esses segundos são cobrados.
O agente consegue mandar WhatsApp durante a ligação telefônica?
Consegue, se você escolher uma conexão de WhatsApp da sua conta para isso. Sem essa escolha, a ferramenta de mensagem fica desligada nas ligações pela linha telefônica.
E se a lista tiver muita gente para ligar ao mesmo tempo?
Na linha telefônica as ligações entram numa fila de linhas e várias acontecem em paralelo, sem depender de conexão. Cada gatilho tem limites por minuto, por dia, por telefone e de gasto diário para manter o volume sob controle.