Come ricevere avvisi di nuove conversazioni su Telegram

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.

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<SEU_TOKEN>/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<TOKEN>/sendMessage con i parametri chat_id e text. Esempio di payload che l'intermediario può ricevere da Papo:

{
  "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)
• Come usare l'API di Papo per gestire Flows di automazione

Inizia gratis →

Crea il tuo account gratuito su Papo e inizia a ricevere avvisi su Telegram già oggi.