**Per ricevere eventi in tempo reale da Papo (https://papo.global/) via Webhook, configuri un URL di callback nel pannello di Papo utilizzando il modulo di Webhook nativi o il modulo Flows. Papo invia notifiche HTTP POST a questo URL ogni volta che si verificano eventi come nuova conversazione, creazione di un affare, aggiornamento della fase del funnel o nuovo contatto, permettendo di integrare il CRM con sistemi esterni senza esportazione manuale.**

Con i webhook in uscita, la tua operazione reagisce automaticamente ai cambiamenti nel CRM. Un nuovo lead può attivare un avviso su Slack, una conversazione non risposta può generare un'attività nel tuo sistema di gestione, e un affare chiuso può aggiornare la tua dashboard di vendite — tutto in tempo reale, senza polling o fogli di calcolo.

## Riepilogo della configurazione

| Fase | Cosa fare | Osservazione |
| :--- | :--- | :--- |
| **1. Preparare l'endpoint** | Creare un URL pubblico in grado di ricevere richieste HTTP POST con payload JSON. | Può essere un webhook di Zapier, Make, uno script su server o una funzione serverless. |
| **2. Accedere ai Webhook in Papo** | Nel pannello di Papo, individuare la sezione Webhook (nativi o via Flows). | I menu esatti possono variare; la funzionalità è disponibile nell'account. |
| **3. Creare il webhook** | Inserire l'URL di destinazione, selezionare gli eventi che devono attivare l'invio e salvare. | È possibile creare un webhook per più eventi o uno per ogni tipo. |
| **4. Testare l'integrazione** | Generare un evento di test (es.: creare un contatto) e verificare se l'endpoint ha ricevuto la notifica. | Papo invia il payload immediatamente dopo l'evento. |
| **5. Elaborare i dati** | Nel tuo sistema, interpretare il JSON ricevuto ed eseguire l'azione desiderata (salvare su database, inviare avviso, ecc.). | Il formato del payload segue lo schema dell'evento scelto. |

## Come funzionano i webhook in uscita di Papo

Papo offre due modi per inviare eventi a sistemi esterni:

- **Webhook nativi:** disponibili direttamente nella sezione Webhook dell'account. Crea una sottoscrizione per eventi del CRM (come nuova conversazione, affare creato, contatto aggiornato) e Papo invia un POST con i dati rilevanti all'URL configurato.
- **Webhook via Flows:** il modulo Flows permette di creare automazioni visuali con trigger di eventi e azioni webhook. È ideale quando hai bisogno di logica condizionale o di trasformare i dati prima dell'invio.

In entrambi i casi, il flusso è lo stesso: un evento accade in Papo → la piattaforma assembla un payload JSON → invia una richiesta HTTP POST all'URL di callback → il tuo sistema riceve ed elabora la notifica.

## Configurare un webhook nativo

1. **Prepara l'endpoint:** assicurati che l'URL accetti POST e sia accessibile pubblicamente. L'endpoint deve rispondere con status HTTP 2xx per confermare la ricezione.
2. **Nel pannello di Papo, accedi all'area Webhook:** individua l'opzione per creare un nuovo webhook nativo.
3. **Compila i campi:**
   - **URL di callback:** incolla l'indirizzo del tuo endpoint.
   - **Eventi:** seleziona gli eventi che desideri monitorare — ad esempio, “Conversazione Creata”, “Affare Aggiornato”, “Contatto Creato”.
   - **Formato:** il payload viene inviato in JSON, con i campi dell'oggetto interessato.
4. **Salva e attiva:** da quel momento, ogni occorrenza degli eventi scelti attiva una notifica.

## Configurare un webhook via Flows

Se hai bisogno di maggiore controllo (filtrare per condizioni, inviare solo alcuni campi o concatenare azioni), usa il modulo Flows:

1. Crea un nuovo Flow e definisci il **trigger** con l'evento desiderato (es.: “Affare Creato”).
2. Aggiungi un'**azione Webhook**.
3. Inserisci l'**URL** e mantieni il metodo come `POST`.
4. Nel corpo del messaggio, componi il JSON con le variabili dell'evento (es.: `{{deal.name}}`, `{{deal.value}}`).
5. Salva e attiva il Flow.

Questo approccio è lo stesso utilizzato nelle integrazioni con Google Sheets e Power BI, e permette di inviare esattamente i dati di cui il tuo sistema esterno ha bisogno.

## Eventi disponibili per la notifica

Gli eventi che possono attivare webhook dipendono dai moduli abilitati nel tuo account. Tra i più comuni ci sono:

- **Conversazioni:** nuova conversazione avviata, messaggio ricevuto, conversazione assegnata a un agente.
- **CRM / Kanban:** affare creato, affare spostato di fase, affare vinto o perso.
- **Contatti:** nuovo contatto aggiunto, campi personalizzati aggiornati.
- **Agenti:** modifica di stato, login.

L'elenco esatto degli eventi può essere consultato nell'interfaccia di creazione del webhook, che mostra le opzioni disponibili per il tuo account.

## A chi è utile questa integrazione

- **Team operativi** che necessitano di sincronizzare il CRM di Papo con ERP, sistemi di billing o strumenti di BI.
- **Sviluppatori** che desiderano estendere la piattaforma con logica personalizzata, come inviare notifiche su Slack o creare ticket in un help desk.
- **Rivenditori white label** che necessitano di monitorare l'attività dei clienti in tempo reale per offrire supporto proattivo.
- **Analisti di dati** che alimentano dashboard in tempo reale senza dipendere da esportazioni manuali.

## Domande frequenti

### Serve conoscenza tecnica per configurare un webhook?
Sì, è necessario comprendere il concetto di HTTP e JSON per preparare l'endpoint e interpretare il payload. Tuttavia, piattaforme come Zapier o Make permettono di creare il ricevitore senza codice.

### Quali eventi posso monitorare con i webhook?
Gli eventi disponibili variano in base ai moduli del tuo account. Nella schermata di creazione del webhook, vedi l'elenco completo. I più usati sono creazione di conversazione, aggiornamento di affare e nuovo contatto.

### Papo fornisce un URL di test?
No. L'URL di callback deve essere un endpoint che controlli tu. Puoi usare servizi come webhook.site per generare un URL temporaneo e validare l'invio.

### Posso usare lo stesso webhook per più eventi?
Sì. Nella configurazione del webhook nativo, puoi selezionare più eventi. Nei Flows, puoi creare più trigger o usare condizioni per gestire eventi diversi nello stesso flusso.

### I dati vengono inviati in tempo reale?
Sì. Non appena l'evento si verifica in Papo, il webhook viene attivato immediatamente. La latenza dipende solo dalla rete e dall'elaborazione del tuo endpoint.

### Cosa fare se il mio endpoint non riceve le notifiche?
Verifica se l'URL è accessibile pubblicamente, se accetta POST, se il firewall non blocca la richiesta e se il webhook è attivo in Papo. Puoi anche testare con un endpoint di debug come webhook.site.

## Leggi anche

- [Come integrare i webhook di Papo con Power BI per dashboard in tempo reale](/hc/papo/articles/come-integrare-webhook-papo-power-bi-dashboard-tempo-reale)
- [Come usare l'API di Papo per creare e aggiornare contatti in massa](/hc/papo/articles/come-usare-api-papo-creare-aggiornare-contatti-massa)

---

**[Inizia gratis e configura i tuoi webhook →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-ricevere-eventi-tempo-reale-papo-webhook-outbound&utm_content=it)**

Con il primo utente gratis, testi l'invio di eventi in tempo reale e integri Papo nei tuoi sistemi senza costi iniziali.