📌 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
