Pular para o conteúdo principal
O WebRTC é o transporte recomendado para o áudio das ligações em tempo real. O áudio vai por UDP com Opus e correção de perda (FEC), então aguenta bem melhor rede ruim, Wi-Fi instável e 4G do que o áudio pelo WebSocket. Você usa pelo d-api-sdk, com uma opção:
Vale para ligações de WhatsApp (saída e recebidas) e para a URA ao vivo. Você precisa de uma conexão WhatsApp não oficial já conectada e de uma API Key do painel.

Como funciona

1

Seu backend inicia a chamada

Com a API Key, dapi.calls.stream() retorna callId e wsUrl. Só esses dois vão para o navegador, nunca a API Key.
2

O navegador abre a chamada

LiveCall.connect() pede o microfone, abre o WebSocket de controle e já toca o áudio por ele.
3

O áudio passa para o WebRTC

Em menos de um segundo o SDK negocia o WebRTC e move o áudio para ele. Eventos, mudo e desligar continuam no WebSocket.
4

Se a rede bloquear o WebRTC

O áudio volta sozinho para o WebSocket, sem derrubar a chamada, e o SDK tenta o WebRTC de novo em segundo plano.
Os eventos, os webhooks call.* e a gravação são os mesmos do WebSocket: só o caminho do áudio muda.

Instalação

No Node (bots, agentes de IA), o WebRTC usa um pacote opcional:
Sem o @roamhq/wrtc, transport: "webrtc" continua funcionando pelo WebSocket. No navegador nada mais é preciso: o WebRTC é nativo.

No navegador

O exemplo completo tem duas partes: uma rota no seu backend, que guarda a API Key, e a página.

Backend: inicie a chamada

server.js

Página: fale e ouça

call.js
O SDK pede o microfone, toca a voz do outro lado e só envia o seu áudio depois que a pessoa atende. Chame LiveCall.connect() dentro de um clique: os navegadores só liberam áudio a partir de uma ação do usuário. A página precisa estar em HTTPS (ou localhost).
Use um bundler (Vite, webpack, Next.js) para importar o d-api-sdk no navegador.

No Node (bots e agentes de IA)

No Node o SDK entrega o áudio cru para o seu código: PCM s16le, 16 kHz, mono, em frames de 20 ms (320 amostras).
bot.js
Áudio enviado antes do accepted é descartado: o outro lado ainda não está ouvindo, e esse áudio atrasaria a chamada inteira. Envie no ritmo real (20 ms de áudio a cada 20 ms); rajadas grandes ficam enfileiradas e chegam atrasadas.

Receber ligações

Com o recebimento ativo na conexão:
No navegador, siga o mesmo padrão do exemplo acima: o seu backend chama dapi.calls.accept({ sessionId, callId, from }) e entrega { callId, wsUrl } à página, que chama LiveCall.connect().

URA ao vivo

A mesma interface: eventos (incluindo dtmf), áudio, hangup(). O exemplo completo, com navegador, está em URA ao vivo com WebRTC.

Eventos

Opções

Quando o WebRTC cai

O evento transport diz por onde o áudio está indo e por quê: Durante a troca o áudio para por poucos segundos e a chamada continua. Redes corporativas que bloqueiam UDP ficam no WebSocket.

Migrando do WebSocket manual

Se você seguiu as Ligações por Stream, o Passo 1 (o backend chamando POST /calls/stream) não muda. Os Passos 2 a 5 viram uma linha:
Os eventos que o seu código já trata chegam iguais em call.on("event").

Outras linguagens

O SDK fala um protocolo aberto no mesmo WebSocket da wsUrl. Para implementar em outra linguagem, com qualquer biblioteca WebRTC: Se algo falhar, chega {"type":"webrtc.error","code":"..."} com unavailable, invalid_offer, at_capacity, gateway_error ou not_negotiated, e o áudio segue no WebSocket. Quem nunca envia essas mensagens continua exatamente como antes.

Próximos passos

Ligações por Stream

O protocolo do WebSocket, os eventos e a gravação.

Receber Ligações

Ative o recebimento e atenda pelo SDK.