Cómo conectar WhatsApp Oficial con Meta Cloud API

• Categoría: Canales y bandejas de entrada
• Disponibilidad: Incluido en todos los planes (Estándar, Premium y Evolución)
• Tiempo estimado de configuración: 10 a 15 minutos
• Rol necesario: Administrador (en Waclis Inbox y en Meta Business Suite)

Conectar tu línea mediante WhatsApp Oficial (Meta Cloud API) integra a tu empresa directamente con la infraestructura en la nube de Meta, sin depender de un teléfono físico encendido y habilitando funciones empresariales avanzadas como el constructor de Plantillas Meta y el monitoreo en tiempo real de la Salud de la Cuenta. En esta guía aprenderás paso a paso los dos métodos reales disponibles en la tarjeta WhatsApp Business de Waclis Inbox: el registro rápido incrustado (Connect with WhatsApp Business) y el flujo de configuración manual de 5 pasos con verificaciones en vivo.

1. ¿Qué puedes hacer y cuándo te sirve?

La conexión oficial con Meta Cloud API está diseñada para operaciones que priorizan continuidad operativa en la nube y escalabilidad:

• Atención empresarial continua en la nube sin teléfono físico: Ideal para centros de atención al cliente, clínicas, bancos, fintechs o tiendas de comercio electrónico con alto flujo diario donde la línea no puede depender de la batería ni de la señal Wi-Fi de un celular.
• Envío de notificaciones transaccionales y campañas con Plantillas Meta: Permite despachar confirmaciones de compra, recordatorios de turnos o promociones a miles de destinatarios respetando los niveles de envío de Meta (1K, 10K, 100K o Ilimitados).

2. Antes de comenzar (Requisitos previos)

Revisa esta lista antes de iniciar cualquiera de los dos métodos de conexión:

1. Rol de Administrador: Debes ser Administrador tanto en Waclis Inbox como en el portafolio comercial de tu empresa en Meta Business Suite (business.facebook.com).
2. Número telefónico apto para WhatsApp Cloud API:

• Puedes usar un número móvil o fijo nuevo que pueda recibir un SMS o llamada telefónica de voz con el código de 6 dígitos de Meta.
• Si el número ya se utiliza en la app móvil estándar de WhatsApp, para conectarlo en modo Cloud API puro primero debes eliminar la cuenta desde la aplicación móvil (Ajustes → Cuenta → Eliminar mi cuenta), o bien utilizar una cuenta de WhatsApp Business App compatible con el modo de Coexistencia durante el registro incrustado.

1. Método de pago en Meta Business Manager (para plantillas pagas): Para iniciar conversaciones con plantillas fuera de la ventana de 24 horas, Meta exige tener una tarjeta de crédito o débito internacional asociada a tu cuenta de WhatsApp Business (WABA) en el panel de facturación de Meta.

3. Paso a paso en Waclis Inbox: Los dos métodos de conexión

Para comenzar, dirígete en Waclis Inbox a Ajustes (icono de engranaje) → Entradas → + Añadir bandeja de entrada, haz clic en la tarjeta WhatsApp y selecciona la primera opción: WhatsApp Business (Aprovisiona números nuevos mediante el flujo de registro incrustado de Meta).

Allí tendrás disponibles dos caminos: el Método A (Registro rápido incrustado), recomendado para el 95% de las empresas, y el Método B (Flujo de configuración manual de 5 pasos), pensado para equipos técnicos que ya crearon su propia App en Meta for Developers.

Método A: Registro rápido incrustado (Connect with WhatsApp Business)

Este flujo conecta tu cuenta automáticamente mediante una ventana emergente segura de Meta sin que tengas que copiar ni pegar identificadores ni tokens de API:

1. Dentro de la pantalla WhatsApp Business, haz clic en el botón Connect with WhatsApp Business.
2. Se abrirá una ventana emergente oficial de Facebook/Meta (Embedded Signup). Inicia sesión con tu usuario administrador de Meta Business.
3. Haz clic en Continuar para conceder los permisos de administración de WhatsApp Business.
4. Selecciona o crea tu Portafolio comercial (Meta Business Account): Elige la empresa registrada en Meta y pulsa Siguiente.
5. Crea o selecciona tu perfil de WhatsApp Business: Define el nombre visible de la empresa (el nombre comercial que verán tus clientes en WhatsApp), selecciona la categoría de tu negocio y pulsa Siguiente.
6. Registra y verifica tu número de teléfono: Ingresa el número telefónico, elige si deseas recibir el código de verificación de 6 dígitos por Mensaje de texto (SMS) o Llamada telefónica, introduce el código recibido y finaliza el asistente emergente.
7. Al cerrarse la ventana de Meta, Waclis Inbox aprovisionará automáticamente la bandeja, configurará los webhooks y te llevará al Paso 3: Añadir agentes.
8. Selecciona a los agentes que atenderán la línea, haz clic en Añadir agentes y tu bandeja quedará creada con la insignia WHATSAPP CLOUD.

Método B: Flujo de configuración manual de 5 pasos (Conecta WhatsApp manualmente)

