Auparavant, les cibles étaient utilisées pour transférer des informations à des applications et des services cloud externes afin de les notifier des modifications ayant lieu dans Zendesk. Cet article décrit comment convertir en webhooks la plupart des cibles existantes.
À propos de la conversion des cibles en webhooks
- Créez un nouveau webhook basé sur votre cible.
- Configurez un déclencheur pour envoyer la notification de webhook.
- Vérifiez que le nouveau webhook et le déclencheur fonctionnent comme prévu, puis désactivez votre cible et tous les déclencheurs qui y sont associés.
Conversion des cibles Clickatell, Pivotal, Twilio, X Corp et Yammer
Il n’existe pas de moyen direct pour mapper les configurations des cibles Clickatell, Pivotal, Twilio, X Corp (anciennement Twitter) et Yammer avec des webhooks. Nous vous conseillons de vous renseigner sur les applications Zendesk Marketplace qui pourraient correspondre à vos besoins.
Création d’un nouveau webhook basé sur votre cible
Pour convertir vos cibles en webhooks, ouvrez une fenêtre avec les détails de la cible et une autre avec le webhook.
Pour créer un webhook basé sur une cible URL
- Dans une fenêtre de navigateur, ouvrez la cible URL.
- Dans le Centre d’administration, cliquez sur Applications et intégrations () dans la barre latérale, puis sélectionnez Cibles > Cibles.
- Cherchez la cible à convertir en webhook et cliquez sur Modifier.
- Dans une autre fenêtre de navigateur, ouvrez la page Webhooks.
- Dans le Centre d’administration, cliquez sur Applications et intégrations dans la barre latérale, puis sélectionnez Actions et webhooks > Webhooks.
- Cliquez sur Créer un webhook.
- Sélectionnez Déclencheur ou automatisme comme moyen de connexion et cliquez sur Suiv.
- Mappez les valeurs de la cible avec les champs du webhook. Pour des instructions de mappage détaillées, consultez :
- Cliquez sur Créer un webhook.
Mappage des configurations des cibles Basecamp avec des webhooks
- Titre : le nom d’un webhook.
- URL : l’URL du point de terminaison du webhook.
- Pour l’authentification du webhook, choisissez l’une des méthodes suivantes :
- Nom d’utilisateur et mot de passe : configurez l’authentification du webhook sur Authentification de base et saisissez le nom d’utilisateur et le mot de passe Basecamp. Vous ne pouvez pas copier et coller le mot de passe.
- Token API : configurez l’authentification du webhook sur Clé API et saisissez le token API de la cible Campfire.
- ID de projet : Ajoutez /projects/[ID] à la fin de l’URL du point de terminaison du webhook. Par exemple : https://corp.basecamphq.com/projects/2612430.
-
Ressources : ajoutez ce qui suit à la fin de l’URL du point de terminaison du webhook.
-
Message : ajoutez /posts/[ID]/comments. Exemple :
https://corp.basecamphq.com/projects/2612430/posts/25611692/comments
- Tâches : ajoutez /todo_lists/[ID]. Exemple : https://corp.basecamphq.com/projects/2612430/todo_lists/25611692.
-
Message : ajoutez /posts/[ID]/comments. Exemple :
Mappage des configurations des cibles Campfire avec des webhooks
- Titre : le nom d’un webhook.
- Sous-domaine : l’URL du point de terminaison du webhook.
- Token API : configurez l’authentification du webhook sur Clé API et saisissez le token API de la cible Campfire.
- Salle : ajoutez cette information à la fin de l’URL de point de terminaison du webhook.
- SSL : cela ne s’applique pas quand vous créez un webhook.
- Conserver le format : cela ne s’applique pas quand vous créez un webhook.
Mappage des configurations des cibles Get Satisfaction avec des webhooks
- Titre : le nom d’un webhook.
-
Nom de l’entreprise : incorporez-le à l’URL du point de terminaison du webhook. Exemple :
https://getsatisfaction.com/yourcompany/
- E-mail et mot de passe : configurez l’authentification du webhook sur Authentification de base et saisissez le nom d’utilisateur et le mot de passe Get Satisfaction. Vous ne pouvez pas copier et coller le mot de passe.
Mappage des configurations des cibles Jira avec des webhooks
- Titre : le nom d’un webhook.
- URL : l’URL du point de terminaison du webhook.
- Nom d’utilisateur et mot de passe : configurez l’authentification du webhook sur Authentification de base et saisissez le nom d’utilisateur et le mot de passe Jira. Vous ne pouvez pas copier et coller le mot de passe.
Mappage des configurations des cibles URL avec des webhooks
- Titre : le nom d’un webhook.
- URL : l’URL du point de terminaison du webhook.
- Méthode : la méthode de la demande du webhook.
- Nom de l’attribut : cela n’est pas nécessaire quand vous créez un webhook, mais sera utilisé lors de la configuration des actions de déclencheur.
- Authentification de base : configurez l’authentification du webhook sur Authentification de base et saisissez le nom d’utilisateur et le mot de passe de la cible URL. Vous ne pouvez pas copier et coller le mot de passe.
- En outre, dans le webhook, vous devez configurer Format de la demande sur Formulaire codé.
Configuration d’un déclencheur pour envoyer les notifications de webhook
Vous devriez déjà avoir un déclencheur configuré pour envoyer les notifications en fonction de la cible. Vous pouvez modifier ce déclencheur ou le cloner, ou vous pouvez créer un nouveau déclencheur.
- Dans le Centre d’administration, cliquez sur l’icône Objets et règles dans la barre latérale, puis sélectionnez Règles de gestion > Déclencheurs.
-
Modifiez ou clonez un déclencheur existant.
Notez la valeur Message pour l’action Notifier par > Cible. Vous la réutiliserez avec votre nouvelle action basée sur le webhook.
- Sous Actions, cliquez sur Ajouter une action et sélectionnez Notifier par > Webhook actif.
- Sélectionnez le webhook que vous avez créé pour remplacer la cible dans le menu déroulant.
- Configurez le webhook pour envoyer les informations nécessaires.
Par exemple, si vous remplacez une cible URL, sous Paramètres de l’URL, vous feriez ce qui suit :
- Configurez la clé sur le nom de l’attribut de la cible URL.
- Configurez la valeur sur le message de l’action Notifier par > Cible.
- Cliquez sur Enregistrer.
- Retournez au webhook et testez la fonctionnalité.
Désactivation de votre cible et des déclencheurs associés
Une fois le webhook créé et les déclencheurs associés mis à jour, testez le webhook avec soin en initiant les conditions de déclencheur appropriées. Tant que le déclencheur est configuré avec deux actions Notifier par, une pour la cible et une autre pour le webhook, vous devriez recevoir des messages en double dans votre application ou système externe.
Une fois que vous avez vérifié que le webhook et le déclencheur fonctionnent correctement, modifiez le déclencheur en supprimant l’action Notifier par > Cible, puis désactivez ou supprimez la cible.