ligações de whatsapp por api
Ligações WhatsApp API: fazer e receber chamadas de voz dentro do seu produto
Com as ligações WhatsApp API da D-API, o seu SaaS faz e recebe chamadas de voz no número que o seu cliente já usa, no navegador ou no backend, sem cobrança por ligação na API não-oficial.
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
Incluído na conexão
Fazer e receber ligações vem junto da conexão não-oficial. Você vende voz como recurso do seu plano sem pagar por minuto de chamada.
No navegador ou no servidor
Áudio por WebRTC, com Opus e correção de perda, ou por WebSocket em PCM de 16 kHz para o seu backend processar.
Agente de voz com IA
O mesmo canal de áudio alimenta um agente que atende e liga no WhatsApp, com transcrição, captura de dados e webhooks.
Trilha completa por webhook
Eventos call.* com o telefone da outra ponta, gravação em três faixas e histórico paginado pela API.
Ligações WhatsApp API são a parte da D-API que mais muda o que um SaaS consegue vender. O seu cliente já atende por mensagem no número da empresa; com a API de ligações, esse mesmo número passa a fazer e receber chamadas de voz dentro do seu produto, com o atendente falando pelo navegador ou um agente de IA conversando pelo servidor. O contato continua no aplicativo de WhatsApp que ele já tem no bolso.
Na D-API, isso vem incluído na conexão da API não-oficial, sem cobrança por ligação nem por minuto. Para quem monta plano de SaaS, a consequência é direta: voz deixa de ser um custo variável que come margem e vira um recurso que diferencia o seu produto no mesmo preço de conexão.
Esta página é a visão de produto. O passo a passo com cada endpoint está no guia API de ligações WhatsApp, e cada fluxo tem uma página própria, linkada ao longo do texto.
Por que voz no WhatsApp vale mais que telefone para o seu cliente
Quem recebe uma ligação de número desconhecido costuma recusar. Quando a chamada chega pelo WhatsApp, aparece com o nome e a foto da empresa com quem a pessoa já conversa por mensagem. A clínica que confirma a consulta, a imobiliária que retorna o lead e a loja que avisa sobre a entrega ligam do mesmo número que o cliente já salvou.
Para o seu SaaS, há um segundo ganho: a conversa por voz e a conversa por mensagem ficam no mesmo número e na mesma sessão. O histórico do contato no seu CRM ou helpdesk reúne o texto, os áudios e as ligações, e o atendente que estava no chat liga com um clique, sem abrir outro sistema nem discar de um ramal.
Se o caso pede telefone tradicional, para fixo ou celular sem WhatsApp, o caminho é o produto de telefonia, coberto na página de API de URA deste site. Aqui o assunto é a chamada de WhatsApp no número da sessão.
O que a API de ligações do WhatsApp entrega
A API cobre os dois sentidos da chamada e as três formas de lidar com o áudio.
| Fluxo | Endpoint principal | Quando usar |
|---|---|---|
| Ligação de saída com áudio ao vivo | POST /api/v1/calls/stream |
Atendente fala pelo navegador ou agente de IA fala pelo servidor |
| Ligação de saída com áudio pronto | POST /api/v1/calls/place |
Tocar uma mensagem gravada, sem ninguém ao vivo |
| Atender chamada recebida | POST /api/v1/calls/accept |
Alguém liga para o número do seu cliente |
| Recusar chamada recebida | POST /api/v1/calls/reject |
Fora do horário, fila cheia, regra do cliente |
| Link e convite de chamada | POST /api/v1/calls/create-link e /calls/send-event |
O contato escolhe a hora e entra pelo link |
| Histórico e gravação | GET /api/v1/calls e GET /api/v1/calls/{callId} |
Relatório, auditoria, qualidade |
A ligação de saída tem página própria em fazer ligações de WhatsApp pela API, e o recebimento, com o canal de eventos em tempo real, está em receber ligações de WhatsApp pela API.
Áudio no navegador com WebRTC
Para o atendente, o que importa é que a voz não picote. O transporte recomendado é o WebRTC: o áudio vai por UDP com Opus e correção de perda (FEC), o que aguenta Wi-Fi instável e 4G muito melhor do que um socket TCP. Se a rede da empresa bloquear UDP, o d-api-sdk volta sozinho para o WebSocket sem derrubar a chamada e tenta o WebRTC de novo em segundo plano. Os detalhes estão em ligação de WhatsApp no navegador com WebRTC.
Áudio no backend com WebSocket
Para quem processa a voz no servidor, a chamada vira um WebSocket com frames binários de PCM s16le, 16 kHz, mono, em blocos de 20 ms (320 amostras, 640 bytes), nos dois sentidos. Frames de texto trazem o ciclo de vida: calling, ringing, accepted, recording, ended. É o formato que um motor de transcrição ou um sintetizador de voz consome sem conversão exótica. A página sobre stream de áudio da ligação de WhatsApp entra no protocolo.
Um exemplo real em poucas linhas
O padrão seguro tem duas metades. O seu backend inicia a chamada com a API key e devolve ao navegador só o que ele precisa:
// backend
import { DApi } from "d-api-sdk";
const dapi = new DApi({ apiKey: process.env.DAPI_API_KEY });
app.post("/api/call", async (req, res) => {
const { callId, wsUrl } = await dapi.calls.stream({
sessionId: req.body.sessionId,
phone: req.body.phone, // DDI + DDD + número, só dígitos
});
res.json({ callId, wsUrl });
});
// navegador
import { LiveCall } from "d-api-sdk";
const { callId, wsUrl } = await fetch("/api/call", { method: "POST", /* ... */ }).then((r) => r.json());
const call = await LiveCall.connect(callId, wsUrl, { transport: "webrtc" });
call.on("event", (e) => console.log(e.type)); // calling, ringing, accepted...
call.on("ended", (e) => console.log("fim", e.reason));
O SDK pede o microfone, toca a voz do contato e só envia o áudio do atendente depois que a pessoa atende. A wsUrl carrega um token exclusivo daquela ligação, então a sua chave nunca sai do servidor.
Casos de uso por segmento de SaaS
O mesmo conjunto de endpoints serve produtos bem diferentes. O que muda é o gatilho da ligação e o que o seu sistema faz com o resultado.
Software de clínicas e agendamento. A recepcionista liga do painel da agenda para confirmar a consulta de amanhã, e o evento call.not_answered marca quem não atendeu para receber uma mensagem em seguida. Quem prefere marcar uma teleconsulta recebe um convite de chamada agendada pelo /calls/send-event, com título e horário, que abre no próprio WhatsApp.
CRM e plataformas de vendas. O vendedor clica em “ligar” no card do lead e fala pelo navegador. A chamada por stream é gravada por padrão, com faixas separadas do vendedor e do lead, o que alimenta revisão de pitch e treinamento. O lead que chegou pelo formulário às 23h pode ser atendido na hora por um agente de voz.
Helpdesk e central de atendimento. O cliente que liga para o WhatsApp da empresa aparece no painel do seu produto, com o contato identificado pelo campo phone, e o atendente atende ali mesmo. Esse cenário, com fila, atendente e canais simultâneos, tem página própria em central de atendimento com ligações de WhatsApp.
Cobrança. A régua que hoje manda mensagem pode ligar no dia do vencimento. Com /calls/place e um áudio gravado, o seu sistema toca o aviso sem ninguém na linha; com um agente de voz, a conversa negocia e envia o link de pagamento por mensagem durante a própria chamada.
Delivery e e-commerce. O entregador não acha o endereço e o lojista liga para o cliente pelo painel do pedido, do mesmo número da loja. Nenhum dos dois expõe o telefone pessoal.
Agentes de IA. Para quem vende automação, o áudio em PCM de 16 kHz entra direto no reconhecimento de fala e a resposta sintetizada volta pelo mesmo socket. A D-API também oferece agentes de voz prontos, criados num painel e acionados pela API. Veja agente de voz com IA no WhatsApp.
O que o seu cliente não vê, mas o seu produto precisa
Ligação em produção pede mais que áudio. Estes são os pontos que costumam virar ticket quando ficam de fora.
Estado consistente entre canais. O evento call.accepted avisa que a chamada recebida foi atendida fora da sua integração, no celular ou em outro aparelho. A confirmação de que o seu sistema atendeu é a resposta HTTP do /calls/accept. Tratar os dois como a mesma coisa faz o painel assumir chamadas atendidas no celular.
Queda de rede no meio da ligação. Por padrão, fechar o WebSocket desliga a chamada. Com &resume=1 na wsUrl, o servidor aguarda a reconexão por até 20 segundos e reenvia os eventos desde o início. O SDK já liga esse comportamento.
Concorrência. Cada conexão vem com 1 canal de voz incluso. Com todos os canais ocupados, uma nova ligação recebe o erro a call is already in progress, que o seu produto deve tratar como “ocupado”. Para mais de uma chamada ao mesmo tempo no mesmo número, a conexão aceita canais extras até 5 no total.
Trilha para auditoria. Todo evento de chamada chega por webhook no envelope comum { event, sessionId, data, timestamp }, e também pela fila RabbitMQ da sessão. O detalhamento dos eventos está em webhook de chamadas do WhatsApp.
Privacidade. Envie "record": false no /calls/stream para não gravar uma chamada específica. A conta também pode desligar a gravação de todas as ligações nas configurações de privacidade do painel, e aí nem "record": true reativa.
Ligações e API Oficial no mesmo produto
As chamadas por API exigem uma conexão não-oficial. Se parte da sua base exige a API Oficial da Meta, o caminho comum é manter os dois tipos no mesmo código: a rota de envio de mensagens é a mesma, o preço por conexão é o mesmo, e o cliente que quer voz usa uma conexão não-oficial. Na prática, o seu código decide o tipo de conexão no cadastro do cliente e trata o resto igual.
Como começar
Comece pela ligação de saída: uma conexão não-oficial de teste, o backend chamando /calls/stream e a página abrindo a chamada com LiveCall.connect. Com o áudio funcionando, ative o recebimento na conexão e conecte o canal de eventos. O passo a passo de cada parte está na documentação da D-API.
Depois, ligue os eventos call.* ao seu banco para ter taxa de atendimento, duração e gravação por cliente. A partir daí, a ligação vira uma linha no seu plano, e o seu cliente ganha um motivo a mais para não sair do seu produto.
Time D-API. Atualizado em .
ligações no whatsapp
Tudo sobre ligações no whatsapp na D-API
- Agente de voz com IA no WhatsApp para o seu SaaSAgente de voz com IA no WhatsApp que atende e liga pelo número do seu cliente, captura dados, envia mensagens e avisa o seu SaaS por webhook.
- Central de atendimento com ligações de WhatsAppMonte uma central de atendimento com ligações de WhatsApp no seu SaaS: atendentes atendem e ligam pelo navegador, com fila, gravação e métricas.
- Fazer ligações de WhatsApp pela API no seu SaaSFaça ligações de WhatsApp pela API: áudio gravado ou conversa ao vivo no navegador, com eventos de toque, atendimento e gravação para o seu SaaS.
- Ligação de WhatsApp no navegador com WebRTCLigação de WhatsApp no navegador com WebRTC: o atendente do seu SaaS fala pelo painel, com áudio Opus resistente a rede ruim e fallback automático.
- Link de ligação do WhatsApp por API para o seu SaaSGere link de ligação do WhatsApp por API, de áudio ou vídeo, e envie convites de chamada agendada com título e horário direto do seu SaaS.
- Receber ligações WhatsApp pela API no seu SaaSReceba ligações de WhatsApp pela API: o seu SaaS sabe na hora quem está ligando, atende no navegador ou recusa com mensagem automática.
- Stream de áudio da ligação de WhatsApp por WebSocketStream de áudio da ligação de WhatsApp em PCM 16 kHz por WebSocket: o seu backend ouve e fala na chamada em tempo real, pronto para IA e gravação.
- Webhook de chamadas do WhatsApp: eventos call.*Webhook de chamadas do WhatsApp com eventos call.* para o seu SaaS: oferta, toque, atendimento, não atendida, fim e gravação, com o telefone do contato.
Perguntas frequentes
Ligações funcionam numa conexão da API Oficial?
Não pela D-API. Os endpoints de chamada exigem uma conexão não-oficial (QR code ou código de pareamento). Numa conexão Cloud API, rotas como /calls/accept respondem 400. Muitos SaaS mantêm os dois tipos no mesmo código e usam a não-oficial para quem precisa de voz.
Quantas ligações simultâneas um número aguenta?
Cada conexão não-oficial vem com 1 canal de voz, ou seja, uma ligação por vez. Dá para contratar canais extras até o total de 5 por conexão, somando chamadas feitas e recebidas. Os valores estão na página de preços.
Preciso instalar algo no computador do atendente?
Não. O áudio roda no navegador, com o WebRTC nativo e o d-api-sdk empacotado no seu front-end. A página precisa estar em HTTPS e a ligação começa a partir de um clique do usuário, porque o navegador só libera áudio depois de uma ação dele.
A minha API key fica exposta no navegador?
Não deve. O seu backend inicia ou atende a chamada com a API key e entrega ao navegador só o callId e a wsUrl, que carrega um token exclusivo daquela chamada e deixa de valer quando ela termina.
Consigo usar ligações por API sem escrever o áudio na mão?
Sim. O d-api-sdk para Node e navegador inicia a chamada, abre o WebSocket, negocia o WebRTC, reconecta se a rede cair e entrega eventos como accepted e ended. Em outra linguagem, o protocolo do WebSocket é documentado e aberto.