Si ya administras una aplicación propia en developers.facebook.com y prefieres ingresar manualmente las credenciales de Meta Cloud API, en la parte inferior de la tarjeta WhatsApp Business haz clic en el enlace flujo de configuración manual. Se abrirá el asistente guiado Conecta WhatsApp manualmente dividido en 5 pasos verificables:

Paso 1: Crea o selecciona una aplicación de Meta

1. Ingresa a developers.facebook.com, crea o abre una App de tipo Empresa (Business) y añade el producto WhatsApp.
2. De vuelta en Waclis Inbox, haz clic en el botón Mi aplicación de Meta está lista.

Paso 2: Añade tu número de teléfono y obtén sus ID

1. En el menú WhatsApp → Configuración de la API de Meta for Developers, localiza tu número de teléfono.
2. En Waclis Inbox, completa los dos campos numéricos:

• ID del número de teléfono: El identificador único del número (ej. 102938475610293).
• ID de cuenta empresarial de WhatsApp: El identificador de la cuenta WABA (ej. 987654321098765).

1. Haz clic en Siguiente.

Paso 3: Generar un token de acceso permanente

1. En Meta Business Suite → Configuración del negocio → Usuarios → Usuarios del sistema, crea un usuario del sistema con rol Administrador, asígnale el activo de tu cuenta de WhatsApp Business y genera un token permanente con los permisos Administración de cuenta de WhatsApp Business y Mensajería de WhatsApp Business.
2. Pega ese token en el campo Token de acceso permanente de Waclis Inbox y haz clic en Verificar detalles.

Paso 4: Crea tu bandeja de entrada de WhatsApp

1. Waclis Inbox consultará a Meta en tiempo real y mostrará en pantalla el Nombre comercial y el Número de teléfono detectados para que confirmes que las credenciales son correctas.
2. Escribe el Nombre de la bandeja de entrada para tu equipo interno y haz clic en Crear bandeja de entrada.

Paso 5: Verifica tu conexión (Las 4 comprobaciones en vivo)

1. En esta pantalla verás la URL de devolución de llamada (Webhook URL) y el Token de verificación generados por Waclis Inbox. Cópialos y pégalos en Meta for Developers → WhatsApp → Configuración → Webhook, suscribiendo el campo messages.
2. Waclis Inbox ejecutará en vivo 4 verificaciones automáticas con indicadores visuales:

• Acceso al número: Confirma que el token tiene permisos sobre el ID del número de teléfono.
• Acceso a plantillas: Confirma acceso de lectura/escritura a las plantillas del ID de cuenta empresarial de WhatsApp.
• Callback del webhook: Valida que Meta pudo verificar la URL del webhook.
• Suscripción al webhook: Confirma que los eventos de mensajes están suscritos a la cuenta.

1. Cuando las 4 verificaciones estén aprobadas, haz clic en Continuar agregando agentes, selecciona a los miembros de tu equipo y pulsa Añadir agentes.

4. Qué significa cada opción en la pestaña Configuración de sesión (Cloud API)

Una vez creada la bandeja de WhatsApp Oficial, al entrar a Ajustes → Entradas → [Tu bandeja WHATSAPP CLOUD] → Configuración de sesión encontrarás herramientas exclusivas para administrar credenciales, sincronizar plantillas, completar el registro del PIN y habilitar llamadas de voz:

5. Otras formas de hacerlo y atajos rápidos

Al operar en el día a día sobre una bandeja de WhatsApp Oficial:

• Envío rápido de plantillas desde el chat: Cuando una conversación supere las 24 horas desde el último mensaje del cliente, haz clic directamente en el botón de Plantillas de WhatsApp en la barra inferior del compositor, busca la plantilla por nombre, completa las variables ({{1}}, {{2}}) con vista previa en vivo y envíala.
• Encuestas CSAT con plantilla nativa de Meta: En la pestaña Encuestas de Satisfacción de tu bandeja Cloud API, cambia el Método de encuesta de Clásico a Plantilla WhatsApp (requiere aprobación). Esto envía al cliente una plantilla interactiva oficial al resolver la conversación, mejorando notablemente la tasa de respuesta.

6. Cómo combinarlo con otras funciones de Waclis Inbox

• Constructor visual de Plantillas Meta (Ajustes → Plantillas Meta): No necesitas entrar al administrador de Meta para crear plantillas; puedes diseñarlas con encabezados multimedia, variables y botones directamente desde Waclis Inbox y enviarlas a revisión (ver Constructor visual de plantillas de WhatsApp Meta y buenas prácticas de aprobación).
• Pestaña Salud de la Cuenta: Supervisa el semáforo de calidad de tu línea (Verde, Amarillo, Rojo), tu nivel de límite de envíos diarios (250, 1K, 10K, 100K) y el estado del webhook sin salir de la bandeja (ver Salud de la cuenta de WhatsApp Oficial, límites de mensajería de Meta, calificación de calidad y migración de bandejas (Migrar bandeja)).
• Agente de IA Capitán + Herramientas personalizadas: Conecta a Capitán en la pestaña Configuración del bot para que atienda instantáneamente dentro de la ventana de 24 horas de Meta, consulte sistemas externos y derive a humanos los casos complejos.

