← Todos os conectores MCP do Telegram

Goose · Block

Conecte o Telegram ao Goose

Adicione a Entergram como extensão MCP no Goose, o agente de IA open-source da Block, e deixe-o trabalhar com sua conta real do Telegram — revele mensagens perdidas, retome leads que esfriaram e atue sobre conversas de forma autônoma.

URL do servidor MCP https://mcp.entergram.com/mcp

O Goose é um agente de IA extensível que se conecta a servidores MCP como extensões. A Entergram expõe sua conta pessoal do Telegram como um servidor MCP hospedado, então o Goose lê e atua sobre suas conversas reais com total segurança via OAuth — sem conta de bot, sem chaves de API.

Configuração pronta para colar

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

Pergunte ao Goose coisas que você nunca poderia perguntar ao Telegram

Com sua conta pessoal conectada, o Goose pode atuar em todas as conversas. Experimente comandos como:

  • «Quantas mensagens eu perdi esta semana e quais são de clientes?»
  • «Quais conversas estou esquecendo de responder?»
  • «Quantifique os leads que esfriaram por falta de retorno.»
  • «Resuma o feedback dos clientes deste mês.»
  • «Escreva respostas para as minhas mensagens sem resposta mais antigas, para eu revisar.»

Conecte o Goose em 3 passos

Funciona com o app desktop e a CLI do Goose.

  1. 01

    Copie sua URL do MCP na Entergram

    Na Entergram, abra Settings → Workspace → Connectors → MCP e copie a URL do seu servidor MCP.

  2. 02

    Adicione a extensão no Goose

    No Goose, adicione uma nova extensão do tipo Streamable HTTP apontando para a URL do MCP da Entergram: https://mcp.entergram.com/mcp.

  3. 03

    Autorize e execute

    Clique em Connect, faça login com sua conta da Entergram e clique em Allow access. O Goose poderá então ler e atuar sobre sua conta do Telegram em suas sessões.

Três formas de rodar a extensão da Entergram

Goose Desktop

Abra a lista de extensões, adicione uma extensão personalizada, escolha o tipo Streamable HTTP e cole a URL. O app desktop cuida do vai e vem no navegador por você, então a tela de consentimento aparece uma única vez e toda sessão seguinte já começa autorizada.

Goose CLI

O `goose configure` te guia pela adição de uma extensão remota sem encostar em YAML — escolha Add Extension e depois a opção remota de Streamable HTTP. Editar ~/.config/goose/config.yaml à mão faz exatamente a mesma coisa e é mais fácil de manter em um repositório de dotfiles junto com o resto do setup da sua máquina.

goose configure

Execuções sem supervisão

Uma vez que a extensão está autorizada, uma invocação headless herda a autorização. É assim que uma varredura do Telegram vira algo que a sua máquina faz às 8 da manhã em vez de algo que você lembra de pedir — combine com cron ou launchd, porque a Entergram não vai acordar o agente sozinha.

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

Trabalhos longos, levados até o fim

O Goose foi feito para sustentar um plano por muitos passos, e isso muda o que vale a pena pedir. Estas são tarefas que você senão entregaria a uma pessoa por uma tarde inteira. Cada uma é uma única instrução; a sequência de ferramentas por baixo é o que o Goose descobre sozinho, e toda chamada fica na transcrição da sessão para você auditar o caminho que ele tomou.

A tarefa

«Passe por todo ticket aberto há mais de três dias, leia a conversa por trás dele e escreva uma atualização de status para cada cliente. Me mostre os rascunhos antes de qualquer coisa sair.»

Ferramentas chamadas

entergram_list_ticketsentergram_get_ticketentergram_list_messagesentergram_send_message

O Goose devolve

Uma instrução, quatro tipos de ferramenta e um loop que dura o tamanho da fila. O Goose filtra por idade, abre cada ticket para achar a conversa de origem, lê histórico suficiente para saber o que o cliente realmente está esperando e escreve um rascunho por ticket. Ele segura no passo de aprovação — as chamadas de envio só disparam para os rascunhos que você mantiver.

