Telegram

Connectez Telegram et chaque article que vous publiez sortira comme message vers le chat, canal ou groupe Telegram de votre choix. Idéal pour diffuser à un canal Telegram d’abonnés, ou simplement vous pinger vous-même.

Telegram nécessite une petite configuration ponctuelle dans l’application Telegram elle-même — créer un bot et trouver l’ID de chat — mais une fois fait, le côté Structura est rapide.

Ce qui est posté

Un seul message Telegram par publication :

Titre de l’article en gras.
Résumé court de l’extrait ou du premier paragraphe.
Lien vers l’article sur votre site WordPress.
Image à la une comme pièce jointe photo du message (si disponible).

Ce dont vous avez besoin

Deux informations :

Un jeton de bot du BotFather de Telegram.
Un ID de chat — l’identifiant numérique du chat, canal ou groupe sur lequel vous voulez que le bot publie.

Les deux viennent de l’application Telegram elle-même ; étapes ci-dessous.

Créer un bot Telegram

Faites cela une fois, dans Telegram :

Ouvrez Telegram et recherchez @BotFather. Démarrez un chat.
Envoyez /newbot.
Donnez au bot un nom d’affichage (par ex. « Structura Publisher »).
Donnez-lui un nom d’utilisateur se terminant par bot (par ex. mysite_structura_bot).
BotFather répond avec un jeton de bot — une longue chaîne comme 123456:ABCdef.... Copiez-la. C’est un secret.

Obtenir votre ID de chat

L’ID de chat dit au bot où poster. Le plus rapide pour le trouver est un bot d’aide comme @RawDataBot ou @getidsbot — pas besoin de jeton de bot ni de navigateur pour cette étape.

Pour un chat privé avec vous-même :

Dans Telegram, recherchez @RawDataBot (ou @getidsbot) et cliquez sur Démarrer.
Il répond instantanément avec un bloc de données. Trouvez la section "chat" et copiez son id — un entier positif comme 685793393. Ce nombre est votre ID de chat.
Avant que Structura puisse vous écrire, vous devez d’abord ouvrir votre propre bot et cliquer sur Démarrer — un bot ne peut pas démarrer une conversation avec vous (voir la note dans « Ce qui peut mal tourner »).

Pour un canal Telegram :

Postez n’importe quel message dans le canal.
Transférez ce message à @getidsbot (ou @RawDataBot). Il répond avec l’ID du canal — un entier négatif préfixé de -100, par ex. -1001234567890.
Ajoutez votre bot Structura comme administrateur du canal (Paramètres du canal → Administrateurs → Ajouter un admin) pour qu’il puisse poster.

Pour un groupe Telegram :

Ajoutez @RawDataBot (ou @getidsbot) au groupe en tant que membre.
Il poste un message affichant l’id du groupe — un entier négatif. Copiez-le.
Ajoutez votre bot Structura au même groupe pour qu’il puisse poster. Vous pouvez retirer le bot d’aide ensuite.

Connecter

Dans wp-admin, allez dans Structura → Channels.
Cliquez sur la carte Telegram. Le panneau d’installation s’ouvre.
Collez le jeton de bot dans le champ Jeton de bot.
Collez l’ID de chat dans le champ ID de chat.
Cliquez sur Connecter. Structura appelle getMe et sendMessage de Telegram pour vérifier les identifiants et que le bot peut poster dans le chat. Si les deux réussissent, le panneau d’installation affiche Connecté et le chat cible reçoit un message de test « Structura connected ».

Ce qui peut mal tourner

Unauthorized à la connexion. Le jeton de bot est faux ou le bot a été supprimé.
chat not found. L’ID de chat est faux, le bot n’est pas membre de ce chat/canal, ou le bot n’est pas administrateur du canal.
Forbidden: bot can't initiate conversation with a user. Pour les chats privés, le bot ne peut vous envoyer un message qu’après que vous lui en avez envoyé un d’abord. Envoyez un message à votre bot et réessayez.
Message envoyé mais pas d’image. L’image à la une de l’article est peut-être trop grande (Telegram rejette les fichiers de plus de 10 Mo pour les bots) ou son URL n’est peut-être pas accessible publiquement.

Voir Un canal affiche « failed » pour le playbook complet.

Tourner le jeton ou changer de chat

Nouveau jeton : régénérez avec /token dans BotFather, puis cliquez sur Reconnecter sur le panneau d’installation Telegram et collez le nouveau.
Nouveau chat : récupérez le nouvel ID de chat de la même manière, puis collez-le dans le panneau d’installation. Vous pouvez garder le même bot.