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

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

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.

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.