# Crea e gestisci le sottoscrizioni webhook di 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 richiesta 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](https://integrations.impact.com/impact-brand/docs/api-webhooks) oppure nella piattaforma Advocate. Questo articolo della guida spiegherà come gestire i webhook tramite la piattaforma Advocate.
#### Crea una sottoscrizione webhook
1. Dalla barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna di sinistra qui sotto *Impostazioni di Advocate*, seleziona **Webhook**.
3. Nella *Sottoscrizioni webhook* pagina, seleziona **Crea sottoscrizione**.
4. Di seguito *Pubblica su URL*, inserisci l'indirizzo univoco che l'applicazione usa per inviare aggiornamenti in tempo reale su eventi specifici.
5. Facoltativamente, sotto *Nome webhook*, inserisci il nome della nuova sottoscrizione webhook.
6. Seleziona **Salva**.
#### Risolvi i problemi dei log dei webhook
Quando registri un URL a cui Advocate invia i dati ogni volta che si verifica un evento nel tuo programma, puoi esaminare i log e risolvere i problemi di eventuali eventi webhook non riusciti.
**Accedi ai log dei tuoi webhook**
1. Dalla barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna di sinistra qui sotto *Impostazioni di Advocate*, seleziona **Webhook**.
3. Nella *Sottoscrizioni webhook* pagina, seleziona **Visualizza log**.
4. Usa i filtri qui sotto *Registro eventi webhook* per filtrare i webhook.
* Fai riferimento alla *riferimento dei filtri* qui sotto per maggiori informazioni.
riferimento dei filtri
| Filtro | Descrizione |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo | Filtra per il webhook [tipo di evento](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events). Questo filtro ha come impostazione predefinita *Tutti i tipi*. |
| Periodo | Filtra per il periodo in cui il webhook è stato aggiornato l'ultima volta. Questo filtro ha come impostazione predefinita *Sempre*. |
**Visualizza i dettagli del webhook**
1. Seleziona un webhook specifico per aprire la vista *Dettagli webhook* .
2. Questa vista fornisce informazioni che possono essere utilizzate per risolvere i problemi di una sottoscrizione webhook.
* Fai riferimento alla *Riferimento evento* qui sotto per maggiori informazioni.
Riferimento evento
| Filtro | Descrizione |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo | Il webhook [tipo di evento](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events). |
| ID webhook | L'identificatore univoco del webhook. |
| Data di creazione | La data in cui il webhook è stato creato. |
| Dati evento | Il webhook [payload](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-payloads). |
| 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 perché la richiesta ha impiegato troppo tempo per ricevere una risposta dal server di destinazione. |
**Sistema di retry dei webhook per le consegne di eventi non riuscite**
* I rest hook vengono recapitati immediatamente dopo che viene attivato un evento. Se l'endpoint non risponde correttamente a un tentativo di consegna (cioè non risponde con un codice di stato diverso da 200), la consegna verrà considerata non riuscita.
* Le consegne non riuscite verranno ritentate ogni ora dopo il tentativo non riuscito precedente, fino a quando non verrà effettuata una consegna riuscita oppure fino a quando non saranno stati effettuati 72 tentativi (circa 3 giorni al ritmo di 1 retry 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 |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.