Telegram bot üzleti célokra: használati esetek, költségek és biztonságos PHP beállítás

Amikor a tulajdonosok „ Telegram bot” szót hallanak, gyakran egy fogyasztói játékot képzelnek el. A gyakorlatban a bot egy nagyon kis szoftver, amely összekapcsolja a rendszereket egy olyan chat-alkalmazással, amely a csapata már rendelkezik a telefonján. Meg tudja mondani, hogy mikor érkezik egy nagy rendelés, megkérheti a menedzserét, hogy hagyja jóvá a visszatérítést egyetlen érintéssel, vagy válaszolhat az ügyfelek gyakori kérdéseire. Ezeket az integrációs munkánk részeként építjük, és így gondolkodunk erről.

Ahol Telegram illik egy amerikai vállalkozáshoz

Legyen reális a közönségével kapcsolatban. Az Egyesült Államokban az ügyfelek többnyire SMS-t, iMessage-t, WhatsApp, e-mailt és webes csevegést használnak, a csapatok pedig Slack vagy a Microsoft Teams szolgáltatást. Telegram több száz millió felhasználója van, Európában, Ázsiában, a Közel-Keleten és Latin-Amerikában. Ez két egyértelmű szerepet ad neki:

• Belső műveletek. Egyszerű, gyors mobilon, és ingyenes, jól dokumentált bot API-val rendelkezik. Sok kis csapat használja riasztásokhoz és jóváhagyásokhoz, mert a beállítás órákat vesz igénybe, nem heteket.
• Nemzetközi ügyfelek és közösségek. Ha olyan piacokon értékesít vagy támogatja az ügyfeleket, ahol Telegram az alapértelmezett, egy bot ott találkozik velük, ahol vannak. Gyakori példák a termékközösségek, a bejelentési csatornák és a támogatási csoportok.

Ha ügyfelei többnyire amerikai fogyasztók, kezdje nekik az internetes chattel vagy SMS-ekkel, és tartsa meg Telegram csapata számára. Ugyanaz az automatizálási logika működik mindkettőnél.

Használjon olyan eseteket, amelyek gyorsan megtérülnek

• Fizetési és bevételi figyelmeztetések: „Új rendelés, 1240 USD, X ügyfél” egy csapatcsevegésben, valamint a sikertelen fizetési és visszatérítési értesítések. Csatlakoztassa a fizetési webhookhoz, ahogyan Stripe webhooks útmutatójában is szerepel.
• Hiba- és üzemidő-riasztások: üzenet, ha a biztonsági mentés meghiúsul, az állapotellenőrzés pirosra vált, vagy hibacsúcsok lépnek fel. Tekintse meg biztonsági mentési és megfigyelési útmutatónkat, hogy mit érdemes megnézni.
• Egyérintéses jóváhagyások: limit feletti visszatérítés, kedvezménykérés, közzétételre kész tartalom. A menedzser megérinti a Jóváhagyás vagy az Elutasítás gombot a csevegésben, és a rendszer erre reagál.
• Új potenciális ügyfelek értesítései: az értékesítési chatbe egy űrlap beküldése érkezik a részletekkel és egy gombbal az igényléshez. A gyorsabb első kapcsolat általában javítja a konverziót.
• Napi összefoglaló: rövid reggeli összefoglaló az eladásokról, regisztrációkról, jegyekről és eseményekről.
• Támogatási osztályozás és GYIK: egy bot megválaszolja a gyakori kérdéseket, a többit pedig átadja az embernek. Ha saját dokumentumaiból szeretne mesterséges intelligencia válaszokat kapni, olvassa el az AI chatbot útmutatónkat a költségekről, a megtérülésről és a biztosítékokról.

Mibe kerül

A Telegram Bot API normál használat esetén nem számít fel üzenetenkénti díjat. A valós költségek a következők:

• Fejlesztés: egy egyszerű figyelmeztető bot néhány óra munka, egy jóváhagyási munkafolyamat vagy támogatási bot napokig tart, egy AI és CRM-integrációval rendelkező bot pedig tovább tart.
• Tárhely: elég egy kis szerver. A bot többnyire tétlen.
• Harmadik féltől származó szolgáltatások: mesterséges intelligencia modellhasználat, CRM, SMS-szolgáltató tartalékként. Ezek a hangerőtől függenek.
• Karbantartás: a Bot API figyelése, frissítései és módosításai. Kicsi, de nem nulla.

Ennek igazolására becsülje meg a megtakarított időt: percenként riasztásonként vagy jóváhagyásonként szorozva a hangerővel, plusz a gyorsabb válaszadás értékével. Sok csapat már az első hónapban megtérül, mert az alternatívák az irányítópultok kézi ellenőrzése vagy a lassú válaszok elvesztése.

