İşletmeler için Telegram botu: kullanım durumları, maliyet ve güvenli bir PHP kurulumu

Sahipler " Telegram botu" kelimesini duyduklarında genellikle bir tüketici oyuncağını hayal ederler. Pratikte bot, sistemlerinizi ekibinizin telefonlarında zaten bulunan bir sohbet uygulamasına bağlayan çok küçük bir yazılım parçasıdır. Size büyük bir siparişin geldiği anı bildirebilir, tek dokunuşla yöneticiden para iadesini onaylamasını isteyebilir veya sık karşılaşılan müşteri sorularını yanıtlayabilir. Bunları entegrasyon çalışmalarımızın bir parçası olarak oluşturuyoruz ve bu şekilde düşünüyoruz.

Telegram ABD'deki bir işletme için uygun olduğu yer

Hedef kitleniz hakkında gerçekçi olun. Amerika Birleşik Devletleri'nde müşteriler çoğunlukla SMS, iMessage, WhatsApp, e-posta ve web sohbeti kullanıyor ve ekipler Slack veya Microsoft Teams kullanıyor. Telegram Avrupa, Asya, Orta Doğu ve Latin Amerika'da yoğunlaşmış yüz milyonlarca kullanıcısı var. Bu ona iki açık rol verir:

• Dahili işlemler. Mobil cihazlarda basittir, hızlıdır ve ücretsiz, iyi belgelenmiş bir bot API'sine sahiptir. Birçok küçük ekip bunu uyarılar ve onaylar için kullanıyor çünkü kurulum haftalar değil saatler sürüyor.
• Uluslararası müşteriler ve topluluklar. Telegram varsayılan olduğu pazarlarda müşterilere satış yapıyorsanız veya müşterilere destek veriyorsanız, bir bot onları bulundukları yerde karşılar. Ürün toplulukları, duyuru kanalları ve destek grupları yaygın örneklerdir.

Müşterilerinizin çoğunluğu Amerikalı tüketicilerse, onlar için web sohbeti veya SMS ile başlayın ve Telegram ekibiniz için saklayın. Her ikisinde de aynı otomasyon mantığı çalışır.

Hızlı bir şekilde geri dönüş sağlayan senaryoları kullanın

• Ödeme ve gelir uyarıları: Ekip sohbetinde "Yeni sipariş, 1.240 ABD doları, müşteri X", ayrıca başarısız ödeme ve geri ödeme bildirimleri. Stripe web kancaları kılavuzumuzda anlatıldığı gibi bunu ödeme web kancalarınıza bağlayın.
• Hata ve çalışma süresi uyarıları: Bir yedekleme başarısız olduğunda, durum kontrolü kırmızıya döndüğünde veya hatalar aniden arttığında görüntülenen mesaj. Ne izleyeceğinizi öğrenmek için yedekleme ve izleme kılavuzumuza bakın.
• Tek dokunuşla onaylar: limitin üzerinde geri ödeme, indirim talebi, yayına hazır içerik. Yönetici sohbette Onayla veya Reddet'e dokunur ve sisteminiz buna göre hareket eder.
• Yeni potansiyel müşteri bildirimleri: Satış sohbetine ayrıntıların ve bunu talep etmek için bir düğmenin bulunduğu bir form gönderimi gelir. Daha hızlı ilk temas genellikle dönüşümü artırır.
• Günlük özet: Satışların, kayıtların, biletlerin ve olayların kısa bir sabah özeti.
• Destek triyajı ve SSS: Bir bot sık sorulan soruları yanıtlar ve geri kalanını bir insana aktarır. Yapay zeka yanıtlarını kendi belgelerinizden almak istiyorsanız maliyet, yatırım getirisi ve güvenlik önlemleri için yapay zeka sohbet robotu kılavuzumuzu okuyun.

Maliyeti nedir

Telegram Bot API normal kullanımda mesaj başına ücret almaz. Gerçek maliyetler:

• Geliştirme: Basit bir uyarı botu birkaç saatlik bir çalışma gerektirir, bir onay iş akışı veya destek botu günler sürer ve AI ve CRM entegrasyonuna sahip bir bot daha uzun sürer.
• Barındırma: küçük bir sunucu yeterlidir. Bir bot çoğunlukla boştadır.
• Üçüncü taraf hizmetleri: Yapay zeka modeli kullanımı, bir CRM, geri dönüş için bir SMS sağlayıcısı. Bunlar hacme bağlıdır.
• Bakım: Bot API'sinin izlenmesi, güncellenmesi ve değiştirilmesi. Küçük ama sıfır değil.

Bunu doğrulamak için, tasarruf edilen süreyi tahmin edin: uyarı veya onay başına dakikanın hacimle çarpımı artı daha hızlı yanıtın değeri. Çoğu ekip bunun karşılığını ilk ayda görüyor çünkü alternatifler kontrol panellerini elle kontrol etmek veya yavaş yanıtları kaybetmek.

