v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:11:00.000Z▲ 0 upvotes

Bot Telegram : webhook ou interrogation longue, secret_token et déploiement sans serveur

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Deux façons de recevoir des mises à jour

L'API Bot transmet les messages entrants de deux manières mutuellement exclusives :

  • Long polling - le bot lui-même appelle getUpdates avec le paramètre timeout, Telegram maintient la demande ouverte jusqu'à ce que les mises à jour apparaissent. Un processus en cours d'exécution en permanence est nécessaire, les ports entrants ne sont pas nécessaires.
  • Webhook - Telegram envoie chaque mise à jour avec une requête POST à ​​votre adresse HTTPS. Le processus ne s'exécute peut-être pas tout le temps, l'option est donc sans serveur.

Ils ne fonctionnent pas en même temps : pendant que le webhook est installé, getUpdates renvoie une erreur 409 Conflict. Il s'agit d'une raison courante pour laquelle « le bot a cessé de répondre » lorsqu'une copie locale a été lancée sur le serveur en mode d'interrogation.

| | Long sondage | Webhook | |---|---|---| | Où courir | VPS, conteneur, local | sans serveur, n'importe quel serveur HTTPS | | Sonorisation | pas nécessaire | HTTPS sur le port 443, 80, 88 ou 8443 | | Développement | simple, fonctionne grâce au NAT | besoin d'un tunnel pour le débogage local | | Processus simple | les mises à jour attendent en ligne | Telegram répète la livraison |

Pour le développement et un bot sur un VPS, les interrogations longues sont plus faciles. Pour le déploiement sur Vercel, Cloudflare Workers ou dans une fonction - uniquement webhook.

Webhook avec secret_token

L'URL du webhook ne peut pas être considérée comme un secret. Sans vérification, toute personne le reconnaissant enverra une fausse mise à jour au nom de n’importe quel utilisateur. Le paramètre secret_token lors de l'installation d'un webhook résout ce problème : Telegram le transmettra dans l'en-tête X-Telegram-Bot-Api-Secret-Token de chaque requête.

SECRET=$(openssl rand -hex 32)   # допустимы A-Z, a-z, 0-9, _ и -, до 256 символов

curl -s "https://api.telegram.org/bot${BOT_TOKEN}/setWebhook" \
  -d "url=https://example.com/api/telegram" \
  -d "secret_token=${SECRET}" \
  -d 'allowed_updates=["message","callback_query"]' \
  -d "drop_pending_updates=true"

allowed_updates limite les types d'événements qui arrivent au webhook - moins d'appels de fonction inutiles. drop_pending_updates supprime la file d'attente accumulée afin que le bot après le déploiement ne réponde pas aux centaines d'anciens messages.

Gestionnaire sur Next.js

// app/api/telegram/route.ts
import { timingSafeEqual } from "node:crypto";
import { db } from "@/lib/db";

const TOKEN = process.env.TELEGRAM_BOT_TOKEN!;
const SECRET = process.env.TELEGRAM_WEBHOOK_SECRET!;

function validSecret(header: string | null) {
  if (!header) return false;
  const a = Buffer.from(header), b = Buffer.from(SECRET);
  return a.length === b.length && timingSafeEqual(a, b);
}

async function tg(method: string, body: unknown) {
  const res = await fetch(`https://api.telegram.org/bot${TOKEN}/${method}`, {
    method: "POST",
    headers: { "content-type": "application/json" },
    body: JSON.stringify(body),
  });
  if (!res.ok) console.error("telegram", method, res.status, await res.text());
}

export async function POST(req: Request) {
  if (!validSecret(req.headers.get("x-telegram-bot-api-secret-token"))) {
    return new Response("forbidden", { status: 403 });
  }

  const update = await req.json();

  const first = await db.query(
    "INSERT INTO tg_updates (update_id) VALUES ($1) ON CONFLICT DO NOTHING",
    [update.update_id]
  );
  if (first.rowCount === 0) return new Response("ok");

  const msg = update.message;
  if (msg?.text === "/start") {
    await tg("sendMessage", { chat_id: msg.chat.id, text: "Привет! Пришлите номер заказа." });
  } else if (msg?.text) {
    await tg("sendMessage", { chat_id: msg.chat.id, text: await lookupOrder(msg.text) });
  }

  return new Response("ok");
}

Pourquoi :

  • Le secret est vérifié en premier et via timingSafeEqual.
  • Déduplication par `update_id`. Si la réponse n'est pas arrivée à temps ou n'a pas été renvoyée 2xx, Telegram répétera la livraison. Sans déduplication, l'utilisateur recevra deux réponses ou deux commandes créées.
  • Toujours 200 après traitement, même si le message n'est pas reconnu. Un statut erroné entraînera de nouvelles tentatives et la file d'attente de mise à jour restera bloquée.
  • Jeton du Bot dans l'URL. Ne journalisez pas les URL complètes des requêtes vers l'API du Bot : le jeton finira dans les journaux. Dans l'exemple, seuls la méthode et l'état sont enregistrés.

Vous pouvez également répondre directement dans le corps de la réponse du webhook, en renvoyant JSON avec le champ method (par exemple, {"method":"sendMessage","chat_id":...,"text":"..."}). Cela enregistre une demande sortante, mais vous ne saurez pas si le message a été remis.

Fonctionnalités sans serveur

  • Délai d'exécution. Si le traitement est long (appel LLM, génération de fichiers), la fonction risque de ne pas respecter la limite de la plateforme et Telegram considérera la livraison comme un échec. Répondez rapidement avec 200 et déplacez le travail vers une file d'attente ou une tâche en arrière-plan et envoyez le résultat via sendMessage.
  • Parallélisme. Le paramètre max_connections dans setWebhook (de 1 à 100, par défaut 40) définit le nombre de requêtes simultanées envoyées par Telegram. L'ordre des messages d'un même utilisateur n'est pas garanti lors d'un traitement parallèle. Si le bot mène un dialogue étape par étape, stockez l'état dans la base de données et tenez compte des courses.
  • Démarrage à froid. Le premier message après le temps d'inactivité est traité plus lentement. Pour les robots, cela est généralement acceptable.

Diagnostic

curl -s "https://api.telegram.org/bot${BOT_TOKEN}/getWebhookInfo"

La réponse contient pending_update_count (combien de mises à jour sont en attente de livraison), last_error_date et last_error_message. Erreurs typiques :

  • Wrong response from the webhook: 403 Forbidden - le secret dans les variables d'environnement ne correspond pas à celui transmis à setWebhook.
  • SSL error ou Connection refused - une adresse indisponible ou un certificat auquel Telegram ne fait pas confiance.
  • Augmentation de pending_update_count - le gestionnaire répond avec une erreur ou est hors de temps.

Quand rester sur des sondages longs

Si le bot vit sur son propre serveur, que la charge est légère et que vous ne souhaitez pas publier de point de terminaison HTTPS, une interrogation longue est fiable et simple. Des bibliothèques comme GrammY et Telegraf prennent en charge les deux modes, et la transition prend alors plusieurs lignes.

Обсуждение (0)

Ещё на vbcd4u.com