DocumentaciónJourney OptimizerGuía de Journey Optimizer

[Disponibilidad limitada]{class="badge informative"}

Configuración de un canal personalizado create-custom-channel

Última actualización: 16 de julio de 2026

Creado para:

  • Experienced
  • Admin

Para poder utilizar un canal personalizado en campañas y recorridos, un administrador debe crear primero el canal. Esto implica definir el punto de conexión, la autenticación, la política de regulación y la estructura de carga útil de mensajes.

La sección Generador de canales es la interfaz central para definir nuevos canales personalizados. Le permite crear y configurar canales personalizados, pero también administrar credenciales de API y delegar subdominios.

IMPORTANT
Para acceder al Generador de canales, crear y administrar canales personalizados, debes tener concedidos los permisos de Ver canales personalizados y Administrar canales personalizados. Obtenga información sobre cómo administrar permisos en esta sección.

Acceso y administración de canales personalizados access-channel-builder

Para acceder al Generador de canales y administrar tus canales personalizados, sigue los pasos a continuación.

  1. Vaya a Administración > Canales en el carril de navegación izquierdo.

  2. Seleccione Canales personalizados en la sección Generador de canales.

    Inventario de canales personalizados {width="70%"}

  3. El inventario enumera todos los canales personalizados de la zona protegida, incluido su estado actual y el tipo de autenticación utilizado para conectarse al extremo externo.

  4. Puede filtrar los canales personalizados por estado (Borrador, Activo o Archivado), quién los creó y buscar por nombre.

  5. Para editar un canal, haga clic en su nombre en el inventario, realice los cambios y guarde los cambios. Para los canales activos, solamente puede editar ciertos campos: más información.

    note caution
    CAUTION
    La modificación de la configuración de restricción o reintento en un canal activo surte efecto inmediatamente para todas las ejecuciones en curso y futuras.

  6. Para archivar un canal, ábralo desde el inventario y haga clic en Archivar.

    El archivado de un canal activo lo elimina de todos los desplegables de selección: selector de acciones de campaña, paleta de acciones de recorrido, lista de canales de campañas orquestadas, configuraciones de canal y plantillas de contenido. Los recorridos y campañas existentes que ya usan el canal siguen funcionando normalmente.

Crear un canal personalizado create-channel

Para crear un nuevo canal personalizado, siga los pasos a continuación.

  1. Haga clic en el botón Crear canal personalizado para abrir el formulario de creación de canales. Comience por definir la configuración general del canal personalizado.

    Configuración general {width="70%"}

  2. En la sección Propiedades, escribe un Nombre para tu canal personalizado. Este nombre aparecerá en el lienzo de recorridos, en el selector de acciones de campaña y en la lista de canales de campañas orquestadas.

    note
    NOTE
    El nombre debe ser único, comenzar por una letra (A-Z), incluir solo caracteres alfanuméricos o caracteres especiales ( _, ., -) y debe ser mayor que 1 carácter.

  3. Puede seleccionar un icono de la biblioteca de iconos predeterminada o seleccionar un archivo SVG del equipo.

    note
    NOTE
    El archivo no debe superar los 150 KB.

    Este icono se muestra junto al nombre del canal en el lienzo de recorrido. Si no se carga ningún icono, se utiliza el icono predeterminado.

  4. Escriba una descripción opcional.

Establecer la configuración del extremo endpoint-configuration

Debe configurar el punto de conexión, que es la URL HTTP del sistema de mensajería externo. Journey Optimizer envía una petición POST a este extremo con la carga útil personalizada cuando un perfil cumple los requisitos de una campaña o recorrido.

Configuración del extremo {width="70%"}

  1. En la sección Configuración de extremo, escriba la URL de host de su sistema de mensajería externo.

    note important
    IMPORTANT
    El sistema de mensajería externa debe exponer un extremo HTTPS al que Journey Optimizer puede llamar a través de HTTP POST. El punto final debe:
    • Acepte el formato de carga útil que define su canal (JSON).
    • Admitir uno de los métodos de autenticación disponibles en el Generador de canales. Más información
    • Devuelva una respuesta HTTP 2xx para confirmar que la solicitud se ha recibido correctamente.

  2. Agregue Encabezados según sea necesario. Los encabezados son pares de clave-valor que se transmiten en el nivel de solicitud HTTP. Se envían junto con cada solicitud al extremo y se utilizan generalmente para tokens de autenticación, especificación de tipo de contenido o cualquier otro metadato requerido por el sistema externo.

    Configuración de encabezados

    Para cada encabezado, puede definir si su valor es:

    • Constante: valor estático establecido una vez e incluido en cada solicitud. Por ejemplo, puede definir el parámetro Content-Typecon el valor application/json o el parámetro Charset con el valor UTF-8.
    • Variable: si se escribe un valor predeterminado aquí, se usa a menos que se anule en la configuración del canal. Por ejemplo, puede definir una variable para el ID de usuario que se resuelve durante la ejecución. Más información

  3. Opcionalmente, agregue parámetros de consulta utilizando el mismo patrón constante/variable. Los parámetros de consulta se anexan a la dirección URL del punto de conexión en el momento de la entrega. Los parámetros constantes siempre se añaden con el mismo valor; los parámetros variables se resuelven en el momento del envío, por ejemplo para pasar un identificador de usuario desde el perfil.

    Parámetros de consulta {width="70%"}

  4. En la sección Configuración de directiva, defina cómo Journey Optimizer administra el rendimiento de las solicitudes y los errores. Esto es importante para garantizar que el sistema externo pueda gestionar el volumen de solicitudes y evitar saturarlo.

    Configuración de directiva

    • Habilitar regulación - Deshabilitado de forma predeterminada. Establezca el número máximo de solicitudes por segundo (predeterminado: 5,000c). Una vez alcanzado el límite, las solicitudes se ponen en cola y se envían lo antes posible.
    • Habilitar reintento - Habilitado de forma predeterminada. Establezca el número máximo de reintentos (predeterminado: 3, intervalo configurable: 0-10) para las solicitudes con errores. Esto ayuda a evitar saturar el extremo durante errores transitorios.
    • Tiempo de espera - Predeterminado: 5.000 milisegundos. Establezca el tiempo máximo de espera para una respuesta del extremo antes de considerar que la solicitud ha fallado.

