Automação do Telegram via Rube MCP

Automatize operações do Telegram através do toolkit do Telegram da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH disponíveis)
• Conexão ativa do Telegram via RUBE_MANAGE_CONNECTIONS com o toolkit telegram
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais
• Token de Bot do Telegram necessário (criado via @BotFather)

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit telegram
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para configurar o bot do Telegram
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Enviar Mensagens

Quando usar: O usuário deseja enviar mensagens de texto para um chat do Telegram

Sequência de ferramentas:

1. TELEGRAM_GET_ME - Verificar identidade e conexão do bot [Pré-requisito]
2. TELEGRAM_GET_CHAT - Obter detalhes do chat e verificar acesso [Opcional]
3. TELEGRAM_SEND_MESSAGE - Enviar uma mensagem de texto [Obrigatório]

Parâmetros chave:

• chat_id: ID numérico do chat ou nome de usuário do canal (ex: '@nomedocanal')
• text: Conteúdo do texto da mensagem
• parse_mode: 'HTML' ou 'MarkdownV2' para formatação
• disable_notification: Enviar silenciosamente sem som de notificação
• reply_to_message_id: ID da mensagem para responder

Armadilhas:

• O bot deve ser membro do chat/grupo para enviar mensagens
• MarkdownV2 requer escape de caracteres especiais: _*[]()~>#+-=|{}.!
• O modo HTML suporta tags limitadas: <b>, <i>, <code>, <pre>, <a>
• Mensagens têm um limite de 4096 caracteres; divida conteúdo mais longo

2. Enviar Fotos e Documentos

Quando usar: O usuário deseja compartilhar imagens ou arquivos em um chat do Telegram

Sequência de ferramentas:

1. TELEGRAM_SEND_PHOTO - Enviar uma imagem [Opcional]
2. TELEGRAM_SEND_DOCUMENT - Enviar um arquivo/documento [Opcional]

Parâmetros chave:

• chat_id: ID do chat de destino
• photo: URL da foto ou file_id (para SEND_PHOTO)
• document: URL do documento ou file_id (para SEND_DOCUMENT)
• caption: Legenda opcional para a mídia

Armadilhas:

• Legendas de fotos têm um limite de 1024 caracteres
• Legendas de documentos também têm um limite de 1024 caracteres
• Arquivos de até 50MB podem ser enviados via API do bot
• Fotos são comprimidas pelo Telegram; use SEND_DOCUMENT para imagens não comprimidas

3. Gerenciar Chats

Quando usar: O usuário deseja obter informações do chat ou gerenciar configurações do chat

Sequência de ferramentas:

1. TELEGRAM_GET_CHAT - Obter informações detalhadas do chat [Obrigatório]
2. TELEGRAM_GET_CHAT_ADMINISTRATORS - Listar administradores do chat [Opcional]
3. TELEGRAM_GET_CHAT_MEMBERS_COUNT - Obter contagem de membros [Opcional]
4. TELEGRAM_EXPORT_CHAT_INVITE_LINK - Gerar link de convite [Opcional]

Parâmetros chave:

• chat_id: ID do chat de destino ou nome de usuário

Armadilhas:

• O bot deve ser um administrador para exportar links de convite
• GET_CHAT retorna campos diferentes para chats privados vs grupos vs canais
• A contagem de membros pode ser aproximada para grupos muito grandes
• A lista de administradores não inclui membros regulares

4. Editar e Excluir Mensagens

Quando usar: O usuário deseja modificar ou remover mensagens enviadas anteriormente

Sequência de ferramentas:

1. TELEGRAM_EDIT_MESSAGE - Editar uma mensagem enviada [Opcional]
2. TELEGRAM_DELETE_MESSAGE - Excluir uma mensagem [Opcional]

Parâmetros chave:

• chat_id: Chat onde a mensagem está localizada
• message_id: ID da mensagem a ser editada ou excluída
• text: Novo conteúdo de texto (para edição)

Armadilhas:

• Bots só podem editar suas próprias mensagens
• Mensagens só podem ser excluídas dentro de 48 horas após o envio
• Em grupos, bots com permissões de exclusão podem excluir qualquer mensagem
• Editar uma mensagem remove seu histórico de carimbo de data/hora de 'editado'

5. Encaminhar Mensagens e Obter Atualizações

Quando usar: O usuário deseja encaminhar mensagens ou recuperar atualizações recentes

Sequência de ferramentas:

1. TELEGRAM_FORWARD_MESSAGE - Encaminhar uma mensagem para outro chat [Opcional]
2. TELEGRAM_GET_UPDATES - Obter atualizações/mensagens recentes do bot [Opcional]
3. TELEGRAM_GET_CHAT_HISTORY - Obter histórico de mensagens do chat [Opcional]

Parâmetros chave:

• from_chat_id: Chat de origem para encaminhamento
• chat_id: Chat de destino para encaminhamento
• message_id: Mensagem a ser encaminhada
• offset: Offset de atualização para GET_UPDATES
• limit: Número de atualizações a serem recuperadas

Armadilhas:

• Mensagens encaminhadas mostram a atribuição do remetente original
• GET_UPDATES retorna uma janela limitada de atualizações recentes

…