A tarefa

«Crie uma coluna Estágio do negócio com as opções Descoberta, Trial, Negociação e Fechado, e depois classifique nela toda conversa que tivemos no último trimestre.»

Ferramentas chamadas

entergram_create_custom_columnentergram_create_custom_column_optionentergram_list_workspace_chatsentergram_patch_chat_custom_fields

O Goose devolve

Schema e backfill na mesma execução, que é onde um agente se paga: a coluna precisa existir antes de um único valor ser gravado, e os valores de opção precisam ser lidos de volta para que o classificador escreva ids de opção reais em vez de texto livre. Espere que demore um pouco e que ele devolva uma lista por conversa no final. Somente com conector de workspace.

A tarefa

«Audite nossos três grupos de parceiros — quem está em cada um e quais dos nossos contatos aparecem em mais de um?»

Ferramentas chamadas

entergram_list_groupsentergram_list_group_membersentergram_list_contact_shared_groups

O Goose devolve

Um cruzamento que não tem interface em lugar nenhum. O Goose enumera os grupos, percorre cada lista de membros, pergunta por contato em quais comunidades vocês dois estão e dobra as respostas em uma tabela de sobreposição. O que sai é a lista de pessoas que merecem uma mensagem em vez de três, mais a descoberta silenciosa de que dois parceiros já se conhecem.

A tarefa

«Encontre quem fez a mesma pergunta duas vezes e nunca recebeu resposta, abra um ticket para cada e cole as duas mensagens da pessoa no ticket como comentário.»

Ferramentas chamadas

entergram_list_messagesentergram_create_ticketentergram_create_ticket_comment

O Goose devolve

O passo de detecção é a parte difícil e é puro raciocínio — duas mensagens recebidas com a mesma intenção e nenhum turno de saída entre elas. Tudo depois disso é mecânico. O comentário importa mais que o ticket: quem pegar a fila vê as palavras exatas que foram ignoradas, citadas, sem precisar reconstruir a conversa.

A tarefa

«Nossa coluna de severidade de tickets se degradou e três opções agora significam a mesma coisa. Consolide tudo em um conjunto canônico.»

Ferramentas chamadas

entergram_list_ticket_custom_columnsentergram_list_ticket_custom_column_optionsentergram_update_ticket_custom_column_optionentergram_update_ticket

O Goose devolve

Faxina que ninguém nunca agenda. O Goose lê o schema de tickets, agrupa as opções quase duplicadas, renomeia as sobreviventes e move os tickets que ainda estão em valores aposentados antes de qualquer coisa ser descartada. Acompanhe a transcrição na primeira vez — este é um plano cujas três primeiras decisões já dizem se o resto vai sair certo.

A tarefa

«Envie as novas notas de versão para todo grupo em que já publicamos notas de versão antes.»

Ferramentas chamadas

entergram_list_groupsentergram_list_messagesentergram_list_accountsentergram_send_media_message

O Goose devolve

O Goose deduz a lista de destino a partir de evidência, e não de uma lista que alguém mantém: ele varre o histórico atrás dos grupos que já receberam esse tipo de publicação, confirma que o padrão se sustenta, resolve qual conta conectada é dona de cada um e então anexa o arquivo e envia. A lista completa de grupos é apresentada antes do primeiro envio, então uma inferência ruim custa um «não» em vez de um pedido de desculpas.

O que o Goose pode fazer com o seu Telegram

  • Ler e resumir conversas do Telegram
  • Mostrar mensagens perdidas e respostas atrasadas
  • Consultar contatos e campos personalizados do CRM
  • Enviar mensagens e respostas com sua aprovação
  • Quantificar oportunidades perdidas e feedbacks
  • Executar ações em várias etapas nas suas conversas

A superfície completa de ferramentas da extensão

