← Tous les connecteurs MCP Telegram

Goose · Block

Connecter Telegram à Goose

Ajoutez Entergram comme extension MCP dans Goose, l’agent IA open source de Block, et laissez-le exploiter votre véritable compte Telegram : faire remonter les messages manqués, relancer les prospects refroidis et agir sur vos conversations en autonomie.

URL du serveur MCP https://mcp.entergram.com/mcp

Goose est un agent IA extensible qui se connecte aux serveurs MCP sous forme d’extensions. Entergram expose votre compte Telegram personnel comme un serveur MCP hébergé : Goose lit vos conversations réelles et agit dessus avec une sécurité OAuth complète, sans compte bot ni clés API.

Configuration prête à coller

~/.config/goose/config.yaml
extensions:
  entergram:
    type: streamable_http
    uri: https://mcp.entergram.com/mcp
    enabled: true

Posez à Goose des questions impossibles à poser à Telegram

Une fois votre compte personnel connecté, Goose peut agir sur l’ensemble de vos conversations. Essayez des prompts comme :

  • « Combien de messages ai-je manqués cette semaine, et lesquels viennent de clients ? »
  • « Quelles conversations suis-je en train d’oublier de relancer ? »
  • « Chiffre les prospects qui se sont refroidis faute de relance. »
  • « Résume les retours clients de ce mois-ci. »
  • « Rédige des réponses à mes plus anciens messages sans réponse pour que je les valide. »

Connecter Goose en 3 étapes

Compatible avec l’application de bureau et la CLI de Goose.

  1. 01

    Copiez votre URL MCP dans Entergram

    Dans Entergram, ouvrez Settings → Workspace → Connectors → MCP et copiez l’URL de votre serveur MCP.

  2. 02

    Ajouter l’extension dans Goose

    Dans Goose, ajoutez une nouvelle extension de type Streamable HTTP pointant vers l’URL MCP d’Entergram : https://mcp.entergram.com/mcp.

  3. 03

    Autoriser et exécuter

    Cliquez sur Connect, connectez-vous avec votre compte Entergram et cliquez sur Allow access. Goose peut alors lire votre compte Telegram et agir dessus au fil de ses sessions.

Trois façons d’exécuter l’extension Entergram

Goose Desktop

Ouvrez la liste des extensions, ajoutez une extension personnalisée, choisissez le type Streamable HTTP et collez l’URL. L’application de bureau gère l’aller-retour navigateur à votre place : l’écran de consentement apparaît une fois, et toutes les sessions suivantes démarrent déjà autorisées.

Goose CLI

`goose configure` vous guide dans l’ajout d’une extension distante sans toucher au YAML — choisissez Add Extension, puis l’option distante Streamable HTTP. Éditer ~/.config/goose/config.yaml à la main revient exactement au même et se conserve plus facilement dans un dépôt de dotfiles, à côté du reste de la configuration de votre machine.

goose configure

Exécutions sans surveillance

Une fois l’extension autorisée, une invocation sans interface en hérite. C’est ainsi qu’un passage en revue de Telegram devient quelque chose que votre machine fait à 8 h du matin plutôt que quelque chose que vous pensez à demander — associez-le à cron ou launchd, car Entergram ne réveillera jamais l’agent de lui-même.

goose run -t "List every Entergram chat that has been waiting on a reply for more than a day"

De longues tâches, menées jusqu’au bout

Goose est conçu pour tenir un plan sur de nombreuses étapes, et cela change ce qu’il vaut la peine de lui demander. Ce sont des travaux que vous confieriez sinon à quelqu’un pour un après-midi. Chacun tient dans une seule consigne ; la séquence d’outils en dessous, c’est Goose qui l’élabore seul, et chaque appel figure dans la transcription de session, de sorte que vous pouvez auditer le chemin emprunté.

La tâche

« Parcours tous les tickets ouverts depuis plus de trois jours, lis la conversation qui est derrière, et rédige un point d’avancement pour chaque client. Montre-moi les brouillons avant tout envoi. »

Outils appelés

entergram_list_ticketsentergram_get_ticketentergram_list_messagesentergram_send_message

Goose renvoie

