**Per ricevere una notifica su Telegram ogni volta che un cliente avvia una conversazione in una casella di posta specifica in Papo (https://papo.global/), devi configurare un Flow che attiva un Webhook verso un servizio intermediario che inoltra il messaggio alla chat desiderata. In questo modo il tuo team di supporto o vendite resta allertato in tempo reale, senza dover monitorare costantemente la piattaforma.** Papo non invia il messaggio direttamente a Telegram. Quello che fa è attivare un Webhook con i dati della nuova conversazione. Un intermediario — come un'automazione in Make, n8n, uno script personalizzato o un endpoint serverless — riceve questo Webhook e chiama l'API di Telegram per consegnare l'avviso nella chat scelta. | Fase | Azione | Strumento | | :--- | :--- | :--- | | 1. Preparare Telegram | Creare un bot e ottenere il token di accesso e l'ID della chat di destinazione | BotFather, Telegram | | 2. Configurare l'intermediario | Creare un endpoint che riceva il Webhook da Papo e invii il messaggio tramite l'API di Telegram | Servizio di automazione o codice proprio | | 3. Creare il Flow in Papo | Configurare un nuovo flusso con trigger “Nuova conversazione” e azione “Webhook” che punta all'endpoint | Modulo Flows (Papo) | | 4. Testare la notifica | Avviare una conversazione nella casella di posta scelta e verificare l'arrivo del messaggio nella chat di Telegram | Papo + Telegram | ## Come funziona — passo dopo passo ### 1. Prepara Telegram Prima di tutto, ti serve un bot su Telegram e l'ID della chat che riceverà gli avvisi. Parla con **@BotFather** su Telegram per creare un nuovo bot e ottenere il token di accesso (qualcosa come `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`). Poi aggiungi il bot al gruppo o canale desiderato e ottieni il **chat_id**. Un modo semplice è inviare un messaggio al bot e accedere a `https://api.telegram.org/bot/getUpdates` per catturare l'ID. Annota il token e il chat_id — saranno usati dall'intermediario. ### 2. Configura l'intermediario Ti serve un endpoint che riceva il Webhook da Papo e chiami l'API di Telegram. Può essere un'automazione in Make (Integromat), un workflow in n8n, una funzione serverless (AWS Lambda, Cloudflare Workers) o uno script sul tuo server. L'endpoint deve: - Accettare richieste POST con il payload inviato da Papo. - Estrarre le informazioni rilevanti (nome del contatto, testo del messaggio, casella di posta). - Costruire una chiamata a `https://api.telegram.org/bot/sendMessage` con i parametri `chat_id` e `text`. Esempio di payload che l'intermediario può ricevere da Papo: ```json { "contact_name": "{{contact.name}}", "message_text": "{{message.text}}", "inbox_name": "{{inbox.name}}" } ``` Con questi dati, l'intermediario invia a Telegram un messaggio come: “Nuova conversazione da Maria Silva nella casella WhatsApp Vendite: ‘Voglio prenotare una demo’”. ### 3. Crea il Flow in Papo Nel pannello di Papo, accedi al modulo **Flows** e crea un nuovo flusso. Dagli un nome che identifichi l'avviso, come “Notifica Telegram – Nuove conversazioni”. Aggiungi un nodo **Trigger** e definisci che il flusso verrà avviato quando arriva una **Nuova conversazione**. Scegli la casella di posta specifica (ad esempio, il numero di WhatsApp, Instagram o Telegram collegato) che deve generare l'avviso. Dopo il trigger, inserisci un nodo **Azione** e seleziona **Invia Webhook**. Compila: - **URL**: incolla l'URL dell'endpoint creato nel passo 2. - **Metodo**: mantieni POST. - **Payload**: componi il JSON con le variabili disponibili nel contesto della conversazione, come `{{contact.name}}`, `{{message.text}}` e `{{inbox.name}}`. L'intermediario userà questi campi per comporre il messaggio di Telegram. ### 4. Attiva e testa il flusso Salva e attiva il flusso. Per testare, invia un messaggio alla casella di posta configurata — ad esempio, parla con il tuo numero di WhatsApp collegato a Papo. In pochi secondi, la notifica dovrebbe apparire nella chat di Telegram. Se non arriva, verifica: - Se il flusso è attivo e il log delle esecuzioni nel modulo Flows non mostra errori. - Se l'intermediario sta ricevendo la richiesta e chiamando l'API di Telegram correttamente. - Se il token e il chat_id di Telegram sono validi. ## A chi è utile questa integrazione - Team di supporto che usano Telegram come centrale di comunicazione e hanno bisogno di avvisi immediati sui nuovi ticket. - Team di vendita che monitorano lead in entrata su canali specifici, come una casella WhatsApp di campagna. - Operazioni che desiderano consolidare notifiche da più canali in un unico gruppo Telegram, senza alternare tra le schede. - Manager che monitorano il volume di nuove conversazioni in tempo reale direttamente nel messenger. ## Domande frequenti ### Devo avere un bot su Telegram per ricevere gli avvisi? Sì. È necessario creare un bot tramite @BotFather e ottenere il token di accesso. Il bot sarà responsabile dell'invio dei messaggi alla chat (gruppo, canale o conversazione privata) che definisci. ### Posso inviare le notifiche a un gruppo Telegram? Sì. Basta aggiungere il bot al gruppo e ottenere il chat_id del gruppo (di solito un numero negativo). L'intermediario deve usare questo chat_id nella chiamata all'API di Telegram. ### Cosa fare se la notifica non arriva su Telegram? Verifica l'esecuzione del Flow nel modulo Flows di Papo. Se il Webhook è stato attivato con successo, il problema potrebbe essere nell'intermediario: controlla se ha ricevuto la richiesta e se la chiamata all'API di Telegram ha restituito un errore. Testa l'endpoint manualmente con un payload di esempio. ### Posso scegliere quali caselle di posta generano gli avvisi? Sì. Nel trigger **Nuova conversazione**, definisci la casella di posta specifica che sarà monitorata. Per notificare caselle diverse in chat distinti, crea un flusso separato per ogni casella e puntalo all'endpoint corrispondente. ### Come testo l'integrazione senza disturbare il team? Usa un contatto di test — ad esempio, il tuo numero personale — e invia un messaggio alla casella configurata. Conferma che l'avviso appaia solo nella chat di test. Puoi eliminare il flusso di test dopo averlo validato. ### C'è un costo aggiuntivo per usare i Webhook in Papo? Le funzionalità Flows e l'invio di Webhook sono inclusi nei piani di Papo. Informazioni dettagliate su limiti e abbonamenti sono disponibili sul sito ufficiale. ## Leggi anche - [Come ricevere eventi in tempo reale da Papo via Webhook (outbound)](/hc/papo/articles/come-ricevere-eventi-tempo-reale-papo-webhook-outbound) - [Come usare l'API di Papo per gestire Flows di automazione](/hc/papo/articles/come-usare-api-papo-gestire-flow-automazione) --- **[Inizia gratis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=come-ricevere-avvisi-nuove-conversazioni-telegram&utm_content=it)** Crea il tuo account gratuito su Papo e inizia a ricevere avvisi su Telegram già oggi.