> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Voz

> Cómo funcionan las llamadas de voz de WhatsApp en la plataforma: configuración y UX del producto

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)](/channels/whatsapp).

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](https://developers.facebook.com/).
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

* [WhatsApp (Texto + Voz)](/channels/whatsapp)
* [Canales de mensajería](/channels/messaging)
* [Números de teléfono](/telephony/phone-numbers)