Guide documentation ChatDirect : de l'installation à l'API

Ce guide couvre tout ce que vous devez savoir pour installer, configurer et tirer le maximum de votre chatbot d'IA conversationnelle ChatDirect. De la première ligne de code à l'API REST avancée, suivez chaque étape à votre rythme.

Installation du widget : une seule ligne de code

L'installation de ChatDirect sur votre site web est d'une simplicité remarquable. Il suffit d'ajouter une seule ligne de code JavaScript avant la fermeture de la balise </body> :

<script src="https://chatdirect.ca/widget.js?client=VOTRE_ID&v=38"></script>

Remplacez VOTRE_ID par l'identifiant de votre client (fourni lors de l'inscription). Le widget se charge automatiquement et affiche le bouton de chat en bas à droite de votre page.

Options d'installation

• HTML statique — collez le script directement dans votre HTML
• WordPress — utilisez le plugin ChatDirect officiel (Settings API, shortcode)
• Shopify, Wix, Squarespace — ajoutez le script dans la section « Code personnalisé » ou « Code injection »
• React, Vue, Angular — ajoutez le script dans votre composant principal ou dans index.html

Configuration du prompt système

Le prompt système est le cœur de votre chatbot. C'est l'instruction qui définit la personnalité, le ton et le comportement de votre IA conversationnelle. Accédez-y via le portail client → Configuration → onglet IA.

Conseils pour un prompt efficace :

• Définissez clairement le rôle du bot (« Tu es l'assistant de [entreprise] »)
• Précisez le ton (professionnel, amical, formel, décontracté)
• Listez les sujets que le bot doit couvrir
• Indiquez quand le bot doit transférer vers un humain
• Ajoutez des exemples de réponses types

Base de connaissances personnalisée

La base de connaissances est le savoir de votre chatbot. C'est un fichier texte (jusqu'à 100 Ko) qui contient toutes les informations que le bot doit connaître : FAQ, tarifs, horaires, services, processus, politiques.

L'éditeur de base de connaissances dans le panneau admin permet de structurer l'information par sections. Plus la base est complète et bien organisée, plus les réponses de l'IA conversationnelle sont précises et pertinentes. Consultez notre guide complet du chatbot IA pour PME pour approfondir ce sujet.

Personnalisation de l'apparence

ChatDirect offre une personnalisation visuelle complète dans l'onglet Apparence du portail :

• Couleurs — couleur principale, couleur de fond, couleur du texte
• Position — bas gauche ou bas droite
• Nom et avatar du bot
• Message de bienvenue personnalisé
• Thème — 4 thèmes widget (light, dark, auto, blue)
• Logo dans le header du chat

Configuration du CRM

Le mini-CRM de ChatDirect se configure principalement dans l'onglet Conversations et Intégrations :

• Questions de qualification — définissez les questions séquentielles pour qualifier vos leads
• Webhooks CRM — connectez HubSpot, Pipedrive, Monday.com ou un webhook personnalisé
• Relances — configurez les 3 étapes de relance avec délais et templates
• Notifications — activez les alertes Slack, WhatsApp ou Messenger

Le pipeline kanban, le scoring et les rappels fonctionnent automatiquement dès que des leads sont capturés par l'IA conversationnelle. Apprenez-en plus sur les avantages du CRM intégré.

API REST pour développeurs

Les plans Business et Enterprise incluent l'accès à l'API REST publique de ChatDirect. Consultez le top 10 des fonctionnalités pour une vue d'ensemble complète. Authentifiée par clé API, elle permet d'interagir programmatiquement avec vos données :

Endpoint	Méthode	Description
/api/v1/leads	GET	Liste des leads avec filtres
/api/v1/conversations	GET	Liste des conversations
/api/v1/conversation	GET	Détail d'une conversation
/api/v1/stats	GET	Statistiques et analytics
/api/v1/webhook-test	GET	Test des webhooks configurés

Rate limit : 100 requêtes par heure. Documentation complète disponible dans le panneau admin → API Docs.

Plugin WordPress

Le plugin WordPress officiel de ChatDirect simplifie l'installation pour les sites WordPress (compatible WP 7.0). Il offre :

• Configuration via Settings API (pas besoin de toucher au code)
• Shortcode [chatdirect] pour intégrer le widget sur des pages spécifiques
• Chargement conditionnel (uniquement sur les pages où le shortcode est présent)
• Compatibilité avec les principaux constructeurs de pages

Conclusion

Découvrez tous les secteurs d'activité qui bénéficient de ChatDirect. ChatDirect a été conçu pour être simple à installer mais puissant à utiliser. Que vous soyez un entrepreneur non technique qui veut un chatbot d'IA conversationnelle opérationnel en 30 minutes, ou un développeur qui veut intégrer l'API dans son application, ChatDirect s'adapte à votre niveau d'expertise.