Beállítás: BotFather egy működő webhookig

1. Hozd létre a botot. A Telegram beszéljen BotFather, hozzon létre egy botot, és másolja ki a tokent. A token egy jelszó: tárolja titokként a szerveren, soha ne kódban vagy Gitben.
2. Hozzon létre egy csoportos csevegést vagy csoportot, adja hozzá a botot, és keresse meg a csevegési azonosítót az első frissítéstől, amelyet a bot kap.
3. Válasszon módot. A hosszú szavazás a fejlesztés során a legegyszerűbb. Éles környezetben használjon webhookot: Telegram minden frissítésnél meghívja a HTTPS URL-jét.
4. Regisztrálja a webhookot egy titkos tokennel, így mindenkit visszautasíthat, aki megtalálja az URL-t:

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"

Egy kicsi, biztonságos PHP implementáció

Először egy segítő, aki meghívja az API-t egy időtúllépéssel, és egy újrapróbálkozással, amikor Telegram azt mondja, hogy "lassít" (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];
}

Ezután egy figyelmeztetés jóváhagyó gombokkal, például amikor a limited feletti visszatérítést kérik:

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 webhook vevő pedig, amely ellenőrzi a titkot, figyelmen kívül hagyja az ismeretlen chateket, elkerüli ugyanazt a frissítést kétszer, és gyorsan válaszol:

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

Figyelje meg az alapelveket: hitelesítse a feladót, engedélyezze a csevegést, érvényesítse a hasznos terhelést, és tegye idempotenssé a kezelőt. Ugyanezek az elvek vonatkoznak a fizetési webhookra is. Ellenőrizze azt is, hogy ki nyomta meg a gombot, mert a csoportban bárki megérintheti, hacsak nem korlátozza, hogy kik jóváhagyhatják.

Biztonsági és megfelelési szabályok

• Tartsa titokban a tokent, és forgassa el BotFather keresztül, ha kiszivárog.
• Ne küldjön bizalmas adatokat a chatekben: jelszavakat, API-kulcsokat, kártyaszámokat vagy egészségügyi adatokat. A rendszeres botcsevegés nincs végponttól végpontig titkosítva, ahogyan azt az emberek feltételezik, ezért kezelje őket úgy, mint az e-maileket.
• Korlátozás csevegés és felhasználó szerint. Jóváhagyást csak megnevezett személyektől szabad elfogadni.
• Szerezzen beleegyezést az ügyfelek üzenetküldéséhez, és adjon egyszerű módot a leállításra. Kövesse az ügyfelekre vonatkozó adatvédelmi szabályokat, például az európai felhasználók GDPR, és írja le a robotot az adatvédelmi szabályzatában.
• Napló műveletek: ki mit hagyott jóvá és mikor.
• Tekintse át a PHP biztonsági ellenőrzőlistánk vezérlőit, mivel a bot egy újabb belépési pont a rendszereibe.

Megbízhatóság: sebességkorlátozások és újrapróbálkozások

Telegram korlátozza a bot küldési sebességét: nagyjából egy üzenetet küldhet másodpercenként egyetlen csevegésre, alacsonyabb arányt csoportokban, és összesen körülbelül harminc üzenetet másodpercenként adásoknál. A csapatcsevegésnél nagyobb dolgok esetén helyezze sorba az üzeneteket, és szabályozott sebességgel küldje el őket. Mindig kezelje a 429-es választ és annak retry_after értékét, egy-két másodpercen belül válaszoljon a webhookra, és lassan dolgozzon a háttérben, és figyelje a kézbesítési hibákat, hogy észrevegye a törött botot, mint bármely más szolgáltatást.

Ésszerű bevezetési terv

1. 1. hét: figyelmezteti a botot a fizetésekre és a hibákra egy belső csevegésben.
2. 2. hét: Potenciális értesítések és napi összefoglaló hozzáadása.
3. 3-4. hét: adjon hozzá jóváhagyásokat gombokkal és egy auditnaplóval.
4. Később: ügyfélszolgálati támogatás vagy mesterséges intelligencia válaszok, ahol a közönség Telegram használja, a válaszidő és a jegyek mennyisége alapján mérve.

Hogyan segíthetünk

Tervezünk és építünk Telegram, webes csevegés és üzenetküldő automatizálásokat vállalatok számára, a mögöttük álló integrációkkal: fizetés, CRM, e-mail és mesterséges intelligencia. Olvasson integrációs szolgáltatásunkról, vagy foglaljon egy rövid hívást, és mondja el, melyik folyamatot szeretné először automatizálni.