Telegram bot pro firmy: případy použití, náklady a bezpečné nastavení PHP

Když majitelé slyší „ Telegram bot“, často si představují spotřebitelskou hračku. V praxi je bot velmi malý kus softwaru, který propojí vaše systémy s chatovací aplikací, kterou váš tým již má na svých telefonech. Může vám sdělit okamžik, kdy dorazí velká objednávka, požádat manažera o schválení vrácení peněz jedním klepnutím nebo odpovědět na běžné dotazy zákazníků. Stavíme je jako součást naší integrační práce a takto o tom přemýšlíme.

Kde se Telegram hodí pro podnikání v USA

Buďte realističtí ohledně svého publika. Ve Spojených státech zákazníci většinou používají SMS, iMessage, WhatsApp, e-mail a webový chat a týmy používají Slack nebo Microsoft Teams. Telegram má stovky milionů uživatelů soustředěných v Evropě, Asii, na Středním východě a v Latinské Americe. To mu dává dvě jasné role:

• Vnitřní operace. Je to jednoduché, rychlé na mobilu a má bezplatné, dobře zdokumentované API pro roboty. Mnoho malých týmů jej používá pro upozornění a schvalování, protože nastavení trvá hodiny, nikoli týdny.
• Mezinárodní zákazníci a komunity. Pokud prodáváte nebo podporujete zákazníky na trzích, kde je Telegram výchozím nastavením, robot se s nimi setká tam, kde jsou. Běžnými příklady jsou produktové komunity, oznamovací kanály a podpůrné skupiny.

Pokud jsou vašimi zákazníky převážně američtí spotřebitelé, začněte s webovým chatem nebo SMS pro ně a ponechte si Telegram pro svůj tým. Pro oba funguje stejná logika automatizace.

Použijte případy, které se rychle vrátí

• Upozornění na platby a příjmy: „Nová objednávka, 1 240 $, zákazník X“ v týmovém chatu plus oznámení o neúspěšné platbě a vrácení peněz. Připojte jej ke svým platebním webhookům, jak je popsáno v našem průvodci webhooky Stripe.
• Upozornění na chyby a dostupnost: zpráva, když se zálohování nezdaří, kontrola stavu zčervená nebo narůstají chyby. Nahlédněte do našeho průvodce zálohováním a monitorováním, kde najdete, co sledovat.
• Schválení jedním klepnutím: vrácení peněz nad limit, žádost o slevu, obsah připravený ke zveřejnění. Manažer klepne na Schválit nebo Odmítnout v chatu a váš systém na to zareaguje.
• Oznámení o nových potenciálních zákaznících: do prodejního chatu dorazí odeslání formuláře s podrobnostmi a tlačítkem pro jeho uplatnění. Rychlejší první kontakt obvykle zlepšuje konverzi.
• Denní přehled: krátké ranní shrnutí prodejů, registrací, vstupenek a incidentů.
• Podpora třídění a FAQ: robot odpovídá na běžné otázky a zbytek předává člověku. Pokud chcete odpovědi AI z vašich vlastních dokumentů, přečtěte si našeho průvodce chatbotem AI, kde najdete informace o nákladech, návratnosti investic a zabezpečení.

Co to stojí

Rozhraní Telegram Bot API neúčtuje poplatky za zprávu pro běžné použití. Skutečné náklady jsou:

• Vývoj: jednoduchý varovný robot zabere několik hodin práce, schvalovací pracovní postup nebo robot podpory trvá dny a robot s integrací AI a CRM trvá déle.
• Hosting: stačí malý server. Robot je většinou nečinný.
• Služby třetích stran: použití modelu AI, CRM, poskytovatel SMS pro nouzové řešení. Ty závisí na objemu.
• Údržba: monitorování, aktualizace a změny v Bot API. Malý, ale ne nulový.

Chcete-li to ospravedlnit, odhadněte ušetřený čas: minuty na upozornění nebo schválení vynásobené objemem plus hodnota rychlejší odezvy. Mnoho týmů vidí návratnost v prvním měsíci, protože alternativou je ruční kontrola dashboardů nebo ztráta pomalých odpovědí.

