Pular para o conteúdo principal
A URA ao vivo aceita o mesmo transporte WebRTC das ligações de WhatsApp. O áudio vai por UDP com Opus e correção de perda (FEC), e aguenta melhor Wi-Fi instável e 4G do que o áudio pelo WebSocket. Se a rede bloquear o WebRTC, o SDK volta sozinho para o WebSocket sem derrubar a ligação.
Você precisa de saldo na carteira e da API Key da conta. A cobrança, a gravação e os webhooks call.* são os mesmos da URA ao vivo: só o caminho do áudio muda. Não é preciso conexão de WhatsApp.

Instalação

No Node, o WebRTC usa um pacote opcional. Sem ele, a ligação segue pelo WebSocket:

No navegador

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

Backend: disque

dapi.voice.liveStart() chama POST /voice/live/start e devolve callId e wsUrl. Só esses dois vão para o navegador.
server.js
O telefone começa a tocar assim que a rota responde. Abra a ligação na página em até 30 segundos, ou ela é desligada e a reserva de saldo volta.

Página: fale e ouça

index.html
ura.js
O SDK pede o microfone, toca a voz de quem atendeu e só envia o seu áudio depois do accepted. A página precisa estar em HTTPS (ou localhost), e o d-api-sdk entra por um bundler (Vite, webpack, Next.js).

No Node (bots e agentes de IA)

dapi.voice.live() disca e já abre a ligação. O áudio chega 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. Rajadas grandes ficam enfileiradas e chegam atrasadas, então envie no ritmo real.

Eventos da URA

Chegam em call.on("event"), iguais ao WebSocket: A telefonia não emite calling nem ringing: até o accepted, o telefone está tocando. Uma ligação que termina sem accepted não foi atendida e não é cobrada, assim como o false-answer. Os reason estão em URA ao vivo. As opções (fallback, audio, webrtcConnectTimeoutMs, resume) e os motivos de volta para o WebSocket são os mesmos das ligações de WhatsApp: veja WebRTC nas ligações de WhatsApp.

Próximos passos

URA ao vivo (Stream)

Cobrança, limites, gravação e o protocolo do WebSocket.

Webhooks da URA

call.started, call.answered, call.dtmf, call.ended e call.audio.