Une consigne, quatre types d’outils, et une boucle qui dure aussi longtemps que la file est longue. Goose filtre par ancienneté, ouvre chaque ticket pour retrouver la conversation d’origine, lit assez d’historique pour comprendre ce que le client attend vraiment, et rédige un brouillon par ticket. Il s’arrête à l’étape d’approbation : les appels d’envoi ne partent que pour les brouillons que vous gardez.

La tâche

« Crée une colonne Étape du deal avec les options Découverte, Essai, Négociation et Clôturé, puis classe dans l’une d’elles chaque conversation du trimestre écoulé. »

Outils appelés

entergram_create_custom_columnentergram_create_custom_column_optionentergram_list_workspace_chatsentergram_patch_chat_custom_fields

Goose renvoie

Schéma et reprise d’historique dans la même exécution, et c’est là qu’un agent justifie son coût : la colonne doit exister avant qu’une seule valeur puisse être écrite, et les valeurs d’option doivent être relues pour que le classement écrive de vrais identifiants d’option plutôt que du texte libre. Attendez-vous à ce qu’il tourne un moment et vous rende une liste conversation par conversation à la fin. Connecteur d’espace de travail uniquement.

La tâche

« Audite nos trois groupes partenaires — qui est dans chacun, et lesquels de nos contacts apparaissent dans plusieurs ? »

Outils appelés

entergram_list_groupsentergram_list_group_membersentergram_list_contact_shared_groups

Goose renvoie

Une jointure qui n’a d’interface nulle part. Goose énumère les groupes, parcourt chaque liste de membres, puis demande contact par contact quelles communautés vous partagez, et replie les réponses en un tableau de recoupement. Il en sort la liste des personnes à qui un seul message suffit au lieu de trois, plus la découverte discrète que deux partenaires se connaissent déjà.

La tâche

« Trouve toutes les personnes qui ont posé deux fois la même question sans jamais obtenir de réponse, ouvre un ticket pour chacune, et colle leurs deux messages en commentaire du ticket. »

Outils appelés

entergram_list_messagesentergram_create_ticketentergram_create_ticket_comment

Goose renvoie

L’étape de détection est la partie difficile et relève du pur raisonnement : deux messages entrants d’intention identique, sans tour sortant entre les deux. Tout ce qui suit est mécanique. Le commentaire compte plus que le ticket : la personne qui prend la file voit la formulation exacte qui a été ignorée, citée, sans avoir à reconstituer le fil.

La tâche

« Notre colonne de gravité des tickets a dérivé et trois options veulent maintenant dire la même chose. Consolide-les en un seul jeu canonique. »

Outils appelés

entergram_list_ticket_custom_columnsentergram_list_ticket_custom_column_optionsentergram_update_ticket_custom_column_optionentergram_update_ticket

Goose renvoie

Le ménage que personne ne planifie jamais. Goose lit le schéma des tickets, regroupe les options quasi identiques, renomme celles qui subsistent, et déplace les tickets encore posés sur des valeurs retirées avant que quoi que ce soit ne disparaisse. Regardez la transcription la première fois : c’est un plan dont les trois premières décisions vous disent si la suite sera juste.

La tâche

« Envoie les nouvelles notes de version à tous les groupes où nous avons déjà publié des notes de version. »

Outils appelés

entergram_list_groupsentergram_list_messagesentergram_list_accountsentergram_send_media_message

Goose renvoie

Goose déduit la liste des destinataires à partir de preuves plutôt que d’une liste tenue par quelqu’un : il parcourt l’historique à la recherche des groupes qui ont reçu ce type de publication, confirme que le motif tient, détermine quel compte connecté possède chacun, puis attache le fichier et envoie. La liste complète des groupes est annoncée avant le premier envoi : une mauvaise déduction vous coûte un non plutôt que des excuses.

Ce que Goose peut faire avec votre Telegram

  • Lire et résumer les conversations Telegram
  • Faire remonter les messages manqués et les réponses en retard
  • Rechercher des contacts et des champs CRM personnalisés
  • Envoyer des messages et des réponses après validation
  • Chiffrer les opportunités manquées et les retours
  • Exécuter des actions en plusieurs étapes sur vos conversations

La surface d’outils complète de l’extension

