Pular para o conteúdo
D-APITestar grátis

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 WhatsApp
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 sobre t + "." + corpo e 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_limited com Retry-After, ou 402 daily_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 capturedData registra 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.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.