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 rilevanti su ciò che è appena accaduto, incluso il tipo di evento e i dati associati a tale evento. Quindi inviamo l'oggetto Event come JSON al tuo URL webhook tramite una richiesta POST HTTP.

I webhook funzionano alla grande quando combinati con il API del forum. Ad esempio, il webhook può notificare la tua applicazione quando un nuovo utente si registra sul tuo forum e quindi puoi usare l'API per apportare modifiche all'account del forum di quell'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 Notinotifica link.
  4. Immettere 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, inclusi i codici 3xx, indicheranno che non hai ricevuto il webhook. Ciò significa che un reindirizzamento URL o una risposta “Non modificata” verrà trattato 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 esempio di evento

{
  "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 Generale link.
  3. Nella Generale , fare clic sul pulsante Webhook (Se non è presente alcun collegamento Webhook , ciò significa che un URL del webhook non è stato fornito nella impostazioni webhook ancora.)


If you still need help, please contact us.