Accès API & MCP

Accès API & MCP

Metricgram inclut une API publique et un serveur MCP pour connecter vos propres outils, tableaux de bord, automatisations ou clients IA aux données et actions disponibles dans votre compte.

Le serveur MCP est disponible avec tous les forfaits payants et pendant l'essai gratuit de 14 jours. Les clients IA peuvent se connecter avec OAuth (en collant l'URL du serveur et en approuvant l'accès) ou avec une clé API. L'API REST nécessite un accès Elite. Si votre compte ne l'inclut pas, la section API peut apparaître verrouillée ou afficher un message de mise à niveau.

Où le trouver

Ouvrez Intégrations > MCP ou Intégrations > API dans le panneau de gestion. Les comptes qui y ont accès peuvent créer des tokens API, consulter les tokens actifs, les révoquer et voir la référence technique disponible pour leur plan.

Fonctionnement des tokens

• Les tokens appartiennent à votre compte utilisateur Metricgram, pas à un groupe précis.
• Un token peut accéder aux groupes et ressources que votre compte peut gérer.
• Les tokens incluent des permissions pour les groupes, membres, messages, automatisations, abonnés, analyses, tickets de support, parrainages et MCP.
• Certains endpoints lisent uniquement des données; d'autres peuvent créer, modifier, modérer ou déclencher des actions selon les permissions du token.
• La valeur du token n'est affichée qu'une seule fois lors de sa création. Conservez-la en sécurité.

Telegram Bot API via MCP

Le serveur MCP expose aussi une Telegram Bot API limitée à vos groupes, pour que les agents IA puissent y agir via le bot Metricgram ou votre bot personnalisé.

• Utilisez telegram_api_methods pour lister les méthodes que votre token peut appeler, et telegram_bot_api pour appeler n'importe laquelle d'entre elles avec les paramètres officiels de la Bot API.
• Des outils typés couvrent le travail quotidien : send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link et d'autres.
• Le chat est toujours l'un de vos propres groupes. Vous ne transmettez jamais de chat_id : Metricgram le déduit du group_id.
• Les actions Telegram utilisent leurs propres scopes : telegram:read, telegram:write, telegram:moderate et telegram:admin. Les tokens créés avant l'existence de ces scopes doivent être recréés pour les utiliser.
• Les médias doivent être une URL HTTPS publique ou un file_id Telegram, et les boutons inline peuvent uniquement ouvrir des URL ou copier du texte.
• Les outils d'écriture acceptent une idempotency_key facultative, pour qu'un appel relancé n'agisse pas deux fois.

Authentification et limites

Les requêtes API utilisent l'en-tête Authorization: Bearer mg_.... La limite par défaut est de 600 requêtes par minute par token, et le formulaire permet de choisir une valeur dans les limites autorisées par l'app.

Si un token est révoqué, si le compte perd l'accès API ou si le plan n'inclut plus API & MCP, les requêtes utilisant ce token seront rejetées.

Bonnes pratiques

• Créez des tokens séparés pour chaque outil externe.
• Utilisez des noms clairs pour identifier où chaque token est utilisé.
• Révoquez les tokens dont vous n'avez plus besoin.
• Ne partagez pas les tokens dans des chats, captures d'écran, tickets ou dépôts publics.

Commencez par un token et des scopes limités à l'outil concerné. Pour une action qui écrit dans Telegram, prévisualisez les paramètres, vérifiez le group_id autorisé et demandez une confirmation humaine avant d'envoyer, modérer ou modifier un accès. Révoquez le token si vous ne reconnaissez plus son usage.