Telegram bot voor bedrijven: gebruiksscenario's, kosten en een veilige PHP installatie

Wanneer eigenaren ' Telegram bot' horen, stellen ze zich vaak een consumentenspeelgoed voor. In de praktijk is een bot een heel klein stukje software dat uw systemen verbindt met een chat-app die uw team al op hun telefoon heeft staan. Het kan u vertellen wanneer een grote bestelling binnenkomt, een manager vragen om met één tik een terugbetaling goed te keuren of veelgestelde vragen van klanten beantwoorden. We bouwen deze als onderdeel van ons integratiewerk, en dit is hoe we erover denken.

Waar Telegram past bij een Amerikaans bedrijf

Wees realistisch over je publiek. In de Verenigde Staten gebruiken klanten vooral sms, iMessage, WhatsApp, e-mail en webchat, en gebruiken teams Slack of Microsoft Teams. Telegram heeft honderden miljoenen gebruikers, geconcentreerd in Europa, Azië, het Midden-Oosten en Latijns-Amerika. Dat geeft het twee duidelijke rollen:

• Interne operaties. Het is eenvoudig, snel op mobiel en heeft een gratis, goed gedocumenteerde bot-API. Veel kleine teams gebruiken het voor waarschuwingen en goedkeuringen, omdat het instellen uren in plaats van weken duurt.
• Internationale klanten en gemeenschappen. Als je verkoopt aan of ondersteuning biedt aan klanten in markten waar Telegram de standaard is, ontmoet een bot ze waar ze zijn. Productgemeenschappen, aankondigingskanalen en steungroepen zijn veelvoorkomende voorbeelden.

Als uw klanten voornamelijk Amerikaanse consumenten zijn, begin dan met webchat of sms voor hen en bewaar Telegram voor uw team. Voor beide werkt dezelfde automatiseringslogica.

Gebruik cases die snel terugbetalen

• Betalings- en inkomstenwaarschuwingen: 'Nieuwe bestelling, $ 1.240, klant X' in een teamchat, plus mislukte betalings- en terugbetalingsmeldingen. Verbind het met uw betalingswebhooks, zoals beschreven in onze Stripe webhooks-gids.
• Fout- en uptime-waarschuwingen: een bericht wanneer een back-up mislukt, een statuscontrole rood wordt of fouten toenemen. Zie onze back-up- en monitoringgids voor wat u kunt bekijken.
• Goedkeuringen met één tik: terugbetaling boven een limiet, kortingsverzoek, inhoud klaar om te publiceren. De manager tikt in de chat op Goedkeuren of Afwijzen en uw systeem handelt ernaar.
• Nieuwe leadmeldingen: er komt een formulierinzending binnen in de verkoopchat met de details en een knop om het te claimen. Een sneller eerste contact verbetert doorgaans de conversie.
• Dagelijks overzicht: een kort ochtendoverzicht van verkopen, aanmeldingen, tickets en incidenten.
• Ondersteuning van triage en veelgestelde vragen: een bot beantwoordt veelgestelde vragen en geeft de rest door aan een mens. Als u AI-antwoorden uit uw eigen documenten wilt, lees dan onze AI-chatbotgids voor kosten, ROI en waarborgen.

Wat het kost

De Telegram Bot API brengt bij normaal gebruik geen kosten per bericht in rekening. Echte kosten zijn:

• Ontwikkeling: een simpele alertbot is een paar uurtjes werk, een goedkeuringsworkflow of supportbot duurt dagen, en een bot met AI- en CRM-integratie duurt langer.
• Hosting: een kleine server is voldoende. Een bot is meestal inactief.
• Diensten van derden: gebruik van AI-modellen, een CRM, een sms-provider voor fallback. Deze zijn afhankelijk van het volume.
• Onderhoud: monitoring, updates en wijzigingen aan de Bot API. Klein, maar niet nul.

Om dit te rechtvaardigen kunt u een schatting maken van de bespaarde tijd: minuten per waarschuwing of goedkeuring vermenigvuldigd met het volume, plus de waarde van een snellere respons. Veel teams zien de terugverdientijd in de eerste maand, omdat de alternatieven het handmatig controleren van dashboards of het verliezen van trage antwoorden zijn.

