Documentation

Mettre en place votre agent IA

De la création du compte à l'intégration par API : tout ce qu'il faut pour être opérationnel.

1. Démarrer en 10 minutes

  1. Créez votre compte. L'essai gratuit dure 7 jours et comprend 50 messages.
  2. Personnalisez l'agent : donnez-lui un nom et décrivez votre activité, votre ton et vos règles.
  3. Remplissez ses connaissances : une fiche par sujet (horaires, adresse, livraison, retours, moyens de paiement). L'agent ne répond que d'après ces fiches : il n'invente rien.
  4. Ajoutez vos produits et commandes en CSV (plans Pro et Business) : colonnes nom;description;prix;stock et reference;telephone;statut;montant.
  5. Installez l'agent sur votre site ou sur WhatsApp.
  6. Suivez l'activité : contacts à rappeler, tickets et conversations.

Astuce : relisez les conversations de la première semaine et complétez les fiches pour chaque question restée sans réponse.

2. Installer l'agent sur votre site

Copiez le code d'installation depuis votre tableau de bord et collez-le juste avant la balise </body> de votre site (WordPress, Wix, site sur mesure…). Une bulle de chat apparaît en bas à droite.

3. Répondre sur WhatsApp (plans Pro et Business)

  1. Sur developers.facebook.com, créez une application « Business » et ajoutez le produit WhatsApp.
  2. Relevez le Phone Number ID, un jeton d'accès permanent et le secret de l'application.
  3. Saisissez-les dans la section WhatsApp de votre tableau de bord.
  4. Dans Meta (WhatsApp > Configuration > Webhook), collez l'URL de rappel et le jeton de vérification affichés dans votre tableau de bord.
  5. Envoyez un message à votre numéro pour tester.

Les frais de conversation WhatsApp sont facturés par Meta. Pour écrire à tout le monde, votre compte Meta doit être vérifié.

4. L'API (plans Pro et Business)

L'API relie l'agent à votre logiciel : mise à jour automatique des produits et commandes, récupération des contacts, ou discussion avec l'agent depuis votre propre application.

Authentification

Créez votre clé dans le tableau de bord (cmt_…). Elle n'est affichée qu'une seule fois : conservez-la en lieu sûr. Chaque requête l'envoie dans l'en-tête Authorization: Bearer cmt_votre_cle (ou X-API-Key). Les réponses sont en JSON.

Routes

RouteRôle
GET ?r=usageMessages utilisés, quota, fin d'abonnement
POST ?r=messageDiscuter avec l'agent
POST ?r=produitsAjouter ou mettre à jour jusqu'à 1000 produits
POST ?r=commandesAjouter ou mettre à jour jusqu'à 1000 commandes
POST ?r=connaissancesAjouter une fiche de connaissance
GET ?r=leadsContacts collectés (&statut=nouveau)
GET ?r=ticketsTickets (&statut=a_traiter)

Exemples

Discuter avec l'agent

Le session_id identifie la conversation de votre client : gardez-le identique pour qu'il se souvienne du fil.

curl -X POST "https://admin.cometedigital.com/ia/api.php?r=message" \
  -H "Authorization: Bearer cmt_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"session_id":"client-42","message":"Quels sont vos horaires ?"}'
Mettre à jour le catalogue
curl -X POST "https://admin.cometedigital.com/ia/api.php?r=produits" \
  -H "Authorization: Bearer cmt_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"produits":[{"nom":"Sac à main cuir","description":"Cuir noir","prix":25000,"stock":4}]}'
Mettre à jour le statut des commandes
curl -X POST "https://admin.cometedigital.com/ia/api.php?r=commandes" \
  -H "Authorization: Bearer cmt_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"commandes":[{"reference":"CMD-1001","telephone":"2250700112233","statut":"En livraison","montant":25000}]}'
Récupérer les nouveaux contacts
curl "https://admin.cometedigital.com/ia/api.php?r=leads&statut=nouveau" \
  -H "Authorization: Bearer cmt_votre_cle"

Appelez toujours l'API depuis votre serveur : ne placez jamais votre clé dans une page web ou une application publique.

Codes de réponse

200 succès · 201 créé · 400 requête invalide · 401 clé invalide ou abonnement expiré · 403 plan insuffisant · 429 trop de requêtes

5. Abonnement et factures

  1. Dans le tableau de bord, choisissez un plan et indiquez votre numéro Mobile Money.
  2. Validez la demande de paiement qui arrive sur votre téléphone.
  3. L'abonnement est prolongé de 30 jours automatiquement et votre facture est créée : retrouvez-la dans « Mes factures ».

À l'expiration, l'agent se met en pause (site, WhatsApp et API) jusqu'au prochain paiement. Vos données sont conservées.

Besoin d'aide pour l'installation ? Nous configurons votre agent avec vous.

Nous contacter Voir les tarifs