Kurulum: BotFather çalışan bir web kancasına

1. Botu oluşturun. Telegram BotFather ile konuşun, bir bot oluşturun ve jetonu kopyalayın. Belirteç bir paroladır: onu sunucunuzda bir sır olarak saklayın; asla kodda veya Git'te saklamayın.
2. Bir ekip sohbeti veya grubu oluşturun, botu ekleyin ve botun aldığı ilk güncellemenin sohbet kimliğini bulun.
3. Bir mod seçin. Uzun oylama geliştirmede en kolay olanıdır. Üretim için bir web kancası kullanın: Telegram her güncelleme için HTTPS URL'nizi çağırır.
4. Web kancasını gizli bir belirteçle kaydedin, böylece URL'yi bulan diğer kişileri reddedebilirsiniz:

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"

Küçük, güvenli bir PHP uygulaması

Öncelikle, Telegram "yavaşla" (HTTP 429) dediğinde zaman aşımı ve yeniden deneme ile API'yi çağıracak bir yardımcı:

<?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];
}

Ardından, örneğin limitinizin üzerinde bir geri ödeme talep edildiğinde, onay düğmelerini içeren bir uyarı:

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

Ve sırrı doğrulayan webhook alıcısı, bilinmeyen sohbetleri yok sayıyor, aynı güncellemeyi iki kez işlemekten kaçınıyor ve hızlı bir şekilde yanıt veriyor:

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

İlkelere dikkat edin: gönderenin kimliğini doğrulayın, sohbeti yetkilendirin, yükü doğrulayın ve işleyiciyi bağımsız hale getirin. Aynı ilkeler ödeme web kancaları için de geçerlidir. Düğmeye kimin bastığını da kontrol edin, çünkü kimlerin onaylayabileceğini kısıtlamadığınız sürece gruptaki herkes düğmeye dokunabilir.

Güvenlik ve uyumluluk kuralları

• Tokenı gizli tutun ve sızdırılması durumunda BotFather aracılığıyla rotasyona tabi tutun.
• Sohbetlerde hassas veriler göndermeyin: şifreler, API anahtarları, kart numaraları veya sağlık verileri. Normal bot sohbetleri insanların varsaydığı gibi uçtan uca şifrelenmez; bu nedenle onlara e-posta gibi davranın.
• Sohbete ve kullanıcıya göre kısıtlayın. Onaylar yalnızca adı geçen kişilerden kabul edilmelidir.
• Müşteri mesajları için izin alın ve durmanın kolay bir yolunu sunun. Avrupa'daki kullanıcılar için GDPR gibi müşterileriniz için geçerli olan gizlilik kurallarına uyun ve botu gizlilik politikanızda tanımlayın.
• Eylemleri günlüğe kaydet: Kim neyi, ne zaman onayladı?
• Bot, sistemlerinize bir giriş noktası daha olduğundan, PHP güvenlik kontrol listemizdeki kontrolleri gözden geçirin.

Güvenilirlik: hız sınırları ve yeniden denemeler

Telegram bir botun gönderebileceği hızı sınırlar: tek bir sohbete kabaca saniyede bir mesaj, gruplarda daha düşük bir oran ve yayınlar için genel olarak saniyede yaklaşık otuz mesaj. Ekip sohbetinden daha büyük herhangi bir şey için mesajları sıraya koyun ve kontrollü bir hızda gönderin. Her zaman 429 yanıtını ve onun retry_after değerini yönetin, web kancalarına bir veya iki saniye içinde yanıt verin ve arka planda yavaş çalışma yapın ve teslim hatalarını izleyerek, diğer hizmetlerde olduğu gibi bozuk bir botu fark etmenizi sağlayın.

Mantıklı bir kullanıma sunma planı

1. 1. Hafta: Dahili sohbetteki ödemeler ve hatalar için botu uyarın.
2. 2. Hafta: Potansiyel müşteri bildirimleri ve günlük özet ekleyin.
3. 3-4. Hafta: düğmeler ve denetim günlüğüyle onaylar ekleyin.
4. Daha sonra: Hedef kitlenizin Telegram kullandığı durumlarda müşteriyle yüz yüze destek veya AI yanıtları, yanıt süresi ve destek talebi hacmine göre ölçülür.

Nasıl yardımcı olabiliriz?

Şirketler için Telegram, web sohbeti ve mesajlaşma otomasyonlarını, bunların arkasındaki entegrasyonlarla (ödemeler, CRM, e-posta ve yapay zeka) tasarlıyor ve oluşturuyoruz. Entegrasyon hizmetimiz hakkında bilgi edinin veya kısa bir arama yapın ve önce hangi süreci otomatikleştirmek istediğinizi bize bildirin.