Prerrequisitos
  • Como cliente nuevo o existente y si no ha utilizado el nuevo proceso WhatsApp Self-service Onboarding, cree una nueva cuenta de WhatsApp Business (WABA) utilizando el flujo de registro integrado.
    • Registre al menos un nuevo número de teléfono como parte de este WABA y cree una integración de WhatsApp en su organización de Genesys Cloud. El nuevo número de teléfono puede ser un número de prueba o de integración, que podrás eliminar más tarde, una vez que hayas migrado los demás números a este WABA. Sin registrar al menos un nuevo número a través del Registro Integrado, no podrá adjuntar la línea de crédito o el método de pago de Genesys al WABA. Sin un método de pago válido, WhatsApp no puede migrar números de teléfono a un WABA. Por lo tanto, debe registrar al menos un número nuevo.
  • Cree una Meta App en el Meta Business Manager y añádale el producto WhatsApp. Necesitas configurar esta aplicación para ejecutar una solicitud de Graph API con los permisos de WhatsApp para iniciar el proceso de migración del número de teléfono. No utilice la aplicación para ningún otro fin que no sea generar un token de acceso o usuario, ejercer permisos e iniciar la migración. Puedes eliminar la aplicación más tarde desde el Gestor de Empresas una vez que hayas migrado todos los números. 
  • Inicie la migración utilizando la Graph API. Genesys no puede realizar la migración en su nombre porque los WABA creados a través de Embedded Signup son propiedad de la empresa y no de Genesys.

Para crear una metaaplicación con el producto WhatsApp, siga estos pasos:

  1. En la página Meta Business Settings, haga lo siguiente:
    1. Sección Cuentas pulse Apps.
    2. Haga clic en Añadir y seleccione Crear un nuevo ID de aplicación.
    3. En la página Crear una aplicación, seleccione Otros.
    4. En la página Seleccione un tipo de aplicación, seleccione Business.
    5. Hacer clic próximo.
    6. En el campo Añadir un nombre de aplicación, introduzca el nombre de la aplicación.
    7. (Opcional) En el campo Business Account, seleccione Genesys Cloud Services, Inc.
    8. Haga clic en Crear aplicación. Aparecerá el panel de Meta App.
    9. En la página Añade productos a tu aplicación, en el mosaico WhatsApp , haz clic en Configurar.
    10. En la página Quickstart, en el panel lateral izquierdo, en App Review, haga clic en Permissions and Features.
    11. En la página Permissions and Features, en el campo Search, escriba business_management.
    12. En la sección Permisos y funciones, visualiza las opciones WhatsApp_business_management y business_management con el nivel de acceso estándar.
  2. Vaya a la pestaña Meta y haga clic en Actualizar.
  3. Visualice la aplicación Genesys Cloud App que ha creado en la página de configuración de la empresa.

Una vez creada la aplicación, configure una URL de devolución de llamada de webhook de prueba para su producto WhatsApp en la aplicación. Para configurar la URL de WhatsApp Webhook Callback para tu Meta app, sigue estos pasos:

  1. En el buscador de URL únicas , cree la URL única. 
  2. Copie y pegue la URL única en otra pestaña del navegador y luego vuelva a la URL de su sitio Webhook.
  3. En la URL del sitio Webhook, haga lo siguiente:
    1. En la parte superior de la página, haga clic en Editar.
    2. En el cuadro de diálogo Editar URL, en el campo Cuerpo de la respuesta, escriba $request.query.hub_challenge$ como variable.
    3. Hacer clic Ahorrar.
  4. En la aplicación Meta, haz lo siguiente:
    1. En el panel lateral izquierdo, vaya a WhatsApp > Configuración, haga clic en Editar.
    2. En el cuadro de diálogo Edit Webhook's callback URL, en el campo Callback URL, pegue la URL única. 
    3. En el campo Verify token, introduzca los detalles del token (que pueden incluir cualquier cadena de texto).
    4. Haga clic en Verifique y guarde para guardar la configuración.
  5. Junto al campo Webhook, haga lo siguiente:
    1. Bajo el campo Editar, haga clic en Gestionar.
    2. En el cuadro de diálogo Webhook fields, en la columna Subscribe, seleccione todas las casillas de la columna Subscribe.
    3. Hacer clic Hecho.

Nota: La configuración del webhook solo es necesaria si está migrando sus números desde otro PSB que esté en la plataforma WhatsApp Cloud. Si está migrando números desde una plataforma local de WhatsApp o un WABA existente propiedad de Genesys a su nuevo WABA integrado, proceda directamente a iniciar la migración telefónica.

