Help > Forum > Integrazione del sito web > Utilizzo di Webhook

Utilizzo di Webhook

Usa i webhook per ricevere una notifica sugli eventi che si verificano nel tuo forum.

Quando si verifica l'evento, ad esempio quando un nuovo utente crea un account sul forum, Website Toolbox crea un oggetto Event. Questo oggetto contiene tutte le informazioni pertinenti su ciò che è appena accaduto, incluso il tipo di evento e i dati associati a tale evento. Inviamo quindi l'oggetto Event come JSON al tuo URL webhook tramite una richiesta HTTP POST.

I webhook funzionano alla grande se combinati con il API del forum. Ad esempio, il webhook può notificare l'applicazione quando un nuovo utente si iscriva al forum e quindi è possibile utilizzare l'API per apportare modifiche all'account del forum di tale utente.

Sono attualmente supportati i seguenti eventi: 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.deleted, conversation.created e message.created. prega facci sapere se hai bisogno di un certo nuovo evento webhook.


Configurazione delle impostazioni del webhook

  1. Accedi al tuo account Website Toolbox.
  2. Fare clic sul pulsante Impostazioni link.
  3. Nella Impostazioni , fare clic sul pulsante NotiFICA link.
  4. Inserisci l'URL del webhook nella casella di testo accanto al Webhook opzione.

Rispondere a un webhook

Per confermare la ricezione di un webhook, l'endpoint deve restituire un codice di stato HTTP 2xx. Qualsiasi altra informazione restituita nelle intestazioni della richiesta o nel corpo della richiesta viene ignorata. Tutti i codici di risposta al di fuori di questo intervallo, compresi i codici 3xx, indicano che non hai ricevuto il webhook. Ciò significa che un reindirizzamento URL o una risposta «Non modificata» verrà trattata come un errore.

Se un webhook non viene ricevuto correttamente per qualsiasi motivo, continueremo a provare a inviare il webhook una volta all'ora per un massimo di 3 giorni.


Un evento di esempio

{
  "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"
}

Visualizzazione di eventi e risposte webhook

È possibile visualizzare gli eventi inviati al webhook e la risposta ricevuta dal webhook seguendo le istruzioni riportate di seguito:

  1. Accedi al tuo account Website Toolbox.
  2. Fare clic sul pulsante Contenuto link.
  3. Nella Contenuto , fare clic sul pulsante Webhook link. (Se non c'è Webhook , significa che un URL webhook non è stato fornito nel impostazioni webhook ancora.)


If you still need help, please contact us.