Saltar al contenido principal
Usa tu app de Meta y tu solución para partners para incorporar clientes a WhatsApp a través de tu software. Completa la incorporación como partner de desarrollo técnico antes de seguir estos pasos. Para ver la opción de integración TP Lite, consulta Partner Direct Link.

Paso 1: Añadir dominios permitidos

Inicia sesión en el Panel de apps de Meta for Developers y ve a Facebook Login for Business > Configuración > Configuración de OAuth de cliente:
Captura de pantalla del producto YCloud
Establece los siguientes interruptores en Sí:
  • Client OAuth Login
  • Web OAuth Login
  • Enforce HTTPS
  • Embedded Browser OAuth Login
  • Use Strict Mode for redirect URIs
  • Login with the JavaScript SDK
⚠️ Notas:
  • Embedded Signup se basa en el JavaScript SDK.
  • Cuando los clientes empresariales completan el flujo de Embedded Signup, su WABA ID, business phone number ID y un exchangeable token code se devuelven a la ventana que inició el flujo, pero solo si el dominio de esa página se ha añadido tanto a Allowed Domains como a Valid OAuth Redirect URIs.
  • Añade todos los dominios en los que planees desplegar Embedded Signup (incluidos los dominios de prueba en entornos de desarrollo).
  • Solo se admiten dominios con HTTPS habilitado.

Paso 2: Crear un ID de configuración de Facebook Login for Business

Una configuración de Facebook Login for Business define qué permisos solicitar y qué información adicional recopilar cuando los clientes empresariales usan Embedded Signup. En la consola, ve a Facebook Login for Business > Configuraciones.
Captura de pantalla del producto YCloud
Haz clic en Crear a partir de una plantilla y selecciona WhatsApp Embedded Signup Configuration With 60 Expiration Token para crear una configuración. Esta plantilla genera una configuración con los permisos y niveles de acceso utilizados con mayor frecuencia.
Captura de pantalla del producto YCloud
Una vez completada la configuración, anota el ID de configuración ; lo necesitarás en el siguiente paso.

Paso 3: Integrar Embedded Signup en tu sitio web

Añade el siguiente código HTML y JavaScript a tu sitio web. Este es el código completo necesario para implementar Embedded Signup. Recomendamos crear diferentes flujos de Embedded Signup según tu solución o las necesidades de tus clientes:

Embedded Signup: Creación de una cuenta de WhatsApp API

1. Crear el botón de Embedded Signup

⚠️ Notas:
  • Sustituye appId, config_id y solutionID por valores reales.
  • El frontend debe pasar waba_id y phone_number_id a tu backend para recuperar la WABA y registrar el número (consulta más abajo).
Más detalles: https://developers.facebook.com/docs/whatsapp/embedded-signup/implementation 2. Vincular la WABA y el número registrado Una vez que el cliente complete el Embedded Signup, tu frontend obtendrá el waba_id y el phone_number_id, y los pasará a tu backend para las llamadas posteriores a la API. Vincular WABA Llama a la API de vinculación de WABA de YCloud y luego asóciala con la cuenta de cliente correspondiente en tu sistema. Ejemplo de solicitud:
Ejemplo de respuesta correcta:
Nota: Si el campo de respuesta paymentMethodAttached es true, indica que YCloud ha vinculado correctamente un método de pago a esta WABA. De lo contrario, contacta con el equipo de YCloud para resolver el problema. Registrar número de teléfono
Respuesta de ejemplo

Embedded Signup: Coexistencia con la app WhatsApp Business

1. Crear el botón de Embedded Signup


2. Recuperar WABA y vincular a YCloud

Una vez que los clientes completen Embedded Signup, tu frontend recibirá waba_id. Pásalo a tu backend para llamadas posteriores a la API. Llama a la API de vinculación de SMB de YCloud. Una vez que se complete con éxito, asocia la WABA con la cuenta de tu cliente en tu sistema.
Respuesta de ejemplo

Preguntas frecuentes

Si has configurado el solutionID correctamente, los clientes verán el nombre real del Solution Partner durante la autorización de Facebook.
Si no lo ven, la configuración no ha surtido efecto.
Asegúrate de que la Revisión de la app se haya completado.
Captura de pantalla del producto YCloud
Esto puede ocurrir si el usuario selecciona una WABA existente en lugar de crear una nueva.
Es posible que la WABA existente ya tenga un método de pago que no se haya eliminado.
Al abrir la página de Embedded Signup, puede aparecer el siguiente mensaje:App not active
This app is not currently accessible and the app developer is aware of the issue. You will be able to log in when the app is reactivated.
Esto sucede cuando la aplicación está en modo de desarrollo , donde solo los usuarios de prueba tienen permisos (consulta App Dashboard > App roles > Roles / Test Users).Solución:
Cambia el modo de la aplicación a En vivo mediante Meta Apps abriendo la aplicación correspondiente en el panel de control.
Como alternativa, autoriza al usuario actual. Consulta: Assign business assets to people in your business portfolio.
Al abrir la página de Embedded Signup, puede aparecer el siguiente mensaje:Feature unavailable
Facebook Login is currently unavailable for this app as we are updating additional details for this app. Please try again later.
Solución:
Ve a App Dashboard > App Review > Permissions and Features y solicita acceso avanzado para public_profile .