Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

1.06 Integración y conexión de WhatsApp Cloud API (Meta)

Aprende a vincular tu número de WhatsApp Business a Lymera, habilitar números para tus campañas y usar plantillas aprobadas por Meta.

📘 Qué es

Lymera se conecta a la API oficial de WhatsApp Business de Meta para enviar y recibir mensajes de WhatsApp desde la plataforma. Tu cuenta de WhatsApp Business en Meta se llama WABA. Una vez conectada, eliges qué números quedan habilitados para tus campañas y usas plantillas aprobadas por Meta para iniciar conversaciones.

Hay dos formas de conectar: la conexión con Meta (recomendada, guiada) y la conexión avanzada (manual), que solo debes usar si tu Customer Success te lo indica.

⚠️ Importante: en algunos planes, la conexión de WhatsApp es parte de un complemento que administra tu Customer Success Manager. Si la tarjeta lo indica, pide los cambios a tu CSM.

📍 Dónde encontrarlo

  • Conexión y números: menú lateral › SETUP › Integraciones › categoría WhatsApp › tarjeta WhatsApp Cloud API · Meta.
  • Plantillas: Creative Hub, sección de plantillas de WhatsApp.
  • Número emisor de una campaña: configuración de la campaña, bloque Número emisor.

Pantalla: 1.06 Integración y conexión de WhatsApp Cloud API (Meta)
Pantalla: 1.06 Integración y conexión de WhatsApp Cloud API (Meta)

🛠️ Cómo se hace

Antes de comenzar

  • Tener un portafolio comercial (Business Manager) activo en Meta, con acceso de administrador.
  • Tener un número para WhatsApp Business que no esté en uso en la app de WhatsApp de ningún teléfono, salvo que uses coexistencia (ver más abajo).
  • Tener un método de pago (tarjeta) en la facturación de tu portafolio comercial de Meta.

Conectar con Meta (recomendado)

  1. Ve a SETUP › Integraciones y busca la tarjeta WhatsApp Cloud API · Meta.
  2. Haz clic en Conectar con Meta (o en + Agregar otra cuenta si ya tienes una).
  3. Se abre una ventana de Meta. Si no aparece, permite las ventanas emergentes para el sitio en tu navegador.
  4. Inicia sesión con tu usuario de Facebook, acepta las políticas y elige tu portafolio comercial.
  5. Elige una opción:

- Cuenta existente: selecciona tu cuenta de WhatsApp Business y el número. - Cuenta nueva: crea una cuenta de WhatsApp Business, completa dirección comercial, país y zona horaria, escribe el número y valida con el código que llega por SMS o llamada.

  1. Espera mientras la tarjeta dice «Esperando autorización…» y luego «Conectando WABA…».
✅ Resultado: verás «Cuenta de WhatsApp conectada correctamente vía Facebook».
⚠️ Importante: el nombre visible de tu cuenta de WhatsApp debe coincidir o parecerse al nombre de tu portafolio comercial en Meta. De lo contrario, Meta puede rechazar la solicitud.
⚠️ Importante: si el número o el nombre visible son nuevos, Meta puede tardar hasta 72 horas hábiles en aprobarlos. Mientras tanto no podrás enviar plantillas ni mensajes masivos, aunque Lymera diga «Conectado». Revisa el estado en la sección de cuentas de WhatsApp de tu Meta Business Manager.

Conexión avanzada (manual)

Está pensada para equipos técnicos. Pide el nombre del negocio, el token de acceso y otros datos que se obtienen en Meta Business Manager › WhatsApp Manager › API Setup. Úsala solo si tu Customer Success te lo indica.

Habilitar números para campañas

  1. En la tarjeta, haz clic en Números habilitados.
  2. Si no ves números, haz clic en Sincronizar para traerlos desde Meta.
  3. Marca los números que usarán tus campañas y haz clic en Guardar.
  4. Si un número necesita registrarse, usa Registrar números.

Otras acciones de la tarjeta

  • Prueba: escribe el teléfono destino (sin +) y haz clic en Enviar.
  • Re-suscribir webhook o Reintentar webhook: restaura la suscripción para que lleguen las respuestas. Cuando todo está bien verás «✓ Webhook suscrito automáticamente por Meta».
  • Importar templates: trae las plantillas aprobadas de tu WABA.
  • Desconectar: no se puede si la cuenta está en uso por campañas. Cambia primero el número en esas campañas.

