À propos de la conversion des cibles en webhooks
Réfléchissez aux points suivants avant de convertir vos cibles.
- L’outil de conversion convertit uniquement les cibles HTTP.
- Pour être converties, les cibles doivent être actives. Les cibles désactivées ne seront pas converties.
- Les webhooks ne prennent pas l’authentification HTTP en charge. Les cibles qui utilisent l’authentification doivent être mises à jour pour utiliser HTTPS avant de pouvoir être converties.
- Toutes les cibles éligibles seront converties. Vous ne pouvez pas convertir une cible à la fois.
- Les cibles resteront actives jusqu’à leur conversion ou jusqu’à l’abandon des cibles HTTP.
- Si la conversion échoue partiellement ou totalement, tout ce qui a trait à la ou aux cibles pour lesquelles la conversation a échoué est restauré à l’état initial. En aucun cas, l’échec d’une conversion ne devrait affecter les configurations existantes des déclencheurs et des règles de gestion.
- Vous pouvez annuler la conversion et revenir aux cibles HTTP jusqu’à leur abandon. Si pour quelque raison que ce soit, vous voulez rétablir une cible que vous avez convertie, vous êtes libre de le faire.
Préparation des cibles HTTP à convertir
Il y a deux cas dans lesquels les cibles ne peuvent pas être converties :
- Les cibles utilisent HTTP au lieu de HTTPS avec authentification de base.
- Les cibles sont inactives.
Dans la plupart des cas, il existe des façons simples de modifier les cibles pour qu’elles soient incluses à la conversion.
Changement de HTTP vers HTTPS
Pendant le processus de conversion, vous pouvez choisir de convertir les cibles non sécurisées en webhooks sécurisés (HTTPS) ou de les ignorer. Si vous choisissez de convertir des cibles non sécurisées, aucune action n’est nécessaire pour résoudre cela à l’avance.
Si vous désirez convertir seulement quelques-unes de vos cibles HTTP, vous pouvez mettre à jour les URL pour ces cibles manuellement, puis sélectionner Ne pas convertir les cibles non sécurisées pendant le processus de conversion.
Pour changer une cible URL de HTTP vers HTTPS
- Dans le Centre d’administration, cliquez sur l’icône Applications et intégrations (
) dans la barre latérale, puis sélectionnez Cibles > Cibles.
- Trouvez la cible dans la liste et cliquez sur Modifier.
- Mettez à jour la valeur de l’URL pour qu’elle utilise https.
- Sélectionnez Mettre à jour la cible dans le menu déroulant et cliquer sur Envoyer.
S’assurer que les cibles sont actives
Seules les cibles HTTP peuvent être converties.
Pour activer une cible
- Dans le Centre d’administration, cliquez sur l’icône Applications et intégrations (
) dans la barre latérale, puis sélectionnez Cibles > Cibles.
- Trouvez la cible que vous voulez réactiver dans la liste des cibles inactives et cliquez sur activer.
Conversion des cibles HTTP en webhooks dans le Centre d’administration
Le processus de conversion commence par le clonage de toutes les cibles existantes. Les règles de gestion sont ensuite modifiées pour utiliser des webhooks au lieu de cibles. La dernière étape consiste à désactiver les cibles et à activer les webhooks.
Si la conversion réussit, les cibles HTTP sont désactivées, les webhooks sont activés et les règles de gestion sont mises à jour quasi simultanément.
Si la conversion d’une cible échoue, la cible et les déclencheurs correspondants restent actifs et inchangés.
Pour convertir des cibles HTTP en webhooks
- Dans le Centre d’administration, cliquez sur l’icône Applications et intégrations (
) dans la barre latérale, puis sélectionnez Webhooks > Webhooks.
- Cliquez sur Commencer.
Si vous avez des cibles éligibles pour la conversion, vous serez guidé tout au long du processus de conversion.
- Cliquez sur Gérer les cibles pour vous assurer que vos cibles sont préparées pour la conversion, puis cliquez sur Suiv.
- Consultez le récapitulatif des cibles qualifiées et cliquez sur Convertissez les cibles.
- Si des cibles non sécurisées (HTTP) sont détectées, vous pouvez choisir de convertir les cibles non sécurisées en webhooks sécurisés (HTTPS) ou de ne pas convertir les cibles non sécurisées.
Remarque – La conversion de cibles non sécurisées en webhooks sécurisés peut endommager vos workflows si votre serveur ne prend pas HTTPS en charge.
- Cliquez sur Consulter le journal de conversion des cibles pour voir pour quelles cibles la conversion a réussi et pour quelles cibles elle a échoué.
Cibles ignorées pendant la conversion
- Les cibles créées à partir d’une intégration, comme Salesforce
Consultation du journal de conversion
À la fin du processus de conversion, vous êtes invité à consulter le journal de conversion. Vous pouvez également y accéder à tout moment à partir de la page Webhooks. Pour consulter le journal de conversion, cliquez sur Actions en haut de la page, puis sur Consulter le journal de conversion des cibles.
- L’onglet En cours de conversion ne contient des cibles que pendant le processus de conversion. La plupart du temps, il devrait être vide.
- L’onglet Converties affiche toutes les cibles dont la conversion en webhooks a réussi. Dans cet onglet, vous pouvez voir les détails d’un webhook, rétablir la cible originale (avant la conversion en webhook) et consulter l’ID de conversion pour un webhook donné.
- L’onglet Échec de la conversion affiche toutes les cibles éligibles pour lesquelles la conversion a échoué. Utilisez cet onglet pour en savoir plus au sujet des raisons de l’échec de la conversion et réessayer la conversion pour chaque cible.
Nouvelle tentative de conversion
À partir du journal de conversion, vous pouvez voir pour quelles cibles la conversion a échoué et réessayer.
Pour réessayer de convertir une cible
- Dans le Centre d’administration, cliquez sur l’icône Applications et intégrations (
) dans la barre latérale, puis sélectionnez Webhooks > Webhooks.
- Cliquez sur Actions en haut de la page, puis sur Consulter le journal de conversion des cibles.
- Cliquez sur l’onglet Échec de la conversion et cherchez la cible pour laquelle vous voulez faire une nouvelle tentative de conversion.
- Résolvez l’erreur décrite pour cette cible.
- Cliquez sur l’icône d’options (
) sur la ligne de la cible et cliquez sur Réessayer la conversion.
Pendant la nouvelle tentative de conversion, la cible apparaît dans l’onglet En cours de conversion. Une fois la nouvelle tentative de conversion terminée, la cible apparaît dans l’onglet Converties ou les informations sur l’échec de conversion de la cible sont mises à jour dans l’onglet Échec de la conversion et la cible déplacée vers le haut du tableau.
Résolution des erreurs de conversion
Échec | Raison | Correction |
---|---|---|
Échec de la mise à jour du déclencheur | La mise à jour du déclencheur qui invoque le webhook a échoué. Cela est souvent dû à une configuration non valide du déclencheur, sans rapport avec la conversion. | Vérifiez que vos déclencheurs peuvent être modifiés et enregistrés, puis réessayez la conversion. |
Échec de la mise à jour de la cible | La mise à jour visant à désactiver la cible HTTP a échoué. Cela est souvent dû à une configuration non valide de la cible, une URL de cible non valide par exemple. | Vérifiez que vos cibles HTTP peuvent être modifiées et enregistrées, puis réessayez la conversion. |
Échec de la mise à jour du webhook | Le webhook n’a pas été créé car il y a des problèmes de validation. | Vérifiez que vos cibles HTTP sont correctement préparées pour la conversion, puis réessayez la conversion. |
Rétablissement d’une cible préalablement convertie en webhook
Pour rétablir une cible préalablement convertie en webhook
- Dans le Centre d’administration, cliquez sur l’icône Applications et intégrations (
) dans la barre latérale, puis sélectionnez Webhooks > Webhooks.
- Cliquez sur Actions en haut de la page, puis sur Consulter le journal de conversion des cibles.
- Cliquez sur l’onglet Converties et trouvez le webhook que vous voulez rétablir en cible.
- Cliquez sur le menu d’actions (
) et sélectionnez Rétablir la cible.
Une fois qu’un webhook est rétabli en cible, il est supprimé de la liste dans l’onglet Converties.
0 Commentaires
Vous devez vous connecter pour laisser un commentaire.