Usa i webhook per ricevere notifiche sugli eventi che accadono 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 quell'evento. Quindi inviamo l'oggetto Event come JSON all'URL del tuo webhook tramite una richiesta HTTP POST.

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

Per utilizzare questa funzionalità è necessario il piano Growth o Pro del forum.

Configurazione delle impostazioni del webhook

1. Accedi al tuo account Website Toolbox.
2. Fai clic sul link Integra.
3. Fai clic sul link Webhook.
4. Fai clic sul pulsante Aggiungi webhook.
5. Inserisci l'URL del tuo webhook e seleziona gli eventi che desideri ricevere.
6. Fai clic su Salva.

Puoi creare più webhook per inviare eventi a URL diversi. Ogni webhook può essere configurato per ricevere diversi tipi di eventi.

Rispondere a un webhook

Visualizza il nostro codice di esempio per ricevere un evento webhook.

Per confermare la ricezione di un webhook, l'endpoint deve restituire un codice di stato HTTP 2xx. Qualsiasi altra informazione restituita nelle intestazioni 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 di un URL o una risposta «Non modificata» verranno considerati un errore.

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

Un evento di esempio

{
«api_version»: «1", 
 «data»: {
«object»: {
«signature»: «Grazie, 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»: 
 «», «oggetto»: «Utente», 
 «invisibile»: 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 degli eventi e delle risposte del webhook

Puoi visualizzare gli eventi che sono stati inviati al tuo webhook e la risposta ricevuta dal tuo webhook seguendo le istruzioni seguenti:

1. Accedi al tuo account Website Toolbox.
2. Fai clic sul link Integra.
3. Fai clic sul link Webhook.
4. Fai clic sul numero di eventi per il webhook che desideri visualizzare.