WhatsApp (BETA)

WhatsApp para Empresas es una solución de mensajería diseñada para que las empresas se comuniquen con sus clientes de forma automatizada y en tiempo real.

A través de este servicio puedes:

• Enviar notificaciones y mensajes automatizados mediante conexión por API.

• Crear y gestionar campañas masivas de WhatsApp.

• Atender clientes mediante chat en línea en tiempo real desde una plataforma centralizada.

Esta guía describe cómo configurar, integrar y utilizar las funcionalidades de WhatsApp para Empresas dentro de tus sistemas

WhatsApp se usa en una plataforma diferente a la de EMAIL, SMS y SMTP, pero son compatibles entre si.

Requisitos Previos

Antes de comenzar con la configuración de WhatsApp para Empresas, asegúrate de contar con lo siguiente:

• 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, que será utilizado para conectar y validar la cuenta de WhatsApp.

Estos requisitos son indispensables para completar el proceso de conexión y habilitar el envío y recepción de mensajes

Configuración y conexión de WhatsApp para Empresas

Esta sección describe el proceso completo para configurar y conectar WhatsApp para Empresas en la plataforma, desde el inicio de la configuración hasta la habilitación final de la cuenta.

Paso 1. Iniciar configuración

Desde el panel de WhatsApp, haz clic en el botón Iniciar configuración para comenzar el proceso de integración.

Paso 2. Crear aplicación

Se mostrará una ventana para crear una aplicación interna que servirá como identificador de la integración. Ingresa un nombre de aplicación (uso interno). Formato recomendado: WhatsAppBusiness[NombreDeLaEmpresa] Ejemplo: WhatsAppBusinessOpptima Haz clic en Crear para continuar.

Paso 3. Conectar cuenta de Facebook

A continuación, se mostrará la pantalla Conecta tu cuenta de Facebook, donde se listan los requisitos necesarios:

• Cuenta de Facebook Business activa

• Permisos de administrador

• Acceso a Meta Business Suite

• Nombre comercial legal de la empresa

Haz clic en Conectar con Facebook para continuar.

Paso 4. Autenticación con Facebook

Se abrirá una nueva pestaña indicando que la conexión fue solicitada por [email protected] mediante Text Wave / Gupshup, partner verificado de Meta. Inicia sesión con la cuenta de Facebook que tenga configurado el Business Manager.

---

Paso 5. Continuar con Text Wave Technologies

Se mostrará el mensaje Conecta tu cuenta fácilmente con Text Wave Technologies Private Limited. Haz clic en Continuar y valida que el socio indicado sea Text Wave Technologies Private Limited. Al continuar, aceptas los términos de WhatsApp Business, API de la nube, mensajes de marketing y herramientas empresariales de Meta.

---

Paso 6. Seleccionar activos comerciales

Selecciona los activos comerciales que deseas compartir con Text Wave App. Aquí podrás:

• Usar o crear un portfolio comercial

• Crear o asignar una Cuenta de WhatsApp Business

---

Paso 7. Ingresar información comercial (solo si es totalmente nueva la cuenta)

En esta sección puedes decidir si crear una cuenta totalmente nueva o usar alguna cuenta de WhatsApp existente.

Completa la información de los nuevos activos:

• Nombre del activo (uso interno)

• Categoría comercial

• País

• Sitio web (opcional)

• Zona horaria

Verifica los datos y continúa.

---

Paso 8. Agregar número de teléfono

Selecciona Agregar un número nuevo e ingresa:

• País

• Número de teléfono

Elige el método de verificación. Para este ejemplo, selecciona Mensaje de texto (SMS).

---

Paso 9. Verificar número de teléfono

Ingresa el código de verificación de 6 dígitos enviado al número configurado. Si no recibes el código, puedes solicitar uno nuevo o cambiar el método de verificación.

---

Paso 10. Revisar permisos

Se mostrará un resumen de los accesos que Text Wave App tendrá sobre tu cuenta, incluyendo:

• Administración de cuentas de WhatsApp

• Acceso a conversaciones

• Registro de eventos enviados a Meta

