Comment créer et connecter un chatbot Telegram

Lors de la configuration d’un groupe privé dans Telegram, vous devrez connecter un bot. Il est nécessaire pour que le participant puisse recevoir des notifications de paiement, ainsi que pour lier le contact dans Kwiga au participant dans Telegram, et à l’avenir aussi pour les mailings et autres notifications dans Telegram. L’ajout des participants au groupe et leur suppression du groupe se feront automatiquement. Vous pouvez utiliser un bot existant ou en créer un nouveau qui sera utilisé uniquement pour un groupe privé spécifique ou pour toutes les notifications de votre projet. Le plus souvent, un seul bot est utilisé pour toutes les notifications de votre projet.

Important ! Toutes les actions décrites ci-dessous doivent être effectuées en même temps que la création d’un groupe privé sur la plateforme. 

Création d’un bot

Ouvrez une conversation avec @BotFather (vous pouvez utiliser ce lien).

Si vous n’avez pas déjà interagi avec ce bot, saisissez \/start puis la commande \/newbot.

Le bot vous demandera de trouver un nom pour votre bot. C’est le nom qui sera affiché dans la liste des contacts (dans notre exemple - kwiga example)

Ensuite, vous devez trouver un nom d’utilisateur pour le bot : c’est un nom unique grâce auquel le bot peut être trouvé dans Telegram, et il doit se terminer par bot (dans notre exemple, KwigaExample_bot).

Après cela, le bot sera créé et vous recevrez des informations sur la manière d’ajouter une description, un avatar, un lien vers le bot lui-même et, plus important encore, le token, qui est nécessaire pour que ce bot puisse envoyer des notifications.

Obtention du token d’un bot créé précédemment

Ouvrez une conversation avec @BotFather (vous pouvez utiliser ce lien). Saisissez la commande \/token et sélectionnez dans la liste le bot dont le token doit être affiché :

Après avoir sélectionné le bot (en prenant @alanaschool3_bot comme exemple), vous recevrez le token.

Passez à la création du groupe privé. À l’étape des paramètres du bot de notification, vous devez remplir 2 champs : nom et token.

Création d’un groupe ou d’un canal dans Telegram

Telegram propose deux types de communication avec les abonnés : un canal et un groupe. Dans un groupe, tous les participants peuvent envoyer des messages, tandis que dans un canal seul l’administrateur du canal peut publier des messages.

Selon vos objectifs, créez un groupe ou un canal. Les exemples ci-dessous décrivent les paramètres du groupe, car c’est l’outil le plus populaire.

Veuillez noter ! Vous pouvez connecter à Kwiga un groupe créé précédemment avec des participants existants, mais cela fonctionnera incorrectement en raison des limitations de Telegram. Le bot ne pourra pas supprimer ni ajouter les participants qui ont rejoint le groupe avant sa configuration sur Kwiga.

Ajout du bot au groupe

Ouvrez le groupe créé et sélectionnez Gérer le groupe.

Sélectionnez Ajouter un administrateur, saisissez le nom de votre bot et ajoutez-le en tant qu’administrateur. Assurez-vous que les autorisations du bot incluent l’ajout et la suppression d’utilisateurs.

Après cela, saisissez la commande \/chatid dans le groupe, et le bot affichera le numéro qui doit être indiqué dans Kwiga. Veuillez noter que la commande doit être saisie non pas dans la conversation avec le bot, mais bien dans le groupe/canal pour lequel vous configurez l’accès. 

Si vous ne voyez pas la réponse du bot à la commande saisie, assurez-vous que vous êtes bien en train de créer le groupe sur la plateforme, c’est-à-dire que vous avez terminé la première étape et indiqué l’API du bot  lors de la création du groupe. Si vous avez seulement créé le bot mais ne l’avez pas indiqué sur la plateforme, la commande ne produira pas le résultat requis.

Autres paramètres

Vous pouvez configurer les autres paramètres du groupe comme cela vous convient ; ils n’affectent pas le fonctionnement du groupe.

Groupe public ou groupe masqué - après avoir ajouté le bot au groupe, il surveillera tous les nouveaux utilisateurs du groupe. Si un utilisateur n’a pas accès au groupe, le bot le supprimera dès qu’il le rejoindra, vous pouvez donc rendre le groupe public ou masqué : il ne contiendra que les participants qui ont reçu ou payé l’accès.

La visibilité de l’historique du chat pour les nouveaux utilisateurs et la possibilité pour les utilisateurs d’enregistrer le contenu : tout cela peut être configuré en plus ou modifié à tout moment.

Ce que les participants du groupe peuvent faire et à quelle fréquence ils peuvent envoyer des messages.