Retour au blog
Guide de configurationBot TelegramTutoriel

Configurer TalkTG : le chat en direct de votre site dans Telegram, étape par étape

Un guide illustré : créez un site, connectez votre bot Telegram, collez une ligne de code et répondez à votre premier visiteur depuis Telegram.

7 min de lecture

Ce guide couvre toute la configuration de TalkTG, de la création du compte jusqu’à votre première réponse à un visiteur depuis Telegram. Comptez environ cinq minutes ; chaque étape est accompagnée d’une capture d’écran.

Ce qu’il vous faut

  • Un site où vous pouvez ajouter une balise script (HTML, WordPress, Shopify, Webflow, Next.js, etc.).
  • Un compte Telegram sur mobile ou ordinateur.
  • Environ cinq minutes.

Étape 1 : Créez votre compte TalkTG

Rendez-vous sur talktg.com et cliquez sur « Commencer gratuitement ». Inscrivez-vous avec Google, ou avec votre nom, votre e-mail et un mot de passe ; un code à 6 chiffres vous est envoyé pour confirmer l’adresse. L’offre gratuite ne demande pas de carte bancaire.

La page d’inscription de TalkTG
La page d’inscription de TalkTG

Étape 2 : Ajoutez votre site

Dans le tableau de bord, ouvrez « Sites » et cliquez sur « Ajouter un site ». Saisissez votre domaine sans https:// (par exemple shop.example.com) et, si vous le souhaitez, un nom. Le widget ne fonctionne que sur ce domaine, ce qui empêche d’autres sites de le réutiliser.

Ajouter un nouveau site avec son domaine et son nom
Ajouter un nouveau site avec son domaine et son nom

Une fois le site créé, vous arrivez sur sa page de présentation. La checklist de lancement en haut indique les étapes restantes : connecter Telegram, installer le widget et recevoir la première conversation.

La page du site avec la checklist de lancement
La page du site avec la checklist de lancement

Étape 3 : Créez un bot Telegram avec BotFather

TalkTG transmet les messages des visiteurs via votre propre bot Telegram : le bot vous appartient et vous choisissez son nom et son image. Cliquez sur le bouton « Telegram » de la page du site pour ouvrir l’assistant, puis créez le bot :

  • Dans Telegram, recherchez @BotFather (le compte officiel a une coche bleue) et appuyez sur Start.
  • Envoyez /newbot.
  • Choisissez un nom affiché, par exemple « Demo Shop Support ».
  • Choisissez un nom d’utilisateur qui se termine par « bot », par exemple DemoShopSupportBot.
  • BotFather répond avec un jeton d’API du type 1234567890:AAE… Copiez-le.
Étape 1 de l’assistant Telegram : créer un bot avec BotFather
Étape 1 de l’assistant Telegram : créer un bot avec BotFather
Traitez le jeton du bot comme un mot de passe : quiconque le possède peut contrôler votre bot. TalkTG le stocke chiffré. En cas de fuite, envoyez /revoke à BotFather puis connectez le nouveau jeton.

Étape 4 : Connectez le bot à votre site

Cliquez sur « I have my bot token », collez le jeton et cliquez sur « Verify & Continue ». TalkTG vérifie le jeton auprès de Telegram et associe le bot à ce site.

Coller le jeton du bot dans TalkTG
Coller le jeton du bot dans TalkTG

TalkTG affiche ensuite un code de vérification à 6 chiffres. Ouvrez votre bot dans Telegram et envoyez-lui ce code (ou /bindsite suivi du code). Cela prouve que le compte Telegram qui recevra les messages est bien le vôtre. Le code expire au bout de 5 minutes.

Le code de vérification à envoyer à votre bot
Le code de vérification à envoyer à votre bot

Cliquez sur « I sent the code ». Dès que le bot le reçoit, la page se met à jour d’elle-même et affiche « Telegram Connected », avec les commandes utilisables dans Telegram.

