Telegram

Telegram se connecte de deux façons. Scannez avec votre téléphone ajoute le bot OmniBrand à votre canal : rien à créer ni à coller. Avancé utilise votre propre bot créé avec @BotFather.

Scannez avec votre téléphone (recommandé)

1. Dans OmniBrand, en tant que Propriétaire ou Admin : Configuration → Comptes → cliquez sur Telegram sous Connecter un compte. La fenêtre Connecter Telegram s'ouvre.
2. Sous Scannez avec votre téléphone, scannez le code avec l’appareil photo de votre téléphone (sur un téléphone, touchez Ouvrir Telegram). Telegram ouvre le bot OmniBrand : touchez Démarrer.
3. Le bot répond « Lié à [votre espace de travail] ([votre organisation]). Ne continuez que si vous venez de scanner ce code sur votre propre ordinateur. » Vérifiez que l’espace de travail et l’organisation sont les vôtres : sinon (quelqu’un vous a envoyé son code), n’ajoutez le bot nulle part. Touchez ensuite « Ajouter au canal » (ou « Ajouter au groupe »), choisissez votre canal, laissez Post Messages activé, puis touchez Terminé. Le code est valable 10 minutes ; après Démarrer, vous avez 30 minutes pour ajouter le bot.
4. La fenêtre affiche « Connecté : [nom du canal] ». Le bot le dit aussi dans Telegram.

Que savoir :

• Seule une personne pouvant ajouter des administrateurs au canal peut ajouter le bot, et seule la personne qui a scanné le code le connecte, à l’espace de travail qui a affiché le code.
• Un canal peut appartenir à un espace de travail. « Déjà connecté à un autre espace de travail OmniBrand » signifie : le déconnecter d’abord à cet endroit.
• « Publier des messages est désactivé » : dans le canal, ouvrez Administrateurs, appuyez sur le bot OmniBrand , activez Publier des messages, puis appuyez sur Enregistrer. La fenêtre se transforme en « Connecté » d’elle-même lorsqu’elle est ouverte.
• Supprimer le bot du canal (ou désactiver les messages Post) indique que le compte est Connexion expirée ; ajouter le bot à nouveau (scanner un nouveau code) pour se reconnecter.
• Avec le bot OmniBrand, les messages d’un groupe connecté arrivent dans la boîte de réception. Les messages envoyés en privé au bot ne le font pas, et Diffusions Telegram nécessitent votre propre bot (Avancé).
• Si Scannez avec votre téléphone n’apparaît pas, ce serveur OmniBrand n’a pas encore de bot partagé ; utilisez Avancé.

Avancé : votre propre bot

Utilisez-le lorsque vous souhaitez votre propre nom de bot, des messages privés dans votre boîte de réception, ou Diffusions Telegram. Dans la fenêtre Connect Telegram, utilisez Utiliser votre propre bot (avancé)

1. Dans Telegram, ouvrez @BotFather et envoyez /newbot. Choisissez un nom et un nom d’utilisateur se terminant par « bot ». BotFather répond par un jeton comme 123456789:AAE.... Traitez-le comme un mot de passe.
2. Ouvrez votre chaîne (ou groupe) Telegram → Administrateurs → Ajouter un admin, et ajoutez le bot. Donnez-lui Publier des messages, et Supprimer les messages si vous voulez que la rétractation fonctionne.
3. Dans OmniBrand, en tant que Propriétaire ou Admin : Configuration → Comptes → cliquez sur Telegram sous Connecter un compte. Dans la fenêtre Connecter Telegram, allez à Utiliser votre propre bot (avancé).
4. Remplissez Jeton du bot (fourni par BotFather) et Canal : @yourchannel pour un canal public, ou l’identifiant numérique tel que -1001234567890 pour un canal privé. Un lien t.me/yourchannel fonctionne aussi. Pour trouver l’identifiant d’un canal privé, ouvrez-le dans Telegram Web (web.telegram.org/a) : l’adresse se termine par cet identifiant, par exemple #-1001234567890.
5. Cliquez sur Connecter un compte. Avant d’enregistrer, OmniBrand vérifie que le jeton fonctionne, que le bot voit le canal et qu’il en est administrateur avec le droit de publier (dans un groupe, qu’il en est membre).

Que se passe-t-il ensuite

• Publiez du texte (jusqu’à 4 096 caractères), ou une image ou une vidéo avec une légende allant jusqu’à 1 024 caractères. Plusieurs pièces jointes sur un même post : la première est publiée (une vidéo est préférée) et on vous le dit.
• Rétracter fonctionne pendant 48 heures après la publication ; après cela, Telegram refuse de la supprimer.
• Un post sur un canal public reçoit un lien t.me ; les publications dans les canaux privés et les groupes n’en ont aucun.
• Toute personne qui écrit directement à votre bot, et les messages dans les groupes auxquels il appartient arrivent dans la boîte mail ; votre réponse revient au même chat. Dans un groupe, Telegram ne transmet à un bot que les messages qui lui sont adressés, sauf si vous désactivez le mode confidentialité du bot dans @BotFather (/setprivacy).

Si quelque chose tourne mal

• La connexion est refusée avec « Telegram n’a pas accepté ce jeton de bot. » - copiez à nouveau le jeton depuis @BotFather (envoyez /mybots, choisissez le bot, puis API Token) et collez-le dans Jeton du bot. Avec « Telegram n’a pas trouvé cette chaîne pour le bot. » - vérifiez Canal : @username pour un canal public, l’identifiant numérique commençant par -100 pour un canal privé, et que le bot y a été ajouté. Avec « Le bot n’est pas administrateur de cette chaîne avec le droit de publier. » - dans Telegram, ouvrez le canal → Administrateurs, ajoutez le bot et activez Publier des messages, puis cliquez à nouveau sur Connecter un compte. Avec « C’est la conversation d’une personne avec le bot, pas une chaîne ni un groupe. » - saisissez dans Canal le @username de la chaîne ou son identifiant -100. Avec « Ce groupe a été transformé en supergroupe et a maintenant un nouvel identifiant » - saisissez cet identifiant dans Canal.
• La connexion est refusée avec « Ce Telegram bot envoie ses messages à un autre outil (un webhook est configuré), donc OmniBrand ne peut pas les recevoir. Supprimez le webhook dans cet outil, puis reconnectez-vous. » - un autre outil (un chatbot builder, un CRM) a pris les messages du bot. Retirez le bot de cet outil, ou créez un nouveau bot dans @BotFather pour OmniBrand, puis cliquez à nouveau sur Connecter un compte .
• La connexion est refusée avec « Ce bot Telegram est déjà connecté dans OmniBrand, à un autre chat ou dans un autre espace de travail. » - Telegram donne à chaque bot une file d’attente de messages, donc un bot sert un canal ou un groupe ici. Créez un second bot dans @BotFather pour ce canal, ou déconnectez l’autre en premier. Reconnecter le même canal avec le même bot est acceptable.
• Les messages cessent d’arriver - utilisez ce bot uniquement avec OmniBrand. Un bot qu’un autre outil lit également (ou qui a un webhook configuré ailleurs) ne peut pas livrer aux deux ; la ligne du compte explique alors pourquoi sous Détails.
• Connexion expirée - le jeton a été révoqué dans BotFather ('/revoke') ou le bot a été retiré du canal. Créer un nouveau jeton, puis se reconnecter. Une publication échoue en indiquant que le groupe « a été transformé en supergroupe » avec un nouvel identifiant : déconnectez le groupe, puis reconnectez-le avec cet identifiant dans Canal.