Activer l’extension enregistre 70 outils répartis en 9 groupes dans la session. C’est Goose qui décide lesquels enchaîner et dans quel ordre : le regroupement ci-dessous est donc moins un menu qu’une carte de leurs relations. Repérez où se trouvent les bords destructeurs — administration des groupes, suppression de schéma, envois sortants — car ce sont précisément ceux qu’un agent personnel ne peut pas atteindre du tout.

Comptes et espace de travail

5 outils

Découverte de l’identité et du périmètre. Tout appel de messagerie exige d’abord un account_id issu de list_accounts : un client IA qui saute cette étape s’adressera au mauvais compte Telegram.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Conversations et découverte

8 outils

Pour retrouver les conversations. Les vues de l’espace de travail portent l’état CRM (tickets, commentaires, champs personnalisés) ; les vues en direct portent l’état de transport Telegram actuel et les compteurs de non-lus.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Messages

9 outils

Lecture et écriture de l’historique des messages, y compris les modifications, les transferts et les réactions. L’envoi est limité à un compte : rien n’est global entre vos comptes connectés.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Contacts

3 outils

À qui vous parlez, et où vous vous croisez ailleurs. La recherche de groupes partagés est ce qui rend possible des questions comme « lesquels de mes prospects sont dans la même communauté ? ».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 outils

Contrôle complet du support : ouvrir, attribuer, prioriser, commenter et clore. Chaque ticket renvoie à la conversation dont il est issu, si bien qu’un client IA passe de l’échange à la file d’attente en une seule étape.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Champs CRM personnalisés

11 outils

Le schéma de votre pipeline. Lisez les colonnes avant d’écrire des valeurs : les cases à cocher attendent des booléens, les listes à choix multiples des tableaux de valeurs d’option, les dates des chaînes ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Champs de ticket personnalisés

9 outils

Le même contrôle de schéma côté tickets : catégories, niveaux de gravité, paliers de SLA et tout ce que votre support suit au-delà du statut et de la priorité.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Notes internes

4 outils

Des commentaires sur une conversation que votre client ne voit jamais. Pratique pour qu’un client IA laisse son raisonnement à un collègue humain qui prendra la suite.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Groupes et canaux

11 outils

Créer et administrer des groupes et canaux Telegram — membres, permissions, confidentialité et informations — plus une commande brute en dernier recours pour tout le reste.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

Les permissions, et pourquoi un agent autonome en veut moins

L’autorisation est une connexion OAuth ordinaire dans votre navigateur : Goose ouvre l’écran de consentement d’Entergram, vous approuvez, et le jeton obtenu réside dans votre configuration Goose locale plutôt que sur le serveur de quiconque. La session Telegram, elle, reste derrière Entergram : le numéro avec lequel vous vous êtes inscrit et la connexion qui y est rattachée ne sont jamais remis à l’agent de Block, ni au fournisseur de modèle vers lequel vous avez pointé Goose. Comme un agent agit pendant que vous regardez ailleurs, le niveau d’accès choisi ici est le véritable garde-fou, bien plus que la consigne.

Agent personnel
Ouvert à tout membre de l’espace de travail. Il peut lire l’espace de travail et ses membres, les comptes connectés, vos contacts, la liste des conversations, l’historique des messages et la file de tickets ; la seule chose qu’il écrit, ce sont les champs personnalisés des conversations rattachées aux comptes que vous avez connectés vous-même. Un agent muni de ce jeton peut enquêter et rendre compte toute la journée sans pouvoir dire un mot à un client — ce qui est en général le bon arbitrage pour une exécution que vous ne surveillez pas.
Connecteur d’espace de travail
Réservé aux propriétaires et administrateurs, il porte l’ensemble complet des permissions — messages sortants, écritures de champs personnalisés sur n’importe quelle conversation, modifications de tickets et de schéma, administration des groupes. Ne le confiez à une instance Goose que lorsque le plan doit réellement agir au nom de l’espace de travail, et gardez-le hors des machines auxquelles d’autres personnes peuvent s’asseoir.
Couper l’accès en pleine exécution
Deux interrupteurs, qui n’agissent pas au même niveau. Désactiver l’extension dans Goose empêche l’agent en cours d’atteindre Entergram. Révoquer le jeton sous Settings → Workspace → Connectors → MCP l’invalide partout à la fois, y compris pour une exécution déjà en cours sur une autre machine.