Telegram connecté et commandes du bot disponibles
Telegram connecté et commandes du bot disponibles
  • /online et /offline : indiquent dans le widget si vous êtes disponible.
  • /sites : liste tous les sites associés à ce bot.
  • Répondre : répondez au message d’un visiteur dans Telegram pour lui répondre.
  • Répondre + /block : fermer la conversation. Répondre + /history : afficher ses 20 derniers messages.

Étape 5 : Installez le widget sur votre site

Revenez sur la page du site et copiez l’extrait de la carte « Embed Code ». Collez-le dans le HTML de votre site, juste avant la balise </body>. Il contient déjà l’identifiant de votre site.

<script src="https://talktg.com/widget.js" data-site-id="YOUR_SITE_ID" async></script>
La carte du code d’intégration avec le bouton Copier
La carte du code d’intégration avec le bouton Copier
  • HTML : collez-le avant </body> sur chaque page, ou dans votre gabarit commun ou de pied de page.
  • WordPress : utilisez le pied de page du thème ou une extension de « scripts d’en-tête et de pied de page ».
  • Shopify : Boutique en ligne → Thèmes → Modifier le code → theme.liquid, juste avant </body>.
  • React, Next.js et autres SPA : ajoutez-le une seule fois dans le modèle HTML racine ou le layout pour qu’il se charge sur toutes les routes.

Le script se charge de manière asynchrone et ne ralentit pas vos pages. Dans la checklist de lancement, cliquez sur « Check widget installation » pour vérifier que TalkTG le détecte sur votre site.

Étape 6 : Adaptez le widget à votre marque (facultatif)

Dans « Widget Settings », choisissez une couleur de marque, le coin inférieur droit ou gauche, puis définissez le nom de l’agent, la bulle d’accueil, le message hors ligne et le message de bienvenue. Vous pouvez aussi demander l’e-mail des visiteurs pour les recontacter s’ils partent. Cliquez sur « Save Changes » : le widget en ligne se met à jour immédiatement.

Réglages du widget : couleur, position, textes et collecte d’e-mail
Réglages du widget : couleur, position, textes et collecte d’e-mail

Étape 7 : Envoyez un message de test

Ouvrez votre site dans une fenêtre de navigation privée. Le bouton de chat apparaît dans le coin choisi.

Le bouton de chat sur le site
Le bouton de chat sur le site

Envoyez un message en tant que visiteur. Il arrive en moins d’une seconde dans la conversation de votre bot sur Telegram, avec la page d’où il a été envoyé. Répondez à ce message dans Telegram (balayez vers la gauche sur mobile, ou clic droit → Répondre sur ordinateur) : votre réponse s’affiche aussitôt dans la fenêtre de chat du visiteur, sans recharger la page.

Le visiteur voit votre réponse Telegram dans le chat du site
Le visiteur voit votre réponse Telegram dans le chat du site

Chaque conversation est aussi enregistrée dans le tableau de bord, sous « Conversations », avec tout l’historique et des informations sur le visiteur comme la page, le navigateur et l’heure de la première visite.

L’historique des conversations dans le tableau de bord TalkTG
L’historique des conversations dans le tableau de bord TalkTG

Dépannage

  • Le bouton de chat n’apparaît pas : vérifiez que l’extrait est présent sur la page affichée et que le domaine saisi dans TalkTG correspond exactement à celui de votre site.
  • Le jeton du bot est refusé : recopiez-le depuis BotFather, partie avant les deux-points comprise et sans espaces.
  • Le code de vérification ne fonctionne pas : il expire au bout de 5 minutes. Cliquez sur « Go back & try again » pour en obtenir un nouveau.
  • Les messages n’arrivent pas dans Telegram : vérifiez que vous n’avez pas bloqué ou arrêté le bot et que le site affiche « Telegram Connected ».

Et ensuite ?

Vous êtes en ligne. Répondez depuis Telegram où que vous soyez, et envoyez /offline quand vous vous absentez pour que les visiteurs laissent un message. Pour répondre automatiquement aux questions fréquentes, même la nuit, ajoutez vos documents et FAQ à la base de connaissances IA (offre Pro) : elle répond à votre place et vous transmet la conversation dans Telegram quand elle ne sait pas.