Como integrar painel SMM com bot do Telegram (tutorial passo a passo)

Por que integrar SMM com bot do Telegram?

Um bot do Telegram conectado à API de um painel SMM permite vender 24/7 sem você estar online. Cliente abre conversa, escolhe serviço via menu, paga via PIX, e o bot cria pedido automaticamente. Custo operacional do revendedor cai drasticamente — você só dá suporte em casos exceção.

Revendedores que automatizam com Telegram costumam fechar 3-5x mais vendas por mês sem aumentar carga horária. O motivo: cliente que decide comprar à 2h da manhã não precisa esperar você acordar.

Quais ferramentas você precisa?

• Conta no SMMHub com saldo (ou outro painel SMM compatível v2)
• API key do painel (em /api depois de logar)
• Bot Token do Telegram via @BotFather
• Servidor PHP/Node.js (VPS R$ 20-50/mês ou serviço gratuito como Vercel/Railway)
• Endpoint de pagamento PIX (MercadoPago API gratuito, ou link estático com QR)

Passo 1 — Criar o bot no Telegram

1. Abra Telegram e busque @BotFather
2. Envie /newbot
3. Defina nome (visível) e username (terminando em _bot)
4. Copie o token retornado (formato 123456:ABC-DEF...) — guarde em segredo
5. Configure descrição, foto e comandos via /setdescription, /setuserpic, /setcommands

Passo 2 — Estrutura mínima do bot em PHP

Arquivo bot.php que recebe webhook do Telegram e responde:

<?php
define('BOT_TOKEN', 'SEU_TOKEN_AQUI');
define('SMM_KEY',   'SUA_KEY_SMMHUB');
define('SMM_URL',   'https://smmhub.com.br/api/v2');

$update = json_decode(file_get_contents('php://input'), true);
$msg    = $update['message'] ?? null;
if (!$msg) exit;

$chatId = $msg['chat']['id'];
$text   = $msg['text'] ?? '';

function send($chatId, $text, $kb = null) {
    $data = ['chat_id' => $chatId, 'text' => $text, 'parse_mode' => 'HTML'];
    if ($kb) $data['reply_markup'] = json_encode($kb);
    file_get_contents('https://api.telegram.org/bot' . BOT_TOKEN . '/sendMessage?' . http_build_query($data));
}

function smm($action, $params = []) {
    $params['key']    = SMM_KEY;
    $params['action'] = $action;
    $ch = curl_init(SMM_URL);
    curl_setopt_array($ch, [
        CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POSTFIELDS => http_build_query($params), CURLOPT_TIMEOUT => 30,
    ]);
    return json_decode(curl_exec($ch), true);
}

if ($text === '/start') {
    send($chatId, "Bem-vindo! Use /servicos para ver o catálogo.");
} elseif ($text === '/servicos') {
    $svc = smm('services');
    $list = "<b>Serviços disponíveis:</b>\n\n";
    foreach (array_slice($svc, 0, 10) as $s) {
        $list .= "ID {$s['service']} — {$s['name']}\nR\$ {$s['rate']}/1k | min {$s['min']}\n\n";
    }
    send($chatId, $list);
} elseif (preg_match('/^\/pedir (\d+) (https?:\S+) (\d+)$/', $text, $m)) {
    $order = smm('add', [
        'service'  => (int)$m[1],
        'link'     => $m[2],
        'quantity' => (int)$m[3],
    ]);
    if (isset($order['order'])) {
        send($chatId, "✅ Pedido #{$order['order']} criado!");
    } else {
        send($chatId, "❌ Erro: " . ($order['error'] ?? 'desconhecido'));
    }
} elseif (preg_match('/^\/status (\d+)$/', $text, $m)) {
    $s = smm('status', ['order' => (int)$m[1]]);
    send($chatId, "Pedido #{$m[1]}\nStatus: {$s['status']}\nRestam: {$s['remains']}");
}

Passo 3 — Configurar webhook do Telegram

Suba bot.php num domínio com HTTPS (Vercel, Railway, ou VPS com SSL). Depois, registre webhook:

curl "https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://seudominio.com/bot.php"

Resposta {"ok":true,"result":true} = webhook ativo. Toda mensagem ao bot agora chega no seu PHP em tempo real.

Passo 4 — Adicionar fluxo de pagamento PIX

Use MercadoPago Pix Transparente (gratis, API). Fluxo:

1. Cliente envia /pedir <id> <link> <qtd>
2. Bot calcula valor (qtd × rate / 1000) e cria PIX via API MercadoPago
3. Bot envia QR Code + copia-e-cola pro chat
4. MercadoPago dispara webhook quando pagamento cai
5. Endpoint de webhook salva no DB e chama smm('add', ...) automaticamente
6. Bot notifica cliente: "✅ Pagamento confirmado! Pedido #X criado"

Passo 5 — Adicionar menu inline para facilitar uso

Em vez de comando textual, mostre botões inline:

$kb = ['inline_keyboard' => [
  [['text' => 'Instagram', 'callback_data' => 'cat_insta']],
  [['text' => 'TikTok',    'callback_data' => 'cat_tiktok']],
  [['text' => 'YouTube',   'callback_data' => 'cat_youtube']],
]];
send($chatId, "Escolha uma rede:", $kb);

Adicione handler para $update['callback_query'] e roteie por callback_data. UX fica nível "loja gringa".

Cuidados de segurança

• Nunca exponha API key no front. Bot.php fica no servidor; só você tem acesso ao arquivo.
• Valide webhook do Telegram com secret_token ao registrar — Telegram envia o token em cada request, você confere.
• Rate-limit por chat_id — bloqueie usuário que mandar mais de 30 requests/minuto. Evita spam e ataque DoS.
• Whitelist de serviços vendáveis. Não deixe cliente pedir qualquer ID — só os serviços que você escolheu manualmente (com markup configurado).
• Log tudo em DB. Cada mensagem, cada pedido, cada pagamento. Em disputa com cliente você prova fluxo completo.

Quanto custa rodar bot Telegram 24/7?

• Servidor: R$ 0 (Vercel free) a R$ 50/mês (VPS pequena)
• Domínio: R$ 5-30/ano (.com.br ou .online)
• MercadoPago: 0% (PIX gratuito para PF)
• API SMMHub: incluído na conta

Total mensal: R$ 5-50. Em troca, você vende 24/7. Bot bem-configurado fatura R$ 2.000-8.000/mês com manutenção mínima.

Pronto pra começar?

Cria conta no SMMHub, pega sua API key em /api, segue o template acima e tá com bot funcional em uma tarde. O resto é refinamento (mais comandos, mais redes, melhor UX).