Crea e gestisci gli abbonamenti webhook Advocate

I webhook sono codice che viene eseguito quando si verifica un evento. Advocate ti consente di usare i webhook per registrare un URL a cui invieremo una POST ogni volta che si verifica un evento nel tuo programma, ad esempio quando viene creato un codice coupon vanity per un nuovo partecipante, viene creato un oggetto evento. Esistono due metodi per creare e gestire i webhook: tramite l'API di Advocate oppure nella piattaforma Advocate. Questo articolo della guida spiega come gestire i webhook tramite la piattaforma Advocate.

Crea una sottoscrizione webhook

1. Dalla barra di navigazione in alto, seleziona [Profilo utente] → Impostazioni.
2. Nella colonna di sinistra qui sotto Impostazioni di Advocate, seleziona Webhook.
3. Nella Sottoscrizioni webhook della pagina, seleziona Crea sottoscrizione.
4. Qui sotto POST su URL, inserisci l'indirizzo univoco che l'applicazione usa per inviare aggiornamenti in tempo reale su eventi specifici.
5. Facoltativamente, qui sotto Nome del webhook, inserisci il nome della nuova sottoscrizione webhook.
6. Seleziona Salva.

Risolvere i problemi dei log webhook

Quando registri un URL a cui Advocate invia dati ogni volta che si verifica un evento nel tuo programma, puoi consultare i log e risolvere eventuali eventi webhook non riusciti.

Accedi ai tuoi log webhook

1. Dalla barra di navigazione in alto, seleziona [Profilo utente] → Impostazioni.
2. Nella colonna di sinistra qui sotto Impostazioni di Advocate, seleziona Webhook.
3. Nella Sottoscrizioni webhook della pagina, seleziona Visualizza log.
4. Usa i filtri qui sotto Log eventi webhook per filtrare i webhook.

   • Consulta il riferimento filtri qui sotto per maggiori informazioni.

riferimento filtri

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

Visualizza i dettagli del webhook

1. Seleziona un webhook specifico per aprire la Dettagli del webhook vista.
2. Questa vista fornisce informazioni che possono essere utilizzate per risolvere i problemi di una sottoscrizione webhook.

   • Consulta il Riferimento eventi qui sotto per maggiori informazioni.

Riferimento eventi

Filtro	Descrizione
Tipo	Il webhook tipo di evento.
ID del webhook	L'identificatore univoco del webhook.
Data di creazione	La data in cui il webhook è stato creato.
Dati dell'evento	Il webhook carico utile.
Sottoscrizioni	Le sottoscrizioni webhook a cui il webhook è stato inviato e il relativo stato.
Dettagli della sottoscrizione	Dettagli sulla risposta ricevuta dall'endpoint della sottoscrizione webhook. I dettagli possono includere il tentativo di consegna del webhook, mostrando la data e l'ora del tentativo, il codice di stato HTTP ricevuto dalla destinazione e se il tentativo è andato in timeout perché la richiesta ha impiegato troppo tempo a ricevere una risposta dal server di destinazione.

Sistema di ritentativo dei webhook per le consegne di eventi non riuscite

• I rest hook vengono recapitati immediatamente dopo l'attivazione di un evento. Se l'endpoint non risponde con successo a un tentativo di consegna (ovvero, non risponde con un codice di stato diverso da 200), la consegna sarà considerata non riuscita.
• I tentativi di consegna non riusciti verranno ritentati ogni ora dopo il precedente tentativo fallito finché non verrà effettuata una consegna riuscita oppure finché non saranno stati effettuati 72 tentativi (circa 3 giorni al ritmo di 1 ritentativo all'ora).
• Gli endpoint webhook che restituiscono errori in modo costante verranno disabilitati automaticamente dopo il seguente numero di errori:

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