Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Embedded Signup de WhatsApp para tus clientes: tu propia app de Tech Provider o una página alojada

Un SaaS puede conectar los números de la app de WhatsApp Business de sus clientes a la Cloud API mediante el Embedded Signup de Meta de dos maneras. Puede convertirse él mismo en Tech Provider de Meta, lo que exige verificación de empresa, App Review con dos videos y su propio desarrollo de Embedded Signup, o enviar a sus clientes a una página alojada de Embedded Signup gestionada por un proveedor que ya lo es, y recibir la conexión terminada.

easyCoexistence ejecuta el Embedded Signup de Meta con Coexistencia en una página alojada con tu nombre, para que tus clientes conecten sus números sin que tú te conviertas en Tech Provider.

10 to 200

Nuevos clientes empresariales que un Tech Provider puede incorporar en cada periodo móvil de 7 días: 10 por defecto, 200 tras la verificación y la revisión.

2 videos

Grabaciones de pantalla que App Review pide a un Tech Provider: un mensaje enviado y recibido, y la creación de una plantilla.

About 24 hours

Tiempo medio de respuesta que Meta indica para el App Review de una app de WhatsApp.

2.24.17

La versión más antigua de la app de WhatsApp Business que un cliente puede conectar mediante Coexistencia.

30 seconds

Tiempo durante el que sigue válido el código que devuelve Embedded Signup para que el servidor lo intercambie por el token de empresa del cliente.

¿Cuáles son las dos formas de incorporar los números de tus clientes?

Ambas usan el Embedded Signup de Meta con Coexistencia y terminan en el mismo punto: el número del cliente en la Cloud API, que sigue funcionando en la app de WhatsApp Business, y tu backend con el token de empresa propio del cliente. Lo que cambia es quién asume los requisitos de Meta y el código que rodea la ventana emergente.

Your own Tech Provider appeasyCoexistence's hosted page
Before the first customerBusiness verification, App Review and your own Embedded Signup buildAn API key and a card on the account
Name in Meta's popupYour appeasyCoexistence, with your name on the page around it
Code you maintainThe popup, the token exchange, webhook subscriptions and the history syncA session request and a return page
The 14-day ruleA PARTNER_REMOVED webhook for your app to handleconnection.disconnected with PRIMARY_INACTIVITY
Meta's message chargesOn the customer's WhatsApp Business AccountOn the customer's WhatsApp Business Account

¿Qué exige Meta para convertirse en Tech Provider?

Meta enumera los pasos en su guía Become a Tech Provider, que el App Dashboard abre bajo la incorporación de Tech Provider del caso de uso de WhatsApp:

  • Una app de Meta con el caso de uso de WhatsApp, conectada a tu Portafolio Comercial.
  • Verificación de empresa, que va primero: Meta solo inicia el App Review para una empresa verificada.
  • Ajustes de la app, como un icono, una política de privacidad y una categoría.
  • Acceso avanzado a whatsapp_business_messaging y whatsapp_business_management, concedido mediante App Review con una explicación escrita y una grabación de pantalla para cada uno.
  • Dos grabaciones en total: un mensaje enviado desde tu app y recibido en WhatsApp, y tu app creando una plantilla de mensaje.

¿Qué construyes una vez aprobado?

La incorporación en sí, que las guías de Embedded Signup de Meta describen paso a paso:

  • El flujo en tu sitio, mediante Facebook Login for Business y el SDK de JavaScript de Meta, en dominios HTTPS que permites en la app.
  • Coexistencia activada en la configuración del flujo, con registro de sesión, que Meta exige para ella.
  • Una llamada al servidor que intercambia el código devuelto por el token de empresa del cliente en menos de 30 segundos.
  • Webhooks: tu app suscrita a la cuenta de cada cliente, con los campos account_update, history, smb_app_state_sync y smb_message_echoes.
  • La sincronización de contactos e historial en las 24 horas posteriores a la incorporación; después, el cliente tiene que desvincularse y volver a ejecutar el flujo.

¿Qué asume la página alojada?

Todo el lado de la ventana emergente. easyCoexistence ejecuta el Embedded Signup con Coexistencia a través de su propia app de Meta como Tech Provider, en una página en easycoexistence.com que muestra tu nombre. El intercambio del token, la suscripción del webhook y la petición del historial ocurren allí, y tu backend recibe un identificador de conexión. Con un webhook_url en la sesión, Meta entrega los mensajes del número directamente a tu servidor, junto con la importación única de contactos y, cuando el cliente lo comparte, hasta 180 días de chats. Tu código luego llama directamente a la Graph API de Meta con el token del cliente, mientras easyCoexistence vigila el número y envía eventos firmados cuando cambia.

