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.
call.* e a gravação são os mesmos do WebSocket: só o
caminho do áudio muda.
Instalaçã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
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).
No Node (bots e agentes de IA)
No Node o SDK entrega o áudio cru para o seu código: PCMs16le, 16 kHz, mono,
em frames de 20 ms (320 amostras).
bot.js
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:dapi.calls.accept({ sessionId, callId, from }) e entrega { callId, wsUrl } à
página, que chama LiveCall.connect().
URA ao vivo
dtmf), áudio, hangup(). O exemplo
completo, com navegador, está em URA ao vivo com WebRTC.
Eventos
Opções
Quando o WebRTC cai
O eventotransport 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 chamandoPOST /calls/stream) não muda. Os Passos 2 a 5 viram uma
linha:
call.on("event").
Outras linguagens
O SDK fala um protocolo aberto no mesmo WebSocket dawsUrl. 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.