Revisa la información y continúa.

---

Paso 11. Conectando la cuenta

El sistema iniciará el proceso de conexión. Este paso puede tardar unos instantes.

---

Paso 12. Cuenta conectada

Se confirmará que la cuenta está conectada a Text Wave Technologies Private Limited. La empresa deberá ser verificada y recibirás un correo cuando el proceso finalice. Haz clic en Finalizar.

---

Paso 13. Asociación del número a la API

En algunos casos, se abrirá una pestaña adicional de Meta para confirmar la conexión con Text Wave Technologies Private Limited.

En el paso 2, seleccionar actualizar y vuelve a la pantalla anterior.

Ahora, Selecciona el número, marca la opción I understand… y haz clic en Next.

Ten en cuenta que este número no podrá volver a usarse en WhatsApp personal ni en WhatsApp Business App.

---

Paso 14. Onboarding completado

Se mostrará una pantalla confirmando que el onboarding fue exitoso, indicando:

• Número de teléfono conectado

• WhatsApp Business ID (WABA ID)

---

Paso 15. Aprobación final

Regresa al panel principal y refresca la página. La cuenta quedará en estado Pendiente de confirmación. Este proceso puede tardar aproximadamente 1 hora o puede acelerarse contactando al equipo de soporte.

Una vez aprobada, la cuenta quedará habilitada y todas las funcionalidades de WhatsApp para Empresas estarán disponibles.

Si necesitas ayuda con el proceso de configuración o tienes algún problema, contacta a soporte para que te ayuden con este proceso.

Inicio

La sección Inicio del módulo WhatsApp funciona como un panel de estadísticas y estado de la cuenta, donde puedes validar rápidamente:

• Qué aplicación de WhatsApp Business está configurada.

• El WABA asociado (WhatsApp Business Account).

• El balance actual disponible en la cuenta.

• El consumo de mensajes (gratuitos y pagados) en un rango de tiempo.

Estadísticas

Al ingresar a WhatsApp > Inicio, verás el título Estadísticas y, en la parte superior derecha, un selector de rango de tiempo.

Rango de tiempo (filtro)

En el selector “Mostrando datos de los últimos” puedes elegir el periodo que se usará para calcular los contadores mostrados en la pantalla (por ejemplo: 7 días).

---

Información de la cuenta

En la parte superior se muestran los datos base de la cuenta y su configuración.

Nombre de la aplicación

Aquí se muestra el nombre de la aplicación configurada para el envío y recepción de mensajes.

• Ejemplo: ClickPandaSandbox

• Estado: Configurado en el provider

Número de WABA

Muestra el Número de WABA asociado a tu WhatsApp Business.

Balance actual

Indica el saldo disponible en la cuenta, el cual se utiliza para el consumo de mensajería (cuando aplica).

---

Consumo y métricas de mensajes

En esta sección se presentan los totales del periodo seleccionado (por ejemplo, “Últimos 7 días”).

Total de mensajes gratuitos enviados

Cantidad total de mensajes gratuitos enviados durante el periodo seleccionado.

Total de mensajes gratuitos recibidos

Cantidad total de mensajes gratuitos recibidos durante el periodo seleccionado.

Total de mensajes pagados

Cantidad total de mensajes pagados registrados durante el periodo seleccionado.

Total de mensajes enviados y recibidos

Suma total de la actividad de mensajería (enviados + recibidos) dentro del periodo seleccionado.

Historial de mensajes (pagos)

La sección Historial te permite consultar el registro de mensajes de WhatsApp pagados junto con un resumen de métricas, usando filtros por rango de fechas y filtros avanzados opcionales. Esta vista está enfocada únicamente en mensajería pagada (no incluye mensajes gratuitos).

---

Resumen por rango de fechas

En la parte superior verás un filtro de fechas (desde / hasta) y acciones para consultar la información:

• Selección de fecha inicial y fecha final.

• Botón Filtrar para aplicar el rango seleccionado.

• Botón Generar Reporte para exportar el resultado del periodo consultado.

Con base en el rango de fechas, se muestra un resumen de conteos:

• Enviados: total de mensajes pagados enviados en el periodo.

• Entregados: mensajes confirmados como entregados.

• Leídos: mensajes marcados como leídos.

• Fallidos: mensajes con error en el envío o entrega.

Adicionalmente, se muestra una gráfica de estadísticas por día para visualizar el comportamiento diario dentro del periodo consultado (enviados, entregados, leídos y fallidos).

---

Tabla de detalle (mensajes pagados)

Debajo del resumen se encuentra la tabla de mensajes, que lista el detalle de cada mensaje pagado dentro del rango de fechas seleccionado.

La tabla incluye campos como:

• Fecha: fecha y hora del registro.

• Destino: número de WhatsApp destinatario.

• ID de mensaje: identificador único del mensaje.

• Categoría: tipo/categoría del mensaje (por ejemplo: utility, authentication).

• Estado: estado del mensaje (por ejemplo: Delivered, Read, Failed).

• Costo: valor cobrado por ese mensaje.

• Mensaje de info: información adicional del proveedor (si aplica).

• ID de plantilla: plantilla utilizada (si aplica).

• ID de campaña: referencia de campaña (si aplica).

• Parámetros de plantilla: variables usadas al enviar la plantilla.

La tabla incluye controles de navegación:

• Paginación (navegar entre páginas).

• Items por página (cantidad de filas visibles por página).

---

Filtros avanzados

Además del rango de fechas, puedes aplicar filtros avanzados para refinar el resultado sin perder el control del periodo consultado.

Filtros disponibles:

• Status (Estado): filtra por estado del mensaje (entregado, leído, fallido, etc.).

• Categoría: filtra por el tipo de mensaje (por ejemplo: utility, authentication).

• Destino: filtra por número destinatario (ej. [phone]).

• ID de plantilla: filtra mensajes asociados a una plantilla específica.

• ID de campaña: filtra mensajes asociados a una campaña específica.

Acciones del modal:

• Buscar: aplica los filtros avanzados.

• Limpiar filtros: restablece los filtros avanzado

---

Qué puedes hacer en esta vista

• Validar el rendimiento de tus mensajes pagados (entregados/leídos/fallidos) en un periodo.

• Auditar costos por mensaje y cruzarlos con plantilla/campaña.

• Encontrar rápidamente envíos específicos usando destino, plantilla o campaña.

Chat en Línea

La sección Chats es el módulo de conversación en tiempo real con tus clientes, similar a un WhatsApp Web, pero integrado directamente en Opptima. Desde aquí puedes centralizar todas las conversaciones, dar seguimiento y mantener un historial completo de la comunicación con tus contactos.

---

En Chats puedes:

• Ver y gestionar conversaciones activas con clientes finales.

• Responder en una ventana de sesión de 24 horas, siempre que el usuario haya escrito primero (regla de WhatsApp Business).

• Mantener un historial centralizado de mensajes dentro del sistema, sin depender de herramientas externas.

---

Cómo está organizada la vista

La pantalla se divide en tres áreas principales:

1. Listado de conversaciones (panel izquierdo) Muestra todas las conversaciones disponibles, con datos como:

   • Nombre del contacto (si existe).

   • Último mensaje recibido/enviado (vista previa).

   • Fecha del último movimiento.

   • Indicador de mensajes pendientes o no leídos (si aplica).

1. Área de conversación (panel central/derecho) Al seleccionar un contacto, se abre el historial del chat y puedes ver:

   • Mensajes del cliente y del agente.

   • Separadores por fecha.

   • Evidencia del intercambio en la sesión activa.

2. Caja de respuesta (parte inferior) Permite responder al cliente dentro del chat:

   • Campo para escribir el mensaje.

   • Botón de envío.

   • Opción para adjuntar archivos (según configuración).

---

Características principales

• Chat en vivo: mensajes entrantes y salientes en tiempo real.

• Regla de 24 horas: solo se puede responder dentro de una sesión activa iniciada por el usuario.

• Soporte de adjuntos: el chat puede incluir contenido como imágenes y archivos (según lo permitido por WhatsApp/proveedor).

