Your AI Connector Docs

Telegram (Bêta)

Connectez votre compte Telegram existant à la plateforme afin que vos conversations Telegram soient directement intégrées dans l’application et qu’un agent IA puisse y répondre. Vous vous connectez en saisissant votre numéro de téléphone et un code de connexion — de la même manière que vous ajouteriez Telegram sur un nouvel appareil.

Bêta. Telegram est désormais disponible pour tout le monde, mais il s’agit d’une nouveauté — attendez-vous à quelques imperfections pendant que nous l’affinons. Si quelque chose ne fonctionne pas comme décrit, veuillez en informer le support.


Qu’est-ce que l’intégration Telegram ?

L’intégration Telegram relie votre compte Telegram personnel à la plateforme en utilisant le flux de connexion propre à Telegram. Il n’y a aucun bot à créer ni aucun numéro de téléphone supplémentaire à acheter : vous vous connectez avec le compte Telegram que vous utilisez déjà, et vos discussions individuelles deviennent disponibles au sein de l’application.

C’est la solution idéale pour les entreprises qui communiquent déjà avec leurs clients sur Telegram et qui souhaitent ajouter un agent IA, des diffusions et une boîte de réception partagée à leur compte existant.

Important — à lire avant de vous connecter. Il s’agit d’une intégration non officielle qui automatise un compte Telegram personnel. Les règles de Telegram découragent l’automatisation ainsi que l’envoi de messages en masse ou non sollicités. Les comptes qui enfreignent ces règles peuvent être restreints ou bannis définitivement (dans certains cas, le numéro de téléphone lui-même peut être bloqué pour toute réinscription). Utilisez ce canal uniquement pour contacter des personnes qui vous ont déjà contacté ou qui sont dans vos contacts enregistrés, maintenez des volumes faibles et laissez l’IA répondre à un rythme naturel. N’utilisez pas ce canal pour du démarchage à froid en masse.


Telegram vs WhatsApp Web

Les deux permettent de connecter un compte que vous possédez déjà, sans passer par une API Business officielle.

Fonctionnalité Telegram WhatsApp Web
Configuration Saisir le numéro de téléphone + code de connexion Associer votre téléphone (QR ou code d’association)
Type de compte Votre compte Telegram personnel Votre WhatsApp personnel/professionnel
Coût par message Gratuit Gratuit
Messages modèles Non applicable Non pris en charge
Indicateurs de saisie Pris en charge Pris en charge
Média (entrant) Photos, documents, notes vocales Photos, documents, notes vocales
Support officiel Intégration non officielle Intégration non officielle
Idéal pour Entreprises déjà actives sur Telegram, contacts chaleureux/existants Entreprises sur WhatsApp, démarrage rapide

Le même numéro sur les deux ? Oui. Si le même numéro de téléphone est utilisé à la fois sur Telegram et WhatsApp (Web), vous pouvez le connecter en tant que deux canaux distincts — ils fonctionnent comme deux connexions séparées sur la page Canaux, chacune avec son propre statut, sa période de chauffe et ses limites. La connexion de l’un n’affecte ni ne remplace l’autre.


Configuration de Telegram

Étape 1 : Ouvrir le flux de connexion

  1. Dans la barre latérale gauche, cliquez sur Settings près du bas.
  2. Dans le menu de gauche des paramètres, sous Channels, cliquez sur Channels.
  3. Trouvez la carte Telegram — elle porte une mention Beta — et cliquez sur Connect.

Étape 2 : Saisir votre numéro de téléphone

  1. Saisissez le numéro de téléphone du compte Telegram que vous souhaitez connecter, en incluant l’indicatif pays (par exemple 555 123 4567).
  2. Activez Importer les conversations existantes si vous souhaitez importer vos récentes conversations Telegram individuelles en tant que contacts, afin de ne pas commencer avec une boîte de réception vide. (L’activation de cette option vous permet également de contrôler Garder l’IA en pause pour les conversations importées — recommandé et activé par défaut, afin que l’importation de votre historique ne déclenche jamais de réponses automatiques à d’anciens messages. Vous pourrez désactiver cette option par contact plus tard, une fois que vous serez prêt.)
  3. Cliquez sur Envoyer le code de connexion.
  4. Telegram envoie un code de connexion à votre application Telegram (il arrive généralement sous forme de message provenant de la discussion de service officielle « Telegram », et pas toujours par SMS).

