Bot Telegram para empresas: casos de uso, custo e configuração segura PHP

Quando os proprietários ouvem “bot Telegram”, muitas vezes imaginam um brinquedo de consumo. Na prática, um bot é um pequeno software que conecta seus sistemas a um aplicativo de bate-papo que sua equipe já possui em seus telefones. Ele pode informar o momento em que um pedido grande chega, pedir a um gerente para aprovar um reembolso com um toque ou responder a perguntas comuns dos clientes. Nós os construímos como parte do nosso trabalho de integração e é assim que pensamos sobre isso.

Onde Telegram se adapta a uma empresa nos EUA

Seja realista sobre o seu público. Nos Estados Unidos, os clientes usam principalmente SMS, iMessage, WhatsApp, e-mail e chat na web, e as equipes usam Slack ou Microsoft Teams. Telegram tem centenas de milhões de usuários, concentrados na Europa, Ásia, Oriente Médio e América Latina. Isso lhe confere duas funções claras:

• Operações internas. É simples, rápido em dispositivos móveis e possui uma API de bot gratuita e bem documentada. Muitas equipes pequenas o utilizam para alertas e aprovações porque a configuração leva horas, não semanas.
• Clientes e comunidades internacionais. Se você vende ou oferece suporte a clientes em mercados onde Telegram é o padrão, um bot os atende onde eles estão. Comunidades de produtos, canais de anúncios e grupos de suporte são exemplos comuns.

Se seus clientes são em sua maioria consumidores americanos, comece com chat na web ou SMS para eles e mantenha Telegram para sua equipe. A mesma lógica de automação funciona para ambos.

Casos de uso que rendem retorno rapidamente

• Alertas de pagamento e receita: "Novo pedido, US$ 1.240, cliente X" em um bate-papo da equipe, além de avisos de falha no pagamento e reembolso. Conecte-o aos seus webhooks de pagamento, conforme abordado em nosso guia Stripe webhooks.
• Alertas de erro e tempo de atividade: uma mensagem quando um backup falha, uma verificação de integridade fica vermelha ou os erros aumentam. Consulte nosso guia de backup e monitoramento para saber o que assistir.
• Aprovações com um toque: reembolso acima do limite, solicitação de desconto, conteúdo pronto para publicação. O gerente toca em Aprovar ou Rejeitar no chat e seu sistema atua de acordo.
• Notificações de novos leads: chega um envio de formulário no chat de vendas com os detalhes e um botão para reivindicá-lo. Um primeiro contato mais rápido geralmente melhora a conversão.
• Resumo diário: um breve resumo matinal de vendas, inscrições, tickets e incidentes.
• Triagem de suporte e perguntas frequentes: um bot responde a perguntas comuns e passa o resto para um humano. Se você deseja respostas de IA a partir de seus próprios documentos, leia nosso guia de chatbot de IA para custos, ROI e salvaguardas.

Quanto custa

A Telegram Bot API não cobra por mensagem para uso normal. Os custos reais são:

• Desenvolvimento: um bot de alerta simples leva algumas horas de trabalho, um fluxo de trabalho de aprovação ou bot de suporte leva dias e um bot com integração de IA e CRM leva mais tempo.
• Hospedagem: um servidor pequeno é suficiente. Um bot está quase sempre ocioso.
• Serviços de terceiros: uso de modelo de IA, CRM, provedor de SMS para reserva. Isso depende do volume.
• Manutenção: monitoramento, atualizações e alterações na API do Bot. Pequeno, mas não zero.

Para justificar, estime o tempo economizado: minutos por alerta ou aprovação multiplicados pelo volume, mais o valor da resposta mais rápida. Muitas equipes veem o retorno no primeiro mês porque as alternativas são verificar os painéis manualmente ou perder respostas lentas.

Configuração: do BotFather para um webhook funcional

1. Crie o bot. No Telegram, fale com BotFather, crie um bot e copie o token. O token é uma senha: armazene-o como segredo no seu servidor, nunca em código ou no Git.
2. Crie um chat de equipe ou grupo, adicione o bot e encontre o ID do chat desde a primeira atualização que o bot recebe.
3. Escolha um modo. A pesquisa longa é mais fácil de desenvolver. Para produção, use um webhook: Telegram chama sua URL HTTPS para cada atualização.
4. Registre o webhook com um token secreto para que você possa rejeitar qualquer pessoa que encontrar o URL:

curl -sS "https://api.telegram.org/bot$TG_BOT_TOKEN/setWebhook" \
  -d "url=https://example.com/telegram-webhook.php" \
  -d "secret_token=$TG_WEBHOOK_SECRET" \
  -d 'allowed_updates=["message","callback_query"]' \
  -d "drop_pending_updates=true"

Uma implementação PHP pequena e segura

Primeiro, um ajudante para chamar a API com um tempo limite e uma nova tentativa quando Telegram disser "desacelere" (HTTP 429):