• Historial unificado: toda la conversación queda registrada para seguimiento, soporte y control interno.

• Búsqueda de conversaciones: puedes localizar chats rápidamente usando el buscador del listado.

---

Uso recomendado

• Usar esta sección para atención comercial y soporte, manteniendo la trazabilidad completa.

• Revisar conversaciones con indicador de actividad para responder oportunamente dentro de la ventana permitida.

• Centralizar aquí la comunicación para evitar pérdidas de contexto entre agentes o canales.

Crear Campaña

El módulo Crear campaña te permite enviar mensajes masivos por WhatsApp Business API usando plantillas aprobadas y una lista de contactos. El flujo es guiado paso a paso y está diseñado para que puedas validar el costo estimado, el contenido y la programación antes del envío.

---

Aviso importante antes de iniciar

Antes de crear una campaña, ten en cuenta lo siguiente:

• Puedes procesar listas grandes de envío, pero por políticas del proveedor existe un límite de velocidad: máximo 10 mensajes por minuto.

• Por esta razón, cada campaña entra en un proceso de cola (queue) y puede tomar tiempo en completarse según el tamaño de la lista.

• No todos los mensajes se entregan siempre. Si un envío falla, el motivo o estado será devuelto por Meta/WhatsApp y quedará reflejado en los reportes.

• El seguimiento de la campaña se realiza con reportes en tiempo real basados en las respuestas de Meta.

• Estos mensajes son pagos, por lo que debes contar con saldo disponible antes de enviar.

---

Requisitos para poder enviar una campaña

Para crear una campaña necesitas:

1. Lista de contactos creada

• Debes tener una lista previamente creada en el módulo Listas de contactos.

• El número debe estar en formato código de país + número, sin símbolos ni espacios. Ejemplo Colombia: 573134567676

1. Plantilla aprobada

• La campaña solo permite usar plantillas previamente creadas y aprobadas.

• No se pueden enviar mensajes libres (texto abierto) en campañas masivas.

1. Saldo disponible

• Debes tener saldo suficiente para cubrir el envío estimado (el cobro final depende de mensajes entregados).

---

Flujo guiado paso a paso (3 pasos)

La creación de campaña se divide en 3 pasos:

1. Configuración Básica

2. Contenido del Mensaje

3. Revisión y Envío

---

Paso 1: Configuración Básica

En este paso defines el identificador interno de la campaña y seleccionas el público objetivo.

1) Nombre de la campaña

• Es un nombre interno para identificar la campaña dentro del sistema.

• Ejemplo: “Promoción Fin de Año 2025”.

2) Lista de contactos

• Selecciona la lista a la que se enviará la campaña.

• En el selector se muestran las listas disponibles y la cantidad de contactos por lista.

3) Estimación de costo (al seleccionar la lista)

Una vez seleccionas la lista, el sistema calcula un costo estimado para validar que tu saldo sea suficiente.

Lo que significa esta sección:

• Costo estimado: es un cálculo aproximado (no es el cobro final).

• Se estima con base en:

  • Cantidad de contactos utilizables.

  • País del contacto (tarifa por país).

  • Tipo/categoría de plantilla (por ejemplo, marketing).

• El sistema no cobra todo de inmediato: el cobro final depende de los mensajes que efectivamente se entreguen.

• También se muestra tu saldo actual para validar capacidad de envío.

---

Paso 2: Contenido del Mensaje

Aquí seleccionas la plantilla que se enviará y confirmas el contenido antes de enviar.

1) Seleccionar plantilla de WhatsApp

• Solo se muestran plantillas aprobadas por WhatsApp/Meta.

• Al elegir una plantilla, verás el estado (por ejemplo: APPROVED) y datos como categoría e idioma.

2) Vista previa del mensaje

• En la pantalla se muestra un preview de cómo se verá el mensaje para el destinatario (simulación tipo WhatsApp).

Plantillas con variables (personalización)

Si tu plantilla incluye variables (por ejemplo: {{1}}, {{2}}, etc.):

• El sistema usa el orden de variables definido en la plantilla.

