Crie um grupo ou canal do Telegram, adicione um bot como administrador e obtenha o link público necessário para conectá-lo no console do Chat App Message Service.
Casos de uso
Grupos e canais do Telegram são duas formas distintas de distribuir mensagens:
Grupo: Permite comunicação bidirecional.
Canal: Focado principalmente na transmissão unidirecional de conteúdo pelos administradores. Canais são ideais para comunicados, atualizações de notícias e distribuição de conteúdo.
Para gerenciar um grupo ou canal pelo console, garanta que:
O bot foi adicionado ao grupo ou canal de destino.
O bot possui permissões de administrador.
O grupo ou canal é público.
Procedimento
A criação de grupos e canais segue etapas semelhantes:
Escolha entre criar um grupo ou um canal com base no seu cenário:
|
Recurso |
Grupo |
Canal |
|
Direção da mensagem |
Comunicação bidirecional entre membros |
Transmissão unidirecional dos administradores |
|
Caso de uso |
Comunidades de usuários, discussões interativas |
Comunicados, distribuição de conteúdo |
|
Função do membro |
Todos os membros podem enviar mensagens |
Apenas administradores podem publicar |
Criar um grupo e adicionar um bot
Etapa 1: Criar um grupo
Antes de começar, verifique se você já criou um bot do Telegram. Caso contrário, consulte Como criar um bot do Telegram para criá-lo e autorizá-lo. Recomendamos o uso do aplicativo móvel ou desktop do Telegram, pois alguns recursos podem não ser compatíveis com o Telegram Web.
Abra o Telegram. Na tela principal, clique em no ícone de nova mensagem no canto superior direito e selecione New Group. Siga as instruções na tela para concluir estas ações:
Selecione os membros iniciais. O Telegram exige a adição de pelo menos um contato como membro inicial. Recomendamos pesquisar e adicionar seu bot pelo nome de usuário.
Insira um nome para o grupo.
(Opcional) Defina uma foto de perfil para o grupo.
Clique em Create.
Etapa 2: Adicionar o bot ao grupo
Se você já adicionou o bot como membro inicial na Etapa 1, pule esta etapa.
Acesse a tela de chat do seu novo grupo. Clique em no nome ou na foto de perfil do grupo na parte superior para abrir sua página de perfil. Na página de perfil, localize e clique em Add Members. Pesquise pelo nome de usuário do seu bot (por exemplo, my_demo_bot) e adicione-o ao grupo.
Se não conseguir encontrar o bot durante a pesquisa, verifique o seguinte:
O bot foi criado com sucesso.
O nome de usuário do bot está escrito corretamente.
As configurações do bot no BotFather permitem que ele seja adicionado a grupos.
Etapa 3: Tornar o bot um administrador
Na página de perfil do grupo, acesse a seção Administrators. Selecione seu bot e ative as permissões necessárias. Recomendamos conceder as seguintes permissões conforme seus requisitos:
|
Permissão |
Descrição |
|
Delete messages |
Permite que o bot exclua mensagens no grupo. |
|
Manage group |
Permite que o bot gerencie as configurações do grupo. |
|
Invite users |
Permite que o bot convide novos membros para o grupo. |
|
Restrict members |
Permite que o bot restrinja permissões de membros no grupo. |
|
Pin messages |
Permite que o bot fixe mensagens no grupo. |
Sem essas permissões, o bot não consegue gerenciar mensagens ou membros.
Etapa 4: Tornar o grupo público
Na página de perfil do grupo, clique em Edit. Altere o tipo de grupo para Public e configure um nome de usuário público. Salvar suas alterações gera um link público para o grupo no formato https://t.me/your_group_name.
O Chat App Message Service usa links públicos para identificar grupos. O link de convite gerado automaticamente pelo Telegram (no formato https://t.me/+xxxx) não pode ser usado para identificação e integração.
Etapa 5: Copiar o link público do grupo
Copie o link público do grupo e salve-o em um local seguro. Esse link é necessário para identificar e conectar o grupo no console do Chat App Message Service.
Criar um canal e adicionar um bot
Etapa 1: Criar um canal
Abra o Telegram. Na tela principal, clique em no ícone de nova mensagem no canto superior direito e selecione New Channel. Siga as instruções na tela:
Insira um nome para o canal.
(Opcional) Adicione uma descrição para o canal.
Clique em Next.
Etapa 2: Definir o link público do canal
Na página de configurações de tipo de canal, selecione Public e configure um nome de usuário público para o canal. Isso cria um link público para o canal no formato https://t.me/your_channel_name.
Se o nome de usuário já estiver em uso, o Telegram solicitará que você insira outro. Após confirmar que o nome de usuário está disponível, clique em Next.
Etapa 3: Adicionar o bot ao canal
Selecione os membros para adicionar ao canal. Recomendamos pesquisar pelo nome de usuário do seu bot e adicioná-lo como membro inicial. Você pode adicionar outros membros conforme necessário após o canal estar conectado no Chat App Message Service.
Após fazer sua seleção, conclua o processo de criação do canal.
Etapa 4: Tornar o bot um administrador
Se você adicionou o bot como membro na Etapa 3, acesse a página de perfil do canal, localize a seção Administrators e promova o bot a administrador. Se não adicionou o bot na etapa anterior, pesquise pelo nome de usuário dele e adicione-o diretamente como administrador.
Bots geralmente são adicionados aos canais como administradores. Se você criar um canal mas não adicionar o bot, o Chat App Message Service não poderá gerenciar o canal.
Conceda ao bot as seguintes permissões de administrador:
|
Permissão |
Descrição |
|
Post messages |
Permite que o bot publique mensagens no canal. |
|
Edit messages |
Permite que o bot edite mensagens publicadas. |
|
Delete messages |
Permite que o bot exclua mensagens no canal. |
|
Manage channel |
Permite que o bot gerencie as configurações do canal. |
|
Manage invite links |
Permite que o bot gerencie os links de convite do canal. |
Sem permissões essenciais como 'Post messages', o bot pode não funcionar corretamente no canal.
Etapa 5: Copiar o link público do canal
Copie o link público do canal e salve-o em um local seguro. Esse link é necessário para identificar e conectar o canal no console do Chat App Message Service.
Próximas etapas
Após criar o grupo ou canal, conecte-o no console do Chat App Message Service. Antes de prosseguir, confirme se todas as condições a seguir foram atendidas:
Você criou e autorizou um bot do Telegram.
O bot foi adicionado ao grupo ou canal de destino.
O bot recebeu permissões de administrador.
O grupo ou canal é público.
Você copiou o link público.
No console do Chat App Message Service, acesse a página Group/Channel Management e insira o link público para identificar e conectar o grupo ou canal. O sistema verifica se o bot está no grupo ou canal e se possui as permissões necessárias. Após uma verificação bem-sucedida, o grupo ou canal fica disponível para gerenciamento.
Para localizar um grupo ou canal, use um dos seguintes métodos:
Lista de conversas: O novo grupo ou canal aparece diretamente na sua lista de conversas do Telegram.
Pesquisa por nome: Pesquise pelo nome de usuário público na barra de pesquisa do Telegram.
Link público: Abra o link público diretamente em um navegador, por exemplo,
https://t.me/my_group_name.
Perguntas frequentes
Grupo vs. canal
De modo geral:
Grupos são mais adequados para comunicação interativa entre membros.
Canais são melhores para transmitir conteúdo dos administradores.
Se deseja administrar uma comunidade, use um grupo. Se o objetivo é enviar comunicados, notificações ou distribuir conteúdo, utilize um canal.
Falha no reconhecimento pelo console
Verifique os seguintes pontos:
O grupo ou canal é público?
O link público está configurado corretamente?
O bot atualmente conectado foi adicionado ao grupo ou canal?
O bot recebeu permissões de administrador?
Se o bot não tiver sido adicionado ou não possuir permissões suficientes, o sistema não o reconhecerá como um destino de conexão válido.
Por que links de convite não são suportados
Links de convite servem principalmente para que usuários entrem em um grupo ou canal e não são adequados como identificadores públicos padrão.
O serviço requer um link público para garantir uma conexão estável e verificável.
Link de convite vs. link público
Um link de convite (no formato https://t.me/+xxxx) serve para convidar membros e não pode ser usado como identificador padrão. O Chat App Message Service utiliza um link público (no formato https://t.me/your_name) para identificação, o que proporciona uma conexão mais estável e verificável.
Requisito de grupo/canal público
Sim. O grupo ou canal deve ser público para ser identificado e conectado no console. Grupos privados, canais privados e links de convite não são suportados.
Falha na conexão apesar da presença do bot
Os motivos comuns incluem:
O bot não recebeu as permissões necessárias de grupo ou canal no BotFather.
O bot foi adicionado, mas não recebeu permissões de administrador.
O bot conectado no console não é o mesmo que foi adicionado ao grupo ou canal.
O grupo ou canal não é público.
O link público fornecido está incorreto.
Nomenclatura de links públicos
O link público afeta a url de acesso, a identificação no console e a experiência de pesquisa do usuário. Estabeleça uma convenção de nomenclatura antes de entrar em produção e escolha um nome simples, memorável e relevante para o seu negócio.