Plantillas

  1. En Creative Hub, haz clic en Nuevo template y define nombre, categoría (Marketing, Utilidad o Autenticación), idioma, cuerpo y variables.
  2. Haz clic en Enviar a Meta →. Si tienes varias cuentas, elige a cuál enviarla.
  3. Revisa su estado: No enviado, Pendiente Meta, Aprobado Meta o Rechazado Meta (con el motivo).
  4. Con Sincronizar desde WABA importas las que ya existen. Si ves «Variables sin mapear», edita la plantilla y asigna cada variable a un campo de Lymera.

Usar un número que ya tienes en la app de WhatsApp Business

Con la coexistencia puedes conectar un número que sigue en la app WhatsApp Business de tu teléfono (versión reciente). Está disponible según tu plan o activación.

  1. Haz clic en Conectar con Meta.
  2. En la ventana de Meta, elige conectar la app WhatsApp Business y escanea el código QR desde tu teléfono.
  3. Espera a que el número muestre «Contactos e historial sincronizados».

Meta solo permite la sincronización inicial durante las primeras 24 horas. Para desconectar un número en coexistencia, hazlo desde la app.

💡 Consejo: puedes reservar un número para un Sales Rep desde el selector Uso del número. Consulta con tu Customer Success si no ves esa opción.

Salud de la cuenta

La tarjeta muestra el estado de la cuenta: Activa, Token expirado, Sin conexión, Suspendida o Sin verificar.

❓ Preguntas frecuentes

❓ ¿Puedo conectar un número que uso en la app de WhatsApp?

Sí, si usas la coexistencia con la app WhatsApp Business. Con la app personal no es posible a la vez. Para usar ese número solo con la API, primero elimina la cuenta en la app (Ajustes › Cuenta › Eliminar cuenta).

❓ ¿Por qué dice «Conectado» pero mis mensajes no se envían?

Puede ser que Meta aún revise tu número o nombre visible, o que no tengas una tarjeta válida en tu portafolio comercial. Revisa en Meta Business Manager que el estado sea Aprobado.

❓ ¿Quién cobra los mensajes de WhatsApp?

Meta cobra directamente el uso de su API, con la tarjeta de tu portafolio comercial. Conectar WhatsApp en Lymera no consume tus créditos por sí mismo.

❓ ¿Puedo conectar más de una cuenta de WhatsApp Business?

Sí. Con varias cuentas, al sincronizar o enviar plantillas se te pide elegir cuál.

❓ ¿Por qué Meta rechazó mi plantilla?

Revisa el motivo que aparece en la plantilla («Motivo: …») y ajústala según las reglas de Meta.

🔧 Si algo no funciona

Qué vesCausa probableQué hacer
No se abre la ventana de MetaVentanas emergentes bloqueadasPermítelas para el sitio y reintenta
«No se pudo completar la autorización con Meta»Cancelaste o falló MetaReintenta
«Meta ya creó el WABA… pero la conexión no se completó»Alta parcialNo repitas el registro; escribe a soporte con el ID del WABA
«Cuenta conectada, pero Meta no confirmó la suscripción de webhooks»Webhook pendienteHaz clic en Reintentar webhook
Estado «Token expirado», «Sin conexión» o «Suspendida»Acceso vencido, caída o suspensión de MetaReconecta con Conectar con Meta y revisa tu Meta Business Manager
«Meta rechazó el mensaje: …» en la pruebaNúmero inválido, ventana de 24 h o plantilla no aprobadaLee el detalle del mensaje
«No se puede desconectar: esta cuenta está en uso…»Campañas usan sus númerosCambia el número en esas campañas
«Este número ya está conectado en otra cuenta…»Mismo número en dos cuentas de LymeraConsulta con tu Customer Success
No ves botones para editarFalta permiso o lo administra tu CSMPide el cambio a tu Account Admin o CSM

Si el problema continúa, escribe a soporte con empresa, número de WhatsApp afectado, hora, mensaje exacto y captura.

🚀 Siguientes pasos