• Para que se personalice por contacto, esas variables deben venir cargadas en la lista de contactos.

• En Opptima se espera que estén en columnas/propiedades tipo:

  • whatsapp_1

  • whatsapp_2

  • whatsapp_3 …según la cantidad de variables.

Esto se configura al crear/cargar la lista en el módulo de contactos.

---

Paso 3: Revisión y Envío

En este último paso confirmas todo antes de ejecutar el envío.

Resumen de la campaña

Verás un resumen con:

• Nombre de la campaña

• Lista de contactos seleccionada y cantidad de contactos

• Plantilla seleccionada

• Costo estimado

¿Cuándo quieres enviar la campaña?

Tienes dos opciones:

1. Enviar ahora

• Envía la campaña inmediatamente y la pasa a procesamiento en cola (según límite de 10/min).

1. Programar

• Permite definir:

  • Fecha de envío

  • Hora de envío

  • Zona horaria (por ejemplo: America/Bogota)

Enviar / Programar campaña

Según la opción elegida, el botón final ejecutará:

• Enviar campaña (si es inmediata)

• Programar campaña (si es programada)

---

Confirmación de campaña

Al finalizar, verás una pantalla de confirmación indicando que la campaña fue creada y enviada/programada, junto con el ID de campaña, que te servirá para seguimiento y trazabilidad.

Acciones comunes en esta pantalla:

• Crear nueva campaña

• Ver detalles (para revisar el progreso/resultado)

Este es el proceso detallado de como crear una campaña en WhatsApp, si requieres apoyo durante el proceso, por favor contacta al equipo de soporte.

Mis campañas (WhatsApp Campaigns)

Este módulo te permite consultar y auditar todas las campañas de WhatsApp creadas en tu cuenta, con filtros por rango de fechas y búsqueda avanzada. Es la vista principal para encontrar una campaña específica y abrir su reporte.

1) Filtro por rango de fechas (principal)

En la parte superior encontrarás un filtro Desde / Hasta y el botón Filtrar.

• El rango de fechas limita los resultados mostrados en la tabla.

• Se recomienda usarlo como primer filtro para mejorar rendimiento y reducir el volumen de datos.

2) Filtro avanzado (opcional)

El botón Filtro avanzado abre una ventana con filtros adicionales que se aplican junto con el rango de fechas.

Filtros disponibles:

• Estado: estado general de la campaña (según el procesamiento y reportes del proveedor).

• Nombre de campaña: búsqueda por el nombre interno que se asigna al crearla.

• ID de plantilla: para ubicar campañas enviadas con una plantilla específica.

• ID de lista: para filtrar campañas asociadas a una lista de contactos.

• ID de campaña: búsqueda directa por identificador.

Acciones:

• Limpiar filtros: reinicia los campos del filtro avanzado.

• Buscar: aplica los filtros.

3) Tabla de campañas

La lista muestra las campañas encontradas con información clave para auditoría y trazabilidad:

• Campaign ID: identificador único de la campaña.

• Campaign Name: nombre interno asignado en la creación.

• List ID: identificador de la lista usada como audiencia.

• Template ID: identificador de la plantilla enviada.

• Status: estado general (proceso / completado / etc.).

• Created At: fecha y hora de creación.

• Scheduled: si fue programada, muestra el dato de programación (si no aplica puede mostrarse vacío/no válido).

• Timezone: zona horaria usada para el envío programado.

• Actions → Ver Reporte: abre el Reporte y Analítica de Campaña.

---

Reporte y Analítica de Campaña (Ver Reporte)

Este módulo es el “centro de control” de una campaña específica. Permite ver el rendimiento general, el detalle por mensaje y, adicionalmente, métricas de la plantilla (últimos 30 días) reportadas por Meta.

Tabs disponibles

Al ingresar verás 3 pestañas:

1. Resumen

2. Informe Detallado

3. Estadísticas de Plantilla

---

1) Resumen (rendimiento de la campaña)

Esta pestaña presenta un panorama rápido del resultado del envío.

Incluye:

• Contadores principales:

  • Enviados

  • Entregados

  • Leídos

  • Fallidos

• Métricas complementarias de la campaña:

  • Respuestas: cantidad de respuestas recibidas asociadas a la campaña (cuando aplica).

  • Costo total: total facturado por mensajes entregados (el valor puede variar vs el estimado).

  • Entrega promedio: tiempo promedio de entrega/resultado reportado.

  • Fecha de envío: fecha y hora real del envío.

Además, encontrarás un bloque de Rendimiento de la Campaña con indicadores porcentuales, por ejemplo:

• Tasa de entrega

• Tasa de lectura

• Tasa de respuesta

Objetivo: entender rápidamente si la campaña funcionó como se esperaba y si hubo caídas de entrega/lectura o fallos relevantes.

---

2) Informe Detallado (detalle por mensaje)

Esta pestaña muestra el registro “uno a uno” de cada mensaje procesado dentro de la campaña.

Características:

• Botón Filtrar mensajes para acotar resultados dentro del detalle.

• Tabla con campos típicos:

  • Fecha

  • Destino (número en formato internacional)

  • ID Mensaje

  • Estado (por ejemplo: delivered, read, failed)

  • Costo (en fallidos puede ser 0.0000, dependiendo del caso)

  • Mensaje de Error (texto devuelto por Meta cuando aplica)

  • Parámetros (variables enviadas si la plantilla usa placeholders)

Uso recomendado:

• Identificar exactamente qué contactos fallaron y por qué.

• Validar costos reales por mensaje entregado.

• Revisar errores devueltos por Meta para depuración (listas, números, restricciones, experimentos, etc.).

---

3) Estadísticas de Plantilla (últimos 30 días)

Esta pestaña no mide “solo” la campaña, sino el desempeño de la plantilla usada (máximo histórico disponible: 30 días). Los datos provienen directamente de Meta y sirven para evaluar la efectividad de esa plantilla de forma global.

Incluye:

• Período analizado (rango de los últimos 30 días disponibles).

• Contadores:

  • Enviados

  • Entregados

  • Leídos

  • Clicks Totales

  • Clicks Únicos

• Tasas:

  • Tasa de entrega

  • Tasa de lectura

  • Tasa de interacción

Notas importantes:

• Si en el período no hay volumen suficiente, algunas tasas pueden verse como 0% o N/A (dependiendo de la disponibilidad del dato).

• Este panel complementa el Resumen de campaña: el resumen te dice “cómo le fue a esta campaña”, y las estadísticas de plantilla te dicen “cómo viene rindiendo esta plantilla en general”.

1) Guía de Mensajería WhatsApp: Plantillas, Sesiones y Costos

Esta guía explica la lógica de mensajería de WhatsApp dentro de Opptima: qué tipos de mensajes existen, cuándo aplican, cómo se reflejan en el sistema y cómo se calculan los cobros para los mensajes pagados.

1.1 Tipos de mensajes en Opptima

Opptima maneja dos tipos principales de mensajes:

A) Mensajes de sesión (Session messages)

• Son mensajes de conversación en tiempo real (tipo chat).

• Se usan para atención y continuidad de una conversación ya iniciada por el contacto.

• Operan dentro de una ventana activa de conversación (según las reglas del canal).

• Se gestionan desde:

  • Módulo Chats (interfaz tipo WhatsApp Web).

  • API mediante endpoint de session message.

B) Mensajes de plantilla (Template messages)

• Son mensajes basados en una plantilla previamente creada y aprobada.

• Se usan para notificaciones estructuradas o para envíos masivos (campañas).

• Se gestionan desde:

  • Módulo Crear campaña (envíos masivos).

  • API mediante endpoint de template message.

1.2 Categorías de plantillas (tipos de plantilla)

Las plantillas aprobadas por WhatsApp Business API se clasifican en categorías. En Opptima, estas categorías aparecen en reportes, filtros y detalle del mensaje:

Authentication

• Uso: validación de identidad y seguridad.

• Ejemplos: códigos OTP, verificación de inicio de sesión, recuperación de cuenta.

• Enfoque: autenticación y confirmación segura.

