Integraciones de WhatsApp

Emelit Express te permite conectar WhatsApp con dos proveedores: Meta Cloud API y Twilio. Ambos son canales oficiales autorizados por Meta (la empresa dueña de WhatsApp) para enviar mensajes de WhatsApp Business a tus clientes. A partir de la migración del 9 de julio de 2026, ya no estás limitado a un solo proveedor: puedes elegir el que mejor se adapte a tu negocio, o incluso combinarlos.

Esta guía te explica en qué se diferencia cada proveedor, cuándo conviene usar uno u otro, y cómo configurarlos paso a paso para enviar confirmaciones de reserva, recordatorios, cancelaciones y notificaciones de pedido listo de forma automática.

---

Antes de empezar

Configurar WhatsApp requiere varios pasos previos y algo de paciencia. No es complicado, pero debes seguir el orden correcto. Prepara lo siguiente:

1. Decide qué proveedor usarás. Tienes dos opciones:

   • Meta Cloud API: es la conexión directa con Meta, sin intermediarios. Suele ser más económico por mensaje y te da control total. Es ideal si tu negocio ya tiene una cuenta de Facebook Business verificada y quieres ahorrar costos intermediarios.
   • Twilio: es un BSP (Business Solution Provider) oficial de WhatsApp. Se encarga de la infraestructura y te da un panel cómodo. Es ideal si no quieres lidiar con configuraciones técnicas de Meta y prefieres una experiencia más guiada.

2. Un número de teléfono para WhatsApp Business. No uses tu número personal. Cada proveedor te ayuda a registrar un número exclusivo para tu negocio, que será el que vean tus clientes como remitente.

3. Una cuenta de Facebook Business (Meta) verificada. Es obligatoria para ambos proveedores, porque Meta exige validar tu negocio independientemente del canal que uses.

4. Información de facturación.

   • Meta Cloud API: cobro por conversación iniciada (aprox. $0.02–$0.15 USD por conversación, según el país y la categoría).
   • Twilio: aprox. $5 USD/mes por número más aprox. $0.06 USD por mensaje proactivo. Twilio ofrece ~$15 USD de crédito inicial.

5. Tiempo estimado de configuración: entre 30 minutos y 2 horas. La verificación de Meta puede tardar de 5 minutos a 24 horas, sin importar el proveedor que elijas.

6. Acceso al panel de administración de Emelit Express con sesión iniciada.

7. Un correo electrónico activo para recibir verificaciones de Meta y/o Twilio.

La principal diferencia práctica: con Meta Cloud API pagas directamente a Meta y gestionas las plantillas en su panel; con Twilio pagas a Twilio (que luego paga a Meta) y gestionas todo desde el panel de Twilio. Emelit Express te permite cambiar de proveedor en cualquier momento sin perder tus plantillas ni el historial de mensajes.

---

Paso a paso detallado

Parte 1: Elegir y configurar tu proveedor

Opción A: Configurar Meta Cloud API

1. Ve a developers.facebook.com e inicia sesión con tu cuenta de Facebook Business.
2. Crea una nueva App de tipo “Business” y agrégale el producto WhatsApp.
3. Meta te asignará un Phone Number ID y un WhatsApp Business Account ID. Anota ambos.
4. Genera un Token de acceso permanente (System User Token) desde la configuración de tu Business Manager. Trátalo como una contraseña bancaria.
5. Verifica tu negocio en Meta Business Manager (sección “Ajustes de la empresa > Verificación de la empresa”). Sin verificación, no puedes enviar mensajes a clientes reales.
6. Registra tu número de teléfono para WhatsApp Business desde la sección “Número de teléfono” de tu app de Meta.

Opción B: Configurar Twilio

1. Abre twilio.com y haz clic en Sign up / Start for free.
2. Completa el formulario con tu nombre, correo y una contraseña segura. Verifica tu correo y tu teléfono personal con el código SMS que Twilio te envía.
3. En el panel de Twilio (Twilio Console), ve a Messaging > WhatsApp y haz clic en Get Started.
4. Conecta tu cuenta de Facebook con Continue with Facebook, selecciona la página de tu negocio y crea el perfil de WhatsApp Business.
5. Compra o conecta un número de WhatsApp Business (aprox. $5 USD/mes). Anota el número con el signo + y el código de país, por ejemplo: +5215512345678.