Étape 3 : Saisir le code de connexion

  1. Ouvrez Telegram sur votre téléphone.
  2. Lisez le code de connexion dans la discussion de service Telegram.
  3. Saisissez le code dans l’application.
  4. Cliquez sur Vérifier le code.

Le code expire rapidement. Ayez votre téléphone à portée de main avant de cliquer sur Envoyer le code de connexion et saisissez le code rapidement. S’il expire, recommencez la connexion pour en obtenir un nouveau.

Étape 4 : Mot de passe à deux facteurs (si vous en avez un)

Si votre compte Telegram a la validation en deux étapes activée, l’application vous demandera votre mot de passe 2FA après le code. Saisissez-le, puis cliquez sur Vérifier le mot de passe. Votre mot de passe est utilisé uniquement pour finaliser la connexion sécurisée et n’est jamais stocké sous une forme lisible.

Une fois vérifié, votre compte apparaît sur la page Canaux comme Connecté. Vos conversations Telegram sont désormais accessibles via la plateforme, et un agent IA affecté à ce canal peut répondre aux messages entrants.

Importation de vos discussions existantes

Si vous avez activé Importer les conversations existantes à l’étape 2 :

  • Seuls les chats privés (individuels) récents sont importés. Les chats de groupe ne sont pas inclus, et seule une quantité limitée d’historique récent est récupérée par chat.
  • L’importation s’exécute une seule fois, en arrière-plan, juste après votre connexion. Pour les comptes plus volumineux, il peut s’écouler un certain temps avant que tout n’apparaisse.
  • Les messages importés complètent la conversation dans Chats, mais ils ne sont pas pris en compte dans les chiffres ou les graphiques de votre Tableau de bord. Seuls les messages envoyés et reçus après la connexion y sont mesurés.

Si vous vous connectez sans importer, les nouvelles conversations arrivent normalement à partir de ce moment-là — seul l’historique plus ancien est ignoré.


Gestion de session

Vérification de l’état de la connexion

L’état de votre connexion Telegram est affiché sur la carte Telegram de la page Canaux :

Statut Signification
Connecté Actif et en train de recevoir/envoyer des messages
Code envoyé En attente de la saisie du code de connexion
Double authentification requise En attente de votre mot de passe de vérification en deux étapes
Non connecté Aucune session active

Reconnexion

Si votre session est interrompue, ouvrez Paramètres → Canaux → Canaux, trouvez la carte Telegram et utilisez son action de connexion/gestion. Si la session ne peut pas être restaurée automatiquement (par exemple, si vous l’avez terminée depuis votre téléphone), il vous sera demandé de vous reconnecter avec un nouveau code.

Déconnexion

Ouvrez la carte Telegram et cliquez sur Déconnecter. Cela déconnecte la plateforme de votre compte Telegram et nettoie la session. Vous pouvez également y mettre fin depuis Telegram lui-même : Paramètres → Appareils → Sessions actives, puis terminez la session de la plateforme.


Rester en sécurité sur Telegram

Comme cela automatise un compte personnel, il est de votre responsabilité de le protéger contre les bannissements. La plateforme cadence l’IA et les envois sortants pour qu’ils paraissent naturels, mais suivez ces pratiques :

  • Envoyez des messages uniquement aux contacts chaleureux/existants. Répondez aux personnes qui vous ont contacté en premier ou qui sont des contacts enregistrés. Évitez de contacter des inconnus en masse — c’est le moyen le plus rapide de déclencher le signalement de spam de Telegram.
  • Maintenez des volumes faibles, surtout sur un compte nouvellement connecté. Augmentez progressivement sur plusieurs jours, pas tout d’un coup.
  • Évitez d’envoyer des liens à des personnes qui ne vous connaissent pas — les messages contenant beaucoup de liens envoyés à des inconnus sont une cause fréquente de bannissement.
  • Laissez l’IA répondre à un rythme naturel. Les délais intégrés et l’indicateur de saisie sont là pour garder la conversation humaine — n’essayez pas de les contourner.
  • Utilisez un vrai numéro que vous contrôlez. Les numéros jetables / virtuels (VoIP — un numéro de téléphone basé sur Internet, pas une carte SIM physique) sont beaucoup plus susceptibles d’être signalés.