Habilitar a extensão registra 70 ferramentas em 9 grupos dentro da sessão. O Goose decide quais encadear e em que ordem, então o agrupamento abaixo é menos um cardápio e mais um mapa de como elas se relacionam. Repare onde ficam as bordas destrutivas — administração de grupos, exclusão de schema, mensagens de saída — porque são exatamente as que um agente pessoal não alcança de forma alguma.

Contas e workspace

5 ferramentas

Descoberta de identidade e escopo. Toda chamada de mensagem precisa antes de um account_id vindo de list_accounts — um cliente de IA que pula essa etapa vai falar com a conta errada do Telegram.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Conversas e descoberta

8 ferramentas

Para localizar conversas. As visões do workspace trazem o estado do CRM (tickets, comentários, campos personalizados); as visões ao vivo trazem o estado atual de transporte do Telegram e a contagem de não lidas.

  • 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

Mensagens

9 ferramentas

Leitura e escrita do histórico de mensagens, incluindo edições, encaminhamentos e reações. O envio é delimitado por conta, então nada vale de forma global entre as suas contas conectadas.

  • 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

Contatos

3 ferramentas

Com quem você está falando e onde mais vocês se cruzam. A busca por grupos em comum é o que torna respondíveis perguntas como «quais dos meus leads estão na mesma comunidade?».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 ferramentas

Controle total da central de suporte: abrir, atribuir, priorizar, comentar e fechar. Os tickets apontam de volta para a conversa que os originou, então um cliente de IA vai da conversa para a fila em um único passo.

  • 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

Campos personalizados de CRM

11 ferramentas

O esquema do seu funil. Leia as colunas antes de gravar valores — caixas de seleção aceitam booleanos, campos de múltipla escolha aceitam arrays de valores de opção e datas aceitam strings 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

Campos personalizados de ticket

9 ferramentas

O mesmo controle de esquema do lado dos tickets — categorias, níveis de severidade, faixas de SLA e tudo o mais que a sua central acompanha além de status e prioridade.

  • 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

Notas internas

4 ferramentas

Comentários em uma conversa que o seu cliente nunca vê. Úteis para o cliente de IA deixar o raciocínio registrado e um colega humano continuar de onde ele parou.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Grupos e canais

11 ferramentas

Criar e administrar grupos e canais do Telegram — participantes, permissões, privacidade e informações — além de uma saída de emergência por comando bruto para o resto.

  • 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

Escopos, e por que um agente autônomo quer menos deles

A autorização é um login OAuth comum no seu navegador: o Goose abre a tela de consentimento da Entergram, você aprova e o token resultante fica na sua configuração local do Goose, não no servidor de ninguém. A sessão do Telegram em si continua atrás da Entergram: o número com que você se cadastrou e o login ligado a ele nunca são entregues ao agente da Block, nem ao provedor de modelo que você apontou para o Goose. Como um agente age enquanto você está olhando para outro lado, o nível de acesso que você escolhe aqui é o controle de segurança de verdade — não o prompt.

Agente pessoal
Aberto a qualquer membro do workspace. Ele lê o workspace e seus membros, as contas conectadas, seus contatos, a lista de conversas, o histórico de mensagens e a fila de tickets; a única coisa que escreve são os campos personalizados de conversas pertencentes a contas que você mesmo conectou. Um agente com esse token pesquisa e relata o dia inteiro e ainda assim não consegue dizer uma palavra a um cliente, que costuma ser a troca correta para uma execução que você não está assistindo.
Conector de workspace
Restrito a owners e admins, e carrega o conjunto de escopos inteiro — mensagens de saída, escrita de campos personalizados em qualquer conversa, mudanças em tickets e schema, administração de grupos. Entregue isso a uma instância do Goose só quando o plano realmente precisar agir em nome do workspace, e mantenha longe de máquinas em que outras pessoas podem sentar.
Cortando o acesso no meio da execução
Duas chaves, que agem em níveis diferentes. Desabilitar a extensão no Goose impede o agente atual de alcançar a Entergram. Revogar o token em Settings → Workspace → Connectors → MCP o invalida em todo lugar de uma vez, inclusive em uma execução já em andamento em outra máquina.