Paso 2: Obtener las credenciales

Independientemente del proveedor, Emelit Express necesita las credenciales correctas. Anota TODO en un lugar seguro:

Para Meta Cloud API necesitas 3 datos:

• WhatsApp Phone Number ID: identificador del número emisor (texto alfanumérico).
• WhatsApp Business Account ID: identificador de la cuenta de WhatsApp Business.
• Token de acceso (Access Token): el System User Token permanente generado en Meta Business Manager. Es confidencial.

Para Twilio necesitas 5 datos:

• Account SID: texto que empieza con AC. Lo encuentras en el Dashboard de Twilio.
• API Key SID: texto que empieza con SK. Se crea en Settings > API Keys > Create API Key.
• API Key Secret: secreto confidencial que solo se muestra UNA vez al crear la API Key. Cópialo de inmediato.
• Messaging Service SID: texto que empieza con MG. Se obtiene en Messaging > Services.
• WhatsApp From: tu número emisor en formato E.164 (+5215512345678).

Para Twilio también necesitarás configurar la Webhook Signature: en tu Messaging Service activa “Deactivate Webhook Validation” o, si la activas, pega la firma que Twilio genera para validar que las peticiones entrantes legítimas vienen de Twilio y no de un atacante. Emelit Express valida esta firma automáticamente cuando la configures en el campo Webhook Signature Validation Token.

Al final de este paso, debes tener anotadas TODAS las credenciales del proveedor que elegiste.

---

Parte 2: Conectar WhatsApp con Emelit Express

Paso 1: Acceder a la sección de Integraciones

1. En la barra lateral izquierda de Emelit Express, haz clic en Integraciones.
2. Verás una cuadrícula con las integraciones disponibles. La tarjeta de WhatsApp ahora muestra dos badges: “Meta Cloud API” y “Twilio”, indicando que ambos proveedores están soportados.
3. Haz clic en la tarjeta de WhatsApp.

Paso 2: Seleccionar el proveedor y llenar el formulario

Arriba del formulario verás un selector de proveedor con dos opciones: Meta Cloud API y Twilio. Selecciona el que configuraste en la Parte 1. El formulario se adapta dinámicamente y muestra solo los campos correspondientes al proveedor elegido.

Si elegiste Meta Cloud API, llena 3 campos:

1. WhatsApp Phone Number ID — pega el identificador del número emisor.
2. WhatsApp Business Account ID — pega el identificador de la cuenta.
3. Access Token — pega el System User Token. Se muestra con puntitos por seguridad.

Si elegiste Twilio, llena 5 campos:

1. Account SID — pega el texto que empieza con AC.
2. API Key SID — pega el texto que empieza con SK.
3. API Key Secret — pega el secreto confidencial.
4. Messaging Service SID — pega el texto que empieza con MG.
5. WhatsApp From — escribe el número emisor en formato E.164 sin espacios: +5215512345678.

Opcionalmente, en el campo Webhook Signature Validation Token pega el token de validación de Twilio (sección “Voice & Fax / Messaging > Settings” de tu Messaging Service). Esto activa la validación criptográfica de webhooks entrantes.

Paso 3: Probar la conexión

1. Antes de guardar, haz clic en el botón Probar conexión.
2. El sistema intenta comunicarse con el proveedor elegido usando tus credenciales. Espera 10 a 15 segundos.
3. Éxito: aparece una notificación verde “Conexión exitosa”. Continúa al paso 4.
4. Fallo: aparece una notificación roja. Revisa que no haya espacios al inicio o final de cada campo. Verifica que el API Key Secret/TOKEN sea correcto. Si dudas, genera credenciales nuevas en Meta/Twilio. Vuelve a probar.

Paso 4: Guardar la configuración

