Intégration

Les événements Deskwoot envoyés à votre propre URL dès qu'ils se produisent

Les webhooks envoient des événements de Deskwoot vers une URL de votre choix dès qu'ils se produisent : une nouvelle conversation, un nouveau message, une attribution, une conversation résolue, un changement de contact ou une note CSAT. Chacun arrive en JSON dans une requête POST signée, ainsi vos propres systèmes réagissent aux événements au lieu de demander sans cesse les changements à l'API.

Gratuit pendant 7 jours, pour 30 membres de votre équipe au maximum. Sans carte bancaire.

Ce que vous obtenez

Ce que vous apporte l'intégration Webhooks

Les événements en direct

Nouvelles conversations, messages, attributions, conversations résolues, changements de contact et notes CSAT arrivent tout de suite sur votre URL, sans interrogations répétées.

JSON signé

Chaque requête est un POST avec un corps JSON, le nom de l'événement dans X-Deskwoot-Event et une signature HMAC SHA256 dans X-Deskwoot-Signature.

Uniquement les événements dont vous avez besoin

Choisissez les événements de chaque webhook, et envoyez des événements différents à des URL différentes, avec un webhook pour chacune.

Mettre en pause sans supprimer

Un interrupteur désactive un webhook et le réactive, et Modifier change son URL ou ses événements.

Connexion

Prêt en 3 étapes

Dans Deskwoot, ouvrez Paramètres → Webhooks et cliquez sur Ajouter un webhook. Seuls les administrateurs voient cette page.
Saisissez une adresse HTTPS publique dans URL de l'endpoint et cochez les événements voulus dans S'abonner aux événements.
Cliquez sur Créer le webhook. Dès lors, Deskwoot envoie une requête POST à votre URL chaque fois qu'un de ces événements se produit.

Lire le guide de configuration

Résumé

Webhooks en détail

Les données de votre support doivent souvent arriver dans un autre système : un CRM qui doit être informé de chaque nouveau contact, une base de données qui compte les conversations résolues, votre propre automatisation qui se lance quand un client note un chat. Les webhooks s'en chargent sans code qui interroge Deskwoot en permanence. Deskwoot appelle votre URL dès que quelque chose se passe.

Vous choisissez les événements de chaque webhook : conversation créée, mise à jour, attribuée et résolue, message créé, contact créé et mis à jour, et CSAT envoyé. Avec le forfait Enterprise et les tickets activés, ticket créé, mis à jour, attribué et résolu sont aussi disponibles. Un webhook sans aucun événement coché reçoit tous les événements sauf ceux des tickets, qui ne vont qu'aux webhooks qui les choisissent. Pour plusieurs URL, créez un webhook pour chacune, avec ses propres événements.

Chaque événement est une requête POST avec un corps JSON qui contient event (le nom de l'événement), data (les données de l'événement, décrites dans la documentation de l'API), timestamp et accountId. L'en-tête X-Deskwoot-Event indique l'événement, et X-Deskwoot-Signature contient sha256= et le HMAC SHA256 du corps brut, signé avec le secret du webhook.

Deskwoot envoie chaque événement tout de suite, sans file d'attente. Votre endpoint a 10 secondes pour répondre avec un statut 2xx. Si la requête échoue, reçoit une erreur ou prend plus de temps, Deskwoot réessaie une fois après 5 secondes, puis l'événement est abandonné. Il peut arriver, rarement, qu'un événement soit reçu deux fois. Le corps n'a pas d'ID d'événement, mais une répétition est une copie exacte avec le même timestamp : utilisez donc ensemble le nom de l'événement, l'ID de l'objet dans data et le timestamp pour ignorer ce que vous avez déjà traité. Deskwoot n'envoie qu'à des adresses HTTPS publiques.

Un webhook ne fait que sortir des données de Deskwoot. Pour répondre aux clients depuis votre propre serveur, utilisez un bot Webhook personnalisé dans Paramètres → Bots (à partir du forfait Startup). Pour répondre aux clients, attribuer, étiqueter ou résoudre des conversations, ou mettre à jour des contacts depuis votre propre code, utilisez l'API REST, qui nécessite le forfait Enterprise. Chaque conversation à laquelle vous répondez de l'une ou l'autre façon compte comme 1 conversation IA. Les webhooks nécessitent le forfait Startup ou supérieur, et l'essai gratuit de 7 jours les inclut. Avec le forfait Free, les webhooks créés auparavant restent dans la liste, mais n'envoient rien jusqu'à ce que votre forfait inclue de nouveau les webhooks.

QUESTIONS

Questions fréquentes

Comment fonctionnent les webhooks de helpdesk dans Deskwoot ?

Vous donnez une URL à Deskwoot et choisissez des événements. Chaque fois que l'un d'eux se produit, Deskwoot envoie à cette URL une requête POST avec l'événement en JSON, signée avec le secret du webhook. Votre système réagit tout de suite au lieu de demander les changements à l'API.

Quel forfait faut-il pour les webhooks ?

Startup ou supérieur, et l'essai gratuit de 7 jours les inclut. Avec le forfait Free, les webhooks créés auparavant restent dans la liste et peuvent être supprimés, mais ils n'envoient rien jusqu'à ce que votre forfait inclue de nouveau les webhooks.

À quels événements puis-je m'abonner ?

Conversation créée, mise à jour, attribuée et résolue, message créé, contact créé et mis à jour, et CSAT envoyé. Avec le forfait Enterprise et les tickets activés, aussi ticket créé, mis à jour, attribué et résolu. Sans événement coché, un webhook reçoit tous les événements sauf ceux des tickets.

Chaque envoi est-il signé ?

Oui. L'en-tête X-Deskwoot-Signature contient sha256= et le HMAC SHA256 du corps brut, signé avec le secret du webhook, et X-Deskwoot-Event indique l'événement. Le tableau de bord n'affiche pas le secret. Un webhook créé via l'API REST le renvoie une seule fois dans sa réponse.

Que se passe-t-il si mon endpoint est hors service ?

Deskwoot réessaie une fois après 5 secondes. Si cela échoue aussi, l'événement est abandonné, car Deskwoot ne garde rien au-delà de cette unique nouvelle tentative. Avec le forfait Enterprise, vous pouvez rattraper le retard via l'API REST, par exemple en listant les conversations dont l'activité est la plus récente.

Un webhook peut-il modifier quelque chose dans Deskwoot ?

Non, un webhook ne fait qu'envoyer des événements vers l'extérieur. Pour répondre aux clients depuis votre propre serveur, utilisez un bot Webhook personnalisé dans Paramètres → Bots (à partir de Startup). Pour répondre aux clients, attribuer, étiqueter ou résoudre des conversations, ou mettre à jour des contacts depuis votre propre code, appelez l'API REST avec le forfait Enterprise. Chaque conversation à laquelle vous répondez de l'une ou l'autre façon compte comme 1 conversation IA.

À voir aussi