Configuración de autenticación authentication-settings

Seleccione el tipo de autenticación que necesita usar para este canal. Las opciones disponibles dependen de los métodos de autenticación admitidos por el sistema de mensajería externo.

Tipo de autenticación {width="70%"}

Proporcione los detalles de autenticación según lo requiera el punto de conexión.

  • Ninguno - La solicitud se envía sin credenciales.
  • Clave API: proporcione el nombre de clave, el valor y la ubicación (parámetro de consulta o encabezado).
  • Autenticación básica - Proporcione un nombre de usuario y una contraseña.
  • OAuth 2.0: configure la carga para la autenticación OAuth 2.0.

Cuando el tipo de autenticación es cualquier otro que None, Journey Optimizer genera automáticamente un conjunto inicial de credenciales de API para este canal cuando se activa. Puede cambiar estas credenciales y crear otras nuevas en el inventario de credenciales de API. Más información

Sin embargo, los detalles de autenticación son necesarios aquí para probar la conexión con el punto de conexión antes de activar el canal. Hay disponible un botón Probar conexión para validar la configuración de autenticación. Más información

Configuración de carga útil payload-configuration

La carga útil se envía al extremo cuando un perfil cumple los requisitos de una campaña o recorrido.

En la configuración de carga útil, defina la estructura de la carga útil del mensaje y los campos que los especialistas en marketing pueden crear y personalizar.

  1. Haga clic en Definir carga útil y elija cómo definir la carga útil:

    • Pegar carga útil JSON de muestra: pegue un objeto JSON representativo y Journey Optimizer infiere automáticamente un esquema de él.

    • Importar esquema JSON (próximamente): cargue un archivo de esquema JSON completo.

      note availability
      AVAILABILITY
      Esta capacidad aún no está disponible. Se añadirá en una versión futura.

  2. Una vez generado el esquema, Journey Optimizer muestra todos los campos detectados en una vista de formulario.

  3. Para cada campo, configure las siguientes opciones:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Configuración Descripción
    Valor predeterminado Opcional. Se utiliza si no se proporciona ningún valor personalizado en el momento de la creación.
    Tipo De solo lectura, derivado de la carga útil. Tipos admitidos: string, integer, decimal, boolean, dateTime, dateTimeOnly, dateOnly, listObject, listString, listInteger, listDecimal, listBoolean, listDateTime, listDateTimeOnly, listDateOnly.
    Requerido Si se habilita, el campo debe tener un valor cuando el canal se utilice en una campaña o recorrido. La falta de campos obligatorios déclencheur un error de validación que impide la activación.
    Configuración de canal Si está activado, el campo aparece en la configuración del canal, lo que permite a los administradores definir diferentes valores por configuración (por ejemplo, un ID de remitente diferente por marca o región). Descubra cómo

    Los campos anidados se representan con notación de puntos (por ejemplo, image.id).

Prueba y activación test-activate

Mientras el canal se encuentra en estado Borrador, use el botón Probar conexión en la parte superior de la pantalla para enviar una solicitud de prueba al extremo y validar la conexión de extremo a extremo.

Botón de conexión de prueba {width="70%"}

Compruebe los registros del sistema externo para confirmar que la solicitud se recibió con la autenticación y la carga útil esperadas.

Una vez realizada la prueba, puede guardar o activar el canal.

  • Haga clic en Guardar como borrador para guardar el progreso sin que el canal esté disponible.
  • Haga clic en Activar para que el canal esté disponible para su uso en configuraciones de canal, campañas y recorridos.
IMPORTANT
Una vez activado un canal, solo permanecen editables los siguientes campos: nombre, descripción, icono, regulación y configuración de reintento. La dirección URL de extremo, los encabezados, los parámetros de consulta, la autenticación y la estructura de carga útil están bloqueados.

Próximos pasos next-steps

Se creará el canal personalizado. Complete la configuración siguiendo los pasos restantes:

recommendation-more-help
journey-optimizer-help