> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/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

<Warning>
  Las llamadas salientes de WhatsApp son una capacidad en Beta sujeta a
  activación por espacio de trabajo, solo están disponibles en las regiones
  compatibles y requieren el permiso explícito del destinatario. Las campañas
  multicanal solicitan ese permiso automáticamente, muestran el lead como
  **Awaiting permission** y solo marcan una vez concedido. Un rechazo o su
  caducidad termina ese intento de entrega.
</Warning>

El mismo asistente que atiende llamadas telefónicas también puede atender llamadas de voz de WhatsApp. Las llamadas de campaña reciben la información del lead y las variables asignadas que hayas configurado en la campaña.

Configuración del producto (credenciales, webhook, interruptores, plantillas): **Settings → Channels → WhatsApp** — consulta [WhatsApp (Texto + Voz)](/es/channels/whatsapp).

El texto y la voz usan la misma conexión de WhatsApp. En una configuración manual, suscribe la URL de webhook mostrada a **messages** y **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.
4. Después de colgar, la llamada aparece en Historial con su análisis y uso.

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)

**Settings → Channels → 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 **Connect with Meta**.
2. Asigna un asistente.
3. Copia la URL mostrada para mensajes, llamadas y actualizaciones del 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.

API pública: `POST /api/v1/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. **Voice calling** 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).

## Configuración de Meta (paso a paso)

1. Crea o abre una app de Meta → agrega **WhatsApp**.
2. En WhatsApp → API Setup, anota:
   * **Phone number ID**
   * **Access token** (usa un token de System User de larga duración en producción)
3. WhatsApp → Configuration → Webhooks:
   * Callback URL: copia la URL específica del conector desde Configuración
   * Verify token: usa el valor mostrado para el conector
   * 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

## Realizar una llamada saliente

Inicia una llamada saliente desde el panel del remitente, mediante `POST /api/v1/calls/whatsapp-outbound` o con la herramienta MCP `start_whatsapp_outbound_call`. Las llamadas iniciadas por empresas solo están disponibles en regiones compatibles y después del permiso explícito del destinatario.

## Relacionado

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