Esta guía te ayuda a migrar una bandeja de entrada de WhatsApp Cloud existente a una configuración manual en Chatwoot. La migración mantiene tu bandeja de entrada actual intacta. Las conversaciones, contactos, colaboradores, reglas de enrutamiento, horarios comerciales, configuraciones de CSAT, ajustes de bots y otras configuraciones de la bandeja se preservan.
Los números de WhatsApp con soporte de Coexistencia están actualmente en revisión. Si tu número de WhatsApp también se utiliza en la App de WhatsApp Business, contacta con el Soporte de Chatwoot antes de iniciar esta migración.
Antes de comenzar la migración, recopila los detalles necesarios de la API de WhatsApp Cloud de Meta: ID de WABA, ID de Número de Teléfono y un token de acceso permanente de usuario del sistema. Usa los pasos a continuación para crear o seleccionar una app de Meta, agregar o seleccionar el número de WhatsApp y generar el token.
Obtén los detalles de tu API de WhatsApp Cloud desde Meta
Para completar la migración, necesitas tres detalles de Meta:
-
ID de cuenta de WhatsApp Business
-
ID de número de teléfono
-
Token de acceso permanente o token de usuario del sistema
Puedes obtener el ID de cuenta de WhatsApp Business y el ID de número de teléfono desde tu app de Meta.
Crea o selecciona una app de Meta
Ve a Meta for Developers y selecciona una app existente o haz clic en Create App.
Si vas a crear una nueva app, ingresa un nombre de app y correo de contacto, luego haz clic en Next.
Elige el caso de uso de WhatsApp
En la pantalla de selección de caso de uso, elige Connect with customers through WhatsApp, luego haz clic en Next.
Elige una cartera comercial
Selecciona la cartera comercial que posee o poseerá tu cuenta de WhatsApp Business.
Si aún no tienes una cartera comercial, puedes crear una durante este paso o continuar y crearla más tarde si Meta lo permite.
Revisa los requisitos de publicación
Meta puede mostrar requisitos de publicación para la app y caso de uso seleccionados. Revisa los requisitos y haz clic en Next.
Revisa y crea la app
Revisa los detalles de la app, el caso de uso de WhatsApp seleccionado y la cartera comercial conectada. Haz clic en Create app para finalizar.
Abre la configuración de la API de WhatsApp
Después de crear o seleccionar la app:
-
Haz clic en Use cases en la barra lateral.
-
Busca Connect with customers through WhatsApp.
-
Haz clic en Customize.
-
Haz clic en API Setup.
En la nueva interfaz de la app de Meta, ve a Basic setup → Step 2. Production setup y abre Register your WhatsApp phone number.
En apps antiguas de Meta, abre WhatsApp → API setup en la barra lateral izquierda.
Agrega o selecciona tu número de WhatsApp
En la sección Send and receive messages o Register your WhatsApp phone number, elige un número existente desde el selector From o haz clic en Add phone number.
Si vas a agregar un nuevo número:
-
Ingresa el nombre para mostrar de tu empresa en WhatsApp y los datos de tu empresa.
-
Ingresa el número de teléfono.
-
Elige verificación por SMS o llamada telefónica.
-
Ingresa el código OTP de Meta para verificar el número.
Copia los IDs requeridos
Después de agregar o seleccionar el número, copia estos valores desde la página de configuración de la API:
-
Phone Number ID
-
WhatsApp Business Account ID
Necesitarás pegar estos valores en el flujo de migración de Chatwoot.
En la antigua interfaz de Meta, estos valores se muestran directamente bajo el selector From en WhatsApp → API setup.
Meta cambia esta interfaz frecuentemente. Si tu pantalla se ve diferente, busca la página de configuración de la API de WhatsApp y el número de remitente seleccionado. El Phone Number ID y el WhatsApp Business Account ID normalmente se muestran cerca del número de teléfono seleccionado en From.
Configura un token de acceso permanente para la API de WhatsApp Cloud
También necesitas un token de acceso permanente de usuario del sistema con permisos de WhatsApp. Este token permite que Chatwoot se conecte a tu número de API de WhatsApp Cloud, envíe y reciba mensajes y sincronice plantillas de mensajes.
Abre usuarios del sistema en la configuración de negocios de Meta
-
Abre Meta Business Settings.
-
Selecciona la cartera comercial que posee tu cuenta de WhatsApp Business.
-
Ve a Users → System users.
-
Si ya tienes un usuario del sistema para Chatwoot, selecciónalo.
-
Si no tienes uno, haz clic en Add.
Crea un usuario del sistema
-
Ingresa un nombre para el usuario del sistema, como
Chatwoot WhatsApp. -
Selecciona Admin como rol del usuario del sistema.
-
Haz clic en Create system user.
Genera un token
-
Selecciona el usuario del sistema.
-
Haz clic en Generate token.
Selecciona la app de Meta
Elige la app de Meta que creaste o seleccionaste anteriormente para la configuración de la API de WhatsApp Cloud, luego haz clic en Next.
Elige la expiración del token
Selecciona Never como expiración del token, luego haz clic en Next.
Asigna los permisos
Selecciona los permisos requeridos de WhatsApp:
-
whatsapp_business_messaging -
whatsapp_business_management -
whatsapp_business_manage_events
Luego continúa para generar el token.
Copia el token
Después de que Meta cree el token, haz clic en Copy y guárdalo de forma segura. Deberás pegar este token en el paso Access token en el flujo de migración de Chatwoot.
Mantén este token privado. Cualquiera con acceso a él podría utilizar tu conexión de la API de WhatsApp Cloud.
Inicia la migración
-
Ve a Settings → Inboxes.
-
Abre la bandeja de WhatsApp conectada mediante registro embebido.
-
Haz clic en Start manual migration.
Chatwoot abrirá un flujo de migración guiado.
Paso 1: Revisa lo que cambiará
El primer paso explica qué se preservará y qué se actualizará.
Se preserva:
-
Conversaciones
-
Contactos
-
Colaboradores
-
Enrutamiento
-
Horarios comerciales
-
Configuración de la bandeja de entrada
Se actualiza:
-
WABA ID
-
Phone Number ID
-
Token de acceso
-
Configuración de webhook
Haz clic en Continue.
Paso 2: Ingresa detalles del negocio
Ingresa los detalles del activo de WhatsApp desde Meta.
Campos:
-
WABA ID: La cuenta de WhatsApp Business que posee este número de teléfono.
-
Phone Number ID: El ID único de Meta para el número de WhatsApp conectado a esta bandeja.
-
Display phone number: El número de WhatsApp mostrado al cliente. No puede ser cambiado durante la migración.
Haz clic en Continue.
Paso 3: Agrega el token de acceso
Pega un token de acceso permanente o token de usuario del sistema con permisos de WhatsApp. El token debe incluir whatsapp_business_messaging, whatsapp_business_management y whatsapp_business_manage_events.
Paso 4: Revisa y reconecta
Revisa la bandeja, el número de teléfono, el WABA ID y el Phone Number ID antes de aplicar los cambios.
Chatwoot verificará las credenciales con Meta antes de aplicar los cambios. Si la verificación falla, la configuración actual no se modifica.
Haz clic en Reconnect WhatsApp inbox para completar la migración.
Después de la migración
Tras completar la migración, la bandeja de entrada permanece igual en Chatwoot, pero la conexión de WhatsApp se realiza mediante la configuración manual de la API de WhatsApp Cloud.
Deberías verificar:
-
Mensajes entrantes
-
Respuestas salientes
-
Envío de mensajes plantilla
-
Sincronización de plantillas
-
Entrega de webhooks
¿Necesitas ayuda?
Si tienes dudas en algún paso, contacta con el Soporte de Chatwoot. Podemos ayudarte a verificar los detalles requeridos de Meta y asistirte con la migración.