# Cos'è un webhook e come funziona

{% stepper %}
{% step %}

### Definizione di Webhook

Un **webhook** è un indirizzo univoco, simile a un indirizzo di casa.

* Ogni task ha il proprio webhook dedicato.
  * Esempio: se creo la **Task 1** con trigger webhook, questa avrà un URL univoco diverso da quello della **Task 2**.
* Questo indirizzo è utilizzato per ricevere dati da sistemi esterni e avviare automaticamente la task.

{% hint style="info" %}
In sintesi: il webhook è come un **indirizzo di spedizione digitale** che permette alla piattaforma di ricevere lead e informazioni.
{% endhint %}
{% endstep %}

{% step %}

### A cosa serve il Webhook

Grazie ai webhook è possibile collegare la piattaforma a qualsiasi fonte di lead, tramite:

* **Software di automazione** (Zapier, Pabbly, Make, n8n, ecc.)
* **CRM** con workflow configurabili
* **Form online** (es. sito web, campagne pubblicitarie, Facebook Lead Ads)

Esempi di azioni che possono avviare una task tramite webhook:

* Un nuovo lead spostato in pipeline dal CRM
* Una richiesta proveniente da un form di Facebook
* Una compilazione di form sul sito aziendale
  {% endstep %}

{% step %}

### Parametri obbligatori

All’interno del webhook devono essere passati alcuni campi **obbligatori** in formato **JSON**:

{% code title="Esempio JSON" %}

```json
{
  "full_name": "Mario Rossi",
  "phone": "+39333111222",
  "email": "mario.rossi@example.com"
}
```

{% endcode %}
{% endstep %}

{% step %}

### Parametri extra

È anche possibile inviare campi aggiuntivi tramite la sezione **extra\_fields**, utile per personalizzare ulteriormente la task.\
Esempio:

{% code title="Esempio JSON con extra\_fields" %}

```json
{
  "full_name": "Giulia Bianchi",
  "phone": "+39344999888",
  "email": "giulia.bianchi@example.com",
  "extra_fields": {
    "eta": 29,
    "citta": "Milano",
    "interesse": "Corso di Marketing"
  }
}
```

{% endcode %}

Questi parametri personalizzati possono essere richiamati all’interno della task, ad esempio con:

* {{extra\_fields.eta}}
* {{extra\_fields.citta}}
  {% endstep %}

{% step %}

### Vantaggi del Webhook

* Automatizza l’acquisizione di lead da qualsiasi fonte.
* Consente di arricchire i dati con informazioni personalizzate.
* Garantisce la massima flessibilità nell’avvio delle conversazioni.
  {% endstep %}
  {% endstepper %}


---

# 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://docs.bookli.ai/task/cose-un-webhook-e-come-funziona.md?ask=<question>
```

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.