1. Una vez exitosa la prueba, haz clic en Guardar.
2. Aparece la notificación verde “WhatsApp configurado exitosamente”.
3. La tarjeta de WhatsApp en la cuadrícula de Integraciones ahora muestra el badge verde Conectado junto al nombre del proveedor activo.
4. ¡Listo! La integración está activa y el sistema ya puede enviar mensajes.

Paso 5 (opcional): Cambiar de proveedor

Si quieres migrar de Meta a Twilio o viceversa:

1. Ve a Integraciones > WhatsApp.
2. Cambia el selector de proveedor a la otra opción.
3. Emelit Express guarda tus credenciales previas, así que si vuelves a cambiar, no tendrás que reescribirlas.
4. Llena las credenciales del nuevo proveedor, prueba conexión y guarda.
5. El historial de mensajes y las plantillas se conservan porque cada plantilla lleva un campo provider que indica a qué proveedor pertenece.

Paso 6 (opcional): Desconectar la integración

1. Ve a Integraciones > WhatsApp.
2. Haz clic en el botón rojo Desconectar.
3. Confirma con Confirmar.
4. La integración se desactiva y los mensajes dejan de enviarse. Tus credenciales quedan guardadas, así que al hacer clic en Conectar se reactiva sin tener que volver a ingresar todos los datos.

---

Parte 3: Crear y gestionar plantillas de mensajes

WhatsApp exige que todo mensaje proactivo use una plantilla pre-aprobada. Cada plantilla en Emelit Express tiene un campo provider que indica a qué proveedor pertenece (Meta Cloud API o Twilio). Esto permite mantener plantillas separadas si usas ambos proveedores, porque el proceso de aprobación de Meta puede variar entre proveedores.

Paso 1: Acceder a las plantillas

Dentro de Integraciones > WhatsApp, debajo del formulario de credenciales, verás la sección Plantillas de mensajes. Incluye:

• Botón Crear plantilla.
• Botón Sembrar plantillas recomendadas.
• Una tabla con plantillas existentes mostrando: nombre, provider, categoría, idioma y estado.

Paso 2: Sembrar plantillas recomendadas

La forma más rápida de empezar:

1. Selecciona el provider para el que quieres sembrar plantillas (Meta o Twilio).
2. Haz clic en Sembrar plantillas recomendadas.
3. El sistema crea automáticamente plantillas útiles con variables listas: reserva_confirmada, recordatorio, pedido_listo, cancelacion_reserva.
4. Cada plantilla queda con el campo provider igual al que seleccionaste. Solo ese proveedor podrá usarlas hasta que también las apruebes en el otro.

Paso 3: Crear una plantilla manualmente

1. Haz clic en Crear plantilla.
2. Llena los campos:
   • Nombre interno sin espacios: confirmacion_reserva, pedido_listo, etc.
   • Provider: selecciona Meta Cloud API o Twilio. La plantilla solo se enviará a través de este proveedor.
   • Categoría: Marketing, Utilidad o Autenticación. Para la mayoría de notificaciones de reservas usa Utilidad.
   • Idioma: normalmente Español (es o es_MX).
   • Variables {{nombre_cliente}}, {{fecha}}, {{hora}}, {{mesa}}, {{nombre_restaurante}}, {{motivo}} que se reemplazan en el envío.
   • Cuerpo del mensaje: el texto completo con las variables. Manten por debajo de 250 palabras.
   • Content SID (opcional): solo si ya tienes plantillas multimedia en Twilio.
   • Activo: interruptor verde para habilitar la plantilla.
3. Haz clic en Guardar. La plantilla se envía al proveedor elegido para aprobación de Meta.

Paso 4: Activar o desactivar una plantilla

Cada plantilla de la lista tiene un interruptor deslizable. Verde = activa (se puede usar). Gris = inactiva (existe pero no se envía). Útil para plantillas de temporada que solo quieres activar en ciertos meses.

---

Parte 4: Notification settings para reservas

