Généré le 15/11/2026 01:03

🛠️ Rapport de Résolution : Panne de Transcription Vocale Telegram (05/11/2026)

Date & Heure : 05 novembre 2026 — 12h48 (Guadeloupe UTC-4)
Composant impacté : Passerelle vocale Telegram Remoat (Remoat/src/utils/voiceHandler.ts & Remoat/src/bot/index.ts)
Incident initial : Vocal de 164s envoyé à 12h16 non transcrit, message de Raphaël à 12h18 ("Probleme de transcription vocal tu peut redoudre stp?")
Statut : 🟢 Résolu et Recompilé à 100% — Vocal récupéré et transcrit avec succès.


1. 🔍 Causes Racines Identifiées

L'enquête dans les journaux d'exécution (Remoat/bot_startup.log) a révélé un blocage en cascade résultant de trois failles cumulées :

  1. Le Circuit Breaker abusif de 24h (Faille Principale) :
    - À 00h31 la nuit dernière, un court audio silencieux de 39s a renvoyé un texte vide.
    - Le code traitait toute absence de texte comme une défaillance API fatale et enclenchait un cooldown de 24 heures (STT_COOLDOWN_MS = 24 * 60 * 60 * 1000).
    - Conséquence : ElevenLabs et Google STT ont été bannis pour toute la journée. À 12h16, ElevenLabs (pourtant 100% opérationnel avec clé valide) a été sauté d'office.

  2. Absence de distinction entre silence audio et erreur technique :
    - Si un utilisateur hésite, enregistre un blanc ou un son faible, l'API renvoie status: 200 avec text: "". L'ancien code appelait aveuglément markSttFailure(), pénalisant inutilement le fournisseur.

  3. Le crash du fallback local faster_whisper :
    - Sauté du Cloud vers le CPU local, le bot a tenté d'exécuter C:\ASSISTANT_IA\scratch\faster_whisper_transcribe.py.
    - Ce fichier dans scratch/ avait été nettoyé (il résidait dans tools/). L'appel s'est soldé par une erreur [Errno 2] No such file or directory, laissant l'audio sans transcription.


2. 🛠️ Correctifs Appliqués & Recompilés

  1. Cooldown ramené de 24h à 3 minutes :
    - STT_COOLDOWN_MS passe de 86 400 000 ms à 180 000 ms (3 min). Si un incident réseau survient, le service est réessayé dès le message suivant au lieu d'être bloqué toute la journée.
  2. Distinction Silence vs Erreur Réseau/API :
    - Création de l'interface SttCallResult { text: string | null; isError: boolean }.
    - markSttFailure() n'est invoqué que sur une vraie erreur HTTP/réseau (isError: true), jamais sur un résultat vide normal.
  3. Résolution Dynamique & Pérenne des Scripts :
    - Ajout des fonctions getFasterWhisperScript() et getGoogleSttScript() ciblant prioritairement C:\ASSISTANT_IA\tools\ avec repli automatique sur scratch/.
    - Création des deux miroirs de compatibilité dans scratch/.
  4. Prise en compte de la durée réelle Telegram :
    - Transmission directe de audioObj.duration à transcribeVoice(voicePath, duration) pour calibrer un timeout CPU adapté (plancher à 240s + 3,5s/s d'audio) évitant toute coupure SIGTERM.
  5. Recompilation & Déploiement :
    - Compilation TypeScript réussie via npm run build dans C:\ASSISTANT_IA\Remoat.
    - Relance différée propre du bot pour charger le binaire mis à jour sans perte de session.

3. 🎙️ Transcription Intégrale du Vocal de 12h16:45 (164 secondes)

Le fichier audio original a été extrait directement depuis les serveurs Telegram (voice/file_7180.oga, 871 Ko) et transcrit fidèlement avec ElevenLabs Scribe :

« Bonjour, alors j'ai pris connaissance un peu de tout ce que tu as fait, notamment sur le site. Il y a du bon boulot. Il y a du bon boulot, je regardais.
Alors, il y a quelques petites choses que je voudrais modifier petit à petit, on va les faire ensemble.
Euh, premièrement, dans la FAQ, il y a une FAQ où tu parles de, de bundle. Où tu dis : « combien de chaussures qu'on peut laver avec vos bundles ? » quelque chose comme ça, il me semble. Je sais pas si le mot bundle est approprié ici, puisqu'on parle à des clients. Donc, euh, est-ce qu'on peut mettre autre chose à la place de bundle ? Donc qui soit un peu plus orienté client, marketing client.
Ensuite, dans la FAQ, la dernière question, justement, a, a une relation avec les avis. Est-ce qu'il y a des avis clients ? Donc ça, on va enlever ça carrément. On sait qu'on n'a pas d'avis clients, mais on va pas dire qu'on n'a pas d'avis et pourquoi. Donc, on va enlever ça.
Ensuite, euh, qu'est-ce que j'ai vu d'autre ? J'ai-- alors, j'ai pas tout noté. Alors, j'ai vu, par contre, tu as créé plusieurs pages. Euh, une page Contact où je vois qu'il y a beaucoup de détails. On va pas mettre autant de détails dans la page Contact. On va se contenter de faire un lien vers la page Contact basique qu'on fait par défaut de Shopify où on met notre email et un message. Juste ça.
Même chose pour la FAQ. On va se contenter de renvoyer aux questions FAQ déjà sur le site, plutôt que de recréer une page spécialement pour ça.
Euh, j'ai vu aussi quelque part où il y avait une histoire de suivi. T'as créé une page pour suivi de commande et tout ça. Non, on va pas faire de pages complexes comme ça pour se retrouver à ne pas pouvoir suivre tous ces éléments. On va laisser donc les commandes qui vont sur la page par défaut de commande de Shopify aussi.
Et on va garder un peu ce principe-là pour tous les liens ou les boutons qui ramènent vers des choses. On va pas spécialement créer de nouvelles pages. On va les rattacher directement à ce qui est existant déjà sur ce que j'ai l'habitude de faire dans mes sites antérieurs. Donc voilà, dans un premier temps. »


4. 📋 Plan d'Exécution Immédiat des Retouches Demandées

  1. FAQ — Remplacement du terme "bundle" : Reformuler en termes orientés client (ex: "packs complets", "kits d'entretien" ou "recharges").
  2. FAQ — Suppression de la question sur les avis clients : Éliminer la question et son explication.
  3. Page Contact : Simplifier pour router vers le template natif standard Shopify (formulaire épuré email + message).
  4. FAQ Globale : Lier directement vers la section FAQ intégrée de la page produit sans créer de sous-page isolée.
  5. Suivi de commande & Liens généraux : Aligner sur les templates et pages par défaut Shopify.