Conectar Telegram

Objetivo: Receber alertas em tempo real de pedidos, envios e estoque baixo no seu celular.

Tempo: 5 minutos.

O que você precisa antes de começar

• Telegram instalado no seu celular ou computador (aplicativo ou web.telegram.org)
• Acesso ao Telegram (criar conta se não tiver)
• Um navegador

Passo a Passo

1. Criar um Bot no BotFather

BotFather é o assistente oficial do Telegram para criar bots. É um "bot do bot" — ele gerencia outros bots.

Passo 1a: Abrir Telegram

1. Abra o Telegram (app no celular, web em web.telegram.org, ou desktop)
2. Na barra de busca, procure por @BotFather (com o @)
3. Clique no verificado (tem um selo azul)

Passo 1b: Usar o /newbot

1. Mande a mensagem /newbot para o BotFather
2. BotFather vai responder pedindo o nome para o seu bot
   • Ex.: "Meu SellerForge" ou "Alertas Loja"
   • Qualquer nome funciona
3. Mande o nome
4. BotFather vai pedir um username (precisa terminar com "bot")
   • Ex.: "minha_loja_bot" ou "sellerforge_alerts_bot"
   • Tem que ser único e terminar com "bot"
5. Mande o username
6. BotFather dirá:

   Done! Congratulations on your new bot. 
   You will find it at t.me/seu_username_bot. 
   You can now add a description, about section and profile picture for your bot, see /help for a list of commands. 
   
   Use this token to access the HTTP API:
   1234567890:ABCdefGHIjklmnoPQRstuvWXyz...

1. Copie o token (o código longo que começa com números e dois-pontos)

2. Conectar no SellerForge WMS

1. Na aplicação SellerForge WMS, vá até Configurações → Integrações
2. Clique no card Telegram
3. Preencha o campo Bot Token com o token que você copiou do BotFather
4. Clique em Salvar / Save

Você deve ver:

Status: Aguardando webhook...

3. Registrar o Webhook

1. Agora você verá um botão Registrar Webhook / Register Webhook
2. Clique nele
3. O SellerForge WMS vai comunicar com Telegram e ativar notificações
4. Você deve ver:

   Status: Pronto! Envie /start para o bot.

4. Iniciar o Chat com o Bot

Agora você precisa iniciar uma conversa com seu bot para que ele capture seu chat ID automaticamente.

1. Volte ao Telegram
2. Procure por seu bot pelo username (ex.: @seu_username_bot) na barra de busca
3. Abra o bot
4. Mande a mensagem /start para o bot
5. O bot vai responder com uma mensagem de confirmação

Pronto! O SellerForge WMS já capturou seu chat ID.

5. Testar a Conexão

De volta ao SellerForge WMS:

1. Clique em Testar conexão / Test Connection
2. O aplicativo vai enviar uma mensagem de teste para seu bot
3. Você deve receber a mensagem de teste no Telegram

Se recebeu, está funcionando!

Adicionar Mais Pessoas (Grupo)

Se quiser que mais pessoas da sua equipe recebam os alertas:

Opção 1: Chat individual

• Repita os passos 1-5 para cada pessoa (cada uma usa um bot diferente)

Opção 2: Grupo (recomendado)

1. No Telegram, crie um novo Grupo (não é um "chat secreto")
2. Adicione o bot ao grupo (procure pelo username)
3. Adicione as pessoas que você quer que recebam alertas
4. Clique no nome do grupo → Add Bot → procure por seu bot
5. De volta ao SellerForge WMS, vá para Configurações → Integrações → Telegram
6. Clique em Registrar Webhook novamente (ou Re-register)
7. No Telegram, no grupo, mande /start para o bot
8. O SellerForge WMS vai capturar o ID do grupo

Aviso: Quando você muda de chat individual para grupo, o chat ID muda. Você vai precisar re-registrar o webhook.

Testar a Conexão

Após clicar em "Testar conexão":

• "Mensagem enviada com sucesso" → Você deve receber uma mensagem no Telegram em 5-10 segundos
• "Error: Chat ID not found" → Você não mandou /start para o bot ainda. Volte ao passo 4.
• "Error: Invalid Bot Token" → Verifique se copiou o token completo (sem espaços)
• "Telegram service unavailable" → Telegram pode estar com problemas; aguarde alguns minutos

Problemas Comuns

Não recebi a mensagem de teste

Causa: O chat ID ainda não foi capturado. Solução: Volte ao Telegram, procure por seu bot, abra a conversa, e mande /start. Aguarde 5 segundos, então volte ao SellerForge WMS e clique "Testar conexão" novamente.

"Error: Invalid Bot Token"

Causa: Você copiou errado ou faltam caracteres. Solução: Volte ao BotFather, mande /mybots, clique no seu bot, e mande /token para receber o token novamente. Copie completo (vai ser bem longo).

"Error: Chat ID not found"

Causa: O /start não foi mandado para o bot. Solução: No Telegram, procure pelo username do bot (ex.: @seu_username_bot), abra, e mande /start. Espere 5-10 segundos para o ID ser capturado.

Quero mudar para um grupo mas o bot não entra

Causa: Pode ser que você não tenha adicionado o bot aos administradores. Solução: No Telegram, vá para o grupo, toque no nome do grupo, procure por "Add Members" ou "Adicionar Membros", procure pelo bot pelo username, e adicione.

Recebi uma mensagem de erro em russo ou outro idioma

Causa: Telegram enviou um erro na sua língua configurada. Solução: Copie a mensagem, procure pela tradução. Geralmente é "chat not found" (chat ID não encontrado) ou "token invalid" (token inválido). Valide os passos acima.

Criei um novo bot mas o antigo continua recebendo mensagens

Causa: Você não atualizou o token no SellerForge WMS. Solução: Copie o novo token do novo bot, vá para Configurações → Integrações → Telegram, atualize o campo Bot Token, e clique Registrar Webhook novamente.

Não quero mais receber alertas

Causa: Você quer desativar. Solução: No SellerForge WMS, vá para Configurações → Integrações → Telegram, e clique Desconectar / Disconnect. As mensagens param imediatamente.

Segurança

Seu Bot Token é criptografado e armazenado apenas no seu banco de dados SellerForge WMS.

Ninguém da equipe SellerForge consegue acessar seu bot.

• Seu Chat ID também é criptografado
• Se o Bot Token vazar, você pode revogar no BotFather: /revoke e depois /token para gerar um novo
• Se você desconectar a integração, o token é deletado do SellerForge WMS

Próximo passo: Seu Primeiro Dia →

Referências Oficiais:

• Telegram Bot API
• Criando um Bot com BotFather