Opzetten: van BotFather naar een werkende webhook

1. Maak de bot. Praat in Telegram met BotFather, maak een bot en kopieer het token. Het token is een wachtwoord: bewaar het geheim op uw server, nooit in code of in Git.
2. Maak een teamchat of groep, voeg de bot toe en zoek de chat-ID van de eerste update die de bot ontvangt.
3. Kies een modus. Lange peilingen zijn het gemakkelijkst in ontwikkeling. Gebruik voor productie een webhook: Telegram roept voor elke update uw HTTPS-URL op.
4. Registreer de webhook met een geheim token, zodat u iedereen die de URL vindt, kunt afwijzen:

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"

Een kleine, veilige PHP implementatie

Eerst een helper om de API aan te roepen met een time-out en een nieuwe poging wanneer Telegram "vertragen" zegt (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];
}

Vervolgens een melding met goedkeuringsknoppen, bijvoorbeeld wanneer er een terugbetaling boven uw limiet wordt aangevraagd:

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

En de webhook-ontvanger, die het geheim verifieert, negeert onbekende chats, vermijdt het tweemaal verwerken van dezelfde update en antwoordt snel:

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

Let op de principes: authenticeer de afzender, autoriseer de chat, valideer de payload en maak de handler idempotent. Dezelfde principes zijn van toepassing op betalingswebhooks. Controleer ook wie op de knop heeft gedrukt, want iedereen in een groep kan erop tikken, tenzij je beperkt wie toestemming mag geven.

Beveiligings- en complianceregels

• Houd het token geheim en roteer het via BotFather als het ooit lekt.
• Stuur geen gevoelige gegevens in chats: wachtwoorden, API-sleutels, kaartnummers of gezondheidsgegevens. Reguliere botchats zijn niet end-to-end gecodeerd zoals mensen denken, dus behandel ze als e-mail.
• Beperk per chat en per gebruiker. Goedkeuringen mogen alleen worden geaccepteerd van met name genoemde personen.
• Verkrijg toestemming voor klantberichten en bied een eenvoudige manier om te stoppen. Volg de privacyregels die van toepassing zijn op uw klanten, zoals GDPR voor gebruikers in Europa, en beschrijf de bot in uw privacybeleid.
• Log acties: wie heeft wat goedgekeurd, en wanneer.
• Bekijk de controles in onze PHP-beveiligingschecklist, aangezien de bot nog een toegangspunt tot uw systemen is.

Betrouwbaarheid: snelheidslimieten en nieuwe pogingen

Telegram beperkt hoe snel een bot kan verzenden: grofweg één bericht per seconde naar een enkele chat, een lager tarief in groepen en ongeveer dertig berichten per seconde in totaal voor uitzendingen. Voor alles wat groter is dan een teamchat, plaatst u berichten in een wachtrij en verzendt u ze met een gecontroleerde snelheid. Behandel altijd het 429-antwoord en retry_after waarde ervan, reageer binnen een seconde of twee op webhooks en voer langzaam werk uit op de achtergrond, en houd leveringsfouten in de gaten, zodat u een kapotte bot opmerkt zoals u bij elke andere service zou doen.

Een verstandig uitrolplan

1. Week 1: alert bot voor betalingen en fouten in een interne chat.
2. Week 2: voeg leadmeldingen en een dagelijkse samenvatting toe.
3. Week 3-4: voeg goedkeuringen toe met knoppen en een auditlogboek.
4. Later: klantgerichte ondersteuning of AI-antwoorden waarbij uw publiek Telegram gebruikt, gemeten aan de hand van de responstijd en het ticketvolume.

Hoe wij kunnen helpen

Wij ontwerpen en bouwen Telegram, webchat- en berichtenautomatiseringen voor bedrijven, met de integraties erachter: betalingen, CRM, e-mail en AI. Lees meer over onze integratieservice of boek een kort gesprek en vertel ons welk proces u eerst wilt automatiseren.