Criar um bot do Telegram

Bots do Telegram entregam texto copiado e mídias compatíveis — como fotos, vídeos, áudio, arquivos e figurinhas — no Telegram. Escolha os tipos em Opções de Encaminhamento; os limites de arquivo do Telegram continuam valendo. Você pode reutilizar um bot salvo em vários grupos, canais, tópicos ou conversas privadas; não precisa criar um bot para cada destino.

Criar o bot com o BotFather

Método 1: usar o Mini App do BotFather

Esta é a maneira visual de criar seu bot, usando um formulário em vez de comandos de chat.

1. Abra o @BotFather no Telegram.
2. Selecione Abrir ou Abrir App para abrir o Mini App. Você também pode usar o link direto do Mini App.
3. Escolha a opção para criar um novo bot.
4. Digite um nome de exibição, como Meu Bot de Notícias, e um nome de usuário disponível que termine em bot, como my_news_updates_bot.
5. Confirme a criação. Você pode adicionar uma foto de perfil e uma descrição nas configurações do bot; ambos são opcionais.
6. Abra as configurações do novo bot e copie o token da API.

Se você não conseguir abrir o Mini App, use o Método 2 abaixo. Os dois métodos criam o mesmo tipo de bot. O Telegram descreve o Mini App como uma alternativa visual no guia do BotFather.

Método 2: usar comandos de chat do BotFather

1. Abra o @BotFather e selecione Iniciar se esta for sua primeira conversa com ele.
2. Envie /newbot.
3. Responda com o nome de exibição do bot.
4. Responda com um nome de usuário disponível que termine em bot.
5. Copie o token da mensagem de confirmação do BotFather.

Adicionar o bot a cada destino

Estas etapas adicionam o bot ao destino do Telegram em que você quer receber as mensagens copiadas — não ao grupo ou canal de onde você está copiando. Escolha abaixo o tipo de destino correspondente e repita as etapas para cada local que deverá receber cópias.

Grupo ou tópico de grupo

1. Abra as informações do grupo e escolha Adicionar membros. Busque o @username do bot e adicione-o. Se não puder adicionar membros, peça a um administrador do grupo que o adicione.
2. Permita que o bot envie mensagens e as mídias que você pretende encaminhar, como fotos, vídeos e arquivos.
3. Se usar Ações de espelhamento para excluir ou fixar cópias, torne o bot administrador e ative as permissões necessárias para essas ações.

Para um destino em tópico, adicione o bot ao grupo que contém o tópico. O mesmo bot pode entregar mensagens em vários tópicos desse grupo; você não precisa de um bot separado para cada tópico.

Canal

Para um destino em canal, o bot precisa ser administrador desse canal.

1. Abra as informações do canal e, em seguida, as configurações de Administradores.
2. Adicione o bot pelo @username. Você precisa ser proprietário ou ter permissão para adicionar administradores; caso contrário, peça a alguém que tenha essa permissão.
3. Ative Publicar mensagens para que o bot possa enviar suas cópias ao canal. Permita também editar ou excluir mensagens se você usar essas ações de espelhamento.

Chat privado

Para receber cópias em privado, a pessoa que vai recebê-las precisa iniciar uma conversa com seu bot primeiro. Isso vale quer o destinatário seja você ou outra pessoa.

1. Abra o bot usando o @username dele ou um link como https://t.me/my_news_updates_bot.
2. Selecione Iniciar, envie /start ou mande uma mensagem ao bot.
3. Abra o bot auxiliar de IDs do ForwardMsg, selecione Iniciar e depois Get ID → My User ID. Copie seu ID numérico de usuário.
4. Ao adicionar o chat de destino no ForwardMsg, use Manual se essa aba aparecer. Informe esse ID de usuário em ID do Chat, dê ao chat um nome fácil de reconhecer e deixe ID do Tópico (Opcional) vazio.
5. Adicione o chat, escolha-o como destino do bot do Telegram e selecione Salvar Alterações.

Para outro destinatário, envie o link do bot e peça que essa pessoa conclua as etapas 1–3 e compartilhe apenas o ID numérico de usuário dela com você. Use o ID dela, não o seu, no ForwardMsg. As cópias chegarão à conversa dela com o bot, não à sua conversa existente com essa pessoa. O Telegram exige que a pessoa envie uma mensagem ao bot primeiro.

Para uma entrega privada, o ID do chat é o ID de usuário do destinatário — não o ID do seu bot. Selecionar sua conversa com o bot na lista de chats da sua conta escolheria o bot, e não a pessoa que deve receber as cópias.

O ForwardMsg também oferece um link de convite quando você conecta o bot. Use-o para adicioná-lo a um grupo ou canal, ou para abrir o chat privado dele.

Conectar o bot ao ForwardMsg

1. Selecione Adicionar Bot do Telegram.
2. Cole o token do BotFather no diálogo e selecione Adicionar.
3. Confirme ou altere o Nome do Bot usado para identificá-lo no ForwardMsg e selecione Continuar.
4. Use a etapa de convite para preparar o chat de destino, caso ainda não tenha feito isso, e selecione Concluir.
5. No ForwardMsg, clique no chat de origem monitorado na lista à esquerda para abrir as configurações dele.
6. Abra Roteamento → Adicionar Destino.
7. Escolha o bot do Telegram salvo.
8. Selecione ou adicione o chat, canal ou tópico de destino.
9. Conclua Adicionar Destino.
10. Selecione Salvar Alterações.

Quando sua automação estiver em execução, confira o chat de destino quando uma mensagem nova chegar a um dos chats de origem selecionados para monitoramento.

Para selecionar destinos e usar IDs de tópico, continue com Chats, canais e tópicos do Telegram. Se o seletor não encontrar o chat, use encontrar um ID de chat do Telegram.

Perguntas frequentes