Permanezca conectado a su Meta Business Account y navegue hasta Meta's Graph API Explorer. En la parte derecha de la página API Explorer, asegúrese de que los parámetros de autenticación están configurados correctamente antes de realizar cualquier solicitud POST utilizando las API.
Para iniciar una migración de teléfono, realice los siguientes pasos:
  1. En el cuadro de diálogo Access Token, en el campo Meta App, seleccione el nombre de la Meta App que creó anteriormente.
  2. En el campo User or Page, seleccione User Token.
  3. En el campo Añadir un permiso, incluya whatsapp_business_management y business_management permissions en la lista de permisos. Si no es así, haga clic en la lista desplegable y selecciónelos. Puede localizar la opción  whatsapp_business_management en la categoría de permisos Otros y business_management en la categoría de permisos Eventos Grupos Páginas .
  4. Haga clic en el botón Generate Access Token . Si el sistema lo solicita, seleccione todos los WABA. Normalmente, para una migración sólo es necesario seleccionar el WABA al que se va a migrar el número. El token de acceso caduca tras un periodo de inactividad. En caso de caducidad, actualice la página o vuelva a generar el token.
  5. Hacer clic Enviar.

Para confirmar si ha iniciado la migración, vaya a su Gestor de WhatsApp y en Herramientas de cuenta > Números de teléfono, vea su número añadido al WABA en estado Pendiente o Desconectado.

Nota: Al iniciar la migración, sólo añade el número al nuevo WABA. Sin embargo, el tráfico fluye a través de su integración de WhatsApp existente asociada al antiguo WABA hasta que complete la migración.

Utilice el flujo de registro integrado de WhatsApp en Genesys Cloud y complete la verificación y el registro del teléfono de WhatsApp. Si la autenticación de dos factores no está desactivada para el número, el teléfono se verificará, sin embargo, no podrá crear la integración de WhatsApp incrustada. Desactivar 2FA es un requisito difícil. Póngase en contacto con GenesysCloudWhatsAppRequests@genesys.com para desactivar la verificación en dos pasos de su número en el antiguo WABA gestionado por Genesys. Si estás migrando el número desde otro BSP y ellos gestionan tu WABA, tendrás que pedirles que lo desactiven por ti.

Puedes activar tu número de teléfono si tu solicitud de API ha tenido éxito y has podido iniciar la migración del número. Si la solicitud de API devuelve un error que indica que al menos una de tus Meta apps debe estar suscrita a webhooks para el WABA de destino, crea una nueva suscripción de webhook para el WABA de destino, realizando una llamada POST al endpoint /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps. 

Puede comprobar que la suscripción se ha realizado correctamente realizando una llamada GET al endpoint /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps.

Nota:Para evitar cualquier riesgo de inactividad en su canal de WhatsApp, para los números de producción, active el número de teléfono durante una ventana de mantenimiento planificada cuando su centro de contacto esté cerrado al público. Tu tráfico de WhatsApp no se verá afectado y no cambiará hasta que se elimine la integración antigua y se cree y active una nueva integración en GC.

Para activar el número de teléfono utilizando el flujo de registro incrustado, realice los siguientes pasos:

  1. Elimine su integración actual de WhatsApp en Genesys Cloud asociada al número de teléfono del antiguo WABA. Es posible que tenga que eliminar primero la Ruta de mensajes asociada a la integración, antes de eliminar la propia integración.
  2. Configura una nueva integración de WhatsApp para el número que iniciaste como parte del nuevo WABA. Para obtener más información sobre cómo configurar una nueva integración de WhatsApp, consulte Work with embedded signup flow. 
  3. Una vez completado el proceso, haz lo siguiente: 
    1. Seleccione su cuenta Meta Business.
    2. Seleccione la cuenta de WhatsApp Business en la que se añadió el número después de iniciar la migración.
    3. Seleccione el número de teléfono/perfil empresarial migrado.
    4. Verifique/registre el número y guarde la integración.

Pueden pasar unos minutos hasta que todas tus plantillas de mensajes de WhatsApp aprobadas se migren automáticamente de tu antiguo WABA al nuevo WABA. Una vez hecho esto, WhatsApp asignará una nueva plantilla de mensaje Namespace. Para reconfigurar las respuestas enlatadas, realice los siguientes pasos:

  1. Inicie sesión en su Meta Business Manager.
  2. Seleccione su empresa.
  3. Vaya a WhatsApp Manager > Herramientas de la cuenta > Plantillas de mensajes
  4. Vuelva a configurar las plantillas de mensajes/respuestas enlatadas en su Genesys Cloud Org debido al nuevo espacio de nombres asignado por WhatsApp. Para obtener más información sobre cómo añadir un mensaje de plantilla de WhatsApp y utilizar un mensaje de plantilla de WhatsApp, consulte Añadir un mensaje de plantilla de WhatsApp y Utilizar un mensaje de plantilla de WhatsApp. 

    Si ha creado una nueva suscripción webhook para el WABA de destino y desea eliminar la solicitud, realice los siguientes pasos:

    1. En la sección Graph API Explorer, Access Token, elimínelo realizando una llamada DELETE al endpoint /WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps.
    2. Introduzca el ID de la cuenta de WhatsApp Business.
    3. Hacer clic Enviar.