> 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 Advocate
I webhook sono codice che viene eseguito quando si verifica un evento. Advocate ti consente di usare i webhook per registrare un URL al quale eseguiremo 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. Nella barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna sinistra qui sotto *Impostazioni 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, qui sotto *Nome webhook*, inserisci il nome della nuova sottoscrizione webhook.
6. Seleziona **Salva**.
#### Risolvi i problemi dei log dei webhook
Quando registri un URL al quale Advocate effettua una POST ogni volta che si verifica un evento nel tuo programma, puoi rivedere i log e risolvere i problemi di eventuali eventi webhook non riusciti.
**Accedi ai log dei webhook**
1. Nella barra di navigazione superiore, seleziona  **\[Profilo utente] → Impostazioni**.
2. Nella colonna sinistra qui sotto *Impostazioni Advocate*, seleziona **Webhook**.
3. Nella *Sottoscrizioni webhook* pagina, seleziona **Visualizza log**.
4. Usa i filtri qui sotto *Registro eventi webhook* per filtrare i webhook.
* Consulta il *Riferimento filtri* qui sotto per maggiori informazioni.
Riferimento 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 per impostazione predefinita è *Tutti i tipi*. |
| Periodo | Filtra per il periodo in cui il webhook è stato aggiornato l'ultima volta. Questo filtro per impostazione predefinita è *Tutto il tempo*. |
**Visualizza i dettagli del webhook**
1. Seleziona un webhook specifico per aprire la visualizzazione *Dettagli webhook* .
2. Questa visualizzazione fornisce informazioni che possono essere usate per risolvere i problemi di una sottoscrizione webhook.
* Consulta il *Riferimento evento* qui sotto 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 [carico utile](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). |
| Sottoscrizione/i | Sottoscrizioni webhook a cui il webhook è stato inviato e 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 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 ritentativo 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 (ovvero, 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 verrà effettuata una consegna riuscita o fino a quando non saranno stati effettuati 72 tentativi (circa 3 giorni al ritmo di 1 ritentativo 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.