Conectar WhatsApp con Meta

Objetivo

Conecta un número de WhatsApp Business a Helios a través del registro guiado oficial de Meta. Haces clic en Connect with WhatsApp, inicias sesión con Facebook dentro del popup de Meta y terminas en minutos. Helios es un Meta Tech Provider: la app de developer, los access tokens, el webhook y la suscripción de la WhatsApp Business Account (WABA) se gestionan por ti — nunca abres Meta for Developers. Solo un paso queda de tu lado: agregar un método de pago en Meta para que el número pueda enviar mensajes.

El camino de configuración manual fue retirado. Crear una conexión a mano — crear una app de Meta, generar un System User token, pegar un Phone Number ID y un App Secret, configurar webhooks — ya no está disponible. Los números conectados así en el pasado siguen funcionando y aún pueden editarse; ver "Editar una conexión existente" más abajo.

Acceso

Sidebar -> WhatsApp

Ruta: /app/{tenant}/whatsapp

Tres puntos de entrada abren el mismo flujo: el botón Connect with WhatsApp en el encabezado de la página, la tarjeta Connect Your First Number cuando aún no existe ningún número, y la fila Connect New Number debajo de la lista de números conectados.

Roles

• Ver la página de WhatsApp y las conversaciones: owner, admin, agent (la cuenta debe estar activa).
• Conectar, editar o eliminar un número: solo owner o admin.
• Se requiere un email de cuenta verificado — conectar o editar queda bloqueado hasta que lo verifiques.

Requisitos previos

• Un plan que incluya WhatsApp y capacidad de números disponible. Sin esto, la acción de conectar abre un aviso de upgrade.
• Una cuenta de Facebook con acceso al portafolio de Meta Business de tu negocio. Si aún no tienes portafolio ni WhatsApp Business Account, el popup de Meta los crea durante el flujo.
• Según la opción que elijas (siguiente sección):
  • Use my own number: un número de teléfono que pueda recibir el código de verificación de Meta por SMS o llamada, y que no esté registrado en la app de WhatsApp de consumo ni en WhatsApp Business — conectarlo aquí lo elimina de esas apps.
  • Use a Helios number: un número de Helios activo (ver Phone Numbers).
• Un método de pago (tarjeta de crédito o débito) para agregar a tu WhatsApp Business Account en Meta después de conectar. Sin él, Meta acepta la conexión pero el número no puede enviar mensajes.
• Un agente activo con el canal WhatsApp habilitado, para asignarlo después de conectar — un número solo puede quedar Active con un agente asignable.

Elige cómo conectar

Cualquier punto de entrada de conexión ejecuta primero las verificaciones de plan y email, y luego abre el diálogo How do you want to connect WhatsApp? con dos opciones:

Si no tienes un número de Helios, la segunda opción aparece deshabilitada con el mensaje "You do not have a Helios number yet. Buy one first, then connect it to WhatsApp."

Elige una opción y haz clic en Continue.

Conectar tu propio número

1. En el popup de Meta, inicia sesión con Facebook y sigue los pasos: selecciona o crea tu portafolio de Meta Business y tu WhatsApp Business Account, y luego ingresa tu número de teléfono.
2. Verifica el número con el código que Meta envía por SMS o llamada de voz.
3. Cuando el popup se cierra, el número aparece bajo Connected Numbers en Helios.

Advertencia: el número queda desvinculado de la app de WhatsApp de consumo/Business y después solo funciona vía la API. Si el número está actualmente activo en WhatsApp, Meta no lo aceptará — quítalo primero de la app, o elige un número de Helios en su lugar.

Conectar un número de Helios

1. Elige el número bajo Choose the number to connect y haz clic en Continue.
2. El popup de Meta solo te pide compartir la WhatsApp Business Account — no hay pantalla de número ni código que teclear.
3. De vuelta en Helios, una tarjeta de progreso ("Connecting your Helios number to WhatsApp") sigue el registro: cuenta enlazada, número agregado, esperando el código de verificación de Meta, código recibido, verificado, registrado y finalmente "Your number is connected to WhatsApp." La mayoría de los registros terminan en un par de minutos; el paso del código depende de la entrega del SMS por la operadora.

Si la tarjeta reporta un fallo:

Si la tarjeta indica que está tardando más de lo esperado, el registro sigue corriendo de nuestro lado — el número aparece en la lista de abajo en cuanto está listo.

Activar el número

Las conexiones nuevas nacen Inactive y sin agente, para que decidas quién responde antes de que se procese ningún mensaje.