Nastavení: od BotFather po funkční webhook

1. Vytvořte robota. V Telegram si promluvte s BotFather, vytvořte robota a zkopírujte token. Token je heslo: uložte jej jako tajné na vašem serveru, nikdy v kódu nebo v Gitu.
2. Vytvořte týmový chat nebo skupinu, přidejte robota a najděte ID chatu z první aktualizace, kterou robot obdrží.
3. Vyberte režim. Dlouhé dotazování je nejjednodušší ve vývoji. Pro produkci použijte webhook: Telegram volá vaši HTTPS URL pro každou aktualizaci.
4. Zaregistrujte webhook pomocí tajného tokenu, abyste mohli odmítnout kohokoli jiného, kdo najde 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á implementace PHP

Nejprve pomocník pro volání API s časovým limitem a opakováním, když Telegram říká „zpomal“ (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];
}

Poté upozornění s tlačítky schválení, například když je požadováno vrácení peněz 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 přijímač webhooku, který ověřuje tajemství, ignoruje neznámé chaty, vyhýbá se zpracování stejné aktualizace dvakrát a odpovídá rychle:

<?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šimněte si principů: autentizace odesílatele, autorizace chatu, ověření užitečného zatížení a udělejte obslužnou osobu idempotentní. Stejné zásady platí pro platební webhooky. Zkontrolujte také, kdo stiskl tlačítko, protože kdokoli ve skupině na něj může klepnout, pokud neomezíte, kdo může schvalovat.

Pravidla bezpečnosti a dodržování předpisů

• Udržujte token v tajnosti a otočte jej přes BotFather, pokud někdy unikne.
• V chatech neposílejte citlivá data: hesla, API klíče, čísla karet nebo zdravotní údaje. Běžné chaty s roboty nejsou end-to-end šifrovány tak, jak lidé předpokládají, takže s nimi zacházejte jako s e-mailem.
• Omezit podle chatu a podle uživatele. Schválení by mělo být přijímáno pouze od jmenovaných osob.
• Získejte souhlas se zasíláním zpráv zákazníkům a poskytněte snadný způsob, jak zastavit. Dodržujte pravidla ochrany osobních údajů, která se vztahují na vaše zákazníky, jako je GDPR pro uživatele v Evropě, a popište robota ve svých zásadách ochrany osobních údajů.
• Zaznamenat akce: kdo co schválil a kdy.
• Zkontrolujte ovládací prvky v našem kontrolním seznamu zabezpečení PHP, protože robot je dalším vstupním bodem do vašich systémů.

Spolehlivost: rychlostní limity a opakování

Telegram omezuje, jak rychle může robot posílat: zhruba jednu zprávu za sekundu do jednoho chatu, nižší rychlost ve skupinách a celkově asi třicet zpráv za sekundu pro vysílání. Pro cokoli většího než je týmový chat umístěte zprávy do fronty a posílejte je kontrolovanou rychlostí. Vždy zpracujte odpověď 429 a její hodnotu retry_after, reagujte na webhooky během sekundy nebo dvou a provádějte pomalou práci na pozadí a sledujte selhání doručení, abyste si všimli nefunkčního robota jako u jakékoli jiné služby.

Rozumný plán uvedení do provozu

1. 1. týden: upozorňující robot na platby a chyby v interním chatu.
2. 2. týden: přidejte oznámení o potenciálních zákaznících a denní přehled.
3. Týden 3-4: přidejte schválení pomocí tlačítek a protokolu auditu.
4. Později: zákaznická podpora nebo odpovědi AI, kde vaše publikum používá Telegram, měřeno podle doby odezvy a objemu lístků.

Jak můžeme pomoci

Navrhujeme a vytváříme Telegram, webový chat a automatizaci zasílání zpráv pro společnosti s integrací za nimi: platby, CRM, e-mail a AI. Přečtěte si o naší integrační službě nebo si zarezervujte krátký hovor a sdělte nám, který proces chcete automatizovat jako první.