DocumentationJourney OptimizerGuide de Journey Optimizer

[Disponibilité limitée]{class="badge informative"}

Configurer un canal personnalisé create-custom-channel

Dernière mise à jour : 16 juillet 2026

Créé pour :

  • Experienced
  • Admin

Pour pouvoir utiliser un canal personnalisé dans les campagnes et les parcours, un administrateur doit d’abord le créer. Cela implique de définir le point d’entrée, l’authentification, la politique de limitation et la structure de la payload du message.

La section Créateur de canaux est l’interface centrale pour définir de nouveaux canaux personnalisés. Il vous permet de créer et de configurer des canaux personnalisés, mais aussi de gérer les informations d’identification d’API et de déléguer des sous-domaines.

IMPORTANT
Pour accéder au Créateur de canaux, créer et gérer des canaux personnalisés, vous devez disposer des autorisations Afficher les canaux personnalisés et Gérer les canaux personnalisés accordées. Découvrez comment gérer les autorisations dans ​ cette section ​.

Accéder aux canaux personnalisés et les gérer access-channel-builder

Pour accéder au Créateur de canaux et gérer vos canaux personnalisés, procédez comme suit.

  1. Accédez à Administration > Canaux dans le rail de navigation de gauche.

  2. Sélectionnez Canaux personnalisés sous la section Créateur de canaux.

    Inventaire des canaux personnalisés {width="70%"}

  3. L’inventaire répertorie tous les canaux personnalisés de votre sandbox, y compris leur statut actuel et le type d’authentification utilisé pour se connecter au point d’entrée externe.

  4. Vous pouvez filtrer les canaux personnalisés par statut (Brouillon, Actif ou Archivé), par auteur et par nom.

  5. Pour modifier un canal, cliquez sur son nom dans l’inventaire, apportez vos modifications et enregistrez-le. Pour les canaux actifs, vous ne pouvez modifier que certains champs. En ​ plus.

    note caution
    CAUTION
    La modification des paramètres de limitation ou de reprise sur un canal actif prend effet immédiatement pour toutes les exécutions en cours et futures.

  6. Pour archiver un canal, ouvrez-le dans l’inventaire et cliquez sur Archiver.

    L’archivage d’un canal actif le supprime de toutes les listes déroulantes de sélection : sélecteur d’actions de campagne, palette d’actions de parcours, liste de canaux des campagnes orchestrées, configurations de canal et modèles de contenu. Les parcours et campagnes existants qui utilisent déjà le canal continuent à fonctionner normalement.

Création d’un canal personnalisé create-channel

Pour créer un canal personnalisé, procédez comme suit.

  1. Cliquez sur le bouton Créer un canal personnalisé pour ouvrir le formulaire de création de canal. Commencez par définir les paramètres généraux de votre canal personnalisé.

    ​ Paramètres généraux ​ {width="70%"}

  2. Dans la section Propriétés , saisissez un Nom pour votre canal personnalisé. Ce nom apparaît dans la zone de travail des parcours, le sélecteur d’actions de campagne et la liste des canaux des campagnes orchestrées.

    note
    NOTE
    Le nom doit être unique, commencer par une lettre (A-Z), inclure uniquement des caractères alphanumériques ou spéciaux ( _, ., -) et doit comporter plus de 1 caractère.

  3. Vous pouvez sélectionner une icône dans la bibliothèque d’icônes par défaut ou sélectionner un fichier SVG sur votre ordinateur.

    note
    NOTE
    La taille du fichier ne doit pas dépasser 150KB.

    Cette icône s’affiche en regard du nom du canal dans la zone de travail de parcours. Si aucune icône n’est chargée, l’icône par défaut est utilisée.

  4. Saisissez une Description facultative.

Définir la configuration du point d’entrée endpoint-configuration

Vous devez configurer le point d’entrée , qui est l’URL HTTP de votre système de messagerie externe. Journey Optimizer envoie une requête POST à ce point d’entrée avec la payload personnalisée lorsqu’un profil est qualifié dans une campagne ou un parcours.

Configuration du point d’entrée {width="70%"}

  1. Dans la section Configuration du point d’entrée, saisissez l’hôte URL de votre système de messagerie externe.

    note important
    IMPORTANT
    Votre système de messagerie externe doit exposer un point d’entrée HTTPS que Journey Optimizer pouvez appeler via HTTP POST. Le point d’entrée doit :
    • Acceptez le format de payload défini par votre canal (JSON).
    • Prend en charge l’une des méthodes d’authentification disponibles dans le créateur de canaux. En savoir plus
    • Renvoyer une réponse HTTP 2xx pour accuser réception de la requête.

  2. Ajoutez des en-têtes si nécessaire. Les en-têtes sont des paires clé-valeur transmises au niveau de la requête HTTP. Ils sont envoyés avec chaque requête à votre point d’entrée et sont généralement utilisés pour les jetons d’authentification, la spécification du type de contenu ou toute autre métadonnée requise par votre système externe.

    ​ Configuration des en-têtes ​

    Pour chaque en-tête, vous pouvez définir si sa valeur est :

    • Constant - Une valeur statique définie une fois et incluse dans chaque requête. Par exemple, vous pouvez définir le paramètre Content-Type avec la valeur application/json ou le paramètre Charset avec la valeur UTF-8.
    • Variable - Si une valeur par défaut est saisie ici, elle est utilisée, sauf si elle est remplacée dans la configuration du canal. Par exemple, vous pouvez définir une variable pour l’ID utilisateur qui est résolue au moment de l’exécution. En savoir plus

  3. Vous pouvez éventuellement ajouter des paramètres de requête en utilisant le même modèle de constante/variable. Les paramètres de requête sont ajoutés à l’URL du point d’entrée au moment de la diffusion. Les paramètres constants sont toujours ajoutés avec la même valeur ; les paramètres variables sont résolus au moment de l’envoi, par exemple pour transmettre un identifiant utilisateur du profil.

    Paramètres de requête {width="70%"}

  4. Dans la section Configuration de la politique, définissez comment Journey Optimizer gère le débit et les échecs des requêtes. Cela est important pour vous assurer que votre système externe peut gérer le volume de requêtes et éviter de le surcharger.

    Configuration de la politique

    • Activer le ralentissement - Désactivé par défaut. Définissez le nombre maximal de requêtes par seconde (par défaut : 5 000 c). Une fois la limite atteinte, les requêtes sont mises en file d’attente et envoyées dès que possible.
    • Activer la reprise - Activé par défaut. Définissez le nombre maximal de reprises (valeur par défaut : 3, plage configurable : 0-10) pour les requêtes ayant échoué. Cela permet d’éviter de surcharger le point d’entrée lors d’échecs transitoires.
    • Délai d’expiration - Valeur par défaut : 5 000 millisecondes. Définissez la durée maximale d’attente d’une réponse du point d’entrée avant de considérer que la requête a échoué.