Emelit Express gestiona automáticamente qué plantilla se envía en cada momento del ciclo de una reserva. Esta configuración vive en la tabla whatsapp_notification_settings, que asocia un event_key (el evento) con el template_name (la plantilla a usar) y un flag is_enabled (encendido/apagado).

Los eventos disponibles para reservas son:

event_key	Cuándo se dispara	Plantilla recomendada
reserva_confirmada	Cuando apruebas una reserva pendiente en el panel de Reservas.	confirmacion_reserva
recordatorio	X horas antes de la hora de la reserva (configurable).	recordatorio_2horas
cancelacion	Cuando cancelas una reserva desde el panel.	cancelacion_reserva

Para editar la notificación de un evento:

1. Dentro de WhatsApp > Notificaciones de reservas, verás una tabla con los 3 eventos.
2. Cada fila tiene: nombre del evento, plantilla asignada (selector) y el interruptor is_enabled.
3. Selecciona la plantilla que quieres usar para cada evento (debe ser de la misma categoría Utilidad y estar activa).
4. Activa o desactiva el interruptor según quieras que ese evento dispare o no un WhatsApp.
5. Haz clic en Guardar notificaciones. Los cambios aplican a partir de la próxima reserva.

Si un evento tiene is_enabled = false, no se envía ningún WhatsApp aunque la plantilla exista y esté activa. Útil para desactivar los recordatorios durante vacaciones sin borrar la plantilla.

---

Parte 5: Historial de mensajes

En la parte inferior de la sección de WhatsApp verás una tabla con el Historial de mensajes. Cada fila muestra:

1. Fecha y hora exactas del envío.
2. Destinatario: nombre del cliente.
3. Plantilla usada y el provider que la envió (Meta Cloud API o Twilio).
4. Estado del envío: Entregado, Enviado, Error, Pendiente.

Usa el historial para verificar que los mensajes se están enviando correctamente, investigar errores y confirmar que un cliente específico recibió su mensaje. Si ves muchos estados “Error”, revisa la sección “Errores comunes” más abajo.

---

Ejemplo practico

Eres dueño de la “Fonda Doña Rosa” en Guadalajara, un restaurante de 15 mesas. Recientemente migraste de Meta-only a multi-provider y quieres decidir entre Meta Cloud API y Twilio para tus notificaciones de reservas.

Objetivo

Quieres:

1. Enviar confirmación automática cuando apruebas una reserva.
2. Enviar un recordatorio 2 horas antes para reducir los no-show.
3. Notificar cancelaciones con el motivo.

Configuración

Lunes, 10:00 AM — Probar Meta Cloud API

1. Sigues los pasos de Opción A: creas una App en developers.facebook.com, obtienes Phone Number ID, Business Account ID y un System User Token.
2. En Emelit Express: Integraciones > WhatsApp > selector: Meta Cloud API.
3. Pegas las 3 credenciales, pruebas conexión → éxito, guardas.
4. Siembras las 3 plantillas recomendadas (reserva_confirmada, recordatorio_2horas, cancelacion_reserva), todas con provider = meta.

Martes, 9:00 AM — También pruebas Twilio por comparar costos

1. Sigues los pasos de Opción B: creas cuenta en Twilio, compras el número +52 33 1234 5678, obtienes Account SID, API Key SID/Secret y Messaging Service SID.
2. En Emelit Express cambias el selector a Twilio, pegas las 5 credenciales, pruebas → éxito, guardas.
3. Siembras las mismas plantillas pero ahora con provider = twilio.
4. Configuras los notification settings:
   • reserva_confirmada → confirmacion_reserva (twilio), is_enabled = true.
   • recordatorio → recordatorio_2horas (twilio), is_enabled = true.
   • cancelacion → cancelacion_reserva (twilio), is_enabled = true.

Miércoles, 8:00 PM — Primera reserva real

1. María García reserva desde tu página web para el sábado a las 20:00, mesa M3, 2 personas.

2. La reserva aparece como Pendiente. La apruebas.

