Resumen de la integración
- Prepara tu cuenta. Conviértete en Tech Partner de YCloud, crea una clave de API y configura tu receptor de webhooks.
- Configura tu punto de entrada. Abre Partner > Tech Partner > Partner Direct Link y define tu imagen de marca, la URL de redirección o los orígenes del SDK.
- Crea un enlace. Tu servidor solicita un enlace de incorporación para un cliente en tu sistema.
- Deja que el cliente se conecte. Abre la página alojada o la ventana emergente del SDK y completa la autorización de Meta.
- Confirma el resultado. Tu backend recibe el Webhook y asocia la WABA con el cliente.
Antes de comenzar
- Conviértete en un Tech Partner de YCloud aprobado. Partner Direct Link estará disponible automáticamente.
- Crea una clave de API en Developers > API Key.
- Configura tu receptor en Developers > Webhooks y suscríbete a
whatsapp.business_account.updated.
Encuentra Partner Direct Link en el panel
- Abre el panel de YCloud correspondiente a tu cuenta aprobada de Tech Partner.
- Abre Partner > Tech Partner.
- Selecciona la pestaña Partner Direct Link .

After approval, open Partner > Tech Partner and select Partner Direct Link.
Configura tu marca y el punto de entrada
Abre Partner > Tech Partner > Partner Direct Link en el panel de YCloud. Completa Basic settings:
Para los orígenes del SDK, introduce el esquema exacto, el dominio y el puerto opcional, sin ruta. Añade cada subdominio o puerto por separado; los comodines no son compatibles. Usa HTTPS en producción. HTTP solo se permite para el desarrollo en
localhost. Direct Link funciona sin un origen del SDK permitido; SDK Button no.
Crea un enlace de incorporación en tu servidor
- WhatsApp Business Platform (
WHATSAPP_BUSINESS_PLATFORM): Elige este modo para conectar un número y enviar mensajes a través de las API y de tu software. - Coexistencia con WhatsApp Business App (
WHATSAPP_BUSINESS_APP): Elige este modo para un número apto existente de Business App cuando el cliente quiera seguir usando la aplicación y añadir mensajería mediante API en el mismo número.
en_US (inglés), zh_CN (chino simplificado), es_ES (español), pt_BR (portugués de Brasil), id_ID (indonesio) e ru_RU (ruso). Los valores distinguen entre mayúsculas y minúsculas. Otros valores devuelven HTTP 400.
Respuesta de ejemplo:
expiresAt es la hora de vencimiento como una marca de tiempo Unix en milisegundos. La vida útil predeterminada del enlace es de dos horas. Cada enlace conecta a un cliente con una WABA. Antes de completar el registro, el cliente puede actualizar, reintentar o abrir el enlace en otro navegador mientras siga siendo válido. Tras una vinculación correcta, el enlace no puede vincular otra WABA. Crea un nuevo enlace cuando el cliente necesite cambiar o añadir una WABA.
Opción 1: Enlace directo
Añade un botón de conexión a la aplicación de tu cliente. Cuando el cliente haga clic en él, solicita un enlace de incorporación a tu servidor y navega aonboardingUrl o ábrelo en una nueva ventana. También puedes enviarlo de forma privada al cliente deseado a través de un canal seguro individual.
El cliente abre la página alojada y hace clic en Continue with Meta. Utiliza una cuenta de Facebook con permisos para administrar su negocio y selecciona o crea su negocio, WABA y número de teléfono en Meta. YCloud completa la vinculación y muestra el resultado.

Direct Link integration and the hosted page preview. This example has no generated onboarding link.
status=connected añadido como parámetro de consulta. Usa esto para actualizar la página orientada al cliente; utiliza el webhook a continuación para confirmar la vinculación en tu backend.
Opción 2: Botón SDK
Añade el origen de tu página a Allowed SDK origins y, a continuación, carga el SDK. El código de tu navegador llama a tu propio backend para obtener el enlace. La ruta/api/ycloud/onboarding-link a continuación es un ejemplo de ruta que implementas en tu servidor.
onStatus(result) informa sobre el estado del registro:
onError(error) significa que el SDK no pudo abrir el registro. Su code puede ser POPUP_BLOCKED o INVALID_ONBOARDING_URL. onClose(event) se activa solo cuando el cliente cierra la ventana antes de obtener un resultado final, con reason: "USER_CLOSED".
Estas devoluciones de llamada actualizan tu frontend. Usa el webhook del lado del servidor como el resultado final de la vinculación.
Confirmar la vinculación con un webhook
Subscribe to whatsapp.business_account.updated in Developers > Webhooks to receive the binding result.
whatsapp.business_account.updated a tu receptor de webhooks configurado después de que la vinculación se complete con éxito. El siguiente fragmento muestra los campos que utiliza tu integración:
updateEvent sea PARTNER_ADDED, procesa la WABA como recién añadida. Haz coincidir partnerCustomerId con tu cliente y guarda la WABA id. Un valor paymentMethodAttached de true significa que la asignación de crédito se realizó correctamente; false significa que no se ha completado.
Deduplica las entregas utilizando el id del evento y devuelve HTTP 2xx tras recibirlo correctamente. Consulta Webhooks para la configuración del receptor.

