feat(admin): add Direct Setup button for super admins on orgs without phone number

- Add "Direct Setup" button (super admin only) on /clients for orgs without a WhatsApp number
- Previously the setup modal was only reachable via the Reconfigure button (orgs with a phone)
- Add i18n keys: clients.actions.direct_setup (en/fr/pt)
- Add scratch scripts for org configuration and DB queries
- Add doc: configurer-token-nouvelle-org.md — how to configure a Meta token on a new org

apps/admin/src/locales/en.json

@@ -651,6 +651,7 @@
     "actions": {
       "reconfigure_wa": "Reconfigure WhatsApp",
       "connect_wa": "Connect WhatsApp (Meta)",
+      "direct_setup": "Direct Setup",
       "personality_studio": "Personality Studio",
       "ai_credits": "AI Credits",
       "billing_details": "Details & Billing"

apps/admin/src/locales/fr.json

@@ -651,6 +651,7 @@
     "actions": {
       "reconfigure_wa": "Reconfigurer WhatsApp",
       "connect_wa": "Connecter WhatsApp (Meta)",
+      "direct_setup": "Configuration directe",
       "personality_studio": "Personality Studio",
       "ai_credits": "Crédits IA",
       "billing_details": "Détails & Facturation"

apps/admin/src/locales/pt.json

@@ -651,6 +651,7 @@
     "actions": {
       "reconfigure_wa": "Reconfigurar WhatsApp",
       "connect_wa": "Ligar WhatsApp (Meta)",
+      "direct_setup": "Configuração direta",
       "personality_studio": "Personality Studio",
       "ai_credits": "Créditos IA",
       "billing_details": "Detalhes & Faturação"

apps/admin/src/pages/ClientsManagementView.tsx

@@ -247,12 +247,23 @@ export default function ClientsManagementView() {
                                         )}
                                     </div>
                                 ) : (
-                                    <button
-                                        onClick={() => handleEmbeddedSignup(client.id)}
-                                        className="flex items-center gap-2 bg-indigo-600 text-white px-5 py-2.5 rounded-xl font-semibold hover:bg-indigo-700 transition shadow-lg shadow-indigo-100"
-                                    >
-                                        <MessageSquare className="w-4 h-4" /> {t('clients.actions.connect_wa')}
-                                    </button>
+                                    <div className="flex gap-2">
+                                        <button
+                                            onClick={() => handleEmbeddedSignup(client.id)}
+                                            className="flex items-center gap-2 bg-indigo-600 text-white px-5 py-2.5 rounded-xl font-semibold hover:bg-indigo-700 transition shadow-lg shadow-indigo-100"
+                                        >
+                                            <MessageSquare className="w-4 h-4" /> {t('clients.actions.connect_wa')}
+                                        </button>
+                                        {isSuperAdmin && (
+                                            <button
+                                                onClick={() => { setSetupOrg(client); setDirectSetup({ wabaId: client.wabaId || '', metaBusinessId: '', accessToken: '', phoneNumberId: '' }); }}
+                                                className="flex items-center gap-2 bg-slate-700 text-white px-4 py-2.5 rounded-xl font-semibold hover:bg-slate-800 transition text-xs"
+                                                title={t('clients.actions.direct_setup')}
+                                            >
+                                                <ShieldCheck className="w-3.5 h-3.5" /> {t('clients.actions.direct_setup')}
+                                            </button>
+                                        )}
+                                    </div>
                                 )}
                                 <button
                                     onClick={() => setSelectedOrgForPersonality(client)}

apps/api/scratch/connect_test4.ts

