Telegram bot pre podnikanie: prípady použitia, náklady a bezpečné nastavenie PHP

Keď majitelia počujú „ Telegram bot“, často si predstavia spotrebiteľskú hračku. V praxi je bot veľmi malý softvér, ktorý spája vaše systémy s chatovou aplikáciou, ktorú už váš tím má vo svojich telefónoch. Môže vám povedať, keď príde veľká objednávka, požiadať manažéra o schválenie vrátenia peňazí jedným klepnutím alebo odpovedať na bežné otázky zákazníkov. Budujeme ich ako súčasť našej integračnej práce a takto o tom uvažujeme.

Kde sa Telegram hodí pre podnikanie v USA

Buďte realistickí, pokiaľ ide o vaše publikum. V Spojených štátoch zákazníci väčšinou používajú SMS, iMessage, WhatsApp, e-mail a webový chat a tímy používajú Slack alebo Microsoft Teams. Telegram má stovky miliónov používateľov sústredených v Európe, Ázii, na Strednom východe a v Latinskej Amerike. To mu dáva dve jasné úlohy:

• Vnútorné operácie. Je to jednoduché, rýchle na mobile a má bezplatné, dobre zdokumentované API pre robotov. Mnoho malých tímov ho používa na upozornenia a schvaľovanie, pretože nastavenie trvá hodiny, nie týždne.
• Medzinárodní zákazníci a komunity. Ak predávate alebo podporujete zákazníkov na trhoch, kde je predvolený Telegram, robot sa s nimi stretne tam, kde sa nachádzajú. Bežnými príkladmi sú produktové komunity, oznamovacie kanály a podporné skupiny.

Ak sú vašimi zákazníkmi väčšinou americkí spotrebitelia, začnite pre nich webovým chatom alebo SMS a ponechajte si Telegram pre svoj tím. Pre obe funguje rovnaká logika automatizácie.

Použite prípady, ktoré sa rýchlo vrátia

• Upozornenia na platby a výnosy: „Nová objednávka, 1 240 USD, zákazník X“ v tímovom rozhovore, plus upozornenia na neúspešnú platbu a vrátenie peňazí. Pripojte ho k svojim platobným webhookom, ako je uvedené v našom sprievodcovi webhookmi Stripe.
• Výstrahy o chybách a dostupnosti: hlásenie, keď záloha zlyhá, kontrola stavu sa zmení na červenú alebo sa zvýši počet chýb. Pozrite si našu príručku zálohovania a monitorovania, kde nájdete informácie o tom, čo môžete sledovať.
• Schválenia jedným klepnutím: vrátenie peňazí nad limit, žiadosť o zľavu, obsah pripravený na zverejnenie. Manažér klepne na položku Schváliť alebo Odmietnuť v rozhovore a váš systém na to zareaguje.
• Nové upozornenia na potenciálnych zákazníkov: do predajného chatu príde odoslaný formulár s podrobnosťami a tlačidlom na jeho uplatnenie. Rýchlejší prvý kontakt zvyčajne zlepšuje konverziu.
• Denný prehľad: krátke ranné zhrnutie predajov, registrácií, lístkov a incidentov.
• Podpora triedenia a FAQ: robot odpovedá na bežné otázky a zvyšok odovzdá človeku. Ak chcete odpovede AI z vašich vlastných dokumentov, prečítajte si nášho sprievodcu chatbotmi AI, kde nájdete informácie o nákladoch, návratnosti investícií a zárukách.

Čo to stojí

Rozhranie Telegram Bot API pri bežnom používaní neúčtuje poplatky za správu. Skutočné náklady sú:

• Vývoj: jednoduchý výstražný robot je niekoľko hodín práce, schvaľovací pracovný postup alebo robot podpory trvá dni a robot s integráciou AI a CRM trvá dlhšie.
• Hosting: stačí malý server. Robot je väčšinou nečinný.
• Služby tretích strán: používanie modelu AI, CRM, poskytovateľ SMS pre prípad núdze. Tie závisia od objemu.
• Údržba: monitorovanie, aktualizácie a zmeny v Bot API. Malý, ale nie nulový.

Aby ste to odôvodnili, odhadnite ušetrený čas: minúty na upozornenie alebo schválenie vynásobené objemom plus hodnota rýchlejšej odozvy. Mnoho tímov vidí návratnosť v prvom mesiaci, pretože alternatívou je ručná kontrola dashboardov alebo strata pomalých odpovedí.