Avertissement. Si Telegram signale le compte pour spam, l’envoi s’arrête jusqu’à ce que le comportement change — attendre seul ne suffit pas à lever le signalement. Des violations répétées peuvent entraîner le bannissement permanent du compte et de son numéro de téléphone.


Limites d’envoi, montée en charge (warm-up) et contrôles des suivis

Telegram utilise les mêmes limites d’envoi protectrices, le même préchauffage automatique et le même coupe-circuit de suivi par compte que WhatsApp Web. Ils existent pour éviter qu’un compte personnel ne ressemble à une ferme à spam et ne soit signalé. Sur la page Canaux, une fois votre compte Telegram connecté, vous verrez :

  • Une carte Limites d’envoi et préchauffage avec les mêmes compteurs que WhatsApp Web — messages envoyés aujourd’hui, nouveaux contacts aujourd’hui et jour de préchauffage actuel.
  • Un commutateur Suivis automatisés — il est activé par défaut pour un numéro nouvellement connecté, donc désactivez-le vous-même tant que le numéro est encore en phase de préchauffage. Il reste interactif tout du long, mais indique quels seuils de préchauffage (âge du numéro, montée en charge de l’activité, engagement récent des contacts) n’ont pas encore été atteints.

Montée en charge automatique (ramp)

Un compte Telegram fraîchement connecté est intentionnellement limité et débloque plus de capacité au fil du temps. Le compte ne gagne un « jour de qualification » que les jours où il envoie réellement au moins 75 % de son plafond actuel — les jours d’inactivité ne comptent pas, le compte ne peut donc pas progresser sans une utilisation réelle et constante.

  • Limite quotidienne de messages = 50 + 8 × (day − 1), plafonnée à 500/jour (atteinte au jour 58).
  • Limite quotidienne de nouveaux contacts = floor((day − 1) × 5 / 6) (arrondi à l’entier inférieur), plafonnée à 50/jour (atteinte au jour 61).

Ainsi, sur un nouveau compte, vous commencez à 50 messages/jour et 0 nouveau contact/jour, pour atteindre le plafond maximal en deux mois environ. La page Canaux affiche le jour actuel, l’utilisation d’aujourd’hui par rapport au plafond et la progression restante.

Conseil : Si vous connectez un compte qui a déjà des mois d’historique Telegram authentique, le panneau de montée en charge vous permet d’avancer le jour de préchauffage afin que les limites soient levées immédiatement. Utilisez cette option honnêtement — uniquement pour les comptes qui ont réellement un historique organique. Un compte flambant neuf qui saute le préchauffage est beaucoup plus susceptible d’être banni.

Dépassement manuel après la montée en charge

Une fois qu’un compte a terminé la montée en charge complète de 58 jours, une option de dépassement vous permet de pousser le plafond quotidien de messages au-delà de 500 (de 750 jusqu’à 5 000, par paliers de 250 messages). Il n’existe pas de chiffre « sûr » publié pour Telegram — restez prudent, surveillez les signalements de spam et réduisez la cadence dès que vous rencontrez des problèmes. Le dépassement n’est disponible que sur les comptes ayant terminé leur montée en charge ; un nouveau compte ne peut pas ignorer cette étape de cette manière.

Coupe-circuit de suivi par compte

