Crea e Gestisci Sottoscrizioni Webhook per Advocate

I webhook sono porzioni di codice che si eseguono quando si verifica un evento. Advocate ti consente di utilizzare i webhook per registrare un URL a cui invieremo una richiesta POST ogni volta che si verifica un evento nel tuo programma, ad es. quando viene creato un codice coupon personalizzato per un nuovo partecipante viene creato un oggetto evento. Esistono due metodi per creare e gestire i webhook: tramite l'API di Advocate o nella piattaforma Advocate. Questo articolo di aiuto spiegherà come gestire i webhook tramite la piattaforma Advocate.

Creare una sottoscrizione webhook

1. Dalla barra di navigazione in alto, seleziona [Profilo utente] → Impostazioni.

2. Nella colonna di sinistra qui sotto Impostazioni Advocate, seleziona Webhook.

3. Su Sottoscrizioni Webhook pagina, seleziona Crea sottoscrizione.

4. Sotto Invia a URL, inserisci l'indirizzo univoco che l'applicazione utilizza per inviare aggiornamenti in tempo reale sugli eventi specifici.

5. Facoltativamente, sotto Nome Webhook, inserisci il nome della nuova sottoscrizione webhook.

6. Seleziona Salva.

Risolvere i problemi nei log dei webhook

Quando registri un URL a cui Advocate invia una POST ogni volta che si verifica un evento nel tuo programma, puoi rivedere i log e risolvere i problemi per eventuali eventi webhook che non sono andati a buon fine.

Accedi ai log dei webhook

1. Dalla barra di navigazione in alto, seleziona [Profilo utente] → Impostazioni.

2. Nella colonna di sinistra qui sotto Impostazioni Advocate, seleziona Webhook.

3. Su Sottoscrizioni Webhook pagina, seleziona Visualizza log.

4. Usa i filtri qui sotto Registro eventi Webhook per filtrare i webhook.

   • Consulta il Riferimento filtri sotto per maggiori informazioni.

Riferimento filtri

Filtro	Descrizione
Tipo	Filtra per il webhook tipo di evento. Questo filtro predefinito è Tutti i tipi.
Periodo	Filtra per il periodo in cui il webhook è stato aggiornato l'ultima volta. Questo filtro predefinito è Tutto il tempo.

Visualizza i dettagli del webhook

1. Seleziona un webhook specifico per aprire la Dettagli Webhook visualizzazione.

2. Questa visualizzazione fornisce informazioni che possono essere utilizzate per risolvere i problemi di una sottoscrizione webhook.

   • Consulta il Riferimento evento sotto per maggiori informazioni.

Riferimento evento

Filtro	Descrizione
Tipo	Il webhook tipo di evento.
ID Webhook	L'identificatore univoco del webhook.
Data di creazione	La data in cui il webhook è stato creato.
Dati evento	Il webhook payload.
Sottoscrizione(i)	Sottoscrizioni webhook a cui il webhook è stato inviato e il loro stato.
Dettagli sottoscrizione	Dettagli sulla risposta ricevuta dall'endpoint della sottoscrizione webhook. I dettagli possono includere il tentativo di consegna del webhook, mostrando il timestamp del tentativo, il codice di stato HTTP ricevuto dalla destinazione e se il tentativo è scaduto a causa del tempo impiegato per ricevere una risposta dal server di destinazione.

Sistema di ritentativo dei webhook per consegne di eventi non riuscite

• I rest hook vengono consegnati immediatamente dopo che si verifica un evento. Se l'endpoint non risponde con successo a un tentativo di consegna (cioè risponde con un codice di stato diverso da 200), la consegna sarà considerata non riuscita.

• Le consegne non riuscite verranno ritentate ogni ora dopo il precedente tentativo fallito fino a quando non viene effettuata una consegna riuscita o fino a quando non sono stati effettuati 72 tentativi (circa 3 giorni al ritmo di 1 ritentativo all'ora).

• Gli endpoint dei webhook che restituiscono costantemente errori verranno disabilitati automaticamente dopo il seguente numero di errori:

  Codice di stato	Errori ricevuti
  Errori 4xx	1000
  Errori 5xx	2000
  Errori 3xx	2000