@@ -0,0 +1,54 @@
+import 'dotenv/config';
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+const TEST4_ORG_ID    = '12247ec1-7629-4650-b695-237654793e0c';
+const TESTCRM_ORG_ID  = 'ba012b65-2289-4ded-956d-aeaaf908fb30';
+const PHONE_NUMBER_ID = '1135406776315489';
+const DISPLAY_PHONE   = '+221788227676';
+const WABA_ID         = '1503271284790621';
+
+async function main() {
+    // 1. Read testcrm's encrypted token (copy it as-is — same ENCRYPTION_SECRET)
+    const testcrm = await prisma.organization.findUnique({
+        where: { id: TESTCRM_ORG_ID },
+        select: { systemUserToken: true, wabaId: true }
+    });
+
+    if (!testcrm?.systemUserToken) {
+        throw new Error('testcrm has no systemUserToken — cannot proceed');
+    }
+
+    console.log(`📋 Source : testcrm | waba: ${testcrm.wabaId} | token: ${testcrm.systemUserToken ? '✅' : '❌'}`);
+
+    // 2. Free WABA ID from testcrm first (unique constraint)
+    await prisma.organization.update({
+        where: { id: TESTCRM_ORG_ID },
+        data:  { wabaId: null }
+    });
+    console.log(`✅ WABA ID retiré de testcrm`);
+
+    // 3. Copy WABA ID + encrypted token to test4
+    await prisma.organization.update({
+        where: { id: TEST4_ORG_ID },
+        data: {
+            wabaId: WABA_ID,
+            systemUserToken: testcrm.systemUserToken,
+            systemUserTokenIssuedAt: new Date()
+        }
+    });
+    console.log(`✅ WABA ID + token copiés vers test4 (WABA: ${WABA_ID})`);
+
+    // 4. Move the phone number from testcrm to test4
+    await prisma.whatsAppPhoneNumber.update({
+        where:  { id: PHONE_NUMBER_ID },
+        data:   { organizationId: TEST4_ORG_ID }
+    });
+    console.log(`✅ Numéro transféré vers test4 : ${DISPLAY_PHONE}`);
+
+    console.log('\n🎉 test4 est maintenant opérationnel avec le numéro', DISPLAY_PHONE);
+    await prisma.$disconnect();
+}
+
+main().catch(console.error);

apps/api/scratch/connect_testcrm.ts

@@ -0,0 +1,37 @@
+import 'dotenv/config';
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+async function main() {
+    const TESTCRM_ORG_ID  = 'ba012b65-2289-4ded-956d-aeaaf908fb30';
+    const PHONE_NUMBER_ID = '1135406776315489';
+    const DISPLAY_PHONE   = '+221 78 822 76 76';
+    const WABA_ID         = '1503271284790621';
+
+    // 1. Retirer le numéro de default-org-id (où on l'avait mis par erreur)
+    await prisma.whatsAppPhoneNumber.update({
+        where: { id: PHONE_NUMBER_ID },
+        data:  { organizationId: TESTCRM_ORG_ID }
+    });
+    console.log(`✅ Numéro transféré vers testcrm : ${DISPLAY_PHONE}`);
+
+    // 2. Mettre à jour le WABA ID sur testcrm
+    await prisma.organization.update({
+        where: { id: TESTCRM_ORG_ID },
+        data:  { wabaId: WABA_ID }
+    });
+    console.log(`✅ WABA ID mis à jour sur testcrm : ${WABA_ID}`);
+
+    // 3. Retirer le WABA ID de default-org-id (il était incorrect)
+    await prisma.organization.update({
+        where: { id: 'default-org-id' },
+        data:  { wabaId: null }
+    });
+    console.log(`✅ WABA ID retiré de default-org-id`);
+
+    console.log('\n🎉 testcrm est maintenant connecté au numéro +221 78 822 76 76');
+    await prisma.$disconnect();
+}
+
+main().catch(console.error);

apps/api/scratch/list_orgs.ts

@@ -0,0 +1,18 @@
+import 'dotenv/config';
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+async function main() {
+    const orgs = await prisma.organization.findMany({
+        select: { id: true, name: true, slug: true, wabaId: true },
+        orderBy: { createdAt: 'desc' }
+    });
+    console.log('\n📋 Organisations disponibles :');
+    orgs.forEach(o => {
+        console.log(`  - [${o.id}] ${o.name} (slug: ${o.slug || 'aucun'}, waba: ${o.wabaId || 'non configuré'})`);
+    });
+    await prisma.$disconnect();
+}
+
+main().catch(console.error);

apps/api/scratch/register_prod_number.ts

@@ -0,0 +1,30 @@
+import 'dotenv/config';
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+async function main() {
+    const PHONE_NUMBER_ID = '1135406776315489';
+    const DISPLAY_PHONE  = '+221 78 822 76 76';
+    const WABA_ID        = '1503271284790621';
+    const ORG_ID         = 'default-org-id';
+
+    // 1. Mise à jour du WABA ID sur l'organisation
+    await prisma.organization.update({
+        where: { id: ORG_ID },
+        data:  { wabaId: WABA_ID }
+    });
+    console.log(`✅ WABA ID mis à jour : ${WABA_ID}`);
+
+    // 2. Enregistrement du numéro de production
+    await prisma.whatsAppPhoneNumber.upsert({
+        where:  { id: PHONE_NUMBER_ID },
+        update: { displayPhone: DISPLAY_PHONE, organizationId: ORG_ID },
+        create: { id: PHONE_NUMBER_ID, displayPhone: DISPLAY_PHONE, organizationId: ORG_ID }
+    });
+    console.log(`✅ Numéro enregistré : ${DISPLAY_PHONE} (ID: ${PHONE_NUMBER_ID})`);
+
+    await prisma.$disconnect();
+}
+
+main().catch(console.error);