Le bouton Suivis automatisés contrôle uniquement ce compte. Lorsqu’il est désactivé, aucun suivi automatisé d’aucune sorte n’est envoyé depuis ce compte, quelles que soient vos configurations de diffusion ou de campagne. Sur un nouveau compte (moins de ~30 jours de montée en charge), il est plus sûr de laisser les suivis désactivés et d’envoyer uniquement la réponse initiale — les suivis sont ce qui fait le plus souvent basculer un compte à faible confiance dans la classification “c’est un bot”. Réactivez-le une fois que le compte est préchauffé et stable.

Lorsque le plafond quotidien de messages est atteint, les suivis programmés sont automatiquement reportés au lendemain plutôt que d’échouer.


Messages multimédias

Les photos, documents et notes vocales entrants sont intégrés dans le chat afin que l’IA puisse les comprendre (les notes vocales sont transcrites automatiquement). Les réponses sortantes de l’IA sont uniquement textuelles dans cette version. Les réponses longues sont automatiquement tronquées à la limite de 4 096 caractères de Telegram.


Lire le statut sur votre téléphone

Lorsque l’IA répond à un chat Telegram, ou que vous ouvrez ce chat dans Chats, le chat est également marqué comme lu sur votre propre application Telegram — ainsi, le badge de non-lu de votre téléphone reste synchronisé au lieu d’accumuler des centaines de chats non lus.

Les chats auxquels le bot ne répond pas (par exemple lorsqu’il est désactivé, en dehors de ses heures d’activité, ou qu’il a choisi de ne pas répondre) sont laissés non lus intentionnellement, afin que vous puissiez toujours les repérer et les gérer vous-même.


Limitations

  • Chats individuels uniquement. Les messages de groupe et de canal ne sont pas gérés dans cette version.
  • Pas de boutons intégrés. Les menus de boutons interactifs ne sont pas pris en charge.
  • Envoi uniquement textuel. L’IA répond par du texte ; l’envoi de médias est prévu pour une mise à jour ultérieure.
  • Intégration non officielle. Elle repose sur la connexion client de Telegram et n’est pas approuvée par Telegram ; les changements de plateforme de leur côté peuvent l’affecter.
  • Risque pour le compte. Une automatisation excessive ou non sollicitée peut entraîner la restriction ou le bannissement du compte — suivez les conseils de sécurité ci-dessus.

Dépannage

Le code de connexion n’arrive jamais

  • Vérifiez la discussion de service Telegram dans l’application Telegram — le code y est généralement envoyé, et non par SMS.
  • Assurez-vous d’avoir saisi le numéro de téléphone avec le code pays correct.
  • Telegram limite les codes pour les comptes/numéros qu’il considère comme suspects. Attendez quelques minutes et réessayez.

“Code expiré” ou “Code invalide”

  • Le code n’est valide que brièvement. Recommencez la connexion pour en demander un nouveau et saisissez-le rapidement.

Demande de mot de passe inattendue

  • Votre compte a la vérification en deux étapes activée. Saisissez votre mot de passe Telegram pour terminer la connexion. Si vous l’avez oublié, réinitialisez-le depuis Paramètres → Confidentialité et sécurité → Vérification en deux étapes de Telegram.

Les messages ne sont pas envoyés

  • Vérifiez que l’état de la connexion indique Connecté sur la page Canaux.
  • Confirmez que le contact est une personne à qui vous pouvez envoyer des messages sur Telegram.
  • Si le compte a été récemment signalé pour spam, réduisez le volume et limitez-vous aux contacts existants.

Compte déconnecté

  • Votre session a été terminée (par vous, depuis un autre appareil, ou par Telegram). Allez dans Paramètres → Canaux → Canaux, cliquez sur Déconnecter, puis reconnectez-vous.

Bonnes pratiques

  • Connectez un compte qui communique déjà avec des clients sur Telegram, et non un compte jetable tout neuf.
  • Commencez avec un faible volume d’automatisation et augmentez progressivement.
  • Répondez aux contacts entrants et chaleureux plutôt que d’envoyer des messages à froid à des inconnus.
  • Maintenez votre compte en bonne santé — un numéro réel, une utilisation normale et un rythme conservateur réduisent considérablement le risque de bannissement.