3. El sistema dispara el evento reserva_confirmada, busca la plantilla en whatsapp_notification_settings, identifica el provider (twilio) y envía el mensaje. María recibe:

   ¡Hola María García! Tu reserva en Fonda Doña Rosa ha sido CONFIRMADA.
   
   Fecha: 22 de julio
   Hora: 20:00
   Mesa: M3
   Duración estimada: 2 horas
   
   Si necesitas cancelar o modificar tu reserva, por favor avisanos con anticipación.
   
   ¡Te esperamos!

Sábado, 6:00 PM — Recordatorio automático

1. Faltan 2 horas. El sistema dispara el evento recordatorio, envía el mensaje y María confirma mentalmente su asistencia.

Sábado, 8:00 PM — María llega puntual

Resultados después de 1 mes

• No-show: bajaron de 8 al mes a solo 2.
• Ahorro de tiempo: ~5 horas/semana que antes pasabas llamando por teléfono.
• Comparación de costos: detectas que Meta Cloud API te sale ~30% más barato para tu volumen, así que cambias el selector a meta en las notification settings sin tocar Twilio.

---

Flujo de trabajo recomendado

Configuración inicial (una sola vez):

1. Día 1: Decide entre Meta Cloud API y Twilio (o ambos para comparar). Configura la cuenta elegida según la Parte 1.
2. Día 1: Obtén y anota las credenciales (3 para Meta, 5 para Twilio).
3. Día 1: En Emelit Express: Integraciones > WhatsApp > selector del proveedor > Conectar.
4. Día 1: Prueba conexión. Corrige errores si los hay.
5. Día 1: Siembra plantillas recomendadas con el provider correcto.
6. Día 1: Configura los notification settings (reserva_confirmada, recordatorio, cancelacion).
7. Día 1: Haz una reserva de prueba con tu propio número. Apruébala y verifica que el WhatsApp llegue.
8. Día 2: Todo funcionando. Empieza a operar normalmente.

Mantenimiento mensual:

1. Primer día de cada mes: Revisa el historial de mensajes. ¿Muchos errores? Investiga.
2. Primer día de cada mes: Verifica saldo. Si usas Meta, revisa el consumo en developers.facebook.com. Si usas Twilio, recarga si está bajo.
3. Cada 3 meses: Revisa plantillas. ¿Cambiaron horarios? ¿Cambió el nombre del negocio? Actualízalas.
4. Cada 6 meses: Rota credenciales por seguridad: genera nuevos tokens en Meta o nuevas API Keys en Twilio y actualízalas en Emelit Express.

---

Errores comunes y soluciones

Error	Causa probable	Solución paso a paso
”Error al probar conexión: credenciales inválidas”	Espacios extra en algún campo, credencial copiada mal, o secret/token expirado.	1. Revisa cada campo letra por letra. 2. Quita espacios en blanco al inicio o final. 3. Si dudas del secret/token, genera uno nuevo en Meta o una nueva API Key en Twilio. 4. Verifica que el Messaging Service SID empiece con “MG”. 5. Reintenta.
”Los mensajes no se envían” (conexión active pero nada llega)	La plantilla no está activa, el cliente no tiene WhatsApp, el número es inválido, is_enabled = false, sin saldo.	1. Revisa el Historial y el estado del mensaje. 2. Verifica que la plantilla tenga Activo = verde. 3. Verifica que la plantilla tenga el provider correcto. 4. Confirma que el event_key en notification settings tenga is_enabled = true. 5. Verifica el número del cliente (con +52 para México). 6. Revisa saldo en Meta/Twilio.
”La plantilla fue rechazada por Meta”	Texto viola políticas de WhatsApp: lenguaje promocional agresivo, MAYÚSCULAS excesivas, contenido no permitido.	1. Lee el motivo de rechazo. 2. Reescribe en tono informativo y profesional. 3. Quita “APROVECHA”, “NO TE LO PIERDAS”, signos de admiración excesivos. 4. Guarda y espera la nueva revisión (horas).
”Cambié de proveedor y ya no manda”	Cambiaste el selector pero las plantillas siguen con el provider anterior, o el nuevo proveedor aún no aprobó esas plantillas.	1. Verifica en la tabla de plantillas cuál es el provider de cada una. 2. Siembra plantillas para el nuevo provider o crea nuevas con el provider correcto. 3. Actualiza los notification settings para que apunten a las plantillas del provider activo.
”Webhook validation failed” (Twilio)	El Webhook Signature Validation Token no coincide con el secreto de tu Messaging Service de Twilio.	1. Abre Twilio > Messaging > Services > tu servicio > Settings. 2. Copia el valor correcto de “Deactivate Webhook Validation” o el token de validación. 3. Pégalo en Emelit Express en el campo Webhook Signature. 4. Guarda y prueba.
”La integración se desconectó sola”	Las credenciales expiraron o fueron revocadas en Meta/Twilio.	Ve a Integraciones > WhatsApp. Vuelve a ingresar credenciales (genera nuevas si hace falta). Prueba. Guarda.

