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.
-
-
Activez l’option Prise en charge de mTLS, qui garantit que le client et le serveur s’authentifient mutuellement avant d’établir une connexion sécurisée.
Pour utiliser mTLS uniquement, sélectionnez Aucune authentification dans le menu déroulant Type d’authentification, puis activez la prise en charge de mTLS.
-
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.
note note NOTE Lors de la configuration d’un fournisseur de SMS personnalisé avec l’authentification de base ou porteur, vous devez inclure le paramètre authOptiondans la payload JSON. En outre, la payload du fournisseur doit référencer les variables de modèle{{fromNumber}},{{toNumber}}et{{message}}. -
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 supprimer vos informations d’identification d’API.
-
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.