Bot Telegram per le aziende: casi d'uso, costi e configurazione PHP sicura

Quando i proprietari sentono " Telegram bot" spesso immaginano un giocattolo di consumo. In pratica un bot è un software molto piccolo che collega i tuoi sistemi a un'app di chat che il tuo team ha già sui propri telefoni. Può dirti quando arriva un ordine di grandi dimensioni, chiedere a un manager di approvare un rimborso con un solo tocco o rispondere alle domande comuni dei clienti. Li costruiamo come parte del nostro lavoro di integrazione, e questo è il modo in cui la pensiamo.

Dove Telegram si adatta a un'azienda statunitense

Sii realistico riguardo al tuo pubblico. Negli Stati Uniti, i clienti utilizzano principalmente SMS, iMessage, WhatsApp, e-mail e chat web, mentre i team utilizzano Slack o Microsoft Teams. Telegram conta centinaia di milioni di utenti, concentrati in Europa, Asia, Medio Oriente e America Latina. Ciò gli conferisce due ruoli chiari:

• Operazioni interne. È semplice, veloce sui dispositivi mobili e dispone di un'API bot gratuita e ben documentata. Molti piccoli team lo utilizzano per avvisi e approvazioni perché la configurazione richiede ore, non settimane.
• Clienti e comunità internazionali. Se vendi o supporti i clienti nei mercati in cui Telegram è l'impostazione predefinita, un bot li incontra dove si trovano. Comunità di prodotto, canali di annuncio e gruppi di supporto sono esempi comuni.

Se i tuoi clienti sono per lo più consumatori americani, inizia con la chat web o gli SMS per loro e mantieni Telegram per il tuo team. La stessa logica di automazione funziona per entrambi.

Casi d'uso che si ripagano rapidamente

• Avvisi su pagamenti ed entrate: "Nuovo ordine, $ 1.240, cliente X" in una chat di team, oltre ad avvisi di pagamento e rimborso non riusciti. Collegalo ai tuoi webhook di pagamento, come spiegato nella nostra guida ai webhook Stripe.
• Avvisi di errore e tempo di attività: un messaggio quando un backup non riesce, un controllo di integrità diventa rosso o un picco di errori. Consulta la nostra guida al backup e al monitoraggio per sapere cosa guardare.
• Approvazioni con un solo tocco: rimborso oltre un limite, richiesta di sconto, contenuto pronto per la pubblicazione. Il manager tocca Approva o Rifiuta nella chat e il tuo sistema agisce di conseguenza.
• Nuove notifiche lead: arriva un modulo di invio nella chat di vendita con i dettagli e un pulsante per richiederlo. Un primo contatto più rapido di solito migliora la conversione.
• Digest giornaliero: un breve riepilogo mattutino di vendite, iscrizioni, biglietti e incidenti.
• Supporta triage e FAQ: un bot risponde alle domande più comuni e passa il resto a un essere umano. Se desideri risposte AI dai tuoi documenti, leggi la nostra guida al chatbot AI per costi, ROI e garanzie.

Quanto costa

L' Telegram Bot API non addebita alcun costo per messaggio per l'utilizzo normale. I costi reali sono:

• Sviluppo: un semplice bot di avviso richiede poche ore di lavoro, un flusso di lavoro di approvazione o un bot di supporto richiede giorni e un bot con integrazione AI e CRM richiede più tempo.
• Hosting: basta un piccolo server. Un bot è per lo più inattivo.
• Servizi di terze parti: utilizzo del modello AI, un CRM, un provider SMS per il fallback. Questi dipendono dal volume.
• Manutenzione: monitoraggio, aggiornamenti e modifiche alle Bot API. Piccolo, ma non zero.

Per giustificarlo, stima il tempo risparmiato: minuti per avviso o approvazione moltiplicati per il volume, più il valore di una risposta più rapida. Molti team vedono il ritorno dell'investimento nel primo mese perché le alternative sono controllare manualmente i dashboard o perdere risposte lente.

Configurazione: da BotFather a un webhook funzionante

1. Crea il bot. In Telegram, parla con BotFather, crea un bot e copia il token. Il token è una password: conservala come segreto sul tuo server, mai nel codice o in Git.
2. Crea una chat di squadra o un gruppo, aggiungi il bot e trova l'ID chat dal primo aggiornamento ricevuto dal bot.
3. Scegli una modalità. Il polling lungo è il più semplice in fase di sviluppo. Per la produzione usa un webhook: Telegram chiama il tuo URL HTTPS per ogni aggiornamento.
4. Registra il webhook con un token segreto in modo da poter rifiutare chiunque altro trovi l'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"

Una piccola e sicura implementazione PHP

Innanzitutto un helper per chiamare l'API con un timeout e riprovare quando Telegram dice "rallenta" (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];
}

Quindi un avviso con pulsanti di approvazione, ad esempio quando viene richiesto un rimborso superiore al limite:

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

E il ricevitore webhook, che verifica il segreto, ignora le chat sconosciute, evita di elaborare due volte lo stesso aggiornamento e risponde rapidamente:

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

Nota i principi: autenticare il mittente, autorizzare la chat, convalidare il payload e rendere idempotente il gestore. Gli stessi principi si applicano ai webhook di pagamento. Controlla anche chi ha premuto il pulsante, perché chiunque in un gruppo può toccarlo a meno che tu non limiti chi può approvare.

Regole di sicurezza e conformità

• Mantieni il token segreto e ruotalo tramite BotFather in caso di perdite.
• Non inviare dati sensibili nelle chat: password, chiavi API, numeri di carte o dati sanitari. Le normali chat dei bot non sono crittografate end-to-end come si presume, quindi trattale come e-mail.
• Limita per chat e per utente. Le approvazioni dovrebbero essere accettate solo da persone nominate.
• Ottieni il consenso per i messaggi dei clienti e offri un modo semplice per interromperli. Segui le regole sulla privacy applicabili ai tuoi clienti, come GDPR per gli utenti in Europa, e descrivi il bot nella tua informativa sulla privacy.
• Azioni di registro: chi ha approvato cosa e quando.
• Rivedi i controlli nella nostra lista di controllo sulla sicurezza PHP, poiché il bot è un ulteriore punto di accesso ai tuoi sistemi.

Affidabilità: limiti di velocità e tentativi

Telegram limita la velocità di invio di un bot: circa un messaggio al secondo per una singola chat, una velocità inferiore nei gruppi e circa trenta messaggi al secondo in totale per le trasmissioni. Per qualsiasi cosa più grande di una chat di squadra, metti i messaggi in coda e inviali a una velocità controllata. Gestisci sempre la risposta 429 e il suo valore retry_after, rispondi ai webhook entro un secondo o due ed esegui un lavoro lento in background e monitora gli errori di consegna in modo da notare un bot rotto come faresti con qualsiasi altro servizio.

Un piano di lancio sensato

1. Settimana 1: avvisa il bot per pagamenti ed errori in una chat interna.
2. Settimana 2: aggiungi notifiche di lead e un riepilogo giornaliero.
3. Settimana 3-4: aggiungi approvazioni con pulsanti e un registro di controllo.
4. Successivamente: supporto rivolto al cliente o risposte AI dove il tuo pubblico utilizza Telegram, misurato rispetto al tempo di risposta e al volume dei ticket.

Come possiamo aiutare

Progettiamo e realizziamo Telegram, web chat e automazioni di messaggistica per le aziende, con le integrazioni alla base: pagamenti, CRM, email e AI. Leggi informazioni sul nostro servizio di integrazioni o prenota una breve chiamata e dicci quale processo desideri automatizzare per primo.