DocumentaciónExperience PlatformGuía de conectores de origen

[Beta]{class="badge informative"}

WhatsApp

Última actualización: 29 de octubre de 2026

Creado para:

  • Desarrollador
NOTE
El origen WhatsApp está en la versión beta. Lea Resumen de fuentes para obtener más información sobre cómo usar conectores con etiqueta beta.
IMPORTANT
Esta fuente se encuentra en versión beta privada y está disponible para un número limitado de clientes. Póngase en contacto con su representante de Adobe para solicitar acceso.

Adobe Experience Platform permite la ingesta de datos desde fuentes externas, al tiempo que ofrece la posibilidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Experience Platform. Puede introducir datos de una variedad de fuentes, como aplicaciones de Adobe, almacenamiento basado en la nube, bases de datos y muchas otras.

Experience Platform es compatible con la ingesta de datos desde aplicaciones de flujo continuo. La compatibilidad con los proveedores de mensajería incluye WhatsApp.

WhatsApp Business es una plataforma de mensajería que las empresas utilizan para comunicarse con los clientes de más de WhatsApp. La fuente WhatsApp transmite mensajes entrantes que sus clientes envían a su número de teléfono WhatsApp Business a Experience Platform en tiempo casi real.

Meta envía cada mensaje a un extremo de flujo continuo de Platform (un gancho web), donde se captura como un registro de evento de experiencia sin procesar y se agrega a un conjunto de datos en el lago de datos para su uso descendente. El conector incorpora la carga útil del gancho web sin procesar tal cual, por lo que se conservan todos los tipos de mensajes de WhatsApp.

Funcionamiento del conector how-it-works

El origen WhatsApp sigue esta secuencia para llevar un mensaje a Experience Platform:

  1. Un cliente envía un mensaje a su número de teléfono WhatsApp Business.
  2. Meta firma la carga útil del gancho web con el secreto de la aplicación (X-Hub-Signature-256) y la envía a la URL de devolución de llamada que configuró en el extremo de flujo continuo de Platform.
  3. Platform valida la firma, captura la carga útil sin procesar como un evento de experiencia y la agrega al conjunto de datos WhatsApp.

Requisitos previos prerequisites

Antes de crear una conexión de origen de WhatsApp, complete lo siguiente en Meta en developers.facebook.com:

  • Crea una aplicación Meta de tipo Empresa y agrégale el producto WhatsApp.
  • Crear una cuenta comercial (WABA) de WhatsApp con un número de teléfono registrado.
  • Asegúrese de que la aplicación tenga los permisos whatsapp_business_management y whatsapp_business_messaging.
  • En Configuración de la aplicación > Básico, copie el secreto de la aplicación. Meta utiliza el Secreto de la aplicación para firmar las cargas útiles de los ganchos web.
  • Elija un token de verificación. Puede ser cualquier cadena y es un secreto compartido que introduce tanto en Platform como en Meta.

En la tabla siguiente se describe dónde encontrar cada credencial y para qué se utiliza.

Credencial
¿Dónde se consigue?
Se usa para
Secreto de aplicación
Meta > Configuración de la aplicación > Básica
Validando la firma X-Hub-Signature-256 en cada webhook entrante.
Verificar token
Tú lo eliges
El protocolo de enlace de verificación único entre Meta y Platform.

Suscribir su aplicación a la WABA subscribe-app

Suscribe tu aplicación de Meta a la Cuenta Empresarial de WhatsApp para que Meta enrute los eventos de WABA a tu aplicación. Este paso es obligatorio y se produce completamente en Meta, pero la entrega solo comienza después de configurar la URL de devolución de llamada. Ver Conectar WhatsApp Business a Experience Platform.

IMPORTANT
Si omite este paso, los mensajes nunca se entregan y no se muestra ningún error en Platform. La falta de una suscripción WABA es la causa más común de problemas de "no se han introducido datos". Ver Solución de problemas.

Suscríbase a su aplicación mediante la API de Graph:

POST https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Verifique la suscripción con:

GET https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps

Ambas llamadas requieren un token con el permiso whatsapp_business_management y acceso al WABA. Reemplazar {VERSION} con una versión actual de la API de Graph, por ejemplo v21.0 o posterior.

Lo que aprovisiona el conector automáticamente automatic-provisioning

Cuando termina de crear un flujo de datos de WhatsApp, el conector crea y conecta las entidades siguientes. No seleccione un conjunto de datos de destinatario ni asigne campos personalmente.

Entidad
Nombre o identificador
Creado o reutilizado
Notas
Esquema
Eventos sin procesar de webhook de WhatsApp (clase XDM ExperienceEvent)
Se reutiliza si está presente; de lo contrario, se crea una vez por zona protegida
El primer flujo de datos WhatsApp de una zona protegida lo crea. Cada flujo de datos posterior reutiliza el mismo esquema.
Grupo de campo
Carga útil de webhook de WhatsApp V2
Reutilizado (estándar)
El conector hace referencia al grupo de campos estándar existente. Nunca crea uno.
Conjunto de datos
Eventos sin procesar de webhook de WhatsApp
Creado por flujo de datos
Conjunto de datos de evento de experiencia de aterrizaje sin procesar para los mensajes entrantes.
Asignación de campos
Generado por el sistema
Creado por flujo de datos
Asigna la carga útil del gancho web sin procesar al esquema y se conecta al flujo de datos como una transformación.
Extremo de streaming (entrada)
Apareció como URL de devolución de llamada
Creado por flujo de datos
Exige la validación de firmas de X-Hub-Signature-256 y el protocolo de enlace verify-token.
Conexión de destino (lago de datos)
Generado por el sistema
Creado por flujo de datos
Enruta los datos asignados al conjunto de datos.

Rotar secretos rotate-secrets

Puede cambiar el Secreto de la aplicación o Verificar token en cualquier momento al actualizar la conexión. Platform admite un secreto principal y uno secundario para que pueda mostrar el secreto de la aplicación sin tiempo de inactividad. Agregue el nuevo valor como secreto principal y mantenga el valor anterior como secreto secundario durante la transición. Al actualizar la conexión, se aplica el cambio a todos los flujos de datos que la utilizan.

Resolución de problemas troubleshooting

En la tabla siguiente se describen problemas comunes y cómo resolverlos.

Síntoma
Causa probable y corrección
Todo en Platform parece correcto, pero no se ingieren datos.
La aplicación no está suscrita a WABA. Complete la suscripción WABA descrita en Suscriba su aplicación al WABA. Esta es la causa más común y falla en silencio. Si la aplicación está suscrita, confirma que el Secreto de la aplicación en Platform coincide con el Secreto de la aplicación actual en Meta en Configuración de la aplicación > Básico.
“Verificar y guardar” produce un error en Meta.
El token de verificación de Meta debe coincidir exactamente con el token de verificación introducido en Platform.

Conectar WhatsApp a Experience Platform connect-to-platform

La siguiente documentación proporciona información sobre cómo crear un conector de flujo continuo WhatsApp para conectarse a Experience Platform mediante la interfaz de usuario:

Conectar WhatsApp a Experience Platform mediante la interfaz de usuario connect-to-platform-using-ui

Recursos adicionales additional-resources

recommendation-more-help
experience-platform-help-sources