✈️ Configuration du Bot Telegram

Procédure : (1) ouvrez Telegram et recherchez @BotFather, (2) envoyez la commande /newbot, (3) choisissez le nom du bot (ex. "AI4CALL Assistant"), (4) choisissez le nom d'utilisateur du bot (doit finir par "bot", ex. "ai4call_assistant_bot"), (5) BotFather génère le Bot Token (chaîne type 123456:ABC-DEF1234ghIkl...), (6) COPIEZ le token immédiatement et sauvegardez-le - c'est le credential API du bot, (7) configurez le bot : /setdescription, /setabouttext, /setuserpic optionnels.

send_telegram : envoie à un UTILISATEUR UNIQUE spécifique en utilisant user_id (ID numérique ou @username). Utilisez pour des notifications personnelles, résumés individuels, messages privés. send_telegram_bulk : envoie le MÊME message à TOUS les utilisateurs dans la liste "Utilisateurs Autorisés" (broadcast). Utilisez pour des avis d'équipe, alertes d'urgence, annonces générales. send_telegram_bulk ne nécessite PAS de user_id - envoie automatiquement à la liste configurée.

Méthode 1 : utilisez le bot @userinfobot - envoyez /start et il répond avec l'ID. Méthode 2 : utilisez le bot @getidsbot - envoyez n'importe quel message. Méthode 3 : ouvrez Telegram Web (web.telegram.org), cliquez sur le profil, l'URL contient l'ID après #id. L'ID numérique est une chaîne type 123456789 (9 chiffres typiquement). Le nom d'utilisateur (@mario) peut changer, l'ID est permanent - mieux d'utiliser l'ID pour la fiabilité.

Oui, utilisez le paramètre parse_mode. Options : (1) parse_mode="Markdown" : *gras*, _italique_, [lien](url), `code`, ```bloc code```. (2) parse_mode="HTML" : gras, italique, lien, code. Exemple : send_telegram avec text="*Urgent* : client demande du support" et parse_mode="Markdown" rend "Urgent" en gras. Par défaut sans parse_mode : texte plain.

Oui, l'outil send_telegram supporte le paramètre photo_url. Fournissez une URL publique HTTPS de l'image (ex. https://example.com/photo.jpg). Telegram la télécharge et l'envoie. Formats supportés : JPG, PNG, GIF, WebP. Taille max : 10MB pour les photos, 50MB pour les fichiers. Si photo_url est fourni, text devient la légende de l'image. Pour envoyer seulement une photo sans texte : utilisez text="" ou ommettez. Exemple : photo_url="https://cdn.com/alert.png".

Le bot PEUT recevoir des messages (si l'utilisateur écrit au bot), mais AI4CALL utilise actuellement Telegram en mode SEND-ONLY (envoi uniquement). Le bot NE lit PAS les réponses des utilisateurs en temps réel pendant l'appel. Pour gérer les réponses : configurez un webhook Telegram séparé avec n8n/Zapier qui traite les messages entrants, sauve sur base de données/CRM, notifie l'équipe. Use case AI4CALL : notifications outbound, pas de conversations bidirectionnelles.

Le Bot Token garantit le contrôle complet du bot. Protection : (1) NE partagez PAS le token publiquement, (2) NE committez PAS dans des dépôts Git publics, (3) conservez-le dans un gestionnaire de mots de passe sécurisé, (4) s'il est compromis : révoquez le token via @BotFather commande /revoke et générez-en un nouveau avec /token, (5) utilisez HTTPS pour les communications API, (6) limitez les utilisateurs autorisés à recevoir des messages. Si le token fuit : n'importe qui peut envoyer des messages au nom de votre bot.

Oui, mais cela nécessite une configuration supplémentaire. Procédure : (1) créez un groupe Telegram, (2) ajoutez le bot au groupe en tant que membre, (3) obtenez le group_id (négatif, ex. -123456789) en utilisant @getidsbot dans le groupe, (4) utilisez send_telegram avec user_id=group_id (numéro négatif). Tous les membres du groupe verront le message. Alternative : utilisez un canal Telegram (broadcast one-way), ajoutez le bot en tant qu'admin, envoyez à channel_id.

Checklist de dépannage : (1) vérifiez que le Bot Token est correct (format 123456:ABC-DEF...), (2) testez le token avec @BotFather commande /mybots, (3) vérifiez que le user_id est correct (ID numérique ou @username existant), (4) contrôlez que l'utilisateur a démarré le bot (envoyé /start) - Telegram bloque les bots qui n'ont pas été démarrés par l'utilisateur, (5) vérifiez que le bot n'est pas bloqué par l'utilisateur, (6) contrôlez les logs AI4CALL pour les erreurs d'API, (7) testez manuellement avec curl/Postman l'API Telegram.

Actuellement send_telegram supporte text et photo_url. Pour les documents : solution de contournement (1) téléchargez le fichier sur un stockage cloud (Google Drive, Dropbox), (2) générez un lien public/temporaire, (3) envoyez le lien via Telegram text avec le message "Document disponible : [lien]". Alternative : étendez l'outil send_telegram avec un paramètre document_url (nécessite une modification backend) qui utilise l'API Telegram sendDocument. Taille max des documents : 50MB.

Configuration via @BotFather : (1) Nom du bot : défini lors de la création avec /newbot, modifiable avec /setname, (2) Nom d'utilisateur du bot : défini avec /newbot (fixe, non modifiable après), (3) Photo de profil : /setuserpic télécharge une image carrée min 512x512px, (4) Description : /setdescription texte affiché lorsque l'utilisateur recherche le bot, (5) À propos : /setabouttext info affichée dans le profil du bot. Le nom affiché apparaît au-dessus des messages envoyés par le bot.

L'API Telegram Bot n'a pas de scheduling natif - envoie immédiatement. Pour le scheduling : (1) intégrez avec n8n/Zapier qui supporte les délais/cron, (2) l'assistant sauvegarde les données + timestamp, (3) n8n attend ou exécute un cron quotidien, (4) n8n invoque send_telegram au moment désiré. Exemple : rappel quotidien à 9:00 à l'équipe via send_telegram_bulk - cron job n8n à 9:00 appelle l'outil automatiquement. Workflow AI4CALL : envoi immédiat pendant/après l'appel.