Intégrations · Telegram

Utiliser votre bot Telegram dans Tookan

Créez votre bot, reliez-le à Tookan puis retrouvez les messages de vos contacts et répondez depuis leurs fiches.

Toute la documentation

Avant de commencer

Prévoyez un compte Telegram, un accès administrateur à Tookan et une application Tookan active contenant une question texte. Chaque compte Tookan utilise son propre bot. Le contact doit ouvrir la conversation avec ce bot avant de recevoir vos messages.

1. Comprendre le fonctionnement

Votre bot est le point de contact de votre entreprise dans Telegram. BotFather sert à le créer ; vos clients écriront ensuite à votre propre bot.

Un message de votre contact rejoint Tookan
Votre bot Telegram

Le contact écrit dans sa conversation privée avec votre bot.

La fiche contact Tookan

Après rattachement et traitement, le message apparaît dans l’application de destination et sur le contact.

Les messages ne sont pas rapprochés automatiquement par nom ou numéro de téléphone.

  • Les textes, photos, documents et messages vocaux peuvent être reçus selon les destinations choisies.
  • L’envoi d’un message Tookan notifie automatiquement le contact sur ses canaux activés : e-mail, push mobile, WhatsApp et Telegram selon sa configuration.

2. Créer le bot et récupérer son jeton

@BotFather est le bot officiel de Telegram pour créer et gérer vos bots. Le signe @ indique son identifiant dans Telegram. Le jeton est la clé qui autorise Tookan à utiliser votre bot.

  1. Ouvrir BotFather

    Dans Telegram, ouvrez le lien officiel @BotFather ci-dessous, puis appuyez sur Démarrer.

  2. Créer votre bot

    Envoyez /newbot à BotFather. Choisissez un nom d’affichage, par exemple « Mon entreprise — Tookan ».

  3. Choisir son identifiant

    Saisissez un identifiant disponible terminant par bot, par exemple monentreprise_tookan_bot. Cet identifiant permettra à vos contacts de retrouver votre bot.

  4. Copier le jeton

    BotFather transmet un jeton, une longue suite de caractères avec deux-points. Copiez uniquement cette valeur dans le champ Jeton du bot de Tookan.

3. Connecter le bot dans Tookan

  1. Ouvrir le paramétrage

    Dans Tookan, ouvrez Paramètres > Intégrations > Telegram avec un accès administrateur.

  2. Renseigner le jeton et les destinations

    Collez le jeton du bot, choisissez le mode de réception expliqué ci-dessous, puis les applications qui accueilleront les messages.

  3. Enregistrer et vérifier

    Cliquez sur Enregistrer la connexion. Le nom du bot et son état apparaissent dans l’écran. Le bouton Vérifier la connexion permet ensuite de contrôler la réception et le traitement.

ChampChoix à effectuer
Application des textes *Choisir une application active contenant une question texte. L’étoile rouge indique que ce choix est requis.
Application des photosFacultatif : choisir une application contenant une question image.
Application des documentsFacultatif : choisir une application contenant une question document.
Application des messages vocauxFacultatif : choisir l’application qui accueillera le fichier audio.
Ne pas importer ce typeLaisser ce choix pour les types de médias que vous ne souhaitez pas recevoir.

Ouvrir le paramétrage Telegram

4. Choisir la réception des messages

Compatible en local

Interrogation périodique

Tookan demande régulièrement à Telegram s’il y a de nouveaux messages. Choisissez ce mode pour une installation locale ou si votre adresse Tookan n’est pas accessible depuis Internet.

Adresse HTTPS publique

Webhook

Telegram transmet chaque nouveau message à une adresse de votre application Tookan accessible depuis Internet. Tookan construit cette adresse et la communique automatiquement à Telegram à l’enregistrement.

Une adresse HTTPS de Tookan, cela veut dire quoi ?

Il s’agit de l’adresse de votre application Tookan hébergée sur Internet, commençant par https://. Une adresse locale telle que http://tookan.front.local ne convient pas. Vous n’avez pas de page à créer ; si l’adresse publique n’est pas configurée, demandez à votre administrateur Tookan de la vérifier.

Le webhook affiche-t-il les messages immédiatement ?

Le webhook transmet le message à Tookan dès sa réception par Telegram. Tookan doit ensuite le traiter pour l’afficher sur la fiche. Le traitement planifié doit être actif dans les deux modes ; sur l’installation locale, il est programmé chaque minute.

5. Rattacher une conversation à un contact

  1. Dans Tookan

    Créer le lien

    Ouvrez une fiche contact enregistrée. Dans son panneau Telegram, cliquez sur Créer le lien de rattachement.

  2. Avec votre contact

    Transmettre le lien

    Envoyez ce lien uniquement au contact concerné, par votre canal habituel. Il ouvre le lien dans Telegram et appuie sur Démarrer.

  3. Dans Tookan

    Vérifier le rattachement

    Rechargez la fiche contact : la conversation est rattachée. Dans Notifications, vérifiez que Notification par Telegram est sur Oui, puis sauvegardez les changements.