Onde uma execução autônoma bate na parede

Restrições que vale conhecer antes de entregar um plano ao Goose e sair de perto da tela.

  • As chamadas de ferramenta exigem um workspace Pro. MCP é um recurso do plano Pro na Entergram, então o handshake OAuth conclui em qualquer plano e depois a primeira chamada do seu plano falha — uma coisa desagradável de descobrir quarenta minutos execução adentro.
  • Um agente pessoal não termina um plano que acaba em envio. Se o passo final é de saída, a execução precisa de um conector de workspace, e só um owner ou admin cria um.
  • Ninguém agenda o Goose além de você. A Entergram não expõe gatilho que acorde um agente, então trabalho recorrente significa cron, launchd ou o runner que você já usa invocando o Goose no intervalo desejado.
  • Não existe primitiva de broadcast. Toda ferramenta de mensagem resolve um account_id e uma conversa, então um agente que decide falar com quarenta pessoas faz quarenta chamadas separadas — cada uma visível na transcrição e interrompível no meio do caminho.
  • O histórico não é infinito. Leituras profundas em um grupo movimentado são limitadas pela retenção e pela paginação do próprio Telegram, não pela Entergram, então um plano que assume conseguir percorrer um ano inteiro de um grupo grande volta incompleto sem avisar em voz alta.
  • Leituras longas custam tokens de modelo. O Goose roda no provedor que você configurou, e um plano que puxa milhares de mensagens para o contexto é cobrado lá — restrinja por conversa, intervalo de datas ou fila de tickets antes de soltá-lo.

Quando uma execução do Goose sai dos trilhos

A extensão está na lista, mas nenhuma ferramenta aparece
O Goose lê a lista de extensões quando uma sessão começa, não durante uma sessão aberta. Confirme que a entrada tem `enabled: true` e então inicie uma sessão nova — uma sessão retomada mantém a lista de ferramentas com que foi criada.
A CLI trava no passo de autorização
A tela de consentimento precisa de um navegador, e uma sessão SSH ou um contêiner não tem com o que abrir um. Autorize uma vez a partir de uma sessão de desktop; as invocações headless seguintes reutilizam o token armazenado.
O Goose tenta iniciar um binário e falha
Foi escolhido o tipo errado de extensão. A Entergram é um servidor hospedado alcançado por Streamable HTTP, não uma extensão de linha de comando — uma entrada do tipo command manda o Goose procurar um executável que nunca esteve na sua máquina.
A execução para no meio com erro de permissão
O plano cruzou de leitura para escrita. Um agente pessoal não envia mensagens, não edita campos de conversas de outras pessoas e não administra grupos, então ou peça a um owner ou admin um conector de workspace, ou reescreva o plano para parar no rascunho.
Ele agiu na conta errada do Telegram
Com várias contas conectadas, uma instrução sem qualificação deixa a escolha para o modelo. Cite a conta no prompt e exija uma chamada de entergram_list_accounts no início, para que o account_id seja resolvido a partir de dados em vez de adivinhado.
Edições no config.yaml parecem ser ignoradas
YAML é sensível à indentação e um bloco extensions mal aninhado é interpretado como nada, em silêncio. Rode `goose configure` e adicione a extensão remota pelo menu — ele escreve o mesmo arquivo corretamente e você pode conferir o diff depois.

Perguntas frequentes: Goose + Telegram

Como o Goose se conecta a servidores MCP?
O Goose se conecta a servidores MCP como extensões. Adicione a Entergram como extensão Streamable HTTP com a URL do MCP e autorize via OAuth.
Isso é um bot do Telegram?
Não. A Entergram conecta sua conta pessoal real do Telegram por meio de um servidor MCP hospedado.
É seguro?
Sim. OAuth 2.0 com permissões delimitadas por escopo; você decide o que o Goose pode acessar e pode revogar a qualquer momento.

Conecte o Telegram ao Goose