Conversion des cibles HTTP en webhooks

Conseil – Les cibles HTTP vont être abandonnées en février 2022. Si vous avez besoin d’aide pour convertir vos cibles HTTP existantes, contactez l’assistance client Zendesk.

Accès rapide : Centre d’administration > Applications et intégrations > Webhooks > Webhooks

Les cibles HTTP dans Zendesk Support sont en cours de remplacement par des webhooks, qui sont créés et gérés dans le Centre d’administration Zendesk. Il existe un processus de conversion simple dans le Centre d’administration pour convertir les cibles HTTP en webhooks.

Cet article contient les sections suivantes :

À propos de la conversion des cibles en webhooks
Préparation des cibles HTTP à convertir
Conversion des cibles HTTP en webhooks dans le Centre d’administration
Consultation du journal de conversion
Nouvelle tentative de conversion
Rétablissement d’une cible préalablement convertie en webhook

À 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

Remarque – Assurez-vous que le serveur contacté par le webhook prend HTTPS en charge avant le changement vers HTTPS ou la conversion en webhooks. Si vous convertissez vos cibles vers HTTPS ou en webhooks et que le serveur ne prend pas HTTPS en charge, les demandes futures échoueront.

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

Avant de convertir les cibles, vous pouvez voir que certaines cibles seront ignorées. Cela signifie qu’aucune action ne sera prise et qu’elles ne feront pas partie du processus de conversion. Les raisons pour lesquelles une cible est ignorée pendant la conversion incluent :

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.

Le journal de conversion comporte trois onglets : un pour les cibles dont la conversion a échoué, un pour les cibles converties et un pour les cibles en cours de conversion. Chaque onglet comprend le nombre de webhooks dans chaque état et un menu d’actions disponibles pour chaque cible dans cet état.

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

Vous trouverez ci-dessous les causes d’échec de conversion des cibles les plus courantes.

É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

Jusqu’à l’abandon des cibles HTTP, vous pouvez rétablir les cibles que vous avez converties en webhooks si vous rencontrez des problèmes.

Remarque – Les nouveaux webhooks créés dans le Centre d’administration ne peuvent pas être convertis en cibles HTTP. Cela ne s’applique qu’aux cibles qui avaient été converties en webhooks.

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.