Marketing

• Uso: comunicaciones promocionales o comerciales.

• Ejemplos: ofertas, campañas, descuentos, lanzamientos, reactivación.

• Enfoque: impacto comercial y conversión.

Utility

• Uso: comunicaciones transaccionales e informativas.

• Ejemplos: confirmaciones, recordatorios, estado de solicitud, alertas operativas.

• Enfoque: información útil asociada a una acción o estado del servicio.

1.3 Cómo se calculan y aplican los cobros (mensajes pagados)

En Opptima, los mensajes de plantilla son pagos. El saldo se debita como una transacción real en función del resultado reportado por el proveedor.

Cómo se calcula el costo El costo de un mensaje de plantilla depende de:

• País del destinatario (según prefijo del número).

• Categoría de la plantilla (Authentication / Marketing / Utility).

• Tarifas aplicadas por el proveedor (Meta) para esa combinación país + categoría.

Cuándo se debita el saldo

• El débito se consolida cuando el proveedor confirma el procesamiento/resultado y se determina la entrega, con base en sus reportes.

• Si un mensaje falla, el reporte refleja el estado y el motivo devuelto por Meta (lo cual explica por qué no se entregó y cómo impacta el costo).

Transparencia del cobro Opptima muestra estos datos en:

• Historial de mensajes pagados (costo por mensaje, estado, respuesta del proveedor).

• Reporte por campaña (costo total + detalle por destinatario/mensaje).

• Detalle de errores (mensaje de error devuelto por Meta).

---

2) Conceptos clave: Plantillas, Ventanas de sesión y Variables

Esta sección define los conceptos operativos que determinan si un mensaje se puede enviar, si requiere plantilla, cómo se personaliza y cómo se garantiza que el contenido llegue con el formato correcto.

2.1 Ventana de sesión (Session window)

La ventana de sesión es el período en el que se permite la conversación libre tipo chat, siempre que esté abierta según las reglas del canal.

Dentro de la ventana de sesión:

• Se pueden intercambiar mensajes como en un chat normal.

• Se pueden recibir y enviar archivos/imágenes (dependiendo del canal y del tipo de mensaje permitido).

• El flujo es “conversacional” (ideal para soporte o ventas en vivo).

Fuera de esa ventana:

• Para contactar o notificar de forma estructurada normalmente se requiere una plantilla aprobada.

2.2 Mensajes de sesión (Session messages)

Características principales:

• Conversación en tiempo real dentro de ventana activa.

• No funcionan como “campaña masiva” (su naturaleza es conversacional).

• No se cobran como mensaje de plantilla.

• Están sujetos a condiciones del plan en cuanto a límites de uso mensual.

Dónde se reflejan:

• Módulo Chats: historial conversacional con cada contacto.

• API: envíos conversacionales mediante endpoint de session message.

2.3 Mensajes de plantilla (Template messages)

Características principales:

• Requieren plantilla aprobada antes de enviar.

• Se pueden usar en campañas masivas y automatizaciones.

• Siempre generan costo y requieren saldo.

• Se usan para integraciones con sistemas externos (CRM, e-commerce, notificaciones transaccionales).

Dónde se reflejan:

• Módulo Crear campaña: envíos masivos con plantilla.

• Historial: auditoría de mensajes pagados.

• Reportes: métricas por campaña y por plantilla.

• API: envío por endpoint de template message.

2.4 Variables en plantillas (ordenamiento posicional)

Las plantillas pueden incluir variables posicionales:

Ejemplo:

• Hola {{1}} tu eres {{2}} felizmente quiero que sepas {{3}}

Reglas:

• {{1}} toma el valor asignado a la primera variable.

• {{2}} toma el valor asignado a la segunda variable.

• {{3}} toma el valor asignado a la tercera variable.

El concepto clave es el orden: las variables no se asignan por nombre, sino por posición.

2.5 Cómo se asignan variables en Opptima (whatsapp_1, whatsapp_2, whatsapp_3)

Para que una campaña (o envío por API con contactos cargados) personalice correctamente la plantilla, la lista debe incluir columnas asignadas a variables predeterminadas:

