Manuel Utilisateur — WhatSaaS

01 Présentation générale

WhatSaaS est une plateforme SaaS qui permet à des commerçants, prestataires et entreprises d'automatiser leurs échanges WhatsApp grâce à un chatbot IA (Groq/Gemini). Elle regroupe présence en ligne, assistant IA, campagnes marketing et facturation en un seul tableau de bord.

02 Connexion et accès

Créer un compte

1. Rendez-vous sur https://whatsaas.ci/register
2. Renseignez votre nom, email, mot de passe
3. Validez — vous êtes redirigé vers le tableau de bord

Se connecter

1. Allez sur https://whatsaas.ci/login
2. Entrez votre email et mot de passe
3. Cliquez Connexion → tableau de bord /ia/dashboard

03 Tableau de bord

Le tableau de bord (/ia/dashboard) est votre page d'accueil principale.

04 Connexion WhatsApp

4.1 Meta Cloud API

Utilisé si votre numéro est validé sur Facebook Business Manager.

1. Allez sur /iasettings → section "API Officielle Meta"
2. Renseignez le Phone Number ID (trouvable sur developers.facebook.com → WhatsApp → API Setup)
3. Renseignez le WABA ID (WhatsApp Business Account ID)
4. Collez l'Access Token permanent depuis Meta for Developers
5. Cliquez Enregistrer

4.2 QR Code (WhatsApp Web)

Pour les numéros WhatsApp non officiels (personnel ou Business simple).

1. Tableau de bord → cliquez "Scanner le QR Code"
2. Ouvrez WhatsApp sur votre téléphone
3. Paramètres → Appareils liés → Lier un appareil
4. Scannez le QR code affiché — statut passe à Connecté ✅

4.3 Connexion via lien public (API Key)

Pour les intégrations avancées, une page QR est accessible sans connexion admin :

https://whatsaas.ci/public/whatsapp/connect/{votre_api_key}

05 Gestion des produits

Accès : /ia/products ou menu Produits.

Ajouter un produit

1. Cliquez "+ Nouveau produit"
2. Renseignez : Nom, Prix (FCFA), Stock, Description, Image
3. Cliquez Enregistrer

06 Configuration de l'IA

Accès : /iasettings

Prompt personnalisé

Donnez une identité à votre bot en renseignant le champ "Prompt personnalisé" :

Tu es l'assistant de "Mon Entreprise CI", basée à Abidjan.
Tu présentes nos produits / services, réponds aux questions et prends les demandes.
Ton ton est professionnel mais chaleureux.
Horaires : Lundi-Vendredi 8h-18h, Samedi 9h-15h.
Paiement : Orange Money, Wave, MTN.

Numéro du gérant

Format : 22507XXXXXXXX (indicatif pays + numéro sans le 0 initial). Reçoit une notification WhatsApp à chaque nouvelle commande.

07 Commandes reçues

Accès : /ia/orders

08 Conversations clients

Accès : /ia/conversations — historique complet de tous les échanges traités par le bot.

Vue Kanban disponible sur /ia/kanban : Intéressés → En cours de commande → Commande passée.

09 Notifications gérant

Dès qu'un client finalise sa commande (nom + téléphone + adresse), le gérant reçoit :

🔔 Nouvelle Commande #12

👤 Client: Coulibaly Cheick
📞 Tél: 22507XXXXXXXX
💰 Total: 150 000 FCFA

Produits:
• 1x Nom du produit

10 Contacts WhatsApp

Accès : /whatsapp-contacts

Ajouter manuellement

Cliquez "Nouveau contact" → renseignez nom (optionnel) + numéro format international sans + (ex: 2250700000000).

Importer en masse

Fichier Excel .xlsx ou CSV avec colonnes telephone et nom. Les doublons sont automatiquement ignorés.

nom,telephone
Kouadio Jean,2250701234567
Diallo Fatou,2250709876543

11 Groupes WhatsApp

Accès : /whatsapp-groups — segmentez vos contacts pour cibler vos campagnes avec précision.

Créer un groupe

1. Cliquez "Nouveau groupe"
2. Donnez un nom (ex: "Clients VIP", "Zone Cocody")
3. Cliquez "Créer"

Ajouter des membres

1. Cliquez l'icône ✏️ Gérer sur le groupe
2. Recherchez et cochez les contacts à ajouter
3. Cliquez "Ajouter les membres sélectionnés"

12 Campagnes de diffusion (Broadcast)

Accès : /whatsapp-broadcast

12.1 Créer une campagne

12.2 Médias acceptés

13 Facturation & Crédits

Accès : /billing

13.1 Comprendre les crédits

13.2 Plans & tarification

13.3 Recharger son solde (Mobile Money)

1. Page /billing → cliquez "Recharger par Mobile Money"
2. Entrez le montant (minimum 500 XOF)
3. Redirigé vers PayDunya (Orange Money, Wave, MTN, Moov…)
4. Après confirmation → crédits ajoutés instantanément

13.4 Historique des transactions

14 API REST — Intégration développeur

Documentation complète : https://whatsaas.ci/developer

Authentification

X-API-KEY: votre_clé_api

Endpoints principaux

Exemple cURL

curl -X POST https://whatsaas.ci/api/v1/send-message \
  -H "X-API-KEY: votre_clé_api" \
  -H "Content-Type: application/json" \
  -d '{"phone": "2250700000000", "message": "Bonjour !"}'

15 Flux de vente — côté client

Client → "Bonjour"
Bot   → "Bonjour ! 👋 Comment puis-je vous aider ?"
         [📋 Catalogue] [🛒 Commander] [❓ Aide]

Client → clique "Catalogue"
Bot   → envoie chaque produit avec photo, prix, stock

Client → "Commander ✅"
Bot   → "Votre nom complet ?"
Client → "Coulibaly Cheick"
Bot   → "Votre téléphone ?"
Client → "0701020304"
Bot   → "Adresse de livraison ?"
Client → "Angré"
Bot   → "✅ Commande #12 enregistrée !"

Gérant reçoit immédiatement → 🔔 Nouvelle Commande #12

16 FAQ & Résolution de problèmes

Le bot ne répond pas

• Vérifiez le statut sur le tableau de bord
• QR Code → rescannez depuis /ia/dashboard
• Meta API → vérifiez que l'Access Token n'a pas expiré

Mon solde est à 0 XOF

• Visitez /billing — les crédits mensuels sont appliqués à la première visite du mois
• Si toujours 0, rechargez via Mobile Money ou contactez le support

Des transactions en double dans l'historique

• Phénomène lié à un cache effacé lors d'un déploiement
• Corrigé automatiquement depuis la v3.0
• Contactez le support pour un ajustement manuel si besoin

Mon appel API retourne 403

• Vérifiez que votre plan inclut l'accès API (WhatsApp Docs ou Entreprise Plus)
• Vérifiez le header X-API-KEY

La campagne planifiée ne s'est pas envoyée

• Le déclenchement automatique se fait à la minute près via le cron serveur
• Vous pouvez toujours lancer manuellement depuis la page détail de la campagne