1. En la fila del número, abre el menú de acciones y haz clic en Edit.
2. Elige el Assigned Agent. Solo se listan agentes activos con el canal WhatsApp habilitado; con Teams habilitado en tu plan también puedes elegir un coordinador que responde como equipo.
3. Marca Active (enable this connection) y haz clic en Save Changes.

También puedes usar el interruptor de la fila — encender un número requiere un agente asignable, y si el agente vinculado quedó inactivo, el diálogo "Choose an active agent to reactivate" te pide elegir un reemplazo.

Agregar tu método de pago en Meta

Este es el único paso que el flujo guiado no puede hacer por ti. Helios es un Meta Tech Provider, así que pagas a Meta directamente por las conversaciones — y Meta exige un método de pago en tu WhatsApp Business Account antes de que el número pueda enviar nada. Meta no reporta confirmación en ningún sentido, así que Helios trata a un número que nunca ha enviado un mensaje como no verificado:

• La página de WhatsApp muestra un banner — "One step left: add your payment method in Meta" — que nombra el número afectado.
• La fila del número lleva un chip Payment unverified, o Cannot send cuando Meta efectivamente rechazó un envío por facturación.

Para agregarlo:

1. Abre Meta Business Manager con la cuenta que usaste para conectar.
2. Ve a WhatsApp Manager y abre la configuración de facturación o pagos — el botón Open Meta billing del banner y de la fila del número te lleva directo.
3. Agrega un método de pago a tu WhatsApp Business Account.

De vuelta en Helios, haz clic en I have added it en la fila expandida del número. La advertencia solo se limpia del todo cuando un mensaje se entrega de verdad — Meta no ofrece forma de comprobar que exista una tarjeta, así que la entrega real es la única prueba.

Costo: Meta cobra a tu tarjeta por conversación, con tarifas que varían por país y categoría — consulta los precios de WhatsApp de Meta. Unos centavos alcanzan para pruebas extensas.

Enviar un mensaje de prueba

Envía un WhatsApp desde otro teléfono al número conectado. El agente debería responder en segundos.

Si el mensaje llega a Helios pero no se genera respuesta, verifica que el número esté Active, que el agente asignado esté activo y con el canal WhatsApp habilitado, y que el paso del pago de arriba esté hecho — un método de pago faltante falla en silencio, sin error en ningún lado.

Editar una conexión existente

Abre el menú de acciones en la fila de un número y haz clic en Edit:

Test Connection verifica el Phone Number ID y el token contra Meta — funciona con las credenciales almacenadas, sin reingresarlas. Si tiene éxito muestra Verified: seguido del nombre de tu negocio (más el quality rating cuando Meta lo devuelve), y limpia una marca Needs attention dejada por un fallo de credenciales anterior.

Si guardar falla con un mensaje del lado de Meta (token rechazado, permisos faltantes, cuenta no encontrada), el arreglo más rápido para una conexión guiada es reconectar: ejecuta Connect with WhatsApp de nuevo con el mismo número. Reconectar refresca las credenciales almacenadas y preserva el estado Active y el agente asignado del número. Los números conectados manualmente en el pasado pueden, en cambio, pegar un token permanente nuevo — el mensaje de error nombra el activo exacto a corregir.

Conexiones legacy de Twilio: una conexión creada a través de la integración de Twilio retirada abre con el aviso "This connection uses a retired setup method." Sus credenciales ya no pueden editarse, pero aún puedes activarla, desactivarla o eliminarla desde la lista. Los números de Twilio en sí siguen totalmente soportados para voz.

Buenas prácticas

• Asigna el agente y activa justo después de conectar — los números nuevos nacen Inactive a propósito, y nada se responde hasta entonces.
• Agrega el método de pago en Meta inmediatamente después de conectar. El modo de fallo sin él es silencio, no un error.
• Trae un número de negocio dedicado, o usa un número de Helios — conectar tu propio número lo elimina de la app de WhatsApp de tu teléfono.
• Para arreglar un problema de credenciales con Needs attention, reconecta con Connect with WhatsApp en vez de eliminar y volver a agregar: la reconexión conserva el estado Active y el agente asignado.
• Ejecuta Test Connection en el modal de edición después de cualquier cambio de credenciales.

Errores comunes

Relacionado

• WhatsApp — conversaciones, plantillas de mensajes, notificaciones
• Phone Numbers — compra el número de Helios que puedes conectar a WhatsApp
• Agents — habilita el canal WhatsApp en un agente