Guide d'Activation Agent IA

🚀 Configuration Initiale (à faire 1 seule fois)

1. Récupérer tes identifiants Meta WhatsApp Business

1. Va sur https://business.facebook.com
2. Sélectionne ton Business Manager
3. Va dans WhatsApp Business Platform
4. Récupère ces 3 informations :
   • Business Account ID (wa_business_account_id)
   • Phone Number ID (wa_phone_id)
   • Access Token (access_token - créé dans les paramètres API)

📝 Note ces valeurs quelque part, tu en auras besoin pour chaque activation.

2. Créer la table des demandes

Dans Supabase SQL Editor, exécute :

supabase/migrations/create_agent_activation_requests.sql

---

👥 Processus d'Activation d'un Utilisateur

Étape 1 : L'utilisateur demande l'activation

1. L'utilisateur va dans Agent IA → Configurer WhatsApp
2. Il clique sur "Demander l'activation"
3. Sa demande est enregistrée dans agent_activation_requests avec status = 'pending'

Étape 2 : Tu vois la demande

Dans Supabase, tu peux voir les demandes :

SELECT user_id, user_email, created_at, status
FROM agent_activation_requests
WHERE status = 'pending'
ORDER BY created_at DESC;

Étape 3 : Tu actives l'utilisateur

Option A - Utiliser le script SQL (recommandé)

1. Ouvre supabase/activate_user_simple.sql
2. Remplace ces valeurs :
   • <USER_ID_ICI> par le user_id de la demande
   • TON_WA_BUSINESS_ACCOUNT_ID par ton Business Account ID
   • TON_WA_PHONE_ID par ton Phone Number ID
   • TON_ACCESS_TOKEN par ton Access Token
   • +33XXXXXXXXX par ton numéro WhatsApp
3. Exécute le script dans Supabase SQL Editor

Option B - Activation manuelle

Copie-colle ce template et remplace les valeurs :

-- Activer l'utilisateur
INSERT INTO vendor_whatsapp_config (
  user_id,
  wa_business_account_id,
  wa_phone_id,
  access_token,
  phone_number,
  is_active
) VALUES (
  'USER_ID_DE_LA_DEMANDE',
  'TON_WA_BUSINESS_ACCOUNT_ID',
  'TON_WA_PHONE_ID',
  'TON_ACCESS_TOKEN',
  '+33XXXXXXXXX',
  true
);

-- Marquer la demande comme approuvée
UPDATE agent_activation_requests
SET status = 'approved', updated_at = NOW()
WHERE user_id = 'USER_ID_DE_LA_DEMANDE';

Étape 4 : L'utilisateur voit l'activation

L'utilisateur retourne dans Agent IA → Configurer WhatsApp et voit :

• ✅ WhatsApp connecté !
• Son numéro WhatsApp Business
• Message : "Votre Agent IA est actif et prêt à recevoir des messages"

---

📊 Gestion des Activations

Voir tous les utilisateurs activés

SELECT
  u.email,
  v.phone_number,
  v.is_active,
  v.created_at as activated_at
FROM vendor_whatsapp_config v
JOIN auth.users u ON u.id = v.user_id
WHERE v.is_active = true
ORDER BY v.created_at DESC;

Désactiver un utilisateur

UPDATE vendor_whatsapp_config
SET is_active = false
WHERE user_id = 'USER_ID';

UPDATE agent_activation_requests
SET status = 'rejected', notes = 'Désactivé'
WHERE user_id = 'USER_ID';

---

❓ FAQ

Pourquoi tous les utilisateurs utilisent le même numéro ?

Pour le MVP, tous les utilisateurs partagent ton numéro WhatsApp Business. L'agent IA sait à quel utilisateur appartient chaque conversation grâce au mapping dans vendor_whatsapp_config.

Puis-je activer plusieurs utilisateurs en masse ?

Oui, décommente la section "Activer TOUS" dans activate_agent_user.sql.

Comment tester l'activation ?

1. Active ton propre compte
2. Envoie un message à ton numéro WhatsApp Business
3. Vérifie que la conversation apparaît dans l'app mobile

---

🔧 Troubleshooting

L'utilisateur ne voit pas "WhatsApp connecté"

Vérifie que :

• La ligne existe dans vendor_whatsapp_config avec is_active = true
• Le user_id correspond bien
• L'utilisateur a relancé l'app

Les messages n'arrivent pas

Vérifie que :

• Le webhook Meta est bien configuré (voir kazalendar-agent-api)
• Le token d'accès Meta est valide
• Le wa_phone_id est correct