docs/organisation-onboarding/configurer-token-nouvelle-org.md

@@ -0,0 +1,192 @@
+# Configurer le token Meta sur une nouvelle organisation
+
+**Public :** Super Admin XAMLÉ  
+**Durée :** 5 minutes  
+**Pré-requis :** Avoir un token Meta valide (`EAA...`) d'une org existante ou obtenu depuis Meta Business Suite
+
+---
+
+## Contexte
+
+Quand une organisation est créée, elle n'a pas de connexion WhatsApp. Le dashboard affiche **"Configuration requise"**. Pour qu'elle devienne opérationnelle, il faut lui associer :
+
+1. Un **WABA ID** — l'identifiant du compte WhatsApp Business Account Meta
+2. Un **token d'accès** (`EAA...`) — long-lived token Meta pour appeler l'API Graph
+3. Un **phoneNumberId** — l'ID du numéro WhatsApp (peut être fait plus tard si le numéro n'existe pas encore)
+
+> **Important — contrainte unique sur wabaId :** Deux organisations ne peuvent pas avoir le même `wabaId` en même temps. Si tu veux que plusieurs orgs opèrent sous le même compte WABA (ex. plusieurs numéros), contacte un développeur pour retirer la contrainte `@unique` du schéma Prisma.
+
+---
+
+## Méthode 1 — Via l'admin UI (recommandé, sans code)
+
+Depuis **Mai 2026**, les super admins peuvent configurer directement le token depuis la page `/clients` sans passer par un script.
+
+### Étapes
+
+1. Aller sur `/clients` dans l'admin
+2. Trouver l'organisation cible (affiche **"Configuration requise"**)
+3. Cliquer sur le bouton **"Configuration directe"** (visible uniquement pour les super admins)
+4. Dans le modal qui s'ouvre, remplir :
+   - **WABA ID** *(obligatoire)* — ex. `1503271284790621`
+   - **Token d'accès** *(obligatoire si le token n'est pas déjà stocké)* — coller le token `EAA...`
+   - **Phone Number ID** *(optionnel)* — laisser vide si le numéro n'est pas encore créé sur Meta
+   - **Meta Business ID** *(optionnel)*
+5. Cliquer **"Enregistrer la configuration"**
+
+> **Où trouver le WABA ID ?**  
+> [business.facebook.com/wa/manage/home](https://business.facebook.com/wa/manage/home) → Accounts → WhatsApp Accounts → l'ID numérique du compte
+
+> **Où trouver le token ?**  
+> Meta for Developers → ton App → WhatsApp → Configuration → Générer un token  
+> OU copier depuis une org existante via le script `scratch/list_orgs.ts` (voir Méthode 2)
+
+### Ce que ça fait en base
+
+L'appel `POST /v1/organizations/:id/whatsapp-setup` :
+- Chiffre et stocke le token dans `Organization.systemUserToken` (avec `ENCRYPTION_SECRET`)
+- Enregistre le `wabaId` sur l'organisation
+- Si `phoneNumberId` fourni : crée ou met à jour l'entrée `WhatsAppPhoneNumber` liée à l'org
+
+---
+
+## Méthode 2 — Via script Prisma (quand l'UI ne suffit pas)
+
+Utiliser cette méthode pour :
+- Copier le token d'une org existante vers une nouvelle (même `ENCRYPTION_SECRET` → copie directe)
+- Effectuer des opérations en masse
+- Déboguer en production sans déploiement
+
+### Pré-requis
+
+```bash
+# Les variables doivent être dans /Volumes/sms/Edtech/.env ou exportées
+DATABASE_URL=...
+ENCRYPTION_SECRET=...
+```
+
+### Étape 1 — Trouver les IDs des organisations
+
+```bash
+cd /Volumes/sms/Edtech/apps/api
+npx tsx scratch/list_orgs.ts
+```
+
+Sortie :
+```
+📋 Organisations disponibles :
+  - [12247ec1-...] test4 (slug: agro-sn, waba: non configuré)
+  - [ba012b65-...] testcrm (slug: test, waba: 1503271284790621)
+  - [default-org-id] XAMLÉ Global (slug: aucun, waba: 938685848818318)
+```
+
+### Étape 2 — Créer le script de configuration
+
+Créer `apps/api/scratch/connect_<nom_org>.ts` :
+
+```typescript
+import 'dotenv/config';
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+// IDs à remplir
+const NOUVELLE_ORG_ID = 'xxx-xxx-xxx';
+const SOURCE_ORG_ID   = 'ba012b65-2289-4ded-956d-aeaaf908fb30'; // org qui a le token
+const WABA_ID         = '1503271284790621';
+const PHONE_NUMBER_ID = '';   // laisser vide si pas encore de numéro
+const DISPLAY_PHONE   = '';
+
+async function main() {
+    // 1. Lire le token chiffré depuis l'org source
+    const source = await prisma.organization.findUnique({
+        where: { id: SOURCE_ORG_ID },
+        select: { systemUserToken: true }
+    });
+    if (!source?.systemUserToken) throw new Error('Org source sans token');
+
+    // 2. Si WABA_ID est déjà utilisé par une autre org, la libérer d'abord
+    // await prisma.organization.update({ where: { id: SOURCE_ORG_ID }, data: { wabaId: null } });
+
+    // 3. Configurer la nouvelle org
+    await prisma.organization.update({
+        where: { id: NOUVELLE_ORG_ID },
+        data: {
+            wabaId: WABA_ID,
+            systemUserToken: source.systemUserToken, // copie directe — même clé de chiffrement
+            systemUserTokenIssuedAt: new Date()
+        }
+    });
+    console.log('✅ Token et WABA ID configurés');
+
+    // 4. Associer un numéro (optionnel)
+    if (PHONE_NUMBER_ID) {
+        await prisma.whatsAppPhoneNumber.upsert({
+            where:  { id: PHONE_NUMBER_ID },
+            update: { displayPhone: DISPLAY_PHONE, organizationId: NOUVELLE_ORG_ID },
+            create: { id: PHONE_NUMBER_ID, displayPhone: DISPLAY_PHONE, organizationId: NOUVELLE_ORG_ID }
+        });
+        console.log('✅ Numéro associé :', DISPLAY_PHONE);
+    }
+
+    await prisma.$disconnect();
+}
+
+main().catch(console.error);
+```
+
+### Étape 3 — Exécuter
+
+```bash
+cd /Volumes/sms/Edtech/apps/api
+npx tsx scratch/connect_<nom_org>.ts
+```
+
+---
+
+## Contrainte wabaId : pourquoi et quand la retirer
+
+Le champ `Organization.wabaId` est `@unique` dans le schéma Prisma. Cela empêche deux orgs d'avoir le même WABA ID, ce qui est la règle aujourd'hui (1 org = 1 WABA = 1 numéro).
+
+**Si à l'avenir** tu veux plusieurs orgs sous le même compte WABA (ex. entreprise avec plusieurs départements, chacun avec son propre numéro WhatsApp) :
+
+1. Créer une migration Prisma qui retire `@unique` sur `wabaId` :
+   ```prisma
+   wabaId  String?  // supprimer @unique
+   ```
+2. Appliquer : `pnpm --filter @repo/database migrate:dev`
+3. Depuis lors, plusieurs orgs peuvent partager le même WABA ID
+
+---
+
+## Cas courants
+
+### Nouvelle org — même WABA qu'une org existante (numéros différents)
+→ Impossible actuellement sans retirer `@unique` (voir ci-dessus)
+
+### Nouvelle org — WABA différent, token fourni par le client
+→ Méthode 1 (admin UI) : remplir WABA ID + token dans le modal "Configuration directe"
+
+### Nouvelle org — pas encore de numéro, token à copier depuis testcrm
+→ Méthode 2 (script) avec `PHONE_NUMBER_ID` vide. L'org sera en "Configuration requise" jusqu'à l'ajout du numéro.
+
+### Transférer un numéro d'une org à une autre
+```typescript
+await prisma.whatsAppPhoneNumber.update({
+    where: { id: PHONE_NUMBER_ID },
+    data:  { organizationId: NOUVELLE_ORG_ID }
+});
+```
+
+---
+
+## Organisations actuelles en base (Mai 2026)
+
+| ID | Nom | WABA ID | Token | Numéro |
+|----|-----|---------|-------|--------|
+| `default-org-id` | XAMLÉ Global | `938685848818318` | ✅ `EAAURe...` | `969048009628694` |
+| `ba012b65-...` | testcrm | `1503271284790621` | ✅ | `+221788227676` |
+| `12247ec1-...` | test4 | null | ✅ (copié) | à configurer |
+| `136f72d9-...` | test | null | — | — |
+
+> Mettre ce tableau à jour après chaque onboarding.