• whatsapp_1 → corresponde a {{1}}

• whatsapp_2 → corresponde a {{2}}

• whatsapp_3 → corresponde a {{3}}

Regla operativa:

• La columna que contiene el dato que debe aparecer en {{1}} debe mapearse como whatsapp_1.

• La columna que contiene el dato que debe aparecer en {{2}} debe mapearse como whatsapp_2.

• Y así sucesivamente.

Opptima se encarga de:

• Leer los valores del contacto.

• Asociarlos por orden a las variables.

• Enviar al proveedor el payload con variables ya estructuradas.

---

3) Cómo funciona WhatsApp en Opptima: Costos, Formatos y Plantillas

Esta sección consolida los requisitos técnicos que garantizan entregabilidad, consistencia de reportes y correcta ejecución de campañas y mensajes automáticos.

3.1 Formato de teléfonos en listas de contactos

El formato aceptado es internacional, sin símbolos:

• Formato requerido: código_de_país + número

• Ejemplo Colombia:

  • Correcto: 573134567676

  • Incorrecto: [phone]

  • Incorrecto: 313 456 7676

  • Incorrecto: 57-313-456-7676

Recomendaciones:

• Mantener el campo como texto (especialmente en CSV/Excel) para evitar transformaciones.

• Evitar espacios, paréntesis, signos “+” o guiones.

3.2 Requisitos previos para enviar campañas de plantillas

Antes de ejecutar una campaña de WhatsApp (mensajes pagados), se requiere:

• Lista de contactos creada (módulo de contactos).

• Formato correcto de números internacionales.

• Plantilla previamente creada y aprobada (no se pueden enviar plantillas no aprobadas).

• Saldo disponible (los mensajes de plantilla son pagos).

3.3 Estimación vs costo real

En el proceso de campaña, Opptima puede mostrar un costo estimado.

El costo estimado:

• Sirve para validar que el saldo sea suficiente antes de ejecutar.

• Se calcula con base en:

  • País de los contactos seleccionados.

  • Categoría/tipo de plantilla.

  • Tarifa aproximada por mensaje.

El costo real:

• Se consolida según la ejecución y el resultado reportado por Meta.

• Puede variar si:

  • Hay mensajes fallidos.

  • El proveedor devuelve respuestas específicas por contacto (por ejemplo, números no válidos, restricciones, etc.).

• Siempre queda reflejado en el reporte final (costo por mensaje y costo total).

3.4 Procesamiento, cola y velocidad de envío

Opptima puede procesar listas grandes, pero el envío se controla por políticas del proveedor:

• Límite de envío: máximo 10 mensajes por minuto.

• La campaña pasa por:

  • Tiempo de procesamiento.

  • Cola de envío (queue) hasta completar.

Esto significa:

• La ejecución no necesariamente es inmediata para listas grandes.

• El avance se monitorea con reportes de estado en tiempo real basados en Meta.

3.5 Estados y errores reportados por Meta

Durante el envío, cada mensaje puede quedar en estados como:

• delivered (entregado)

• read (leído)

• failed (fallido)

• otros estados operativos según la respuesta del proveedor

Cuando ocurre un fallo:

• El sistema registra el “mensaje de error” devuelto por Meta.

• Este error explica la razón del fallo y se refleja en:

  • Reporte detallado por mensaje.

  • Historial de mensajes pagados.

  • Reporte de campaña.

3.6 Uso por Web y por API (resumen operativo)

Opptima integra el mismo motor de mensajería en dos superficies:

Web

• Chats: manejo de sesiones y conversación real.

• Campañas: envíos masivos con plantilla.

• Reportes: métricas de campaña y auditoría de costos/estados.

API

• Permite enviar:

  • Mensajes de sesión (conversación).

  • Mensajes de plantilla (notificaciones/automatización).

• Es el método ideal para integrar un CRM o sistema externo para notificaciones transaccionales, donde se requiere:

  • Un endpoint estable.

  • Credenciales.

  • Plantillas aprobadas y trazabilidad completa.