feat(i18n): full 5-language support across all bot handlers

Extend EN/ES/PT support to NavigationHandler, ExerciseHandler,
NudgeHandler, AdminHandler, FeedbackHandler, and EnrollHandler.
All user-facing messages now use per-language string maps instead
of WOLOF/FR binary checks.

EnrollHandler now sends a localised "content coming soon" message
when the requested track doesn't exist, instead of silently failing.

OnboardingHandler falls back to T1-FR for EN/ES/PT until orgs
create language-specific tracks via the admin dashboard.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

apps/whatsapp-worker/src/handlers/AdminHandler.ts

@@ -33,12 +33,8 @@ export class AdminHandler implements JobHandler {
 
         const { sendAudioMessage } = await import('../whatsapp-cloud');
         await sendAudioMessage(user.phone, overrideAudioUrl, tenantConfig);
-        await sendTextMessage(user.phone,
-            user.language === 'WOLOF'
-                ? "Baax na ! Yónnee *SUITE* ngir dem ci kanam."
-                : "Bravo ! Envoyez *SUITE* pour passer à la leçon suivante.",
-            tenantConfig
-        );
+        const adminMsg = { FR: "Bravo ! Envoyez *SUITE* pour passer à la leçon suivante.", WOLOF: "Baax na ! Yónnee *SUITE* ngir dem ci kanam.", EN: "Well done! Send *CONTINUE* to move to the next lesson.", ES: "¡Bravo! Envía *CONTINUAR* para pasar a la siguiente lección.", PT: "Muito bem! Envie *CONTINUAR* para passar para a próxima lição." }[user.language] ?? "Bravo ! Envoyez *SUITE* pour passer à la leçon suivante.";
+        await sendTextMessage(user.phone, adminMsg, tenantConfig);
 
         await prisma.response.create({
             data: {

apps/whatsapp-worker/src/handlers/EnrollHandler.ts

@@ -39,7 +39,17 @@ export class EnrollHandler implements JobHandler {
     async handle(job: Job<JobData>, connection: Redis): Promise<void> {
         const { userId, trackId, organizationId } = job.data;
         const track = await prisma.track.findUnique({ where: { id: trackId } });
-        if (!track) return;
+        if (!track) {
+            logger.warn({ userId, trackId }, '[EnrollHandler] Track not found — cannot enroll');
+            const user = await prisma.user.findUnique({ where: { id: userId } });
+            if (user?.phone) {
+                const tenantConfig = await this.getTenantConfig(organizationId as string, connection);
+                const msgMap: Record<string, string> = { FR: "La formation est en cours de préparation. Nous te préviendrons dès qu'elle est disponible ! 📚", WOLOF: "Dafa daan jàppale — dinañu la xam bu amee ci kanam ! 📚", EN: "Training content is being prepared. We'll notify you when it's ready! 📚", ES: "El contenido de formación está en preparación. ¡Te avisaremos cuando esté listo! 📚", PT: "O conteúdo da formação está a ser preparado. Iremos notificá-lo quando estiver pronto! 📚" };
+                const msg = msgMap[user.language] ?? msgMap['FR'];
+                await sendTextMessage(user.phone, msg, tenantConfig);
+            }
+            return;
+        }
 
         if (track.isPremium) {
             try {

apps/whatsapp-worker/src/handlers/ExerciseHandler.ts

@@ -3,6 +3,8 @@ import { isFuzzyMatch } from '../services/utils';
 import { prisma } from '../services/prisma';
 import { logger } from '../logger';
 import { getTimeTravelContext } from '../timeTravelContext';
+import { getT } from '../services/i18n';
+import { Language } from '@repo/database';
 
 
 
@@ -64,9 +66,14 @@ export class ExerciseHandler implements MessageHandler {
         if (!pendingProgress) {
             // If completed and no revalidation, send navigation guidance
             if (userProgress?.exerciseStatus === 'COMPLETED') {
-                const reminder = user.language === 'WOLOF'
-                    ? "Mat nga bés bi ba pare ! ✨\nBindal *2* wala *SUITE* ngir dem ci bés bi ci kanam."
-                    : "Tu as déjà validé cette étape ! ✨\nEnvoie *2* ou *SUITE* pour passer à la suite.";
+                const t = getT(user.language as Language);
+                const reminder = {
+                    FR: `Tu as déjà validé cette étape ! ✨\nEnvoie *2* ou *SUITE* pour passer à la suite.`,
+                    WOLOF: `Mat nga bés bi ba pare ! ✨\nBindal *2* wala *SUITE* ngir dem ci bés bi ci kanam.`,
+                    EN: `You've already completed this step! ✨\nSend *2* or *CONTINUE* to move on.`,
+                    ES: `¡Ya completaste este paso! ✨\nEnvía *2* o *CONTINUAR* para seguir adelante.`,
+                    PT: `Você já completou esta etapa! ✨\nEnvie *2* ou *CONTINUAR* para avançar.`,
+                }[user.language] ?? t('exercise_prompt');
                 await whatsappQueue.add('send-message', { userId: user.id, text: reminder, organizationId: ctx.organizationId });
                 return true;
             }
@@ -101,12 +108,13 @@ export class ExerciseHandler implements MessageHandler {
         const minWordCount = shouldBypassGuardrail ? 1 : 3;
 
         if (wordCount < minWordCount) {
-             const msg = user.language === 'WOLOF' ? "Tontu bi gatt na..." : "Ta réponse est un peu courte.";
-             await whatsappQueue.add('send-message', { userId: user.id, text: msg, organizationId: ctx.organizationId });
-             return true;
+            const shortMsg = { FR: "Ta réponse est un peu courte.", WOLOF: "Tontu bi gatt na...", EN: "Your answer is a bit short.", ES: "Tu respuesta es un poco corta.", PT: "Sua resposta é um pouco curta." }[user.language] ?? "Ta réponse est un peu courte.";
+            await whatsappQueue.add('send-message', { userId: user.id, text: shortMsg, organizationId: ctx.organizationId });
+            return true;
         }
 
-        await whatsappQueue.add('send-message', { userId: user.id, text: user.language === 'WOLOF' ? "⏳ Defar ak sa tontu..." : "⏳ Analyse de votre réponse...", organizationId: ctx.organizationId });
+        const spinnerMsg = { FR: "⏳ Analyse de votre réponse...", WOLOF: "⏳ Defar ak sa tontu...", EN: "⏳ Analysing your answer...", ES: "⏳ Analizando tu respuesta...", PT: "⏳ Analisando sua resposta..." }[user.language] ?? "⏳ Analyse de votre réponse...";
+        await whatsappQueue.add('send-message', { userId: user.id, text: spinnerMsg, organizationId: ctx.organizationId });
 
         let currentIterationCount = pendingProgress.iterationCount || 0;
         if (isDeepDiveAction) {

apps/whatsapp-worker/src/handlers/FeedbackHandler.ts

@@ -167,10 +167,7 @@ export class FeedbackHandler implements JobHandler {
         } catch (err: any) {
             logger.error({ err, userId, jobId: job.id }, '[FEEDBACK] Feedback generation failed');
 
-            const errorMsg = language === 'WOLOF'
-                ? "⚠️ Am na problem technique. Saytu waat bi rekk."
-                : language === 'EN' ? "⚠️ Technical issue. Please try again."
-                : "⚠️ Un problème technique est survenu. Réessaie.";
+            const errorMsg = { FR: "⚠️ Un problème technique est survenu. Réessaie.", WOLOF: "⚠️ Am na problem technique. Saytu waat bi rekk.", EN: "⚠️ Technical issue. Please try again.", ES: "⚠️ Problema técnico. Por favor, inténtalo de nuevo.", PT: "⚠️ Problema técnico. Por favor, tente novamente." }[language as string] ?? "⚠️ Un problème technique est survenu. Réessaie.";
 
             await whatsappQueue.add('send-message', { userId, text: errorMsg, organizationId });
             throw err;

apps/whatsapp-worker/src/handlers/NavigationHandler.ts

@@ -38,7 +38,7 @@ export class NavigationHandler implements MessageHandler {
             });
 
             if (userProgress?.exerciseStatus !== 'COMPLETED' && userProgress?.exerciseStatus !== 'PENDING_DEEPDIVE' && !lastResponse) {
-                const msg = user.language === 'WOLOF' ? "Dafa laaj nga tontu !" : "Tu dois d'abord répondre !";
+                const msg = { FR: "Tu dois d'abord répondre !", WOLOF: "Dafa laaj nga tontu !", EN: "You must answer first!", ES: "¡Debes responder primero!", PT: "Você precisa responder primeiro!" }[user.language] ?? "Tu dois d'abord répondre !";
                 await whatsappQueue.add('send-message', { userId: user.id, organizationId: ctx.organizationId, text: msg });
                 return true;
             }
@@ -74,11 +74,11 @@ export class NavigationHandler implements MessageHandler {
                     where: { id: userProgress!.id }, 
                     data: { exerciseStatus: 'PENDING_DEEPDIVE' } 
                 });
-                const msg = user.language === 'WOLOF' ? "Wax ma ndox mi..." : "Très bien ! Quelle info ?";
+                const msg = { FR: "Très bien ! Quelle info ?", WOLOF: "Wax ma ndox mi...", EN: "Great! What would you like to know?", ES: "¡Muy bien! ¿Qué información quieres?", PT: "Ótimo! Que informação você quer?" }[user.language] ?? "Très bien ! Quelle info ?";
                 await whatsappQueue.add('send-message', { userId: user.id, organizationId: ctx.organizationId, text: msg });
                 return true;
             } else {
-                const msg = user.language === 'WOLOF' ? "Tontul exercice bi ba pare !" : "Réponds d'abord à l'exercice principal !";
+                const msg = { FR: "Réponds d'abord à l'exercice principal !", WOLOF: "Tontul exercice bi ba pare !", EN: "Answer the main exercise first!", ES: "¡Responde primero al ejercicio principal!", PT: "Responda primeiro ao exercício principal!" }[user.language] ?? "Réponds d'abord à l'exercice principal !";
                 await whatsappQueue.add('send-message', { userId: user.id, organizationId: ctx.organizationId, text: msg });
                 return true;
             }

apps/whatsapp-worker/src/handlers/NudgeHandler.ts

@@ -41,15 +41,14 @@ export class NudgeHandler implements JobHandler {
         const tenantConfig = await this.getTenantConfig(organizationId || '', connection);
         if (!user?.phone) return;
 
-        const isWolof = user.language === 'WOLOF';
-        const messages = {
-            ENCOURAGEMENT: isWolof
-                ? "Assalamuyalaykum ! Fatte wuñu sa mbir. Tontu bu gatt ngir wéy ? 💪"
-                : "Coucou ! On n'a pas oublié ton projet. Une petite réponse pour continuer ? 💪",
-            RESURRECTION: isWolof
-                ? "Sa liggeey mu ngi lay xaar ! Am succès dafa laaj lëkkalë. Ñu tàmbaleeti ? 🚀"
-                : "Ton business t'attend ! Le succès vient de la régularité. On s'y remet ? 🚀"
+        const nudgeStrings: Record<string, { ENCOURAGEMENT: string; RESURRECTION: string }> = {
+            FR:    { ENCOURAGEMENT: "Coucou ! On n'a pas oublié ton projet. Une petite réponse pour continuer ? 💪", RESURRECTION: "Ton business t'attend ! Le succès vient de la régularité. On s'y remet ? 🚀" },
+            WOLOF: { ENCOURAGEMENT: "Assalamuyalaykum ! Fatte wuñu sa mbir. Tontu bu gatt ngir wéy ? 💪",           RESURRECTION: "Sa liggeey mu ngi lay xaar ! Am succès dafa laaj lëkkalë. Ñu tàmbaleeti ? 🚀" },
+            EN:    { ENCOURAGEMENT: "Hey! We haven't forgotten about your project. A quick reply to keep going? 💪",  RESURRECTION: "Your business is waiting! Success comes from consistency. Let's get back to it? 🚀" },
+            ES:    { ENCOURAGEMENT: "¡Hola! No hemos olvidado tu proyecto. ¿Una respuesta rápida para continuar? 💪", RESURRECTION: "¡Tu negocio te espera! El éxito viene de la constancia. ¿Lo retomamos? 🚀" },
+            PT:    { ENCOURAGEMENT: "Oi! Não esquecemos do seu projeto. Uma resposta rápida para continuar? 💪",     RESURRECTION: "Seu negócio está esperando! O sucesso vem da regularidade. Vamos retomar? 🚀" },
         };
+        const messages = nudgeStrings[user.language] ?? nudgeStrings['FR'];
 
         const nudgeType = (type || 'ENCOURAGEMENT') as keyof typeof messages;
         const text = messages[nudgeType] || messages.ENCOURAGEMENT;

apps/whatsapp-worker/src/handlers/OnboardingHandler.ts

@@ -34,7 +34,8 @@ function getValidatedConfig(ctx: MessageContext) {
 }
 
 function getDefaultTrack(language: string): string {
-    const map: Record<string, string> = { FR: 'T1-FR', WOLOF: 'T1-WO', EN: 'T1-EN', ES: 'T1-ES', PT: 'T1-PT' };
+    // EN/ES/PT fall back to T1-FR until org creates language-specific tracks
+    const map: Record<string, string> = { FR: 'T1-FR', WOLOF: 'T1-WO', EN: 'T1-FR', ES: 'T1-FR', PT: 'T1-FR' };
     return map[language] ?? 'T1-FR';
 }