---

Preguntas frecuentes

P: ¿Cuál proveedor me conviene más? R: Depende. Meta Cloud API suele ser más barato por mensaje y te da control directo, pero requiere cierta familiaridad con la consola de Meta. Twilio es más cómodo ay guiado, pero paga un intermediario. Si tu negocio manda muchas notificaciones y quieres ahorrar, ve por Meta. Si prefieres simplicidad o ya usas Twilio para SMS, ve por Twilio.

P: ¿Puedo usar ambos proveedores al mismo tiempo? R: Sí. Puedes tener configurados ambos y asignar cada evento a un proveedor distinto en los notification settings, usando el campo provider de cada plantilla. Por ejemplo: confirmaciones por Meta (más barato) y recordatorios por Twilio. Es una configuración avanzada y poco común, pero soportada.

P: ¿Qué pasa con mis plantillas si cambio de proveedor? R: Quedan guardadas con su provider original. Si migras de Meta a Twilio, debes crear (o sembrar) plantillas nuevas con provider = twilio, porque Meta y Twilio tienen procesos de aprobación independientes. El sistema te ofrece “Sembrar plantillas recomendadas” para cada provider, así que el trabajo extra es mínimo.

P: ¿Cuánto cuesta realmente? R: Meta Cloud API: cobro por conversación iniciada, aprox. $0.02–$0.15 USD/conversación según país y categoría. Twilio: ~$5 USD/mes por el número más ~$0.06 USD por mensaje proactivo. Para 100 mensajes/mes, Meta suele salir ~30% más barato. Twilio ofrece $15 USD de crédito inicial.

P: ¿Los clientes pueden responderme por WhatsApp? R: Sí. Las respuestas llegan al número de WhatsApp Business registrado con cada proveedor. Para gestión avanzada de respuestas (bandeja de entrada, CRM), integrating con un CRM omnicanal o usar Meta Inbox.

P: ¿Puedo enviar imágenes o PDFs? R: Las plantillas de texto solo envían texto. Para plantillas multimedia necesitas usar Content SID (en Twilio) o plantillas multimedia en la consola de Meta. Es una funcionalidad avanzada.

P: ¿Puedo desactivar solo un evento sin borrar todo? R: Sí. En la tabla de notification settings, pon is_enabled = false en el evento que quieras silenciar (por ejemplo, recordatorio durante vacaciones). La plantilla sigue existiendo y el resto de eventos siguen funcionando.

P: ¿Necesito conocimientos técnicos? R: No necesitas programar. Si sabes crear una cuenta en Facebook y copiar y pegar texto, puedes hacerlo. Si tienes problemas, pide ayuda a un familiar o empleado cómodo con la tecnología.

P: ¿Qué pasa si mi cuenta se queda sin saldo? R: Los mensajes dejan de enviarse. Las reservas y pedidos siguen funcionando en Emelit Express, solo sin WhatsApp. Te recomendamos recarga automática en Twilio o revisar tu consumo mensual en Meta.

---

Ahora que tienes WhatsApp configurado, aprende a gestionar las reservas de tus clientes en Gestión de Reservas.