Saltar al contenido principal
Partner Direct Link (TP Lite) es una opción de integración para Tech Partners aprobados de YCloud. Está disponible una vez aprobada tu solicitud de Tech Partner y no necesitas convertirte en socio de Meta. Crea un enlace de incorporación de corta duración en tu servidor. Tu cliente puede abrirlo directamente o mediante un botón en tu sitio web. Empieza con Direct Link para probar tu integración y luego usa el botón del SDK si quieres que los clientes completen el registro en una ventana emergente.

Resumen de la integración

  1. Prepara tu cuenta. Conviértete en Tech Partner de YCloud, crea una clave de API y configura tu receptor de webhooks.
  2. 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.
  3. Crea un enlace. Tu servidor solicita un enlace de incorporación para un cliente en tu sistema.
  4. Deja que el cliente se conecte. Abre la página alojada o la ventana emergente del SDK y completa la autorización de Meta.
  5. Confirma el resultado. Tu backend recibe el Webhook y asocia la WABA con el cliente.

Antes de comenzar

  1. Conviértete en un Tech Partner de YCloud aprobado. Partner Direct Link estará disponible automáticamente.
  2. Crea una clave de API en Developers > API Key.
  3. Configura tu receptor en Developers > Webhooks y suscríbete a whatsapp.business_account.updated.
Llama a la API de creación de enlaces desde tu servidor. Nunca coloques tu clave de API en el código del navegador o de una aplicación móvil. Trata cada URL de incorporación como una credencial temporal: mantenla fuera de páginas públicas, herramientas de analítica y registros públicos.
  1. Abre el panel de YCloud correspondiente a tu cuenta aprobada de Tech Partner.
  2. Abre Partner > Tech Partner.
  3. Selecciona la pestaña Partner Direct Link .
Página de Tech Partner con las pestañas Meta Tech Provider y Partner Direct Link

After approval, open Partner > Tech Partner and select Partner Direct Link.

La página contiene Basic settings para tu imagen de marca e Integration para crear un enlace, integrar el punto de entrada y suscribirte a webhooks. Usa Hosted page preview para ver la página orientada al cliente.

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.
Los idiomas admitidos son 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 a onboardingUrl 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.
Integración con enlace directo con un marcador de posición de URL de incorporación y una vista previa de la página de registro del cliente

Direct Link integration and the hosted page preview. This example has no generated onboarding link.

Si configuraste una URL de redireccionamiento, el registro correcto redirige allí con 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

Paso de integración de Partner Direct Link que muestra el evento de webhook whatsapp.business_account.updated

Subscribe to whatsapp.business_account.updated in Developers > Webhooks to receive the binding result.

YCloud envía 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:
Cuando 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.