Là où une exécution autonome se heurte à un mur

Des contraintes à connaître avant de confier un plan à Goose et de vous éloigner de l’écran.

  • Les appels d’outils exigent un espace de travail Pro. MCP est une fonctionnalité de l’offre Pro dans Entergram : la poignée de main OAuth aboutit sur n’importe quel niveau, puis le premier appel d’outil de votre plan échoue — chose désagréable à découvrir quarante minutes après le début d’une exécution.
  • Un agent personnel ne peut pas terminer un plan qui se conclut par un envoi. Si la dernière étape est sortante, l’exécution exige un connecteur d’espace de travail, que seul un propriétaire ou un administrateur peut créer.
  • Rien ne planifie Goose à part vous. Entergram n’expose aucun déclencheur capable de réveiller un agent : le travail récurrent passe donc par cron, launchd ou l’ordonnanceur que vous utilisez déjà pour invoquer Goose à l’intervalle voulu.
  • Il n’existe aucune primitive de diffusion. Chaque outil de message résout un account_id et une conversation : un agent qui décide de contacter quarante personnes fait quarante appels distincts — tous visibles dans la transcription, et interruptibles en cours de route.
  • L’historique n’est pas sans fond. Les lectures profondes dans un groupe actif sont bornées par la rétention et la pagination propres à Telegram, et non par Entergram : un plan qui suppose pouvoir remonter une année entière d’un grand groupe reviendra incomplet sans le dire bien fort.
  • Les lectures longues coûtent des jetons de modèle. Goose tourne sur le fournisseur que vous avez configuré, et un plan qui charge des milliers de messages en contexte y est facturé — restreignez par conversation, par plage de dates ou par file de tickets avant de le lâcher.

Quand une exécution Goose part de travers

L’extension est listée mais aucun outil n’apparaît
Goose lit sa liste d’extensions au démarrage d’une session, pas pendant qu’une session est ouverte. Vérifiez que l’entrée porte bien `enabled: true`, puis démarrez une session neuve — une session reprise conserve la liste d’outils avec laquelle elle a été créée.
La CLI se bloque à l’étape d’autorisation
L’écran de consentement réclame un navigateur, et une session SSH ou un conteneur n’a rien pour en ouvrir un. Autorisez une fois depuis une session graphique ; les invocations sans interface qui suivent réutilisent le jeton enregistré.
Goose tente de lancer un binaire et échoue
Le mauvais type d’extension a été choisi. Entergram est un serveur hébergé atteint via Streamable HTTP, pas une extension en ligne de commande — une entrée de type commande envoie Goose chercher un exécutable qui n’a jamais existé sur votre machine.
L’exécution s’arrête à mi-parcours sur une erreur de permissions
Le plan est passé de la lecture à l’écriture. Un agent personnel ne peut ni envoyer de messages, ni modifier les champs de conversations d’autrui, ni administrer de groupes : demandez un connecteur d’espace de travail à un propriétaire ou un administrateur, ou réécrivez le plan pour qu’il s’arrête au brouillon.
Il a agi sur le mauvais compte Telegram
Avec plusieurs comptes connectés, une consigne imprécise laisse le choix au modèle. Nommez le compte dans la requête et exigez un appel à entergram_list_accounts en amont, pour que l’account_id soit résolu à partir de données plutôt que deviné.
Les modifications de config.yaml semblent ignorées
Le YAML est sensible à l’indentation, et un bloc extensions mal imbriqué se lit comme rien du tout, en silence. Lancez `goose configure` et ajoutez l’extension distante par le menu : il écrit le même fichier correctement, et vous pouvez comparer ensuite.

FAQ Goose + Telegram

Comment Goose se connecte-t-il aux serveurs MCP ?
Goose se connecte aux serveurs MCP sous forme d’extensions. Ajoutez Entergram comme extension Streamable HTTP avec l’URL MCP et autorisez via OAuth.
Est-ce un bot Telegram ?
Non. Entergram connecte votre véritable compte Telegram personnel via un serveur MCP hébergé.
Est-ce sécurisé ?
Oui. OAuth 2.0 avec des permissions limitées ; vous décidez de ce à quoi Goose peut accéder et pouvez révoquer l’accès à tout moment.