Comment recevoir des alertes de nouvelles conversations sur Telegram

Pour recevoir une notification sur Telegram chaque fois qu’un client démarre une conversation dans une boîte de réception spécifique de Papo (https://papo.global/), vous devez configurer un Flow qui déclenche un Webhook vers un service intermédiaire qui transmet le message au chat souhaité. Cela permet à votre équipe de support ou de vente de rester alertée en temps réel, sans avoir à surveiller constamment la plateforme.

Papo n’envoie pas le message directement vers Telegram. Ce qu’elle fait, c’est déclencher un Webhook avec les données de la nouvelle conversation. Un intermédiaire — comme une automatisation dans Make, n8n, un script personnalisé ou un endpoint serverless — reçoit ce Webhook et appelle l’API de Telegram pour livrer l’alerte dans le chat choisi.

Comment ça marche — étape par étape

1. Préparez Telegram

Avant tout, vous avez besoin d’un bot sur Telegram et de l’ID du chat qui recevra les alertes. Parlez à @BotFather sur Telegram pour créer un nouveau bot et obtenir le token d’accès (quelque chose comme 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11). Ensuite, ajoutez le bot au groupe ou au canal souhaité et obtenez le chat_id. Une méthode simple consiste à envoyer un message au bot et à accéder à https://api.telegram.org/bot<SEU_TOKEN>/getUpdates pour capturer l’ID. Notez le token et le chat_id — ils seront utilisés par l’intermédiaire.

2. Configurez l’intermédiaire

Vous avez besoin d’un endpoint qui reçoit le Webhook de Papo et appelle l’API de Telegram. Cela peut être une automatisation dans Make (Integromat), un workflow dans n8n, une fonction serverless (AWS Lambda, Cloudflare Workers) ou un script sur votre serveur. L’endpoint doit :

• Accepter les requêtes POST avec le payload envoyé par Papo.
• Extraire les informations pertinentes (nom du contact, texte du message, boîte de réception).
• Construire un appel vers https://api.telegram.org/bot<TOKEN>/sendMessage avec les paramètres chat_id et text. Exemple de payload que l’intermédiaire peut recevoir de Papo :

{
  "contact_name": "{{contact.name}}",
  "message_text": "{{message.text}}",
  "inbox_name": "{{inbox.name}}"
}

Avec ces données, l’intermédiaire envoie à Telegram un message comme : « Nouvelle conversation de Maria Silva dans la boîte WhatsApp Ventes : “Je veux planifier une démonstration” ».

3. Créez le Flow dans Papo

Dans le panneau Papo, accédez au module Flows et créez un nouveau flux. Donnez-lui un nom qui identifie l’alerte, comme « Notification Telegram – Nouvelles conversations ».

Ajoutez un nœud Déclencheur et définissez que le flux sera lancé lorsqu’une Nouvelle conversation arrive. Choisissez la boîte de réception spécifique (par exemple, le numéro WhatsApp, Instagram ou Telegram connecté) qui doit générer l’alerte.

Après le déclencheur, insérez un nœud Action et sélectionnez Envoyer un Webhook. Remplissez :

• URL : collez l’URL de l’endpoint créé à l’étape 2.
• Méthode : conservez POST.
• Payload : construisez le JSON avec les variables disponibles dans le contexte de la conversation, comme {{contact.name}}, {{message.text}} et {{inbox.name}}. L’intermédiaire utilisera ces champs pour composer le message Telegram.

4. Activez et testez le flux

Enregistrez et activez le flux. Pour tester, envoyez un message à la boîte de réception configurée — par exemple, parlez à votre propre numéro WhatsApp connecté à Papo. En quelques secondes, la notification doit apparaître dans le chat Telegram. Si elle n’arrive pas, vérifiez :

• Si le flux est actif et si le journal d’exécutions dans le module Flows n’affiche pas d’erreurs.
• Si l’intermédiaire reçoit bien la requête et appelle correctement l’API de Telegram.
• Si le token et le chat_id Telegram sont valides.

À qui cette intégration est utile

• Les équipes de support qui utilisent Telegram comme centrale de communication et ont besoin d’alertes immédiates sur les nouveaux tickets.
• Les équipes de vente qui surveillent les leads entrants sur des canaux spécifiques, comme une boîte WhatsApp de campagne.
• Les opérations qui souhaitent consolider les notifications de plusieurs canaux dans un seul groupe Telegram, sans alterner entre les onglets.
• Les managers qui suivent le volume de nouvelles conversations en temps réel directement dans la messagerie.

Questions fréquentes

Dois-je avoir un bot sur Telegram pour recevoir les alertes ?

Oui. Il est nécessaire de créer un bot via @BotFather et d’obtenir le token d’accès. Le bot sera chargé d’envoyer les messages vers le chat (groupe, canal ou conversation privée) que vous définissez.

Puis-je envoyer les notifications vers un groupe Telegram ?

Oui. Il suffit d’ajouter le bot au groupe et d’obtenir le chat_id du groupe (généralement un nombre négatif). L’intermédiaire doit utiliser ce chat_id dans l’appel à l’API de Telegram.

Que faire si la notification n’arrive pas sur Telegram ?

Vérifiez l’exécution du Flow dans le module Flows de Papo. Si le Webhook a été déclenché avec succès, le problème peut venir de l’intermédiaire : vérifiez s’il a reçu la requête et si l’appel à l’API de Telegram a renvoyé une erreur. Testez l’endpoint manuellement avec un payload d’exemple.

Puis-je choisir quelles boîtes de réception génèrent les alertes ?

Oui. Dans le déclencheur Nouvelle conversation, vous définissez la boîte de réception spécifique qui sera surveillée. Pour notifier différentes boîtes dans des chats distincts, créez un flux séparé pour chaque boîte et pointez vers l’endpoint correspondant.

Comment tester l’intégration sans déranger l’équipe ?

Utilisez un contact de test — par exemple, votre propre numéro personnel — et envoyez un message à la boîte configurée. Confirmez que l’alerte apparaît uniquement dans le chat de test. Vous pouvez supprimer le flux de test après validation.

Y a-t-il un coût supplémentaire pour utiliser les Webhooks dans Papo ?

Les fonctionnalités Flows et l’envoi de Webhooks sont inclus dans les forfaits Papo. Des informations détaillées sur les limites et les abonnements sont disponibles sur le site officiel.

Lire aussi

• Comment recevoir les événements en temps réel de Papo via Webhook (outbound)
• Comment utiliser l’API de Papo pour gérer les Flows d’automatisation

Commencez gratuitement → Créez votre compte gratuit Papo et commencez à recevoir des alertes sur Telegram dès aujourd’hui.