Création de webhooks à l’aide de la cible HTTP

Vous pouvez créer un webhook en combinant un déclencheur ou un automatisme avec une cible HTTP dans Zendesk Support. Dans le développement Web, un webhook envoie une demande HTTP à une URL spécifiée en réponse à un événement : quand un déclencheur ou un automatisme s’exécute dans Zendesk Support. Les développeurs Web utilisent généralement un webhook pour invoquer un comportement dans un autre système.

Vous pouvez utiliser les webhooks pour créer des intégrations avec les services ou votre système interne. Exemples :

• Prévenez votre équipe dans Slack quand un ticket urgent est créé.
• Transmettez les détails de ticket à votre équipe de documentation dans Asana une fois un ticket résolu.
• Notifiez votre système interne quand un événement de ticket important survient.

Une cible HTTP vous permet de transmettre des informations à des services tiers et des API REST qui acceptent le contenu JSON, XML ou codé pour les formulaires dans les demandes HTTP. Les cibles HTTP sont utilisées par les automatismes et les déclencheurs dans Zendesk Support quand un ticket remplit certaines conditions. Pour en savoir plus sur l’utilisation des cibles, consultez Notification de cibles externes.

Remarque – Les actions d’automatismes et de déclencheurs peuvent envoyer des demandes à des services tiers, mais ne peuvent pas prendre de mesures basées sur les réponses HTTP.

Les cibles HTTP sont différentes des cibles URL. Les cibles URL prennent uniquement en charge l’envoi d’informations dans des paramètres URL, comme www.example.com?order=345. Les cibles HTTP prennent en charge l’envoi d’informations dans le corps des demandes POST ou PUT, ce qui est nécessaire pour de nombreux services tiers et API ouvertes. Voici un exemple JSON :

Vous pouvez utiliser n’importe quelle balise de contenu disponible pour insérer des données de ticket dans le contenu.

Pour en savoir plus, consultez le guide de référence des balises Zendesk Support.

Création d’un webhook

1. Dans Zendesk Support, cliquez sur l’icône Admin () de la barre latérale sur la gauche, puis choisissez Paramètres > Extensions.
2. Cliquez sur l’onglet Cibles, puis sur Ajouter une cible.
3. Sélectionnez Cible HTTP.
4. Configurez la cible à intégrer au service tiers.

   

5. Enregistrez la cible.
6. Utilisez la cible dans un déclencheur ou un automatisme. Consultez Utilisation des cibles dans les automatismes et les déclencheurs.

Débogage d’un webhook

Si un webhook ne fonctionne pas, vous pouvez utiliser l’onglet Échecs de la cible du tableau de bord de l’API pour voir les problèmes liés à la demande.

1. Dans Zendesk Support, cliquez sur l’icône Admin () de la barre latérale sur la gauche, puis choisissez Canaux > API.
2. Sélectionnez l’onglet Échecs de la cible.

Pour en savoir plus, consultez Utilisation du tableau de bord de l’API.

Exemples

Les articles suivants donnent des exemples de création d’intégrations à l’aide de webhooks.

• Integrating with Slack (Intégration avec Slack), de Steven Yan
• Hipchat Integration with Hipchat v2 API (Intégration Hipchat avec l’API Hipchat v2), de Skip Moore
• Integrating the HTTP Target with Trello (Intégration de la cible HTTP avec Trello), de Steven Yan