Convyra Bot : répondre depuis Telegram

Ce que fait le bot

• ✓Pousse chaque nouveau message visiteur dans le chat Telegram connecté (chat privé ou groupe d’équipe).
• ✓Répondre à la notification envoie votre texte au visiteur, dans le widget et par email si son adresse est connue.
• ✓La connexion se fait avec un code à usage unique généré dans le dashboard : personne ne peut connecter votre projet sans ce code.

1. Créer le bot (administrateur du déploiement)

Ouvrez @BotFather dans Telegram et créez votre bot :

/newbot
Nom affiché : Convyra Bot
Identifiant : votre_convyra_bot

2. Configurer le déploiement Convex

Définissez trois variables d’environnement sur le déploiement Convex (le webhook et l’envoi des messages tournent côté Convex) :

npx convex env set TELEGRAM_BOT_TOKEN "123456789:AA..."
npx convex env set TELEGRAM_BOT_USERNAME "votre_convyra_bot"
npx convex env set TELEGRAM_WEBHOOK_SECRET "$(openssl rand -hex 32)"

3. Enregistrer le webhook

Indiquez à Telegram où livrer les mises à jour. L’URL est celle de votre déploiement Convex (suffixe .convex.site) :

npm run setup:telegram -- https://VOTRE-DEPLOIEMENT.convex.site
# ou manuellement :
curl "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
  -d "url=https://VOTRE-DEPLOIEMENT.convex.site/telegram/webhook" \
  -d "secret_token=$TELEGRAM_WEBHOOK_SECRET" \
  -d "allowed_updates=[\"message\"]"

4. Connecter un projet (chaque utilisateur)

• ✓Ouvrez Convyra → Paramètres → Notifications.
• ✓Cliquez sur « Générer un code de connexion ». Le code est à usage unique et expire après 15 minutes.
• ✓Dans Telegram, ouvrez le bot officiel @convyrabot_bot via t.me/convyrabot_bot (ou ajoutez-le à un groupe d’équipe) puis envoyez /link VOTRE-CODE.
• ✓Le bot confirme la connexion au projet : les prochains messages visiteurs de ce projet arrivent dans ce chat.

Répondre et piloter

• ✓Répondre à une notification (fonction « Répondre » de Telegram) envoie votre message au visiteur.
• ✓/status liste les projets connectés au chat.
• ✓/unlink déconnecte le chat.
• ✓/help affiche l’aide.
• ✓La liste des chats connectés et un bouton de déconnexion sont aussi dans Paramètres → Notifications.

Sécurité

• ✓Le code de connexion est stocké haché, à usage unique, et expire après 15 minutes.
• ✓Le webhook vérifie le secret Telegram en temps constant et rejette tout autre appel.
• ✓Un chat déconnecté (dans Telegram ou dans le dashboard) ne reçoit plus rien immédiatement.
• ✓Si le bot est bloqué ou retiré d’un groupe, la connexion correspondante est nettoyée automatiquement.