Centre d'aideIntégrations

Pour: Administrateurs

Configurer un webhook pour l'activité du flux

Envoyez à votre système un message chaque fois qu'un article, un commentaire ou une pièce jointe est ajouté, modifié ou supprimé.

Dans cet article8 sections

Le webhookWebhook Une adresse que vous fournissez au hub afin qu'il puisse envoyer un message à vos propres systèmes chaque fois qu'une publication ou un commentaire est modifié. envoie un message à votre propre système chaque fois qu’un événement se produit dans le FeedAlimentation Chronologie des publications relatives à une affaire, où le cabinet partage des informations et où toutes les personnes impliquées dans l'affaire peuvent commenter. d’une affaire, comme une nouvelle publication ou un commentaire. Chaque message est crypté, donc le système qui le reçoit a besoin d’un code développeur pour pouvoir le lire.

  1. Ouvrir les webhooks

    Veuillez aller à Intégration › Webhooks et choisir NOUVEAU.

  2. Saisissez l'adresse

    Sous URL, saisissez l’adresse de votre système qui reçoit les messages. Cette adresse doit commencer par https:// ou http://, et elle doit être accessible depuis Internet. Les lettres majuscules doivent être conservées lors du saisissement de cette adresse.

    La description est optionnel : une note pour votre équipe, par exemple des informations concernant les cas que vous souhaitez mettre en mémoire dans notre système de gestion de relations clients.

  3. Choisissez les événements

    Sous Événements, sélectionnez ceux qui doivent envoyer des messages, comme le message est créé et le commentaire de publication est créé. Il y a dix éléments possibles : des posts, des commentaires sur les posts, ainsi que des fichiers qui peuvent être ajoutés ou supprimés. Veuillez consulter les événements liés au webhook et les données transmises par ces événements indique ce que chacun d’eux envoie.

  4. Allumez-le et économisez

    Actif commence à fonctionner. Laissez-le en état : un webhook inactif ne reçoit rien, et ce qu’il manque n’est pas envoyé par la suite. Choisissez SAUVEGARDER. Le message “Webhook ajouté” apparaît alors.

  5. Garde le secret

    La fenêtre Webhook secret affichée montre la clé secrète du webhook : c’est la clé privée qui permet de déverrouiller chaque message envoyé par le webhook. Cette information est affichée une seule fois. Choisissez Télécharger au format .pem pour enregistrer ce contenu en fichier, ou Copier dans le presse-papiers pour copier tout le texte, y compris les sauts de ligne. Transmettez ce contenu à votre développeur de manière sécurisée, par exemple via un gestionnaire de mots de passe. Ensuite, choisissez Terminé.

  6. Testez-le

    Ajoutez une petite publication pour un cas où il n’y a pas de clients réels… Comme l’un des deux exemples de cas que votre équipe a déjà traité. Votre développeur vérifie que le message a bien été reçu, et que le secret correspond à ce que le message contient.

Que se passe-t-il ensuite ?

Chaque fois qu’un événement spécifique se produit dans un cas de votre hub, le webhook envoie un message à votre système. Ce message indique qui a effectué ce changement : votre équipe, un client, l’Assistante virtuelleAssistant virtuel Un membre d'équipe automatisé qui publie des messages de bienvenue, des enregistrements et des publications pour l'entreprise ; ses publications portent un badge d'assistant virtuel., ou une clé API. Personne d’autre n’est informé de cela.

Si deux livraisons se produisent en même temps et échouent, le webhook s’arrête, et un e-mail est envoyé à chaque administrateur concerné. Pour régler ce problème, consultez Corrigez le webhook qui ne fonctionne plus. Pour modifier son adresse ou les événements concernés, sélectionnez l’icône en forme de crayon, Webhook de modification, dans sa ligne. La clé secrète reste inchangée.

Si quelque chose tourne mal

  • La limite liée aux webhooks a été atteinte. Votre hub peut avoir cinq webhooks. Supprimez celui que vous n’utilisez plus : sélectionnez l’icône de la boîte à supprimer. Supprimer le webhook, Sur sa rangée, alors. Effacer. Il s’arrête immédiatement, et ne peut plus être réactivé.
  • L’URL indiquée est invalide. Exemple : https://example.com/hook. Veuillez saisir l’adresse complète, en commençant par https:// ou http://. Les adresses qui ne fonctionnent que sur votre propre ordinateur ne sont pas acceptées.
  • Vous avez perdu ce secret. Il ne peut pas être réutilisé. Ajoutez un nouveau webhook avec le même adresse et les mêmes événements. Donnez son mot de passe à votre développeur, puis supprimez l’ancien webhook.

Articles connexes

Rechercher les événements et les charges utiles des webhooksCe que chacun des dix événements de flux envoie, comment le message est chiffré et comment le déchiffrer avec votre secret.IntégrationsRésoudre un problème de webhook qui a cessé d'envoyer des messages.Pourquoi un webhook s'arrête après deux échecs de livraison ou lorsqu'il est inactif, et comment le fait de l'enregistrer à nouveau le réactive.IntégrationsComprendre les possibilités de l'APIDécouvrez ce que permettent chacune une clé de gestion et une clé de hub, pourquoi chaque clé agit comme un assistant virtuel et où trouver la liste technique complète.Intégrations