> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md).
# 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 effettueremo 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](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs) 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 sinistra qui sotto *Impostazioni di Advocate*, seleziona **Webhook**.
3. Nel *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 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 eventuali eventi webhook che falliscono.
**Accedi ai log dei tuoi webhook**
1. Dalla barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna sinistra qui sotto *Impostazioni di Advocate*, seleziona **Webhook**.
3. Nel *Sottoscrizioni webhook* pagina, seleziona **Visualizza log**.
4. Usa i filtri qui sotto *Registro eventi webhook* per filtrare i webhook.
* Fai riferimento alla *guida ai filtri* di seguito per maggiori informazioni.
guida ai filtri
| Filtro | Descrizione |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo | Filtra per il webhook [tipo di evento](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). Questo filtro predefinito è *Tutti i tipi*. |
| Periodo | Filtra per il periodo in cui il webhook è stato aggiornato l'ultima volta. Questo filtro predefinito è *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* di seguito per maggiori informazioni.
Riferimento evento
| Filtro | Descrizione |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo | Il webhook [tipo di evento](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). |
| 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/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). |
| Sottoscrizione/i | Le sottoscrizioni webhook a cui il webhook è stato inviato e il loro stato. |
| Dettagli della 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 è andato in timeout perché la richiesta ha impiegato troppo tempo per ricevere una risposta dal server di destinazione. |
**Sistema di ripetizione dei webhook per le consegne di eventi fallite**
* I rest hook vengono recapitati immediatamente dopo che un evento viene attivato. Se l'endpoint non risponde correttamente a un tentativo di consegna (cioè non risponde con un codice di stato diverso da 200), la consegna sarà considerata fallita.
* Le consegne fallite verranno ritentate ogni ora dopo il precedente tentativo fallito, finché non verrà effettuata una consegna riuscita o finché non saranno stati effettuati 72 tentativi (circa 3 giorni al ritmo di 1 nuovo tentativo all'ora).
* Gli endpoint 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 |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.