> ## 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 (Texto y Voz)

> Conecta la API de WhatsApp Business Cloud para chat y llamadas de voz de la plataforma

WhatsApp es un canal del espacio de trabajo en **Configuración → Canales → WhatsApp**.

| Modo            | Stack                                                | Indicador de plan        |
| --------------- | ---------------------------------------------------- | ------------------------ |
| Chat de texto   | Meta Cloud API                                       | `plans.whatsapp_channel` |
| Llamadas de voz | Conector de voz WhatsApp de la plataforma            | `plans.whatsapp_voice`   |
| Plantillas      | Meta Message Templates API + sincronización por cron | misma WABA que el texto  |

**Onboarding recomendado (solo en el dominio de la plataforma, p. ej. app.famulor.io):** [Registro integrado de WhatsApp](/channels/whatsapp-embedded-signup) (Conectar con Meta). En dominios personalizados de whitelabel, los espacios de trabajo usan únicamente el **pegado manual de credenciales**.

**Los números de Marketplace** (Configuración → Números) son **PSTN/SIP** para voz telefónica. Ese mismo E.164 se convierte en número de WhatsApp solo después de que Meta lo verifique (OTP). La configuración de tu troncal SIP es independiente de la API de WhatsApp Cloud. Los helpers de SMS de la plataforma son solo SMS/MMS, no se usan para WhatsApp.

## Requisitos previos

**Usuarios del espacio de trabajo**

* El plan incluye WhatsApp de texto y/o WhatsApp de voz
* Los webhooks usan tu **URL base de la app** (host de la plataforma o dominio personalizado verificado). Después de conectar, Configuración muestra la URL exacta del webhook para pegarla en Meta si hace falta, sin necesidad de acceso al entorno del servidor

**Operadores de la plataforma** (Registro integrado / app de Meta): consulta [Registro integrado de WhatsApp](/channels/whatsapp-embedded-signup).

## Interfaz del producto

1. **Conectar con Meta** (Registro integrado) — elige el asistente, número de Marketplace opcional, helper de OTP para SMS de Marketplace
2. O pega las credenciales manualmente (token, secreto de la app, token de verificación, ID de número de teléfono, ID de WABA)
3. Interruptores: texto / voz entrante / voz saliente
4. **Editar** una conexión → Detalles del remitente de WhatsApp (nombre visible, respuestas automáticas con IA, mantener como no leído, perfil de negocio, **Sincronizar perfil con WhatsApp**, estado de las llamadas)
5. Plantillas: borrador → **Enviar a Meta** → estado vía webhook + cron → enviar prueba
6. Probar llamada de WhatsApp (`POST /api/calls/whatsapp-outbound`)

Webhook (tras conectar): `https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId}`
Suscríbete a: **messages**, **calls**, **message\_template\_status\_update** (API v23/v24). Para voz, activa también las llamadas en el número de teléfono (Editar → Activar llamadas en Meta).

## Historial

* Conversaciones de texto: canal **WhatsApp** (tablas `messaging_*`)
* Voz: canal **WhatsApp voice** (`calls.metadata.channel = whatsapp_voice`)

## Facturación

* Texto: los créditos de mensajería de recepción/envío ya existentes
* Voz: la reserva/liquidación de créditos por minuto de voz ya existente (igual que en las llamadas de teléfono/SIP)
* Precios de conversación de Meta: método de pago del cliente en WhatsApp Manager (Tech Provider)

## API pública

* Registro integrado: `GET/POST /api/whatsapp/embedded-signup`, rutas de sesión OTP
* Conectores de mensajería: `GET/POST /api/v1/messaging-connectors` con `platform=whatsapp`
* Plantillas: `GET/POST /api/v1/whatsapp/templates`
* Voz saliente: `POST /api/v1/calls/whatsapp-outbound`
* MCP: herramientas de plantillas de WhatsApp + `complete_whatsapp_embedded_signup` + `start_whatsapp_outbound_call`

Consulta también [Configuración del Registro integrado](/channels/whatsapp-embedded-signup), [Canales de mensajería](/channels/messaging), [WhatsApp Voice](/telephony/whatsapp-voice).