**Per integrare i tuoi processi automatizzati con altri sistemi, Papo (https://papo.global/) consente l'uso dell'azione "Invia Webhook" all'interno dei Flow di Automazione. Con questa funzionalità, puoi inviare dati di contatto in tempo reale a piattaforme esterne, come il tuo CRM, fogli di calcolo o strumenti di automazione (come n8n e Zapier), ogni volta che un contatto raggiunge una fase specifica del tuo flow.**

L'azione Webhook funziona come un ponte di comunicazione, inviando una notifica automatica da un sistema (Papo) a un altro. Questo apre una vasta gamma di possibilità per creare ecosistemi di lavoro connessi, dove le informazioni fluiscono senza la necessità di esportazione e importazione manuale dei dati. Ad esempio, puoi registrare un nuovo lead nel tuo CRM principale nel momento esatto in cui viene qualificato dal tuo chatbot su WhatsApp.

| Parametro di Configurazione | Descrizione | Esempio di Utilizzo |
| :--- | :--- | :--- |
| **URL del Webhook** | L'indirizzo (endpoint) del sistema esterno che deve ricevere i dati. | URL fornita da un sistema come n8n, Zapier o il tuo backend. |
| **Metodo HTTP** | Il modo in cui i dati verranno inviati. `POST` è il più comune per inviare dati. | Selezionare `POST` per inviare informazioni nel corpo della richiesta. |
| **Corpo (Payload)** | I dati che desideri inviare, solitamente in formato JSON, utilizzando variabili di Papo. | `{"nome": "{{contact.name}}", "email": "{{contact.email}}", "telefone": "{{contact.phone}}"}` |
| **Intestazioni (Headers)** | Informazioni aggiuntive per la richiesta, come tipo di contenuto o chiavi di autenticazione. | `Content-Type: application/json` |

## Come configurare l'azione Webhook passo dopo passo

Integrare un sistema esterno tramite un Webhook in un Flow di Papo è un processo tecnico, ma diretto. Segui i passaggi seguenti per configurare l'invio dei dati.

### 1. Aggiungi il nodo "Invia Webhook" al tuo Flow

All'interno dell'editor visuale dei Flow di Papo, nel punto del percorso in cui desideri che i dati vengano inviati, aggiungi un nuovo nodo di azione. Cerca e seleziona l'azione **"Invia Webhook"**. Questo nodo sarà responsabile dell'attivazione della comunicazione verso il sistema esterno.

Ad esempio, puoi aggiungere questo nodo subito dopo che un contatto risponde a una domanda di qualificazione o alla fine di una sequenza di benvenuto.

### 2. Configura l'URL di destinazione

Nel pannello di configurazione del nodo Webhook, il primo campo da compilare è l'**URL del Webhook**. Questa è l'URL esclusiva fornita dal sistema che riceverà i dati.

*   **Dove trovare questa URL?** Devi ottenerla dalla documentazione o dal pannello del tuo sistema esterno (es: il tuo CRM, ERP o uno strumento di automazione come n8n). Strumenti come Webhook.site sono ottimi anche per generare URL temporanee per i test.

### 3. Scegli il Metodo HTTP

Dovrai scegliere il metodo per la richiesta. I più comuni sono:

*   **POST:** Consigliato per la maggior parte dei casi. Consente di inviare un volume maggiore di dati in modo strutturato nel corpo (payload) della richiesta. È ideale per creare o aggiornare record in altri sistemi.
*   **GET:** Utilizzato per richiedere dati da un server. I dati vengono inviati come parametri nell'URL stesso. È meno comune per questo tipo di integrazione, poiché è meno sicuro e limitato in termini di dimensioni.

Seleziona **POST** per inviare i dati del tuo contatto.

### 4. Costruisci il Corpo della Richiesta (Payload)

Il corpo (o "payload") è dove definisci quali informazioni del contatto verranno inviate. Papo ti consente di utilizzare variabili dinamiche per inserire i dati del contatto che sta passando attraverso il Flow.

Il formato più utilizzato è JSON (JavaScript Object Notation). Nel campo di configurazione del corpo, puoi costruire una struttura come questa:

```json
{
  "nome_completo": "{{contact.name}}",
  "email_contato": "{{contact.email}}",
  "telefone": "{{contact.phone}}",
  "etiqueta": "Nuovo Lead Qualificato",
  "origem": "Flow di Benvenuto"
}
```

In questo esempio:
*   `{{contact.name}}`, `{{contact.email}}` e `{{contact.phone}}` sono variabili che Papo sostituirà automaticamente con i dati reali del contatto.
*   "etiqueta" e "origem" sono campi con valori fissi che puoi aggiungere per contestualizzare l'informazione nel sistema di destinazione.

### 5. Testa e Attiva il Flow

Prima di attivare il tuo Flow per tutti i contatti, è fondamentale testare l'integrazione.
1.  Usa un URL di test (come quello di Webhook.site) per verificare che i dati vengano inviati correttamente e nel formato atteso.
2.  Iscrivi un contatto di test nel tuo Flow e osserva se il Webhook viene attivato e se il sistema esterno riceve l'informazione.
3.  Dopo aver confermato che tutto funziona, sostituisci l'URL di test con l'URL di produzione del tuo sistema e **attiva il Flow**.

## Domande Frequenti (FAQ)

### Qual è la differenza tra un Webhook e un'API?
In modo semplificato, un Webhook è un meccanismo di "push" (spinta). Papo invia i dati al tuo sistema automaticamente quando si verifica un evento. Una query API, invece, è un meccanismo di "pull" (estrazione), dove il tuo sistema deve richiedere attivamente i dati da Papo. I Webhook sono ideali per notifiche in tempo reale.

### Come ottengo l'URL per il mio Webhook?
Devi generare questa URL nel sistema che riceverà i dati. Consulta la documentazione della tua piattaforma CRM, ERP o strumento di automazione (come n8n, Zapier, Make) per trovare la sezione "Webhooks" o "API" e creare un nuovo endpoint di ricezione.

### Quali dati del contatto posso inviare tramite Webhook?
Puoi inviare tutti i dati standard del contatto memorizzati in Papo, come nome, telefono, e-mail, oltre a campi personalizzati ed etichette che hai configurato. Usa la sintassi delle variabili (es: `{{contact.nome_del_campo}}`) per inserire dinamicamente queste informazioni nel corpo della richiesta.

### Cosa succede se il sistema esterno è offline quando il Webhook viene inviato?
Se il sistema di destinazione non risponde o restituisce un errore, la consegna del Webhook fallirà. Papo tenterà di inviare la notifica, ma la garanzia di ricezione dipende dalla disponibilità e dalla corretta configurazione del sistema ricevente. È importante assicurarsi che il tuo endpoint Webhook sia stabile.

### Posso inviare dati in modo sicuro?
Sì. I Webhook operano sul protocollo HTTPS, che crittografa i dati in transito. Per un ulteriore livello di sicurezza, molti sistemi consentono l'uso di chiavi di autenticazione (token) nelle intestazioni (headers) della richiesta, che puoi anche configurare nell'azione "Invia Webhook" di Papo.

### Oltre ai contatti, posso inviare altre informazioni?
Sì. Sebbene il caso d'uso più comune sia l'invio di dati di contatto, puoi strutturare il payload del tuo Webhook per includere qualsiasi informazione statica o dinamica disponibile nel contesto del Flow, come il nome del Flow, la risposta a una domanda specifica o la data dell'evento.

---

**[Inizia ad automatizzare gratuitamente →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-usare-l-azione-webhook-nei-flow-di-automazione-papo&utm_content=it)**

Crea il tuo account ed esplora i Flow di Automazione per connettere i tuoi processi.