publora/telegram-post

Publication Telegram

Créez et planifiez des publications vers des canaux et groupes Telegram à l'aide du serveur MCP Publora. Prend en charge le formatage Markdown enrichi, les photos, les vidéos et les options de livraison de messages.

Prérequis

Forfaits : Fonctionne avec le forfait Starter gratuit. Limites et tarifs actuels : publora.com/pricing.

Pour commencer

1. Créez un compte sur publora.com/register (gratuit)
2. Créez un bot Telegram :
   • Envoyez un message à @BotFather sur Telegram
   • Envoyez /newbot et suivez les instructions
   • Conservez le jeton du bot
3. Ajoutez le bot à votre canal :
   • Ajoutez le bot en tant qu'administrateur de votre canal/groupe
   • Accordez la permission can_post_messages
4. Connectez-vous dans Publora sur le Tableau de bord avec le jeton du bot et le nom du canal
5. Obtenez la clé API sur app.publora.com/dashboard/api
6. Connectez votre agent au serveur MCP à l'adresse https://mcp.publora.com, en vous authentifiant avec Authorization: Bearer sk_VOTRE_CLE_API. Dans Claude Code :

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_VOTRE_CLE_API"

Claude Desktop, Cursor, Codex, OpenClaw et le connecteur claude.ai nécessitent chacun un fichier de configuration ou un flux différent : consultez la configuration client pour le chemin exact et l'extrait.

Solution de repli avec l'API REST

Si le serveur MCP est indisponible ou renvoie des erreurs, utilisez directement l'API REST :

URL de base : https://api.publora.com/api/v1

Authentification : Utilisez l'en-tête x-publora-key (PAS Authorization: Bearer) :

# Obtenez vos plateformes connectées
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_votre_cle_api"

# Créez une publication
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["telegram-1001234567890"],
    "content": "*Annonce*\n\nVotre message ici",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Format de l'ID de plateforme : telegram-{chat_id} où {chat_id} est l'ID numérique du canal/groupe provenant de /platform-connections.

Exemples d'IDs : telegram-1001234567890, telegram--1002345678901

📖 Documentation complète de l'API : docs.publora.com

Limites de la plateforme (API Bot)