Nastavenie: od BotFather po funkčný webhook

1. Vytvorte robota. V Telegram sa porozprávajte s BotFather, vytvorte robota a skopírujte token. Token je heslo: uložte ho ako tajomstvo na svojom serveri, nikdy nie v kóde alebo v Git.
2. Vytvorte tímový čet alebo skupinu, pridajte robota a nájdite ID četu z prvej aktualizácie, ktorú robot dostane.
3. Vyberte režim. Dlhé hlasovanie je najjednoduchšie vo vývoji. Pre produkciu použite webhook: Telegram volá vašu HTTPS URL pre každú aktualizáciu.
4. Zaregistrujte webhook pomocou tajného tokenu, aby ste mohli odmietnuť kohokoľvek iného, kto nájde adresu 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"

Malá, bezpečná implementácia PHP

Najprv pomocník na volanie API s časovým limitom a opätovným pokusom, keď Telegram povie „spomaliť“ (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];
}

Potom sa zobrazí upozornenie s tlačidlami na schválenie, napríklad keď sa požaduje vrátenie peňazí nad váš limit:

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],
    ]]],
]);

A prijímač webhooku, ktorý overuje tajomstvo, ignoruje neznáme chaty, vyhýba sa spracovaniu tej istej aktualizácie dvakrát a odpovedá rýchlo:

<?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);

Všimnite si princípy: overte odosielateľa, autorizujte chat, overte užitočné zaťaženie a urobte operátora idempotentným. Rovnaké princípy platia aj pre platobné webhooky. Skontrolujte tiež, kto stlačil tlačidlo, pretože ktokoľvek v skupine naň môže klepnúť, pokiaľ neobmedzíte, kto to môže schváliť.

Pravidlá bezpečnosti a súladu

• Udržujte token v tajnosti a otočte ho cez BotFather, ak niekedy unikne.
• V chatoch neposielajte citlivé údaje: heslá, API kľúče, čísla kariet alebo zdravotné údaje. Bežné rozhovory s robotmi nie sú end-to-end šifrované spôsobom, akým ľudia predpokladajú, takže s nimi zaobchádzajte ako s e-mailom.
• Obmedziť podľa chatu a podľa používateľa. Schválenia by sa mali prijímať iba od menovaných osôb.
• Získajte súhlas so zasielaním správ zákazníkom a poskytnite jednoduchý spôsob, ako zastaviť. Dodržiavajte pravidlá ochrany osobných údajov, ktoré sa vzťahujú na vašich zákazníkov, ako napríklad GDPR pre používateľov v Európe, a opíšte robota vo svojich zásadách ochrany osobných údajov.
• Zaznamenať akcie: kto čo a kedy schválil.
• Skontrolujte ovládacie prvky v našom kontrolnom zozname zabezpečenia PHP, pretože robot je ďalším vstupným bodom do vašich systémov.

Spoľahlivosť: limity rýchlosti a opakované pokusy

Telegram obmedzuje, ako rýchlo môže robot posielať: približne jednu správu za sekundu do jedného chatu, nižšiu rýchlosť v skupinách a celkovo asi tridsať správ za sekundu pre vysielanie. V prípade čohokoľvek väčšieho ako je tímový chat umiestnite správy do frontu a posielajte ich kontrolovanou rýchlosťou. Vždy spracujte odpoveď 429 a jej hodnotu retry_after, reagujte na webhooky v priebehu sekundy alebo dvoch a robte pomalú prácu na pozadí a monitorujte zlyhania doručenia, aby ste si všimli nefunkčného robota ako pri akejkoľvek inej službe.

Rozumný plán zavádzania

1. 1. týždeň: upozorní robot na platby a chyby v internom chate.
2. 2. týždeň: pridajte upozornenia na potenciálnych zákazníkov a denný súhrn.
3. 3. – 4. týždeň: pridajte schválenia pomocou tlačidiel a denníka auditu.
4. Neskôr: zákaznícka podpora alebo odpovede AI, kde vaše publikum používa Telegram, merané podľa času odozvy a objemu lístkov.

Ako môžeme pomôcť

Navrhujeme a vytvárame Telegram, webový chat a automatizáciu správ pre spoločnosti s integráciami za nimi: platby, CRM, e-mail a AI. Prečítajte si o našej integračnej službe alebo si rezervujte krátky hovor a povedzte nám, ktorý proces chcete automatizovať ako prvý.