> 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 un 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) o nella piattaforma Advocate. Questo articolo di assistenza 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 a sinistra qui sotto *Impostazioni di Advocate*, seleziona **Webhook**.
3. Nella *Sottoscrizioni webhook* pagina, seleziona **Crea sottoscrizione**.
4. Di seguito *Invia all'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**.
#### Risolvi i problemi dei log dei webhook
Quando registri un URL a cui Advocate invia un post ogni volta che si verifica un evento nel tuo programma, puoi esaminare i log e risolvere eventuali eventi webhook non riusciti.
**Accedi ai log dei tuoi webhook**
1. Dalla barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna a 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 al *riferimento dei filtri* di seguito per ulteriori informazioni.
riferimento dei 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 è impostato per impostazione predefinita su *Tutti i tipi*. |
| Periodo | Filtra per il periodo in cui il webhook è stato aggiornato l'ultima volta. Questo filtro è impostato per impostazione predefinita su *Sempre*. |
**Visualizza i dettagli del webhook**
1. Seleziona un webhook specifico per aprire la *Dettagli del webhook* visualizzazione.
2. Questa vista fornisce informazioni che possono essere utilizzate per risolvere i problemi di una sottoscrizione webhook.
* Fai riferimento al *Riferimento evento* di seguito per ulteriori 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'identificativo 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 recapito 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 a ricevere una risposta dal server di destinazione. |
**Sistema di retry dei webhook per i recapiti di eventi non riusciti**
* I rest hook vengono recapitati immediatamente dopo che un evento viene attivato. Se l'endpoint non risponde con successo a un tentativo di recapito (cioè non risponde con un codice di stato diverso da 200), il recapito verrà considerato non riuscito.
* I recapiti non riusciti verranno ritentati ogni ora dopo il tentativo non riuscito precedente fino a quando non viene effettuato un recapito riuscito o finché non saranno stati effettuati 72 tentativi (circa 3 giorni al ritmo di 1 retry 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.