<?php
function tg(string $method, array $params, int $tries = 3): array {
    $url = 'https://api.telegram.org/bot' . getenv('TG_BOT_TOKEN') . '/' . $method;
    for ($i = 1; $i <= $tries; $i++) {
        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_POST           => true,
            CURLOPT_POSTFIELDS     => json_encode($params),
            CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 10,
        ]);
        $raw  = curl_exec($ch);
        $code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        curl_close($ch);
        $res = is_string($raw) ? (json_decode($raw, true) ?: []) : [];
        if ($code === 429) { sleep((int)($res['parameters']['retry_after'] ?? 1)); continue; }
        if ($code >= 500 || $raw === false) { sleep($i); continue; }
        return $res;
    }
    return ['ok' => false];
}

Em seguida, um alerta com botões de aprovação, por exemplo quando for solicitado um reembolso acima do seu limite:

tg('sendMessage', [
    'chat_id'    => getenv('TG_OPS_CHAT_ID'),
    'parse_mode' => 'HTML',
    'text'       => 'Refund request <b>#' . $refundId . '</b>: $' . number_format($amount, 2) . "\nCustomer: " . htmlspecialchars($customerName),
    'reply_markup' => ['inline_keyboard' => [[
        ['text' => 'Approve', 'callback_data' => 'refund:ok:' . $refundId],
        ['text' => 'Reject',  'callback_data' => 'refund:no:' . $refundId],
    ]]],
]);

E o receptor do webhook, que verifica o segredo, ignora chats desconhecidos, evita processar a mesma atualização duas vezes e responde rapidamente:

<?php
// telegram-webhook.php
if (!hash_equals((string)getenv('TG_WEBHOOK_SECRET'), $_SERVER['HTTP_X_TELEGRAM_BOT_API_SECRET_TOKEN'] ?? '')) {
    http_response_code(403); exit;
}

$update = json_decode(file_get_contents('php://input'), true);
if (!is_array($update) || !isset($update['update_id'])) { http_response_code(400); exit; }

// idempotency: Telegram may re-deliver an update
if (!claim_update((int)$update['update_id'])) { http_response_code(200); exit; }   // e.g. INSERT IGNORE into a table

$chatId  = $update['message']['chat']['id'] ?? $update['callback_query']['message']['chat']['id'] ?? null;
$allowed = array_map('intval', explode(',', (string)getenv('TG_ALLOWED_CHATS')));
if (!in_array((int)$chatId, $allowed, true)) { http_response_code(200); exit; }     // ignore strangers

if (isset($update['callback_query'])) {
    [$what, $decision, $id] = explode(':', $update['callback_query']['data']) + [null, null, null];
    if ($what === 'refund' && ctype_digit((string)$id)) {
        handle_refund_decision((int)$id, $decision === 'ok', $update['callback_query']['from']['id']);
        tg('answerCallbackQuery', ['callback_query_id' => $update['callback_query']['id'], 'text' => 'Recorded']);
    }
}
http_response_code(200);

Observe os princípios: autenticar o remetente, autorizar o chat, validar a carga útil e tornar o manipulador idempotente. Os mesmos princípios se aplicam aos webhooks de pagamento. Verifique também quem pressionou o botão, porque qualquer pessoa do grupo pode tocar nele, a menos que você restrinja quem pode aprovar.

Regras de segurança e conformidade

• Mantenha o token em segredo e gire-o através BotFather se ele vazar.
• Não envie dados confidenciais em chats: senhas, chaves de API, números de cartão ou dados de saúde. Os bate-papos normais de bots não são criptografados de ponta a ponta como as pessoas supõem, portanto, trate-os como e-mail.
• Restringir por chat e por usuário. As aprovações só devem ser aceitas de pessoas nomeadas.
• Obtenha consentimento para mensagens de clientes e forneça uma maneira fácil de parar. Siga as regras de privacidade que se aplicam aos seus clientes, como GDPR para usuários na Europa, e descreva o bot na sua política de privacidade.
• Ações de registro: quem aprovou o quê e quando.
• Revise os controles em nosso checklist de segurança PHP, já que o bot é mais um ponto de entrada em seus sistemas.

Confiabilidade: limites de taxa e novas tentativas

Telegram limita a velocidade de envio de um bot: aproximadamente uma mensagem por segundo para um único chat, uma taxa mais baixa em grupos e cerca de trinta mensagens por segundo no geral para transmissões. Para algo maior que um bate-papo em equipe, coloque as mensagens em uma fila e envie-as em uma taxa controlada. Sempre lide com a resposta 429 e seu valor retry_after, responda aos webhooks dentro de um ou dois segundos e faça um trabalho lento em segundo plano e monitore as falhas de entrega para notar um bot quebrado como faria com qualquer outro serviço.

Um plano de implementação sensato

1. Semana 1: bot de alerta sobre pagamentos e erros em chat interno.
2. Semana 2: adicione notificações de leads e um resumo diário.
3. Semana 3-4: adicione aprovações com botões e um registro de auditoria.
4. Mais tarde: suporte ao cliente ou respostas de IA onde seu público usa Telegram, medido em relação ao tempo de resposta e ao volume de tickets.

Como podemos ajudar

Projetamos e construímos Telegram, web chat e automações de mensagens para empresas, com as integrações por trás delas: pagamentos, CRM, e-mail e IA. Leia sobre nosso serviço de integrações ou agende uma breve ligação e diga-nos qual processo você deseja automatizar primeiro.