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 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
Página: fale e ouça
index.html
ura.js
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
accepted é descartado. Rajadas grandes ficam
enfileiradas e chegam atrasadas, então envie no ritmo real.
Eventos da URA
Chegam emcall.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.