--- # System prepended metadata title: Como adicionar Canais ou Grupos do Telegram no App do Parceiro tags: [app-do-parceiro] --- # 🚧🚧🚧 Tutorial em Construção 🚧🚧🚧 # 📢 Como adicionar Canais ou Grupos do Telegram no App do Parceiro Agora que seu bot já está configurado no App do Parceiro, chegou o momento de conectar os **canais ou grupos** onde as ofertas serão enviadas automaticamente. Este passo é simples e rápido. --- #### ⭐ Se você preferir, aqui está o tutorial em vídeo: https://youtu.be/zQVrvckPa-g?si=Jq9XKN8olVLfFW83 ## 📌 Parte 1: Obtendo o link do seu canal ou grupo no Telegram 1. Abra o **canal** ou **grupo** onde deseja receber as ofertas 2. Toque no nome do canal/grupo no topo da tela 3. Procure pela opção **Link de convite** ou **Link público** 4. Toque em **Copiar link** 📸 **INSERIR PRINT DO TELEGRAM MOSTRANDO O LINK COPIADO** > Importante: para canais, o **bot precisa ser administrador**. > Para grupos, o bot também deve ser adicionado e com permissão de enviar mensagens. --- ## 📌 Parte 2: Adicionando o canal no App do Parceiro 1. Abra o **App do Parceiro** 2. Vá novamente em **Configurar Telegram** no menu 3. Toque no botão **+** (botão redondo flutuante no lado direito da tela) 📸 **INSERIR IMAGEM MOSTRANDO O BOTÃO DE ADICIONAR CANAL** 4. Uma nova tela/modal será aberta solicitando a **URL do canal/grupo** 5. Cole o link que você copiou no Telegram 6. Opcionalmente, adicione uma **nota/descrição** para identificar o canal depois 7. Clique em **Adicionar** ou **Salvar** 📸 **INSERIR IMAGEM DO FORMULÁRIO COM O CAMPO PARA A URL E NOTA** --- ## ✅ Canal cadastrado com sucesso Se tudo estiver correto, o canal aparecerá na tela com o status de **Conectado** junto com as informações principais. 📸 **INSERIR IMAGEM DA LISTA DE CANAIS CONFIGURADOS** Agora seu bot já consegue fazer o disparo automático de ofertas para esse canal. --- ### ❗Checklist rápido Antes de testar o disparo, confirme: * O bot está configurado e aparece corretamente no App do Parceiro * O bot foi adicionado ao canal ou grupo * O bot é **Administrador** com permissão para **Enviar Mensagens** Caso alguma dessas condições falhe, o sistema não conseguirá enviar as ofertas. --- # 🛠️ Solução de Problemas (FAQ) ## Integração do Telegram no App do Parceiro Mesmo seguindo todos os passos, pode acontecer algum problema na configuração. Aqui estão as dúvidas mais comuns e como resolver. --- ## ❌ O bot não aparece como configurado após colar o token Verifique: * Se o token foi colado **sem espaços** no início ou final * Se o BotFather realmente gerou um token válido * Se o bot possui um **username único** com **terminação “bot”** * Se seu dispositivo está com **internet estável** 📌 Caso tenha dúvidas sobre o token ou queira gerar outro: No BotFather, envie: ``` /token @SeuBotUsername ``` ou se quiser revogar o token anterior: ``` /revoke @SeuBotUsername ``` --- ## ❌ O canal não aparece na lista ou fica como “Não Conectado” Esse é o motivo mais comum: > O bot não está com **permissão de Administrador** no canal Solução rápida: 1. Abra o canal no Telegram 2. Toque no nome do canal 3. Vá em **Administradores** 4. Adicione seu bot e habilite **Enviar Mensagens** 📸 **INSERIR PRINT DOS ADMINISTRADORES NO TELEGRAM** --- ## ❌ As mensagens não chegam no canal após o envio pelo App Checklist rápido: * O bot é administrador no canal? * O canal configurado no App é o mesmo em que o bot está dentro? * O link colado no App é realmente o **link público ou de convite** válido? * O bot não está silenciado ou sem permissão de envio? Se estiver tudo ok, tente: * Enviar uma **nova oferta** * Fechar e abrir o app novamente * Reconfigurar o token (raro, mas pode resolver) --- ## ❌ Estou tentando usar um **Grupo** e não funciona Grupos possuem mais restrições. Faça isso: 1. Adicione o bot ao grupo 2. Promova o bot a administrador 3. Nas permissões, habilite no mínimo: * ✅ Enviar mensagens * ✅ Enviar mídia * ✅ Adicionar links 📸 **INSERIR PRINT COM PERMISSÕES DE ADMIN EM GRUPO** Dica extra: > Transformar o grupo em **Supergrupo** pode melhorar a compatibilidade com bots --- ## ❌ Coloquei o link, mas o App diz que é inválido O link deve ser no formato: * Canal público: ``` https://t.me/NOME_DO_CANAL ``` * Canal privado (link de convite): ``` https://t.me/+CódigoAleatório ``` Evite copiar links de mensagens individuais do canal. Sempre copie o link do canal em si. --- ## 🆘 Ainda com problemas? Você pode: * Repetir o passo do token * Revalidar as permissões no canal * Cadastrar novamente o canal no App do Parceiro * Verificar se o canal não está configurado como **somente leitura** Se mesmo assim não funcionar, entre em contato com nosso **suporte interno no App**, descrevendo: * Modelo do celular e sistema operacional * Nome do canal configurado * Captura de tela dos administradores do canal Quanto mais detalhes, mais rápido conseguiremos ajudar. --- Quer que eu junte os **3 tutoriais** em um único documento pronto para publicar no HackMD? Posso também inserir **rótulos numerados** para facilitar a adição dos prints.