> 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 consente di usare i webhook per registrare un URL a cui invieremo una richiesta POST ogni volta che si verifica un evento nel programma, ad esempio quando viene creato un codice coupon personalizzato per un nuovo partecipante e 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 spiega come gestire i webhook tramite la piattaforma Advocate.

#### Creare una sottoscrizione webhook

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profilo utente] → Impostazioni**.
2. Nella colonna a sinistra, sotto *Impostazioni di Advocate*, seleziona **Webhook**.
3. Nella pagina *Sottoscrizioni webhook* , seleziona **Crea sottoscrizione**.
4. In *Invia a URL*, inserisci l'indirizzo univoco che l'applicazione usa per inviare aggiornamenti in tempo reale su eventi specifici.
5. Facoltativamente, in *Nome webhook*, inserisci il nome della nuova sottoscrizione webhook.
6. Seleziona **Salva**.

#### Risoluzione dei problemi nei log dei webhook

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

**Accedere ai log dei webhook**

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profilo utente] → Impostazioni**.
2. Nella colonna a sinistra, sotto *Impostazioni di Advocate*, seleziona **Webhook**.
3. Nella pagina *Sottoscrizioni webhook* , seleziona **Visualizza log**.
4. Usa i filtri qui sotto *Registro eventi webhook* per filtrare i webhook.
   * Per ulteriori informazioni, consulta *Riferimento dei filtri* qui sotto.

<details>

<summary>Riferimento del filtro</summary>

| Filtro  | Descrizione                                                                                                                                                                                                      |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo    | Filtra per il [tipo di evento](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). Il valore predefinito di questo filtro è *Tutti i tipi*. |
| Periodo | Filtra in base al periodo in cui il webhook è stato aggiornato l'ultima volta. Il valore predefinito di questo filtro è *Tutto il periodo*.                                                                      |

</details>

**Visualizzare i dettagli del webhook**

1. Seleziona un webhook specifico per aprire la vista *Dettagli webhook* .
2. Questa vista fornisce informazioni utili per risolvere i problemi di una sottoscrizione webhook.
   * Per ulteriori informazioni, consulta *Riferimento degli eventi* qui sotto.

<details>

<summary>Riferimento degli eventi</summary>

| Filtro                        | Descrizione                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Tipo                          | Tipo di evento [del webhook](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 è stato creato il webhook.                                                                                                                                                                                                                                                                                                                          |
| Dati dell'evento              | Il payload [del webhook](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs).                                                                                                                                                                                                                  |
| Sottoscrizione/i              | Le sottoscrizioni del webhook a cui è stato inviato il webhook e il relativo stato.                                                                                                                                                                                                                                                                                |
| Dettagli della sottoscrizione | Dettagli sulla risposta ricevuta dall'endpoint della sottoscrizione del webhook. Possono includere i tentativi di consegna del webhook, con l'indicazione del timestamp del tentativo, del codice di stato HTTP ricevuto dalla destinazione e dell'eventuale timeout dovuto al tempo eccessivo impiegato dal server di destinazione per rispondere alla richiesta. |

</details>

**Sistema di ripetizione dei tentativi dei webhook per le consegne degli eventi non riuscite**

* Gli hook REST vengono recapitati immediatamente dopo il verificarsi di un evento. Se l'endpoint non risponde correttamente a un tentativo di consegna (ovvero, risponde con un codice di stato diverso da 200), la consegna viene considerata non riuscita.
* Le consegne non riuscite verranno ritentate ogni ora dopo il tentativo non riuscito precedente, fino a quando la consegna non andrà a buon fine oppure non saranno stati effettuati 72 tentativi (circa 3 giorni, al ritmo di 1 nuovo tentativo all'ora).
* Gli endpoint dei webhook che restituiscono errori in modo continuativo verranno disattivati 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=<question>&goal=<user_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.