¿Qué ve tu cliente?

Una página con tu nombre y un solo botón Conectar. Antes de abrirse la ventana de Meta, una lista de verificación pide al cliente confirmar cinco cosas: una app de WhatsApp Business actualizada, un número en uso real durante al menos 7 días, ningún otro proveedor de API ni herramienta de automatización en él, ninguna app no oficial, y el teléfono a mano con un inicio de sesión de Facebook. No se le pide ninguna cuenta, correo electrónico ni tarjeta.

1Your pageYour name, the checklist and one Connect button
2Meta's popupFacebook sign-in, the number, then the business portfolio
3QR codeScanned from inside the WhatsApp Business app
4In the appConnect, then Confirm: share chat history or not
5Back to youConnected, then your redirect_url

¿Qué ocurre dentro de la ventana de Meta?

El flujo de Meta inicia sesión al cliente con Facebook, le pide autorizar la app e introducir el número, y muestra el perfil de la app de WhatsApp Business de ese número para que lo confirme. Elige o crea un portafolio comercial y luego escanea un código QR desde dentro de la app de WhatsApp Business; Meta también envía al número un mensaje de WhatsApp con un enlace al código. En la app pulsa Conectar y elige si comparte el historial de chats. Por último, aparecen el nombre de la cuenta, una zona horaria y los términos de Meta. El orden puede variar mientras Meta despliega un flujo que pide primero el número de teléfono.

¿Con qué nombre aparece la ventana de Meta?

Con el nombre de la app que solicita el acceso. En la página alojada es easyCoexistence, y no puede cambiarse, mientras que la página que rodea la ventana muestra tu nombre tomado de partner_name. Una app de Tech Provider propia muestra en cambio el nombre de tu app, a costa de la verificación, la revisión y el desarrollo descritos arriba.

¿Qué es la regla de los 14 días?

Meta desconecta un número de Coexistencia cuando el teléfono que tiene la app de WhatsApp Business lleva inactivo unos 14 días, y notifica el motivo como PRIMARY_INACTIVITY. El cliente se vuelve a conectar ejecutando de nuevo el flujo con el mismo número. A través de la página alojada, easyCoexistence vigila cada número y envía a tu URL de eventos connection.disconnected con ese motivo, así que un nuevo enlace de conexión para el cliente puede devolver el número.

Errores comunes

  • Construir sobre Embedded Signup v2 o v3. Meta retiró ambas el 15 de octubre de 2026 y responde a las peticiones dirigidas a ellas como v4.
  • Pedir permisos que la app no usa. Meta señala los permisos innecesarios como una causa habitual de rechazo de App Review.
  • Grabar un solo video para ambos permisos. Meta quiere una grabación de pantalla y una explicación escrita separadas para cada uno, y puede rechazar un video que muestre varios.
  • Pedir a los clientes que se conecten desde el teléfono que tiene el número. La ventana de Meta se abre allí como una pestaña nueva, y ese mismo teléfono tiene que escanear el código QR, así que es más fácil usar un ordenador.
Hacerlo con EasyCoexistence

Tu backend recibe el token propio de cada cliente, Meta entrega los mensajes directamente a tu webhook y las desconexiones te llegan como eventos firmados. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Necesito ser Tech Provider de Meta para incorporar los números de WhatsApp de mis clientes?

Solo para ejecutar el Embedded Signup desde tu propia app de Meta. Enviar a los clientes a una página alojada gestionada por un Tech Provider conecta sus números sin tu propia verificación de empresa ni App Review.

¿Cuánto tarda el App Review de Meta para una app de WhatsApp?

Meta sitúa la media en unas 24 horas. La verificación de empresa debe estar completa antes de que pueda empezar la revisión, y cada envío rechazado añade otra ronda.

¿Mi cliente sigue usando la app de WhatsApp Business?

Sí. La app sigue funcionando en su teléfono junto a la API, y los mensajes se reflejan entre ambas. Algunas funciones de la app cambian: las listas de difusión pasan a ser de solo lectura, y los mensajes temporales y de visualización única se desactivan.

¿Quién paga a Meta por los mensajes?

El cliente. Meta factura los mensajes enviados por la API a la cuenta de WhatsApp Business del propio cliente, con un método de pago que añade allí, mientras que los mensajes enviados desde la app de WhatsApp Business siguen siendo gratuitos.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el