Paramètres d’authentification authentication-settings

Sélectionnez le Type d’authentification que vous devez utiliser pour ce canal. Les options disponibles dépendent des méthodes d’authentification prises en charge par votre système de messagerie externe.

Type d’authentification {width="70%"}

Fournissez les détails d’authentification requis par le point d’entrée.

  • Aucune - La requête est envoyée sans informations d’identification.
  • Clé API - Indiquez le nom, la valeur et l’emplacement de la clé (paramètre de requête ou en-tête).
  • Authentification de base - Indiquez un nom d’utilisateur et un mot de passe.
  • OAuth 2.0 - Configurez la payload pour l’authentification OAuth 2.0.

Lorsque le type d’authentification est autre chose que Aucun, Journey Optimizer génère automatiquement un jeu initial d’informations d’identification d’API pour ce canal lorsqu’il est activé. Vous pouvez modifier ces informations d’identification et en créer de nouvelles dans l’inventaire des informations d’identification de l’API. En savoir plus

Toutefois, les détails d’authentification sont nécessaires ici pour tester la connexion à votre point d’entrée avant d’activer le canal. Un bouton Tester la connexion est disponible pour valider la configuration de l’authentification. En savoir plus

Configuration de la payload payload-configuration

La payload est envoyée au point d’entrée lorsqu’un profil est qualifié dans une campagne ou un parcours.

Dans la configuration de la payload, définissez la structure de la payload du message et les champs que les marketeurs peuvent créer et personnaliser.

  1. Cliquez sur Définir la payload et choisissez comment la définir :

    • Coller un exemple de payload JSON - Collez un objet JSON représentatif et Journey Optimizer en déduit automatiquement un schéma.

    • Importer un schéma JSON (bientôt disponible) - Téléchargez un fichier de schéma JSON complet.

      note availability
      AVAILABILITY
      Cette fonctionnalité n’est pas encore disponible. Elle sera ajoutée dans une version ultérieure.

  2. Une fois le schéma généré, Journey Optimizer affiche tous les champs détectés dans une vue de formulaire.

  3. Pour chaque champ, configurez les paramètres suivants :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Paramètre Description
    Valeur par défaut Facultatif. Utilisé si aucune valeur personnalisée n’est fournie au moment de la création.
    Type Lecture seule, dérivée de la payload. Types pris en charge : string, integer, decimal, boolean, dateTime, dateTimeOnly, dateOnly, listObject, listString, listInteger, listDecimal, listBoolean, listDateTime, listDateTimeOnly, listDateOnly,.
    Obligatoire Si cette option est activée, le champ doit avoir une valeur lorsque le canal est utilisé dans une campagne ou un parcours. Les champs obligatoires manquants déclenchent une erreur de validation qui empêche l’activation.
    Configuration du canal Si cette option est activée, le champ s’affiche dans la configuration du canal, ce qui permet aux administrateurs de définir des valeurs différentes par configuration (par exemple, un identifiant d’expéditeur différent par marque ou région). Voici comment procéder

    Les champs imbriqués sont représentés à l’aide de la notation par points (par exemple, image.id).

Tester et activer test-activate

Lorsque le canal a le statut Brouillon, utilisez le bouton Tester la connexion en haut de l’écran pour envoyer une requête de test à votre point d’entrée et valider la connexion de bout en bout.

Bouton Tester la connexion {width="70%"}

Vérifiez les journaux de votre système externe pour vous assurer que la demande a été reçue avec l’authentification et la payload attendues.

Une fois le test réussi, vous pouvez enregistrer ou activer le canal.

  • Cliquez sur Enregistrer en tant que brouillon pour enregistrer votre progression sans rendre le canal disponible.
  • Cliquez sur Activer pour rendre le canal disponible pour une utilisation dans les configurations de canal, les campagnes et les parcours.
IMPORTANT
Une fois qu’un canal est activé, seuls les champs suivants restent modifiables : nom, description, icône, limitation et configuration de la reprise. L’URL du point d’entrée, les en-têtes, les paramètres de requête, l’authentification et la structure de payload sont verrouillés.

Étapes suivantes next-steps

Votre canal personnalisé est maintenant créé. Effectuez la configuration en suivant les étapes restantes :

recommendation-more-help
journey-optimizer-help