En esta página: configura las credenciales de la API de WhatsApp, los webhooks y una configuración de canal para conectar tu cuenta de WhatsApp Business, de modo que tu entorno esté listo para enviar mensajes de WhatsApp con Journey Optimizer.
Antes de enviar tu mensaje de WhatsApp, debes configurar tu entorno de Adobe Journey Optimizer y asociarlo a tu cuenta de WhatsApp. Para realizar esto:
Estos pasos debe realizarlos un administrador del sistema de Adobe Journey Optimizer.
Crear credenciales de API de WhatsApp whatsapp-credentials
-
En el carril izquierdo, vaya a Administración
>Canales y seleccione el menú Credenciales de API. Haga clic en el botón Crear nuevas credenciales de API. -
Configure las credenciales de la API como se detalla a continuación:
- Token de API: escriba el token de API. Obtenga más información en Documentación de Meta
- ID de cuenta empresarial: escriba el número único relacionado con su portafolio empresarial. Obtenga más información en Documentación de Meta.
-
Haga clic en Continuar.
-
Elige la cuenta comercial de WhatsApp a la que deseas conectarte con tus credenciales de la API de WhatsApp.
-
Selecciona el nombre del remitente que se usa para enviar tus mensajes de WhatsApp.
-
La configuración de tu número de teléfono se completa automáticamente:
-
Clasificación de calidad: refleja los comentarios de los clientes sobre los mensajes enviados en las últimas 24 horas.
- Verde: alta calidad
- Amarillo: calidad Medium
- Rojo: baja calidad
Más información sobre Clasificación de calidad
-
Rendimiento: indica la velocidad a la que su número de teléfono puede enviar mensajes.
-
-
Haga clic en Enviar cuando termine de configurar las credenciales de la API.
Después de crear y configurar sus credenciales de API, ahora debe crear su webhook para mensajes de WhatsApp. Más información
Crear webhook WhatsApp-webhook
Una vez que tus credenciales de la API de WhatsApp se hayan creado correctamente, ahora puedes configurar Webhooks para:
- Capturar respuestas entrantes para administrar el consentimiento de inclusión y exclusión
- Recibir informes de envío, como confirmaciones de lectura (cuando están disponibles) y el estado de envío del mensaje
- Habilitar eventos de seguimiento para análisis e informes en conjuntos de datos de Adobe Experience Platform
Los webhooks actúan como el puente de comunicación entre WhatsApp Business Platform y Adobe Journey Optimizer de Meta, lo que le permite recibir notificaciones en tiempo real sobre eventos de mensajes e interacciones de usuarios.
Tenga en cuenta que Meta solo permite un webhook, una URL de llamada de retorno y un token de verificación, por cuenta comercial de WhatsApp, incluso en varias zonas protegidas o credenciales de WhatsApp. Los eventos de comentarios (Enviados, Entregados, Leídos, Errores, Clics en botones) se siguen capturando correctamente en cada zona protegida. Los eventos entrantes (respuestas, palabras clave de inclusión/exclusión/ayuda) solo se reciben en la única zona protegida en la que está registrado el gancho web. Regístrela en la zona protegida de producción para recibir eventos entrantes allí.
-
En el carril izquierdo, vaya a Administración
>Canales, seleccione el menú Webhooks de WhatsApp en Configuración de WhatsApp y haga clic en el botón Crear webhook.
-
Escribe un Nombre para tu webhook.
-
En el menú desplegable Seleccionar configuración, seleccione las Credenciales de API que creó anteriormente.
-
Elija su categoría de palabras clave de entrada, como:
- Palabras clave de inclusión
- Palabras clave de exclusión
- Palabras clave de ayuda
- Predeterminado - Categoría de reserva para todos los mensajes entrantes que no coincidan con otras palabras clave. Utilice esta categoría para habilitar el seguimiento de eventos (aperturas, informes de envío) en conjuntos de datos de Adobe Experience Platform.
-
Escriba sus palabras clave y haga clic en
-
En el campo Mensaje de respuesta, escriba el mensaje enviado cuando reciba una palabra clave configurada o seleccione una opción predefinida en el menú desplegable.
-
Haga clic en
-
Haz clic en Enviar cuando hayas terminado la configuración de tu webhook de WhatsApp.
-
En el menú de Webhooks, haz clic en el
-
Para modificar la configuración existente y acceder a tu URL de webhook o Herramienta de verificación de webhook, localiza el webhook deseado y haz clic en la opción Editar para realizar los cambios necesarios.
-
Copie la Herramienta de verificación de webhook que se generó aquí y péguela en la interfaz de Meta como parte de la configuración de webhook.
Para obtener instrucciones detalladas sobre cómo y dónde agregar este token de verificación, consulte Documentación de Meta.
-
Accede y copia tu nueva URL de webhook desde tu webhook de WhatsApp enviado anteriormente.
Ahora que tu webhook está configurado, puedes crear tu configuración de WhatsApp.
Crear configuración de WhatsApp whatsapp-configuration
-
En el carril izquierdo, vaya a Administración > Canales y seleccione Configuración general > Configuraciones de canal. Haga clic en el botón Crear configuración de canal.
-
Introduzca un nombre y una descripción (opcional) para la configuración y, a continuación, seleccione el canal de WhatsApp.
note NOTE Los nombres deben comenzar por una letra (A-Z). Solo puede contener caracteres alfanuméricos. También puede utilizar caracteres de guion bajo _, punto.y guion-. -
Seleccione WhatsApp como su canal.
-
Seleccione Acciones de marketing para asociar directivas de consentimiento a los mensajes que usan esta configuración. Todas las políticas de consentimiento asociadas con la acción de marketing se aprovechan para respetar las preferencias de los clientes. Más información
-
En la sección Configuración de WhatsApp, selecciona la configuración de WhatsApp creada anteriormente.
-
Escriba el número de teléfono del remitente que desea usar para sus comunicaciones. No incluya un signo “+” antes del número, ya que esto puede impedir que el flujo de exclusión funcione correctamente.
-
Use el Campo de ejecución de WhatsApp para seleccionar entre los atributos de perfil el número de teléfono que desea usar como prioridad si hay varios números disponibles en la base de datos. Más información
note NOTE De manera predeterminada, Journey Optimizer usa el número de teléfono especificado en configuración general en el nivel de espacio aislado. Al actualizar este campo, se anula el valor predeterminado de los recorridos y campañas que utilizan esta configuración. -
Una vez configurados todos los parámetros, haga clic en Enviar para confirmar. También puede guardar la configuración de canal como borrador y reanudarla más adelante.
-
Una vez creada la configuración del canal, se muestra en la lista con el estado Procesando.
note NOTE Si las comprobaciones no se realizan correctamente, obtenga más información sobre los posibles motivos de error en esta sección. -
Una vez que las comprobaciones son correctas, la configuración del canal obtiene el estado Activo. Está listo para utilizarse para enviar mensajes.
Una vez configuradas, puede aprovechar todas las funcionalidades de canal integradas, como la creación de mensajes, la personalización, el seguimiento de vínculos y la creación de informes.
Ya estás listo para enviar mensajes de WhatsApp con Journey Optimizer.
Solucionar problemas de configuración de canales de WhatsApp troubleshooting
Errores HTTP 500 durante la configuración de credenciales de API
Si se produce un error HTTP 500 al configurar las credenciales de la API de WhatsApp, siga estos pasos para solucionar problemas:
-
Verificar derechos: Confirme que su organización tiene el derecho
cjm_whatsappaprovisionado. Sin este derecho, el canal de WhatsApp no se puede configurar. -
Validar campos de cuenta empresarial: Asegúrese de que todos los campos obligatorios estén correctamente rellenados:
- Token de API: debe ser un token de acceso de Meta válido con los permisos apropiados. Más información
- ID de cuenta empresarial: debe coincidir exactamente con su ID de cuenta empresarial de Meta. Más información
-
Probar credenciales externamente: compruebe sus credenciales directamente con la API de Meta para confirmar si el problema se debe a las credenciales o a la administración de credenciales de Journey Optimizer.
-
Habilitar el registro avanzado: Para identificar errores de configuración del servidor o la autenticación internos, habilite los registros avanzados en su entorno de Journey Optimizer para proporcionar información detallada sobre los errores de las llamadas de API.
-
Póngase en contacto con el soporte técnico: Si el entorno y los derechos se confirman válidos, pero el error HTTP 500 persiste, póngase en contacto con el representante de Adobe.
Vídeo práctico video
El siguiente vídeo muestra cómo configurar el canal de WhatsApp en Adobe Journey Optimizer.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how a System Administrator configures the WhatsApp channel in Journey Optimizer by creating WhatsApp API credentials, a Webhook, and a channel configuration to connect a WhatsApp Business account.
Intents:
- Create WhatsApp API credentials and connect a WhatsApp Business Account
- Create a WhatsApp Webhook to capture inbound responses, receive delivery reports, and enable tracking events
- Create a WhatsApp channel configuration and associate marketing actions and consent policies
- Set the sender phone number and WhatsApp Execution Field for a configuration
- Troubleshoot HTTP 500 errors during API credential setup
Glossary:
- API Credentials: The credential set (API Token and Business Account ID) used to connect Journey Optimizer to a WhatsApp Business Account (product-specific)
- API Token: A Meta access token from a System User in the same Business Manager as your WhatsApp assets, used to authenticate (product-specific)
- Business Account ID: Your Meta Business portfolio ID (Business Manager ID), not the WhatsApp Business Account ID (product-specific)
- Webhook: The communication bridge between Meta’s WhatsApp Business Platform and Journey Optimizer that receives real-time notifications about message events and user interactions (product-specific)
- Inbound keyword category: The classification (Opt-in, Opt-out, Help, Default) that determines which auto-response is sent based on user text (product-specific)
- WhatsApp Execution Field: The field used to select, among profile attributes, the phone number to use in priority when several numbers are available (product-specific)
- Quality Rating: A rating (Green/High, Yellow/Medium, Red/Low) reflecting customer feedback on messages sent in the past 24 hours (product-specific)
- Throughput: The rate at which your phone number can send messages (product-specific)
Guardrails:
- These steps must be performed by a Journey Optimizer System Administrator.
- Meta tokens expire after about 60 days; renew the token before it lapses.
- The API Token’s System User needs whatsapp_business_management, whatsapp_business_messaging, and business_management permissions, plus asset-level access to your WhatsApp Business Account.
- Meta allows only one webhook, callback URL, and Verify Token per WhatsApp Business Account, even across multiple sandboxes or WhatsApp credentials.
- Feedback events (Sent, Delivered, Read, Error, button click) are captured correctly in every sandbox, but inbound events (replies, opt-in/opt-out/help keywords) are only received in the single sandbox where the webhook is registered; register it against your production sandbox to receive inbound events there.
- Without specified opt-in or opt-out keywords, standard consent messages are not enabled.
- A profile must have at least one message sent from Journey Optimizer before incoming messages are captured in the dataset.
- Keywords are not case-sensitive (e.g., stop and STOP are treated the same).
- Configuration names must begin with a letter (A-Z), can only contain alpha-numeric characters, and may also use underscore, dot, and hyphen.
- Do not include a ‘+’ sign before the sender phone number, as this can prevent the opt-out flow from working correctly.
- HTTP 500 troubleshooting: the organization must have the
cjm_whatsappentitlement provisioned; without it, the WhatsApp channel cannot be configured.
Terminology:
- Canonical name: WhatsApp channel configuration — Acronym: n/a — variants: channel configuration, WhatsApp configuration
- Synonyms: “Business Account ID” = “Meta Business portfolio ID” = “Business Manager ID”
- Do not confuse: “Business Account ID” (Meta Business portfolio / Business Manager ID) ≠ “WhatsApp Business Account ID” (not entered in this field)
- Do not confuse: “API Credentials” ≠ “Webhook” ≠ “channel configuration” (three distinct setup steps)
- Do not confuse: “Processing” (status while checks run) ≠ “Active” (status once checks are successful and the configuration is ready to deliver)
FAQ:
- Q: What are the steps to configure the WhatsApp channel? — Create WhatsApp API credentials, create a WhatsApp Webhook, then create a WhatsApp channel configuration.
- Q: Who can configure the WhatsApp channel? — A Journey Optimizer System Administrator.
- Q: How often do Meta tokens expire? — About every 60 days; renew the token before it lapses.
- Q: Why are my inbound events missing in some sandboxes? — Meta allows only one webhook per WhatsApp Business Account, so inbound events are only received in the sandbox where the webhook is registered; register it against your production sandbox.
- Q: What does the channel configuration status mean? — It shows Processing while checks run and becomes Active once checks are successful, meaning it is ready to deliver messages.
- Q: What causes an HTTP 500 error during API credential setup? — Possible causes include a missing
cjm_whatsappentitlement, invalid or mismatched API Token or Business Account ID, or credential handling issues; verify entitlements and fields, test credentials with Meta, enable advanced logging, and contact support if it persists. - Q: Why should I not add a ‘+’ before the sender phone number? — It can prevent the opt-out flow from working correctly.