Guia passo a passo
Como criar o bot no Telegram, colocar no grupo, pegar o ID do grupo e rodar as campanhas (sem banco de dados).
0) O que este sistema faz (importante)
- Você cria uma campanha com uma mensagem e uma lista de grupos.
- Um script (
disparar.php) roda periodicamente e envia a mensagem para os grupos da campanha.
- Tudo fica salvo em
data/campanhas.json (sem banco de dados).
Muito importante: isso só funciona rodando em um servidor PHP (Apache/Nginx/cPanel).
Se você abrir index.php no navegador por duplo clique (modo file://), as campanhas não serão criadas.
Atenção: disparar mensagens em grupos com muita frequência pode ser considerado spam.
Use com responsabilidade e com permissão dos grupos.
1) Criar o bot no Telegram (BotFather)
- Abra o Telegram e procure por @BotFather.
- Clique em Start (Iniciar).
- Envie o comando
/newbot.
- Escolha Nome e Username (o username precisa terminar com
bot).
- O BotFather vai retornar o token. Copie esse token.
Segurança: não publique seu token. Com o token, qualquer pessoa pode controlar o seu bot.
2) Colocar o bot no(s) grupo(s)
- Abra o grupo onde você quer disparar mensagens.
- Adicione o bot como membro.
- Garanta que o bot tenha permissão de Enviar mensagens (em alguns grupos precisa ser admin).
3) Descobrir o ID do grupo (chat_id)
Grupos/canais com link público (ex.: t.me/divulganks)
Se o grupo tem um link como https://t.me/divulganks, o ID é o username com @ na frente:
@divulganks
No painel, na lista de grupos, coloque um por linha, por exemplo:
@divulganks
@outrogrupo
O bot precisa ser membro do grupo/canal para enviar mensagens.
Grupos privados (sem link público)
Para esses grupos a API usa um número. Use o método abaixo.
Método getUpdates do próprio bot
- Depois de adicionar o bot ao grupo, envie uma mensagem qualquer no grupo.
- No navegador, abra (troque
SEU_TOKEN pelo token real):
https://api.telegram.org/botSEU_TOKEN/getUpdates
- Procure no JSON por
"chat": { "id": -1001234567890, ... }. O número em chat.id é o ID do grupo.
Se o getUpdates vier vazio: o bot precisa ter recebido ao menos 1 mensagem e não pode estar com webhook configurado.
4) Configurar o token no projeto
- Abra o arquivo
telegram-campanhas/config.php.
- Substitua
SEU_TOKEN_AQUI pelo seu token real.
5) Criar uma campanha (pelo painel)
- Abra
telegram-campanhas/index.php no navegador (via servidor PHP, ex.: cPanel).
- Preencha nome, mensagem e lista de grupos (um ID ou @username por linha).
- Clique em Criar campanha.
A frequência de envio é definida pelo Cron Job que você configurar no cPanel.
6) Rodar o disparo (Cron no cPanel)
No cPanel, em Cron Jobs, adicione um comando para rodar disparar.php na frequência desejada (ex.: a cada 5 minutos).
Exemplo de comando (ajuste o caminho para sua hospedagem):
php -q /home/SEU_USUARIO/public_html/telegram-campanhas/disparar.php
Ou use um cron externo para acessar pela URL: https://seudominio.com/telegram-campanhas/disparar.php
7) Problemas comuns
- “Token não configurado”: edite o
config.php.
- “chat not found” / bot não envia: o bot precisa estar no grupo e com permissão para enviar.
- Nada acontece ao clicar Criar campanha: rode em servidor PHP (cPanel), não por file://. Veja a caixa “Diagnóstico” no painel.