Fonctionnalité	Limite
Message texte	4 096 caractères
Légende média	1 024 caractères (limite critique !)
Images	10 Mo max, 10 par groupe de médias
Formats d'image	JPEG, PNG, GIF, BMP, WebP
Taille vidéo	50 Mo max (pas 4 Go - c'est pour les utilisateurs !)
Formats vidéo	MP4, MOV, AVI, MKV, WebM
Limite de débit	30 msg/sec global, 20 msg/min par groupe

Critique : L'API Bot a des limites bien inférieures à celles des utilisateurs Telegram classiques. Les vidéos de plus de 50 Mo et les légendes de plus de 1 024 caractères échoueront.

Formatage Markdown

Telegram utilise sa propre variante de Markdown avec des astérisques simples pour le gras :

Syntaxe	Résultat
*gras*	gras
_italique_	italique
`code`	code en ligne
code	Bloc de code
[texte](url)	lien hypertexte
> texte	Citation en bloc

Remarque : Cela diffère du Markdown standard où **double astérisques** produit du gras.

Outils disponibles

create_post

Crée une nouvelle publication Telegram.

Paramètres :

• platforms : Tableau contenant votre ID de connexion Telegram (ex. ["telegram-1001234567890"])
• content : Texte du message (prend en charge le markdown)
• scheduledTime : Datetime ISO 8601 UTC. Optionnel : omettez-le et la publication est créée comme brouillon. Envoyez une heure future pour planifier. Une heure passée de cinq minutes ou plus est rejetée avec l'erreur SCHEDULED_TIME_IN_PAST ; pour une publication immédiate, utilisez l'heure actuelle plus une minute.
• mediaUrls : Jusqu'à 10 URL d'images ou de vidéos publiques https. Publora les télécharge côté serveur et les attache avant la validation, donc les médias et la planification se font en un seul appel. C'est l'alternative en un seul coup au flux brouillon puis get_upload_url puis complete_media. L'ingestion est limitée à 60 URL par heure.

get_upload_url

Obtient une URL pré-signée pour les téléversements de médias.

complete_media

Finalise un fichier téléversé via get_upload_url, après la réussite du PUT pré-signé. Optionnel, car la planification finalise également les médias en attente, mais l'appeler tôt permet de détecter les erreurs de format et de sonde avant la publication. Non nécessaire pour les médias attachés avec mediaUrls.

Paramètres :

• mediaId : l'ID retourné par get_upload_url

list_connections

Liste vos comptes connectés avec leurs IDs de plateforme. Appelez-le d'abord et copiez les IDs textuellement ; ils ne sont jamais devinables.

list_posts / get_post / update_post / delete_post

Gérez les publications planifiées et les brouillons. update_post modifie également content et platforms sur un brouillon ou une publication planifiée, donc corriger une faute de frappe ou changer de cible ne signifie plus supprimer et recréer. delete_media et prune_media_reference nettoient les fichiers téléversés.

Options de publication (via l'API REST)

Options spécifiques à Telegram disponibles via platformSettings.telegram de l'API REST :

Option	Description
disableNotification	Envoyer silencieusement (pas de son)
disableWebPagePreview	Pas de cartes d'aperçu de liens
protectContent	Empêcher le transfert/enregistrement

La légende au-dessus du média n'est pas configurable : showCaptionAboveMedia n'est pas une clé acceptée et son envoi renvoie 400 PLATFORM_SETTING_UNKNOWN.

Remarque : platformSettings est accepté par les outils MCP create_post et update_post ainsi que via REST. Le schéma est strict : une plateforme ou une clé mal orthographiée est rejetée avec une erreur de validation plutôt que d'être ignorée silencieusement.

Exemples

Publication simple sur un canal

Publiez ceci sur mon canal Telegram :
"*Mise à jour produit v2.5*

Nous avons déployé les améliorations suivantes :
- _Temps de réponse API plus rapides_ (45 ms en moyenne)
- Nouveau point d'accès `batch` pour les opérations en bloc

[Lire le journal des modifications](https://example.com/changelog)"

Annonce formatée

Créez une publication Telegram avec ce formatage :
"*Mise à jour importante*

Nous lançons notre nouvelle fonctionnalité demain à 10h UTC.

_Quoi de neuf :_
- Améliorations de la fonctionnalité A
- Sortie de la fonctionnalité B

[Lire l'annonce complète](https://example.com/mise-a-jour)"

Publication avec image

Publiez cette image sur mon canal Telegram avec la légende :
"*Aperçu du nouveau tableau de bord*

Voici un avant-goût de notre tableau de bord d'analyse repensé."

Important : La légende doit faire moins de 1 024 caractères lors de la publication avec un média.

Publication planifiée

Planifiez ceci pour demain à 8h, heure de Moscou :
"*Bonjour !* Voici votre résumé quotidien du marché..."

Restrictions importantes

1. Limite de légende à 1 024 caractères : Lors de la publication avec des médias (images/vidéos), le texte est envoyé comme légende limitée à 1 024 caractères. Les messages texte uniquement autorisent 4 096 caractères.

2. Vidéo max 50 Mo : L'API Bot limite les vidéos à 50 Mo (pas 4 Go comme les utilisateurs classiques). Les vidéos volumineuses échoueront.

3. Le bot doit être administrateur : Votre bot doit avoir le rôle d'administrateur avec la permission can_post_messages. Ceci est vérifié au moment de la connexion.

4. Pas de médias mixtes : Une publication unique ne peut pas contenir à la fois des images et des vidéos.

5. Dépassement de légende : Si la légende dépasse 1 024 caractères sur une publication média, elle est envoyée comme message de réponse séparé au lieu d'être tronquée.

Bonnes pratiques

Contenu

1. Utilisez le formatage : Les titres en gras, l'accentuation en italique améliore la lisibilité
2. Aperçus de liens : Excellents pour les articles ; désactivez-les pour des annonces plus épurées
3. Utilisation d'émojis : Courants et attendus sur Telegram
4. Longueur des publications : Pas de pénalité pour les publications plus longues sur les messages texte uniquement

Timing

• Audience mondiale : Les utilisateurs Telegram sont dans le monde entier ; tenez compte des fuseaux horaires pour les publications
• Meilleurs moments : 8h-10h, 12h-14h, 19h-21h dans les régions cibles
• Fréquence : Les canaux peuvent publier plus fréquemment (5-10/jour)

Engagement

• Activez les commentaires dans les paramètres du canal pour les discussions
• Utilisez des sondages pour l'engagement
• Épinglez les annonces importantes

Dépannage

Erreur	Cause	Solution
"Bot pas administrateur"	Le bot n'a pas les permissions d'admin	Ajoutez le bot comme administrateur avec can_post_messages
"Canal non trouvé"	Mauvais nom/ID de canal	Vérifiez @nomducanal ou l'ID numérique du chat
MEDIA_CAPTION_TOO_LONG	Légende > 1 024 caractères	Raccourcissez la légende ou utilisez une publication texte uniquement
"Bad Request : fichier trop volumineux"	Fichier > 50 Mo	Compressez la vidéo/image à moins de 50 Mo
"Médias mixtes non supportés"	Images + vidéo dans la même publication	Utilisez un seul type de média par publication