Configurer un fournisseur personnalisé sms-configuration-custom
Cette fonctionnalité vous permet d’intégrer et de configurer vos propres fournisseurs de messagerie, offrant ainsi une flexibilité qui va au-delà des options disponibles par défaut (Sinch, Twilio et Infobip). Cela permet une création, une diffusion, des rapports et une gestion du consentement transparents pour les messages SMS et RCS.
En configurant un fournisseur personnalisé, vous pouvez connecter des services de messagerie tiers directement dans Journey Optimizer, personnaliser les payloads des messages pour du contenu dynamique et gérer les préférences d’opt-in/opt-out pour assurer la conformité sur les canaux SMS et RCS.
Pour configurer votre fournisseur personnalisé, procédez comme suit :
Créer vos informations d’identification d’API api-credential
Pour envoyer des SMS et des messages RCS dans Journey Optimizer à l’aide d’un fournisseur personnalisé non disponible par défaut chez Adobe (par exemple, Sinch, Infobip, Twilio), procédez comme suit :
-
Dans le rail de gauche, accédez à Administration
>Canaux, sélectionnez le menu Informations d’identification d’API sous Paramètres SMS, puis cliquez sur le bouton Créer de nouvelles informations d’identification d’API.
-
Configurez les informations d’identification pour l’API SMS, comme indiqué ci-dessous :
-
Fournisseur de SMS : personnalisé.
-
Nom : saisissez un nom pour les informations d’identification d’API.
-
AppId du fournisseur : saisissez l’ID de l’application fourni par votre fournisseur de SMS.
-
Nom du fournisseur : saisissez le nom du fournisseur de SMS.
-
URL du fournisseur : saisissez l’URL du fournisseur de SMS.
-
Type d’authentification : sélectionnez le type d’autorisation et renseignez les champs correspondants en fonction de la méthode d’authentification choisie.
-
-
Dans la section En-têtes, cliquez sur Ajouter un nouveau paramètre pour définir les en-têtes HTTP du message de requête à envoyer au service externe.
Les champs d’en-tête Content-Type et Charset sont définis par défaut et ne peuvent pas être supprimés.
-
Ajoutez la payload du fournisseur pour valider et personnaliser les payloads de votre requête.
Pour les messages RCS, cette payload est ensuite utilisée lors de la conception du contenu.
-
Cliquez sur Envoyer lorsque vous avez terminé la configuration de vos informations d’identification d’API.
-
Dans le menu Informations d’identification d’API, cliquez sur l’
-
Pour modifier les informations d’identification existantes, recherchez les informations d’identification d’API souhaitées et cliquez sur l’option Modifier pour apporter les modifications nécessaires.
-
Cliquez sur Vérifier la connexion SMS, à partir de vos informations d’identification d’API existantes, pour tester et vérifier vos informations d’identification d’API SMS en envoyant un exemple de message à un appareil désigné.
-
Renseignez les champs Numéro et Message, puis cliquez sur Vérifier la connexion.
note important IMPORTANT Le message doit être structuré de manière à s’aligner sur le format de payload du fournisseur. 
Une fois vos informations d’identification d’API créées et configurées, vous devez configurer les paramètres entrants du webhook pour les SMS.
Options d’authentification pour les fournisseurs de SMS personnalisés auth-options
Une fois vos informations d’identification d’API créées, renseignez les champs obligatoires relatifs à l’authentification par clé API :
- Nom : saisissez un nom pour votre configuration de clé d’API.
- Jeton API : saisissez le jeton API fourni par votre fournisseur de SMS.
Une fois vos informations d’identification d’API créées, renseignez les champs obligatoires relatifs à l’authentification MAC :
- Nom : saisissez un nom pour votre configuration d’authentification MAC.
- Jeton API : saisissez le jeton API fourni par votre fournisseur de SMS.
- Clé secrète d’API : saisissez la clé secrète d’API fournie par votre fournisseur de SMS. Cette clé est utilisée pour générer la balise MAC (code d’authentification de message) pour une communication sécurisée.
- Format de hachage d’autorisation Mac : sélectionnez le format de hachage pour l’authentification MAC.
Une fois vos informations d’identification d’API créées, renseignez les champs obligatoires relatifs à l’authentification OAuth :
-
Nom : saisissez un nom pour votre configuration d’authentification OAuth.
-
Jeton API : saisissez le jeton API fourni par votre fournisseur de SMS.
-
URL OAuth : saisissez l’URL permettant d’obtenir le jeton OAuth.
-
Corps OAuth : indiquez le corps de la requête OAuth au format JSON, y compris les paramètres tels que
grant_type,client_idetclient_secret.
Une fois vos informations d’identification d’API créées, renseignez les champs obligatoires relatifs à l’authentification JWT :
-
Nom : saisissez un nom pour votre configuration d’authentification JWT.
-
Jeton API : saisissez le jeton API fourni par votre fournisseur de SMS.
-
Payload JWT : saisissez la payload JSON contenant les revendications requises pour JWT, telles que l’émetteur, l’objet, l’audience et l’expiration.
Créer un webhook webhook
Si les mots-clés relatifs à l’opt-in ou à l’opt-out ne sont pas fournis, des messages de consentement standard sont utilisés pour respecter la confidentialité des personnes. L’ajout de mots-clés personnalisés remplace automatiquement les valeurs par défaut.
Mots-clés par défaut :
- Opt-in : SUBSCRIBE (s’abonner), YES (oui), UNSTOP (redémarrer), START (démarrer), CONTINUE (continuer), RESUME (reprendre), BEGIN (commencer).
- Opt-out : STOP (arrêter), QUIT (quitter), CANCEL (annuler), END (terminer), UNSUBSCRIBE (se désabonner), NO (non).
- Aide : HELP (aide).
Une fois vos informations d’identification d’API créées, l’étape suivante consiste à créer un webhook et à configurer vos paramètres entrants. Cette configuration garantit que votre système peut recevoir et traiter correctement les données ou messages entrants.
-
Dans le rail de gauche, accédez à Administration
>Canaux, sélectionnez le menu Webhooks SMS sous Paramètres SMS, puis cliquez sur le bouton Créer un webhook.
-
Configurez vos paramètres de webhook comme indiqué ci-dessous :
-
Nom : saisissez un nom pour votre webhook.
-
Sélectionner le fournisseur de SMS : personnalisé.
-
Sélectionner les informations d’identification d’API : choisissez dans la liste déroulante les informations d’identification d’API configurées précédemment.
-
Mots-clés d’opt-in : saisissez les mots-clés par défaut ou personnalisés qui déclencheront automatiquement votre message d’opt-in. Pour plusieurs mots-clés, utilisez des valeurs séparées par des virgules.
-
Message d’opt-in : saisissez la réponse personnalisée qui est automatiquement envoyée en tant que message d’opt-in.
-
Mots-clés d’opt-out : saisissez les mots-clés par défaut ou personnalisés qui déclencheront automatiquement votre message d’opt-out. Pour plusieurs mots-clés, utilisez des valeurs séparées par des virgules.
-
Message d’opt-out : saisissez la réponse personnalisée qui est automatiquement envoyée en tant que message d’opt-out.
-
-
Cliquez sur Afficher l’éditeur de payload pour valider et personnaliser les payloads de votre requête.
Vous pouvez personnaliser votre payload de manière dynamique à l’aide d’attributs de profil, et veiller à ce que des données précises sont envoyées pour le traitement et la génération de réponse à l’aide de fonctions d’assistance intégrées.
-
Cliquez sur Envoyer lorsque vous avez terminé la configuration de votre webhook.
-
Dans le menu Webhooks, cliquez sur l’
-
Pour modifier la configuration existante, recherchez le webhook souhaité et cliquez sur l’option Modifier pour apporter les modifications nécessaires.
-
Accédez à la nouvelle URL du webhook et copiez-la à partir du webhook précédemment envoyé.
Après avoir créé et configuré les paramètres entrants pour le webhook, vous devez créer une configuration des canaux pour les messages SMS.
Une fois qu’il est configuré, vous pouvez tirer parti de toutes les fonctionnalités d’origine des canaux, telles que la création de messages, la personnalisation, le suivi des liens et la création de rapports.