Lorsque de nouvelles informations d’identification d’API sont créées dans Journey Optimizer, les webhooks SMS permettent désormais de capturer à la fois les mots-clés entrants et les événements de commentaires tels que les diffusions et les erreurs. Chaque fournisseur disposant de fonctionnalités différentes, il existe des instructions distinctes pour activer les Webhooks.
Les webhooks prenant désormais en charge les fournisseurs personnalisés, il est désormais possible de collecter les commentaires et la collecte de mots-clés entrants de la part de n’importe quel fournisseur pour les signaler et les traiter dans Journey Optimizer.
-
Nouveaux clients : suivez les instructions ici pour configurer correctement les Webhooks SMS.
-
Clients existants : vous pouvez migrer des informations stockées dans les informations d’identification de l’API vers des Webhooks et il n’existe aucun calendrier pour les clients de migrer. Pour les clients existants qui souhaitent migrer vers des Webhooks SMS, les étapes de migration doivent être effectuées comme indiqué dans le guide de migration.
Vue d’ensemble overview
Une fois vos informations d’identification d’API créées, vous pouvez configurer des webhooks afin de capturer les réponses entrantes pour la gestion du consentement d’opt-in et d’opt-out, et de recevoir les rapports de diffusion, y compris les accusés de réception de lecture, le cas échéant.
Lors de la configuration d’un webhook, vous pouvez définir son objectif en fonction du type de données que vous souhaitez capturer :
-
Entrant : utilisez cette option si vous souhaitez capturer des réponses de consentement, telles que les opt-ins ou les opt-outs, et collecter les préférences utilisateur.
-
Commentaires : sélectionnez cette option pour effectuer le suivi des événements de diffusion et d’engagement, y compris les diffusions, les erreurs sortantes, les accusés de réception de lecture (le cas échéant) pour prendre en charge les rapports et analyses.
Selon votre fournisseur, les attentes quant à ce qui doit être configuré pour une implémentation SMS réussie seront différentes :
-
Sinch et Sinch Conversational : créez un webhook qui gère les événements entrants et de retour. Aucune configuration de payload n’est requise.
-
Infobip : créez deux webhooks distincts, l’un pour les événements entrants et l’autre pour les événements de commentaires. Aucune configuration de payload n’est requise pour les webhook.
-
Twilio : les Webhooks ne sont pas disponibles. La collecte de données entrantes et de commentaires n’est pas prise en charge.
-
Fournisseur personnalisé : créez deux webhooks distincts, l’un pour les événements entrants et l’autre pour les événements de commentaires. La configuration de la payload est requise pour que les deux Webhooks fonctionnent correctement.
Assistance du fournisseur provider-support
Le tableau suivant indique les fournisseurs qui prennent en charge les webhooks de retour et entrants, et si la création d’une payload est requise :
Pour les clients qui passent des informations d’identification d’API aux webhooks SMS, des informations sur le chemin de migration sont disponibles dans le guide de migration.
Créer un webhook
Pour Sinch et Sinch Conversational create-webhook-sinch
Pour Sinch et Sinch Conversational, créez un webhook unique qui gère les événements entrants et de retour. Aucune configuration de payload personnalisée n’est requise.
-
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 webhook, comme décrit ci-dessous :
-
Nom : saisissez un nom pour votre webhook.
-
Sélectionnez le fournisseur de SMS : Sinch ou Sinch Conversational.
-
Informations d’identification d’API : choisissez dans la liste déroulante les informations d’identification d’API configurées précédemment.
-
Numéro de téléphone de l’expéditeur : saisissez le numéro de téléphone de l’expéditeur que vous souhaitez utiliser pour vos communications.
-
-
Commencez à configurer les mots-clés entrants en saisissant des mots-clés dans le champ Saisir un mot-clé. Plusieurs mots-clés peuvent être ajoutés et supprimés. Notez que les mots-clés ne respectent pas la casse.
-
Sélectionnez une catégorie de mots-clés dans le menu déroulant Catégorie de mots-clés entrante pour configurer :
-
accordion Abonnement -
Activez les mots-clés qui inscrivent des utilisateurs avec leur consentement. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, son numéro de téléphone est accepté pour recevoir des SMS.
-
Par défaut, les mots-clés suivants sont activés : S’abonner, Oui, Reprendre, Continuer, Reprendre et Commencer. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’accord préalable.
-
-
accordion Opt-Out -
Activez les mots-clés qui désactivent les utilisateurs et suppriment le consentement pour envoyer des messages texte. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, son numéro de téléphone est désinscrit de la réception des SMS.
-
Par défaut, les mots-clés suivants sont activés : Arrêter, Arrêter, Annuler, Terminer, Se désabonner, Non. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’opt-out.
-
Activez Logique floue pour détecter des mots-clés similaires aux mots-clés d’exclusion configurés. Si la réponse d’un utilisateur est proche mais non exacte, le message saisi dans le champ Réponse automatique floue est envoyé. En règle générale, ce message indique que le processus d’opt-out n’a pas eu lieu et indique le mot-clé exact nécessaire pour se désabonner.
-
-
accordion Double Opt-In -
Activez les mots-clés pour l’exigence de double opt-in. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, il n’est pas entièrement opt-in à ce stade. Ce workflow de consentement en deux étapes nécessite que les utilisateurs confirment leur opt-in par un deuxième mot-clé.
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsqu’un mot-clé de double opt-in est recherché. Ce message demande à l’utilisateur de saisir un mot-clé d’accord préalable pour terminer le processus d’accord préalable.
-
-
accordion Aide -
Activez les mots-clés qui fournissent une réponse standard lorsque de l’aide est demandée. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, il reçoit le message de réponse d’aide.
-
Par défaut, les mots-clés suivants sont activés : Aide, Infos, Informations. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’aide.
-
-
accordion Valeur personnalisée -
Configurez un seul mot-clé personnalisé. Lorsque le message d’un utilisateur ou d’une utilisatrice correspond à ce mot-clé, celui-ci est écrit dans le jeu de données Suivi des commentaires sur les messages pour la création de rapports et d’audiences.
-
Créez une audience (par flux ou par lots) qui fait référence à ce mot-clé à utiliser dans vos parcours et campagnes.
-
-
-
Saisissez un Message de réponse par défaut. Ce message est automatiquement envoyé lorsque la réponse d’un utilisateur ne correspond à aucun mot-clé configuré.
-
Cliquez sur Envoyer pour enregistrer la configuration du webhook.
-
Dans le menu Webhooks, vous pouvez modifier ou supprimer des webhooks existants.
-
Accédez au Webhook que vous venez de créer et copiez l’URL du Webhook.
-
Utilisez votre URL Webhook pour activer les événements Feedback et Inbound dans Journey Optimizer.
-
Pour le canal SMS , en savoir plus dans la documentation Sinch
-
Pour le canal MMS, en savoir plus dans la documentation Sinch
-
Pour les clients qui ont acheté des SMS directement via Journey Optimizer, enregistrez un ticket d’assistance auprès de l’assistance Adobe. L’équipe du compte Adobe configurera l’URL du webhook pour vous.
-
Si votre webhook utilise des informations d’identification d’API associées à une configuration de canal existante, le webhook prend immédiatement effet. Sinon, créez une configuration de canal.
Pour Infobip create-webhook-infobip
Pour Infobip, créez deux webhooks distincts : l’un pour les événements de commentaires et l’autre pour les événements 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 webhook, comme décrit ci-dessous :
-
Nom : saisissez un nom pour votre webhook.
-
Sélectionnez le fournisseur de SMS : Infobip.
-
Type : sélectionnez Commentaires ou Entrant. Vous devez créer les deux séparément. Ici, nous commençons par Inbound.
-
Informations d’identification d’API : choisissez dans la liste déroulante les informations d’identification d’API configurées précédemment.
-
Numéro de téléphone de l’expéditeur : saisissez le numéro de téléphone de l’expéditeur que vous souhaitez utiliser pour vos communications.
-
-
Commencez à configurer les mots-clés entrants en saisissant des mots-clés dans le champ Saisir un mot-clé. Plusieurs mots-clés peuvent être ajoutés et supprimés. Notez que les mots-clés ne respectent pas la casse.
-
Sélectionnez une catégorie de mots-clés dans le menu déroulant Catégorie de mots-clés entrante pour configurer :
-
accordion Abonnement -
Activez les mots-clés qui inscrivent des utilisateurs avec leur consentement. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, son numéro de téléphone est accepté pour recevoir des SMS.
-
Par défaut, les mots-clés suivants sont activés : S’abonner, Oui, Reprendre, Continuer, Reprendre et Commencer. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’accord préalable.
-
-
accordion Opt-Out -
Activez les mots-clés qui désactivent les utilisateurs et suppriment le consentement pour envoyer des messages texte. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, son numéro de téléphone est désinscrit de la réception des SMS.
-
Par défaut, les mots-clés suivants sont activés : Arrêter, Arrêter, Annuler, Terminer, Se désabonner, Non. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’opt-out.
-
Activez Logique floue pour détecter des mots-clés similaires aux mots-clés d’exclusion configurés. Si la réponse d’un utilisateur est proche mais non exacte, le message saisi dans le champ Réponse automatique floue est envoyé. En règle générale, ce message indique que le processus d’opt-out n’a pas eu lieu et indique le mot-clé exact nécessaire pour se désabonner.
-
-
accordion Double Opt-In -
Activez les mots-clés pour l’exigence de double opt-in. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, il n’est pas entièrement opt-in à ce stade. Ce workflow de consentement en deux étapes nécessite que les utilisateurs confirment leur opt-in par un deuxième mot-clé.
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsqu’un mot-clé de double opt-in est recherché. Ce message demande à l’utilisateur de saisir un mot-clé d’accord préalable pour terminer le processus d’accord préalable.
-
-
accordion Aide -
Activez les mots-clés qui fournissent une réponse standard lorsque de l’aide est demandée. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, il reçoit le message de réponse d’aide.
-
Par défaut, les mots-clés suivants sont activés : Aide, Infos, Informations. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’aide.
-
-
accordion Valeur personnalisée -
Configurez un seul mot-clé personnalisé. Lorsque le message d’un utilisateur ou d’une utilisatrice correspond à ce mot-clé, celui-ci est écrit dans le jeu de données Suivi des commentaires sur les messages pour la création de rapports et d’audiences.
-
Créez une audience (par flux ou par lots) qui fait référence à ce mot-clé à utiliser dans vos parcours et campagnes.
-
-
-
Saisissez un Message de réponse par défaut. Ce message est automatiquement envoyé lorsque la réponse d’un utilisateur ne correspond à aucun mot-clé configuré.
-
Cliquez sur Envoyer pour enregistrer la configuration du webhook.
-
Dans le menu Webhooks, vous devez maintenant créer un webhook Feedback pour Infobip.
-
Configurez vos paramètres webhook, comme décrit ci-dessous :
-
Nom : saisissez un nom pour votre webhook.
-
Sélectionnez le fournisseur de SMS : Infobip.
-
Type : sélectionnez Commentaires.
-
-
Cliquez sur Envoyer pour enregistrer la configuration du Webhook de commentaires.
-
Dans le menu Webhooks, vous pouvez modifier ou supprimer des webhooks existants.
-
Accédez à vos Webhooks nouvellement créés et copiez l’URL du Webhook à partir de chacun de vos Webhooks.
-
Vous pouvez désormais utiliser ces URL pour activer les deux URL de rappel afin d’importer des commentaires et des événements entrants dans Journey Optimizer.
Si votre webhook utilise des informations d’identification d’API associées à une configuration de canal existante, le webhook prend immédiatement effet. Sinon, créez une configuration de canal.
Pour le fournisseur personnalisé create-webhook-custom
Pour les fournisseurs de SMS personnalisés, créez deux webhooks distincts : l’un pour les événements de commentaires et l’autre pour les événements 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 webhook, comme décrit ci-dessous :
-
Nom : saisissez un nom pour votre webhook.
-
Sélectionner le fournisseur de SMS : personnalisé.
-
Type : sélectionnez Commentaires ou Entrant. Vous devez créer les deux séparément. Ici, nous commençons par Inbound.
-
Informations d’identification d’API : choisissez dans la liste déroulante les informations d’identification d’API configurées précédemment.
-
Numéro de téléphone de l’expéditeur : saisissez le numéro de téléphone de l’expéditeur que vous souhaitez utiliser pour vos communications.
-
-
Commencez à configurer les mots-clés entrants en saisissant des mots-clés dans le champ Saisir un mot-clé. Plusieurs mots-clés peuvent être ajoutés et supprimés. Notez que les mots-clés ne respectent pas la casse.
-
Sélectionnez une catégorie de mots-clés dans le menu déroulant Catégorie de mots-clés entrante pour configurer :
-
accordion Abonnement -
Activez les mots-clés qui inscrivent des utilisateurs avec leur consentement. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, son numéro de téléphone est accepté pour recevoir des SMS.
-
Par défaut, les mots-clés suivants sont activés : S’abonner, Oui, Reprendre, Continuer, Reprendre et Commencer. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’accord préalable.
-
-
accordion Opt-Out -
Activez les mots-clés qui désactivent les utilisateurs et suppriment le consentement pour envoyer des messages texte. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, son numéro de téléphone est désinscrit de la réception des SMS.
-
Par défaut, les mots-clés suivants sont activés : Arrêter, Arrêter, Annuler, Terminer, Se désabonner, Non. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’opt-out.
-
Activez Logique floue pour détecter des mots-clés similaires aux mots-clés d’exclusion configurés. Si la réponse d’un utilisateur est proche mais non exacte, le message saisi dans le champ Réponse automatique floue est envoyé. En règle générale, ce message indique que le processus d’opt-out n’a pas eu lieu et indique le mot-clé exact nécessaire pour se désabonner.
-
-
accordion Double Opt-In -
Activez les mots-clés pour l’exigence de double opt-in. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, il n’est pas entièrement opt-in à ce stade. Ce workflow de consentement en deux étapes nécessite que les utilisateurs confirment leur opt-in par un deuxième mot-clé.
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsqu’un mot-clé de double opt-in est recherché. Ce message demande à l’utilisateur de saisir un mot-clé d’accord préalable pour terminer le processus d’accord préalable.
-
-
accordion Aide -
Activez les mots-clés qui fournissent une réponse standard lorsque de l’aide est demandée. Lorsque le message d’un utilisateur correspond à un mot-clé configuré, il reçoit le message de réponse d’aide.
-
Par défaut, les mots-clés suivants sont activés : Aide, Infos, Informations. Supprimez tous les mots-clés par défaut en cliquant sur
-
Utilisez le champ Message de réponse pour créer un message qui est automatiquement envoyé lorsque le message entrant d’un utilisateur correspond à un mot-clé d’aide.
-
-
accordion Valeur personnalisée -
Configurez un seul mot-clé personnalisé. Lorsque le message d’un utilisateur ou d’une utilisatrice correspond à ce mot-clé, celui-ci est écrit dans le jeu de données Suivi des commentaires sur les messages pour la création de rapports et d’audiences.
-
Créez une audience (par flux ou par lots) qui fait référence à ce mot-clé à utiliser dans vos parcours et campagnes.
-
-
-
Saisissez un Message de réponse par défaut. Ce message est automatiquement envoyé lorsque la réponse d’un utilisateur ne correspond à aucun mot-clé configuré.
-
Créez une payload personnalisée correspondant au fichier JSON provenant du fournisseur. Notez que le seul format webhook pris en charge est JSON. Les données de formulaire pour les Webhooks ne sont pas prises en charge.
Le webhook entrant nécessite les champs suivants pour recevoir des valeurs du webhook de votre fournisseur :
- InboundMessage : message entrant ou mot-clé reçu de l’utilisateur.
- ProfileNumber : numéro de téléphone de l’utilisateur qui a envoyé le message.
- RequestID : identifiant unique fourni par votre fournisseur SMS pour identifier une transaction spécifique.
- OriginTimestamp : la date et l’heure de réception du message, au format UTC.
- InboundNumber : numéro de téléphone utilisé pour cette configuration de webhook.
accordion Exemple de payload code language-none « json { « inboundMessage »: « {{inboundMessage}} », « profileNumber »: « {{profileNumber}} », « requestId »: « {{requestId}} », « originTimestamp » : « {{originTimestamp}} », « inboundNumber »: « {{inboundNumber}} » } « -
Une fois votre fichier JSON créé, cliquez sur Afficher l’éditeur de payload, puis copiez et collez votre payload JSON dans l’éditeur et enregistrez-la.
-
Cliquez sur Envoyer pour enregistrer la configuration du webhook.
-
Dans le menu Webhooks, vous devez maintenant créer un webhook Feedback pour le fournisseur personnalisé.
-
Configurez vos paramètres webhook, comme décrit ci-dessous :
-
Nom : saisissez un nom pour votre webhook.
-
Sélectionner le fournisseur de SMS : personnalisé.
-
Type : sélectionnez Commentaires.
-
-
Créez une payload personnalisée correspondant au format JSON de votre fournisseur. Notez que le seul format webhook pris en charge est JSON. Les données de formulaire pour les Webhooks ne sont pas prises en charge.
Le webhook de commentaires nécessite les champs suivants pour recevoir les valeurs du webhook de votre fournisseur :
- Référence client : identifiant unique renvoyé dans la payload à des fins de journalisation.
- Code : code d’échec fourni par votre fournisseur SMS.
- Statut : le statut d’échec fourni par votre fournisseur SMS.
accordion Exemple de payload code language-none « json { « clientReference »: « {{client_reference}} », « status » : [ { « code »: « {{failureCode}} », « status »: « {{feedbackStatus}} » } ] } « -
Cliquez sur Afficher l’éditeur de payload, puis copiez et collez votre payload JSON dans l’éditeur et enregistrez-la.
-
Cliquez sur Envoyer pour enregistrer la configuration du Webhook de commentaires.
-
Dans le menu Webhooks, vous pouvez modifier ou supprimer des webhooks existants.
-
Accédez à vos Webhooks nouvellement créés et copiez l’URL du Webhook à partir de chacun de vos Webhooks.
-
Configurez votre fournisseur de SMS pour envoyer des événements Commentaires et Entrant à ces URL webhook dans Journey Optimizer.
Les instructions de configuration varient selon le fournisseur SMS. Consultez la documentation de votre fournisseur pour plus d’informations sur la configuration des URL de rappel.
Si votre webhook utilise des informations d’identification d’API associées à une configuration de canal existante, le webhook prend immédiatement effet. Sinon, créez une configuration de canal.