Criar o bot no @BotFather e conectar

O bot é criado por você, na sua conta do Telegram, e por isso é seu: o AgoraFood só o usa para mandar os avisos da loja. Leva um minuto.

Criar o bot

1. No Telegram, abra uma conversa com @BotFather (o bot oficial do Telegram para criar bots).

2. Mande /newbot.

3. Ele pede um nome — é o que aparece nas conversas. Use o nome da loja: Pizzaria do João.

4. Ele pede um usuário, que precisa terminar em bot e ser único no Telegram: pizzariadojoao_bot, por exemplo.

5. O @BotFather responde com o token: uma linha como 123456789:AAF..., com os dois pontos no meio. Copie a linha inteira.

Se quiser, dê uma foto ao bot (/setuserpic) — é a foto que a equipe vai ver nos avisos.

O token é uma senha

Quem tem o token manda mensagem como o seu bot. Não o cole em grupo. Se vazar, no @BotFather mande /revoke para gerar outro, e cole o novo no painel.

Conectar no painel

1. No painel da loja, abra Configurações → Notificações.

2. No card Telegram, toque em Adicionar integração com Telegram. Preencha Nome deste bot (só para você reconhecer na tela) e cole o Token do bot — a linha inteira, com os dois pontos.

3. Clique em Conectar bot. O painel confere o token com o Telegram antes de guardar.

Quando dá certo, a tela mostra o bot como conectado, com o usuário dele (@pizzariadojoao_bot). Ele já está pronto para receber os pareamentos — o próximo passo é dar acesso ao grupo da equipe.

Se o Telegram recusar

• “O Telegram recusou a credencial. Confira o token que o @BotFather enviou.” — o token está errado, incompleto ou foi revogado. Peça um novo com /token no @BotFather e cole de novo.
• “Confira o token: ele tem a forma 123456789:AA… — copie a linha inteira.” — faltou um pedaço na colagem.
• “Este bot já está conectado a outra loja.” — um bot serve uma loja só. Se você tem duas lojas, crie um bot para cada uma no @BotFather. Se a outra loja não é sua, revogue o token (/revoke) — o bot é seu, e só o token novo vai funcionar.
• “O bot pode ter sido salvo mesmo assim” — o token foi aceito, mas a última etapa da conexão falhou (rede, na maioria das vezes). Olhe o estado no topo do card: se aparece conectado, está tudo certo; se não, clique em Conectar bot de novo, que só repete a conferência.

Trocar o bot

No card Telegram, em O bot da loja, cole outro token e clique em Conectar bot: o novo substitui o atual. Quem já estava pareado continua pareado — os avisos passam a sair pelo bot novo. Não é preciso refazer os links.

Desconectar

Em Configurações → Notificações, clique em Desconectar e confirme. Os avisos param na hora, para todo mundo que estava pareado. O histórico fica.

Para voltar a avisar, cole um token e clique em Conectar bot — e refaça os links de ativação: um bot reconectado depois de desconectado começa sem ninguém pareado. Se a ideia é só trocar o bot, não desconecte: cole o token novo por cima, que os pareados continuam.