Le contact a déjà écrit au bot sans utiliser de lien. Que faire ?

Dans Intégrations > Telegram, retrouvez sa conversation dans Conversations récentes. Recherchez sa fiche par nom ou e-mail, sélectionnez-la puis cliquez sur Rattacher après avoir vérifié son identité. Les messages en attente pourront alors être importés. Aucune fiche contact n’est créée automatiquement.

Combien de temps les messages non rattachés sont-ils conservés ?

Les données en attente de rattachement sont conservées au maximum sept jours. Une fois importés, les messages suivent la conservation habituelle de Tookan.

6. Tester votre premier échange

  1. Envoyer depuis Telegram

    Depuis le compte Telegram du contact rattaché, envoyez un court message à votre bot. Laissez au traitement planifié le temps de s’exécuter, puis actualisez Tookan.

  2. Vérifier dans Tookan

    Retrouvez le message dans l’application des textes et sur la fiche du bon contact. Si vous avez activé les photos ou les messages vocaux, testez aussi un exemple.

  3. Envoyer votre message Tookan

    Créez et envoyez votre message Tookan comme d’habitude, ou utilisez Notifier le contact. Si Notification par Telegram est sur Oui, Tookan place automatiquement l’envoi Telegram dans la file avec les autres canaux activés.

  4. Contrôler la livraison

    Dans le suivi Telegram, vérifiez que l’envoi passe à Envoyé et confirmez sa réception dans Telegram. Envoyé indique que Telegram a accepté le message ; ce n’est pas une confirmation de lecture.

Vérifier la connexion et les échanges

7. Gérer les échanges au quotidien

ActionCe qui se passe
Notification par Telegram : NonLe contact reste rattaché, mais Tookan n’envoie plus de notification à cette conversation.
/stop envoyé par le contactLe contact désactive ses notifications Telegram. /start les réactive pour une conversation déjà rattachée.
/help envoyé par le contactLe bot affiche ses indications d’utilisation.
Retirer le lienTookan détache la conversation du contact et annule ses envois en attente. Les messages déjà importés restent sur leur fiche d’origine.
Déconnecter le botTookan désactive la connexion et annule les envois en attente. Les messages déjà importés sont conservés.
  • Les fichiers entrants sont limités à 20 Mo et les fichiers sortants à 50 Mo ; seuls les formats pris en charge peuvent être importés.
  • Les textes, photos, documents et messages vocaux sont couverts. Les vidéos, stickers et échanges de groupe ne sont pas importés par cette intégration.
  • Les photos d’un album sont traitées comme des messages séparés.
  • L’intégration reçoit les nouveaux messages disponibles ; elle ne reprend pas tout l’historique personnel d’un compte Telegram.

8. Résoudre les difficultés courantes

Le jeton est refusé.

Copiez à nouveau la valeur transmise par BotFather, sans espace ajouté. Si le jeton a été remplacé ou révoqué, enregistrez le nouveau jeton du même bot dans Tookan.

Une application de destination est refusée.

Vérifiez qu’elle est active, qu’elle appartient à votre compte et qu’elle contient le type de question attendu : texte, image ou document.

Aucun message n’apparaît.

Vérifiez que le contact écrit au bon bot et que la conversation est rattachée à sa fiche. Dans le suivi Telegram, consultez Dernière réception et Dernier traitement, puis cliquez sur Vérifier la connexion. Si aucun traitement récent n’apparaît, demandez à votre administrateur de vérifier le traitement planifié.

Le mode webhook ne fonctionne pas.

Vérifiez que Tookan possède une adresse HTTPS publique accessible depuis Internet. En local, choisissez Interrogation périodique. Si un autre webhook est signalé, faites vérifier les autres usages de ce bot avant de modifier sa connexion.

Une photo ou un document n’est pas importé.

Vérifiez que le type de média possède une destination, que son format est pris en charge et que le fichier ne dépasse pas 20 Mo. Après correction d’une destination, utilisez Retraiter les réceptions en erreur dans le suivi Telegram.

Un message reste en attente d’envoi.

Vérifiez le traitement récent, le rattachement du contact et l’activation des envois. Telegram peut demander un délai avant la prochaine tentative ; Tookan respecte ce délai automatiquement.

Le suivi indique Livraison incertaine.

La connexion a pu s’interrompre après l’acceptation du message par Telegram. Vérifiez la conversation avant d’envoyer à nouveau. Tookan ne relance pas automatiquement cet envoi pour éviter un doublon.

Le contact ne reçoit plus mes réponses.

Vérifiez que les envois Telegram sont activés sur sa fiche. S’il a envoyé /stop, il peut envoyer /start. S’il a bloqué le bot, il doit le débloquer dans Telegram.

La conversation est déjà rattachée à une autre fiche.

Vérifiez d’abord quelle est la bonne fiche. Retirez le lien actuel avant un nouveau rattachement. Les messages déjà importés ne sont pas transférés automatiquement vers une autre fiche.