Skip to main content
Las llamadas de voz de WhatsApp usan el conector de voz de WhatsApp de la plataforma. El mismo agente de voz que atiende las llamadas telefónicas también atiende las llamadas de WhatsApp. Configuración del producto (credenciales, webhook, interruptores, plantillas): Configuración → Canales → WhatsApp — consulta WhatsApp (Texto + Voz). El chat de texto usa la ruta de la API de Cloud en el mismo conector (campo de webhook messages). La voz usa la misma URL de webhook con el campo calls.

​
Lo que ve el usuario final

  1. El cliente toca llamar en tu número de WhatsApp Business (o responde una llamada saliente).
  2. Interfaz de llamada normal de WhatsApp (sonando → conectada).
  3. Tu asistente habla como en una llamada telefónica normal (STT/LLM/TTS dentro de la sesión de llamada).
  4. Después de colgar: el mismo flujo de Historial / análisis / créditos que las demás llamadas de voz.
No existe un marcador de WhatsApp personalizado dentro de la app para el cliente: se queda en WhatsApp.

​
Qué verán los administradores del espacio de trabajo (producto)

Configuración → Canales → WhatsApp:
  1. Conecta las credenciales de Meta (ID de número de teléfono + token permanente de System User + secreto de la app + verify token + ID de WABA), o usa Conectar con Meta.
  2. Asigna un asistente.
  3. Copia la URL del webhook para Meta (messages + calls + estado de plantillas).
  4. Activa los interruptores de voz entrante/saliente (saliente depende de la región + permiso del usuario en Meta).
  5. Opcional: haz una llamada de prueba de WhatsApp desde el mismo panel.
Ruta del webhook: https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId}. API de salida: POST /api/calls/whatsapp-outbound.

​
Apps/cuentas que necesitas

  1. Cuenta de Meta Developer.
  2. Cuenta de WhatsApp Business (WABA) con un número de teléfono empresarial.
  3. Llamadas de voz habilitadas en ese número (Cloud API v23/v24).
  4. App de Meta con el producto WhatsApp + token de acceso permanente de System User (o Embedded Signup).
  5. Infraestructura de voz de la plataforma con llamadas de WhatsApp habilitadas (configurada por el operador).

​
Configuración de Meta (paso a paso)

  1. Crea o abre una app de Meta → agrega WhatsApp.
  2. En WhatsApp → API Setup, anota:
    • ID de número de teléfono
    • Token de acceso (usa un token de System User de larga duración en producción)
  3. WhatsApp → Configuration → Webhooks:
    • Callback URL: https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId} (o el webhook de WhatsApp de la plataforma)
    • Verify token: el verify token del conector (o el verify token de la plataforma para el callback a nivel de app)
    • Suscríbete al menos a calls (y a messages para texto)
    • Usa la versión de API v23.0 o v24.0 de forma consistente
  4. Activa los permisos de llamadas:
    • Entrante: configura los horarios disponibles para llamadas (llamadas iniciadas por el usuario)
    • Saliente: solo en regiones compatibles + permiso explícito del usuario

​
Flujo de llamada (producto)

​
Entrante

  1. El usuario llama a tu número de WhatsApp Business.
  2. Meta envía (POST) un webhook de conexión de llamada con la oferta SDP + el ID de llamada.
  3. La plataforma acepta la llamada, despliega el agente de voz y conecta el audio a la sesión de llamada.
  4. El asistente funciona como en una llamada telefónica normal.

​
Saliente

  1. El espacio de trabajo (UI/API/MCP) inicia una llamada saliente de WhatsApp al número del usuario.
  2. Meta llama al usuario y envía un webhook de conexión de llamada con la respuesta SDP.
  3. La plataforma conecta el audio de inmediato (un retraso puede causar silencio o que se corte la llamada).
  4. Al colgar: Meta envía call terminate → la plataforma desconecta la sesión.

​
Relacionado