Verificando estado...
omnibridge-voice-bridge
Microservicio stateless en Node.js (TypeScript) que actúa como Media Bridge en tiempo real entre WhatsApp Business Calling API (Meta WebRTC) y Gemini Live API (WebSocket).
Estado en vivo
Llamadas activas
-
Eventos enviados / descartados
-
Memoria RSS
-
¿Cómo está hecho?
- WebRTC (werift): Procesa el
sdpOfferde Meta, negocia ICE (STUN/TURN) y responde consdpAnswer(códec OPUS) a Meta Graph APIv22.0. - Pipeline de audio en
worker_threads: Aísla la transcodificaciónOPUS ↔ PCM16y el resampling (48kHz ↔ 16kHz/24kHz) conopusscriptfuera del event loop principal. - Gemini Live API (WebSocket): Streaming bidireccional de audio con
inputAudioTranscription,outputAudioTranscriptiony soporte de barge-in (vaciado inmediato del buffer al detectarinterrupted). - Eventos y resiliencia: Cola en memoria acotada (máx. 500 eventos) con
AbortController(timeout 3s) y 3 reintentos asíncronos, TTL de 15 min por llamada y graceful drain enSIGTERM.
Documentación de API
GET/health
Healthcheck del servicio y métricas básicas de capacidad.
{
"ok": true,
"activeCalls": 0,
"maxCalls": 5,
"eventsSent": 12,
"eventsDropped": 0,
"rssMb": 64
}
POST/calls/inbound
Inicia una sesión de puente de voz. Requiere header Authorization: Bearer <VOICE_BRIDGE_SECRET>.
{
"callSessionId": "sess_123",
"metaCallId": "wamid.call.abc",
"businessId": "biz_456",
"conversationId": "conv_789",
"phoneNumberId": "10987654321",
"accessToken": "EAAG...",
"sdpOffer": "v=0...",
"systemPrompt": "Eres un asistente de soporte..."
}
Eventos salientes hacia ${OMNIBRIDGE_URL}/api/calls/events
Enviados de forma asíncrona con Authorization: Bearer <VOICE_BRIDGE_SECRET> y X-Correlation-Id:
// Estado de llamada
{ "type": "STATUS", "callSessionId": "sess_123", "businessId": "biz_456", "status": "ACTIVE" | "ENDED" | "FAILED" }
// Transcripción en vivo
{ "type": "TRANSCRIPT", "callSessionId": "sess_123", "businessId": "biz_456", "speaker": "USER" | "AI", "text": "...", "isFinal": true }