Help > Forum > Intégration de sites Web > Utilisation de Webhooks

Utilisation de Webhooks

Utilisez les webhooks pour être averti des événements qui se produisent dans votre forum.

Lorsque l'événement se produit - par exemple, lorsqu'un nouvel utilisateur crée un compte sur votre forum - Website Toolbox crée un objet Event. Cet objet contient toutes les informations pertinentes sur ce qui vient d'arriver, y compris le type d'événement et les données associées à cet événement. Nous envoyons ensuite l'objet Event en tant que JSON à votre URL webhook via une requête HTTP POST.

Les webhooks fonctionnent très bien lorsqu'ils sont combinés avec le API forum. Par exemple, le webhook peut avertir votre application lorsqu'un nouvel utilisateur s'inscrit sur votre forum, puis vous pouvez utiliser l'API pour modifier le compte forum de cet utilisateur.

Les événements suivants sont actuellement pris en charge : user.created, user.approved, user.updated, user.deleted, user.email.verified, user.payment.received, user.paid_subscription.started, user.paid_subscription.ended, topic.created, topic.updated, topic.deleted, post.created, post.approved, post.updated, post.delete, conversation.created et message.created. S'il vous plaît Faites-nous savoir si vous avez besoin d'un certain nouvel événement webhook.


Configuration de vos paramètres webhook

  1. Connectez-vous à votre compte Website Toolbox.
  2. Cliquez sur le bouton Paramètres lien.
  3. Dans le Paramètres , cliquez sur le bouton Notification lien.
  4. Entrez l'URL de votre webhook dans la zone de texte située à côté de la fenêtre Webhook option.

Répondre à un webhook

Pour accuser réception d'un webhook, votre point de terminaison doit renvoyer un code d'état HTTP 2xx. Toute autre information renvoyée dans les en-têtes ou le corps de la demande est ignorée. Tous les codes de réponse en dehors de cette plage, y compris les codes 3xx, indiqueront que vous n'avez pas reçu le webhook. Cela signifie qu'une redirection d'URL ou une réponse « Non modifié » sera traitée comme un échec.

Si un webhook n'est pas reçu avec succès pour une raison quelconque, nous continuerons à essayer d'envoyer le webhook une fois par heure pendant jusqu'à 3 jours.


Exemple d'événement

{
  "api_version": "1",
  "data": {
    "object": {
      "signature": "Thanks, John.",
      "name": "John Doe",
      "allowEmails": false,
      "lastPostTimestamp": 0,
      "userGroups": [7440, 2452, 52423],
      "userTitle": "Power User",
      "reputation": 423,
      "username": "john",
      "postCount": 32,
      "userId": 181855,
      "lastVisitTimestamp": 1322811119,
      "instantMessagingType": "",
      "instantMessagingId": "",
      "object": "User",
      "invisible": false,
      "email": "johnDoe@gmail.com",
      "avatarUrl": "https://test.com/images/avatar.png",
      "joinDateTimestamp": 1322811119,
      "enableMessages": true
    }
  },
  "object": "event",
  "id": 1534,
  "type": "user.created",
  "mode": "live"
}

Affichage des événements et des réponses webhook

Vous pouvez afficher les événements qui ont été envoyés à votre webhook et la réponse reçue de votre webhook en suivant les instructions ci-dessous :

  1. Connectez-vous à votre compte Website Toolbox.
  2. Cliquez sur le bouton Général lien.
  3. Dans le Général , cliquez sur le bouton Webhook (S'il n'y a pas de lien Webhook , cela signifie qu'une URL webhook n'a pas été fournie dans le fichier paramètres webhook encore.)


If you still need help, please contact us.