> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opptima.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introducción
> WhatsApp Business en Opptima: conceptos de sesiones, plantillas, costos y variables.
WhatsApp para Empresas está en **BETA**. Funciona en una plataforma distinta a Email, SMS y SMTP, pero es compatible con ellas.
**WhatsApp para Empresas** te permite comunicarte con tus clientes de forma automatizada y en tiempo real. Con este servicio puedes:
* Enviar **notificaciones y mensajes automatizados** mediante la **API**.
* Crear y gestionar **campañas masivas** de WhatsApp.
* Atender clientes con **chat en línea en tiempo real** desde una plataforma centralizada.
Proceso de conexión paso a paso con Meta.
Envío masivo con plantillas aprobadas.
## Requisitos previos
Antes de configurar WhatsApp para Empresas, necesitas:
* Una **cuenta de Facebook Business** activa.
* **Permisos de administrador** en la cuenta y página de Facebook asociada.
* Acceso a **Meta Business Suite**.
* El **nombre comercial legal** de tu empresa.
* Un **número de teléfono activo** para conectar y validar la cuenta de WhatsApp.
## Tipos de mensajes
Opptima maneja dos tipos de mensajes, con reglas y costos distintos:
Conversación en tiempo real (tipo chat), dentro de una ventana activa iniciada por el contacto. **No se cobran** como plantilla; sujetos a los límites de tu plan. Se gestionan desde **Chats** o la API (*session message*).
Basados en una plantilla **aprobada**. Para notificaciones estructuradas y campañas masivas. **Siempre generan costo** y requieren saldo. Se gestionan desde **Crear campaña** o la API (*template message*).
### Ventana de sesión (24 horas)
La **ventana de sesión** es el período en que se permite la conversación libre tipo chat, **siempre que el usuario haya escrito primero** (regla de WhatsApp Business). Dentro de ella puedes intercambiar mensajes y archivos como en un chat normal. Fuera de ella, para contactar de forma estructurada normalmente se requiere una **plantilla aprobada**.
## Categorías de plantillas
Las plantillas aprobadas se clasifican en tres categorías (visibles en reportes y filtros):
| Categoría | Uso | Ejemplos |
| ------------------ | ----------------------------------- | ------------------------------------------------------------- |
| **Authentication** | Validación de identidad y seguridad | OTP, verificación de inicio de sesión, recuperación de cuenta |
| **Marketing** | Comunicaciones promocionales | Ofertas, campañas, descuentos, lanzamientos |
| **Utility** | Transaccional e informativo | Confirmaciones, recordatorios, estado de solicitud, alertas |
## Variables en plantillas
Las plantillas usan **variables posicionales** (`{{1}}`, `{{2}}`, `{{3}}`…). No se asignan por nombre, sino por **orden**:
```text theme={null}
Hola {{1}}, tu pedido {{2}} fue enviado el {{3}}
```
Para personalizar por contacto, tu lista debe incluir columnas mapeadas a variables predeterminadas:
* `whatsapp_1` → `{{1}}`
* `whatsapp_2` → `{{2}}`
* `whatsapp_3` → `{{3}}`
Opptima lee los valores del contacto, los asocia por orden y envía el payload con las variables ya estructuradas. Esto se configura al [crear o cargar la lista](/recursos/lista-de-contactos).
## Costos
Los **mensajes de plantilla son pagos**. El costo de cada mensaje depende de:
* El **país** del destinatario (según el prefijo del número).
* La **categoría** de la plantilla (Authentication / Marketing / Utility).
* Las **tarifas de Meta** para esa combinación país + categoría.
El saldo se debita cuando Meta confirma el procesamiento y resultado. Si un mensaje falla, el reporte refleja el estado y el motivo devuelto por Meta. Opptima muestra el costo por mensaje en el historial y en el reporte de cada campaña.
## Formato de números de teléfono
El formato aceptado es **internacional, sin símbolos**: `código_de_país + número`.
```text Correcto theme={null}
573134567676
```
```text Incorrecto theme={null}
+57 313 456 7676
313 456 7676
57-313-456-7676
```
En CSV/Excel, mantén el campo como **texto** para evitar que se transformen los números, y evita espacios, paréntesis, `+` o guiones.
## Web y API
El mismo motor de mensajería está disponible en dos superficies:
* **Web** — Chats (sesiones), Crear campaña (envíos masivos) y Reportes.
* **API** — mensajes de sesión y de plantilla, ideal para integrar un CRM o sistema externo. Ver la [referencia de WhatsApp en la API](/api/whatsapp/enviar-mensaje-con-plantilla-de-whatsapp).