Guia Completo de Configuração do Telegram Business Bot: Deixe Seu Robô Gerenciar Mensagens da Conta Pessoal

📌 Antes de Começar

Muitos desenvolvedores perguntam: "Meu código do robô tem lógica businessMessage(), por que não recebo atualizações?"

A resposta geralmente é: você escreveu apenas metade do código; a outra metade precisa ser configurada no Telegram.

Para que seu robô lide com mensagens da sua conta pessoal, são necessárias duas etapas:

• Etapa 1: Ativar o Business Mode no @BotFather
• Etapa 2: Vincular o robô à sua conta pessoal nas configurações do Telegram App

🤖 Etapa 1: Ativar Business Mode no BotFather

Esta é a etapa mais crucial—determina se seu robô pode receber atualizações businessMessage.

Procedimento

• Abra @BotFather, envie /mybots, selecione seu robô.
• Navegue: Bot Settings → Business mode → Turn Business mode on.

(Para Desenvolvedores) Configurar Tipos de Atualização do Webhook

Se seu robô usa webhooks, certifique-se de que allowed_updates inclua:

• business_connection
• business_message
• edited_business_message

👤 Etapa 2: Vincular o Robô no Telegram App

Após a configuração no BotFather, autorize o robô a gerenciar suas mensagens.

Procedimento

• Abra Configurações do Telegram, toque em "Telegram Business".
• Entre em "Chatbots", digite o nome de usuário do seu robô (ex: @YourBusinessBot), selecione-o e toque em Adicionar.
• Defina o escopo de acesso: All 1-to-1 Chats, Only Selected Chats, ou Exclude Chats.

📱 Caminho Completo

Configurações → Telegram Business → Chatbots → Adicionar robô → Definir escopo → ✅ Concluído

🔔 Atualização Importante: Agora Totalmente Gratuito!

Muitos ainda pensam que recursos Business exigem Premium. Veja a linha do tempo:

• Lançamento em 2024: apenas Telegram Premium
• 2026 agora: ✅ Gratuito para todos!

Sem necessidade de assinatura Premium—seu robô pode gerenciar todas as DMs.

🎯 O Que Você Pode Fazer Após a Configuração

• ✅ Responder automaticamente a mensagens privadas
• ✅ Roteirizar consultas de clientes por palavras-chave
• ✅ Atendimento 24/7 de perguntas frequentes
• ✅ Integrar com seu código para marketing automatizado
• ✅ Coletar dados businessMessage para análises

⚠️ FAQ

P1: Ainda não recebo businessMessage?

R: Verifique se o Business Mode no BotFather está ativado e se o allowed_updates do webhook inclui business_message.

P2: Preciso de Premium?

R: Não. Gratuito desde 2026.

P3: Posso vincular vários robôs?

R: Sim, adicione vários robôs no menu Chatbots.

P4: O robô pode acessar histórico?

R: Não, apenas mensagens recebidas após a vinculação.

P5: Ordem de prioridade no código?

R: Mensagens normais > Posts de canal > Mensagens de negócios.

📝 Resumo

• Etapa 1: Ativar Business Mode no @BotFather
• Etapa 2: Adicionar lógica businessMessage no código
• Etapa 3: Vincular robô nas Configurações do Telegram
• Etapa 4: Definir escopo de acesso