7. Relación con el ecosistema Waclis

Tu canal de WhatsApp Oficial (Meta Cloud API) se integra de forma nativa con las herramientas del ecosistema Waclis:

• WaclisCAL: Permite compartir enlaces públicos de reserva en tus conversaciones de WhatsApp o integrar agendas mediante API REST, Aplicaciones del panel o Herramientas personalizadas HTTP de Capitán.
• Waclis (Tienda / Carrito Cotizador) y WaclisPOS: Utiliza la bandeja oficial para recibir pedidos de la tienda y enviar confirmaciones o presupuestos emitidos desde el punto de venta.
• Waclis Factur: Una vez emitido el comprobante electrónico en Waclis Factur, los agentes pueden compartir el enlace público o el PDF con el cliente en la conversación de WhatsApp Oficial.
• Waclis Reach: Ejecuta secuencias salientes respetando las plantillas y puede coordinarse mediante Webhooks e integraciones API cuando el cliente responde en Waclis Inbox.

8. Problemas frecuentes y cómo resolverlos

8.1 El número se conectó con Connect with WhatsApp Business, pero figura "Pendiente" y no envía mensajes

• Síntoma: Creaste la bandeja mediante el registro incrustado, pero al intentar enviar una plantilla falla o en Salud de la Cuenta el estado del número aparece como Pendiente.
• Causa probable: Falta completar el paso final de registro en la nube de Meta ingresando el PIN de verificación en dos pasos de 6 dígitos.
• Cómo resolverlo: Ve a Ajustes → Entradas → [Tu bandeja WHATSAPP CLOUD] → Configuración de sesión, localiza la sección Completar Registro del Teléfono, introduce un PIN numérico de 6 dígitos (o el PIN de verificación en dos pasos que ya tenía la línea en Meta) y haz clic en Completar registro.

8.2 En el flujo manual, los mensajes salientes se envían pero las respuestas de los clientes no llegan a Inbox

• Síntoma: Tus clientes reciben las plantillas que envías desde Waclis Inbox, pero cuando te contestan el mensaje no aparece en la conversación.
• Causa probable: El webhook de Meta no quedó suscrito al campo messages de esa cuenta WABA.
• Cómo resolverlo: Entra a la pestaña Salud de la Cuenta de tu bandeja en Waclis Inbox, revisa el bloque Configuración de Webhook y haz clic en el botón Registrar Webhook.

8.3 A los pocos días de configurar manualmente la bandeja, dejó de enviar mensajes (Error 190 / Token expirado)

• Síntoma: La bandeja funcionó durante 24 horas y luego todos los mensajes salientes aparecen como fallidos.
• Causa probable: Durante el flujo manual pegaste el Token de acceso temporal de 24 horas de la pantalla de pruebas de Meta for Developers en lugar de un Token de usuario del sistema permanente.
• Cómo resolverlo: Crea un Usuario del sistema en Meta Business Suite, genera un token permanente con permisos de WhatsApp, entra a la pestaña Configuración de sesión de tu bandeja en Waclis Inbox, pégalo en Actualizar Clave API y guarda los cambios.

9. Preguntas frecuentes (FAQ)

¿Qué diferencia hay entre usar Connect with WhatsApp Business y el flujo de configuración manual?

El resultado final es idéntico: ambos crean una bandeja WHATSAPP CLOUD conectada a la API Oficial de Meta. La diferencia es que Connect with WhatsApp Business automatiza en una ventana emergente la creación del portafolio, la verificación del número y el registro del webhook, mientras que el flujo de configuración manual está pensado para desarrolladores que ya tienen credenciales propias en Meta for Developers.

¿Puedo usar en WhatsApp Cloud API el número de prueba gratuito que da Meta?

Sí, para pruebas internas iniciales puedes conectarlo mediante el flujo manual, pero recuerda que los números de prueba (Sandbox) de Meta solo permiten enviar mensajes a un máximo de 5 números verificados previamente en el portal de desarrolladores.

¿Por qué Meta me pide agregar una tarjeta de crédito en Meta Business Suite si mi plan de Waclis Inbox ya está pago?

Porque tu suscripción en panel.waclis.com cubre el uso de la plataforma Waclis Inbox, mientras que Meta cobra por su cuenta el consumo de mensajes de plantilla (Marketing, Utilidad, Autenticación) directamente en el administrador comercial de Meta. Las respuestas que envíes dentro de las 24 horas posteriores a un mensaje del cliente no tienen costo por plantilla en Meta.

10. Artículos relacionados

• Conexión de WhatsApp: diferencias entre código QR y Cloud API oficial
• Salud de la cuenta de WhatsApp Oficial, límites de mensajería de Meta, calificación de calidad y migración de bandejas (Migrar bandeja)
• Constructor visual de plantillas de WhatsApp Meta y buenas prácticas de aprobación
• Diagnóstico: Error