Créer son premier agent IA avec Heeya : tutoriel pas-à-pas (10 min)

Étape 1 : Créer son compte sur Heeya

Rendez-vous sur heeya.fr/register pour créer votre compte gratuitement. L'inscription prend moins d'une minute : email, mot de passe, et vous êtes directement redirigé vers votre tableau de bord. Aucune carte bancaire requise pour démarrer.

Le plan gratuit vous permet de créer un premier agent et de tester l'ensemble des fonctionnalités — RAG, outils, intégration web. Les limites de quota selon les plans sont détaillées sur la page tarifs si vous souhaitez comparer avant de commencer.

Étape 2 : Créer son premier assistant IA

Depuis votre tableau de bord (URL : /dashboard), vous verrez en haut de la page une carte à bordure pointillée avec le bouton "Créer un assistant". Cliquez dessus — une fenêtre modale s'ouvre avec trois champs à remplir.

Les trois champs du formulaire de création

1. Nom de l'assistant (obligatoire)

Choisissez un nom clair et descriptif. Ce nom s'affiche dans votre tableau de bord et, si vous le configurez, dans le widget sur votre site. Exemples : "Assistant FAQ", "Support Client", "Conseiller Produits", "RH Bot".

2. Description (optionnel)

Ce champ vous aide à retrouver l'agent dans votre tableau de bord si vous en gérez plusieurs. Inutile de le soigner pour le fonctionnement de l'agent — c'est une note interne. Exemple : "FAQ e-commerce — retours, livraisons, produits".

3. Instructions pour l'IA (obligatoire — c'est le prompt système)

C'est le champ le plus important. Ces instructions définissent le comportement, le ton, le périmètre et les règles de votre agent. L'IA les lit avant chaque conversation. Un prompt système bien écrit transforme un LLM générique en un expert de votre domaine. Pour approfondir ce sujet, notre guide complet sur le prompt engineering couvre les techniques avancées.

3 templates de prompts système copiables

Voici trois templates prêts à l'emploi, adaptés aux cas d'usage les plus fréquents. Copiez le template le plus proche de votre besoin, puis personnalisez les zones entre crochets.

Template 1 — Service client e-commerce

Tu es l'assistant IA de [Nom de la boutique], une boutique en ligne spécialisée dans [catégorie de produits].

Ton rôle :
- Répondre aux questions sur les produits, les tailles, les matières et les délais de livraison
- Accompagner les clients dans leurs demandes de retour et d'échange (délai : 30 jours)
- Expliquer les modalités de paiement et les promotions en cours

Ton comportement :
- Tu es chaleureux, concis et professionnel
- Tu réponds uniquement sur la base des informations disponibles dans ta base de connaissances
- Si tu ne sais pas, tu le dis clairement et tu proposes de mettre le client en contact avec l'équipe

Périmètre :
- Ne discute pas de sujets sans rapport avec la boutique
- Ne donne jamais de prix sans avoir vérifié dans ta base de connaissances
- Si le client exprime le besoin d'être rappelé ou d'un devis personnalisé, propose-lui le formulaire de contact

Template 2 — FAQ entreprise / RH

Tu es l'assistant RH interne de [Nom de l'entreprise]. Tu aides les collaborateurs à trouver rapidement les réponses à leurs questions RH du quotidien.

Sujets que tu couvres :
- Congés et absences (procédures, délais de demande, soldes)
- Paie et notes de frais (dates de virement, formulaires à utiliser)
- Avantages salariés (mutuelle, tickets restaurant, télétravail)
- Formations et montée en compétences

Ton comportement :
- Tu réponds de façon précise et directe
- Tu cites la politique ou le document interne concerné quand c'est pertinent
- Si la question dépasse ton périmètre ou nécessite une décision RH, tu renvoies vers le bon interlocuteur

Limites :
- Ne traite pas les questions individuelles sensibles (disciplinaire, licenciement)
- Ne donne pas d'avis juridique — renvoie vers le service juridique ou la DRH dans ces cas

Template 3 — Conseil produit / recommandation

Tu es le conseiller produit IA de [Nom de l'entreprise]. Ton rôle est d'aider les visiteurs à trouver le produit ou la solution qui correspond précisément à leur besoin.

Ta méthode :
1. Comprends le besoin du client en posant 1 à 2 questions de qualification si nécessaire
2. Recommande 1 à 3 options en expliquant pourquoi elles correspondent au besoin exprimé
3. Mets en avant les avantages différenciants de chaque option
4. Si le client hésite, propose-lui d'être mis en contact avec un expert humain via le formulaire

Ton ton :
- Expert mais accessible — tu vulgarises sans être condescendant
- Tu ne survends pas : si un produit moins cher répond au besoin, tu le dis
- Tu es honnête sur les limites d'une solution

Informations disponibles :
- Catalogue produits complet dans ta base de connaissances
- Fiches techniques, comparatifs, cas d'usage clients

Une fois vos trois champs remplis, cliquez sur "Créer". L'agent est créé instantanément avec une collection vectorielle dédiée dans Qdrant — la base technique qui permettra la recherche sémantique dans vos documents. Vous êtes automatiquement redirigé vers la page de configuration de votre agent.

Étape 3 : Alimenter la base de connaissances RAG

Sans base de connaissances, votre agent répond uniquement à partir de ses connaissances générales — ce qui peut être utile, mais souvent insuffisant pour un usage professionnel. Alimenter le RAG, c'est donner à votre agent l'accès à votre contenu spécifique : documentation produit, conditions générales, politique de retour, guide employé, catalogue, etc.

Dans la page de votre agent, cliquez sur l'onglet "Fichiers".

Quels formats de fichiers sont acceptés ?

• PDF : le format le plus courant. Compatible avec tous les types de documents — plaquettes, contrats, guides, catalogues.
• DOCX : fichiers Word. Idéal pour les procédures internes, les chartes, les politiques RH.
• PPTX : présentations PowerPoint. Le contenu des slides est extrait et indexé.
• TXT : fichiers texte brut. Parfait pour les FAQ déjà rédigées, les scripts d'appel, les listes de produits.

Bonnes pratiques pour organiser vos documents

La qualité de la base de connaissances détermine directement la qualité des réponses de votre agent. Quelques règles à respecter avant d'uploader :

• Privilégiez les documents thématiques : un fichier = un sujet. Un PDF "politique de retour" vaut mieux qu'un PDF "conditions générales + retours + livraison + mentions légales" mélangés.
• Utilisez des titres et sous-titres explicites dans vos documents. Le découpage en chunks (morceaux) s'appuie sur la structure — des titres clairs produisent des chunks plus cohérents.
• Évitez les documents scannés non OCR : un PDF image sans couche texte ne peut pas être lu par le système. Vérifiez que votre PDF contient du texte sélectionnable.
• Retirez les pages inutiles : pages de garde vides, mentions légales génériques, tables des matières de 3 pages — elles consomment des tokens sans apporter de valeur.
• Mettez à jour les documents plutôt que d'en accumuler : si votre catalogue a évolué, supprimez l'ancienne version avant d'uploader la nouvelle.

Le scraping web : quand l'utiliser ?

L'onglet "Fichiers" propose également une option de scraping d'URLs web. Au lieu d'uploader un document, vous entrez une URL et Heeya extrait automatiquement le contenu de la page pour l'indexer.

Utilisez le scraping quand :

• Votre contenu de référence est déjà en ligne et maintenu (pages produits, FAQ publique, documentation en ligne)
• Vous ne souhaitez pas gérer des exports de fichiers à chaque mise à jour
• Votre site est public et accessible sans authentification

Évitez le scraping quand le contenu est derrière un login, quand les pages sont très dynamiques (SPA sans HTML statique), ou quand votre site est protégé par un captcha. Dans ces cas, exportez vos contenus en PDF ou TXT.

Exemple : 5 documents à uploader pour un agent e-commerce

1. catalogue-produits.pdf — Liste complète des produits avec descriptions, références, prix et disponibilité
2. politique-retours-echanges.pdf — Procédure de retour, délais, conditions d'éligibilité, remboursement
3. faq-livraison.txt — Délais selon les transporteurs, zones couvertes, suivi de commande, que faire en cas de colis perdu
4. guide-tailles-matieres.pdf — Tableau des tailles, guide d'entretien, composition des matières
5. promotions-en-cours.txt — Codes promo actifs, conditions, date d'expiration

Pour comprendre les mécanismes de découpage et d'indexation qui se déroulent en arrière-plan, notre article sur l'expertise RAG de Heeya détaille l'architecture technique.

Étape 4 : Tester son agent dans l'onglet Conversations

Avant d'intégrer votre agent sur votre site, testez-le intensivement. L'onglet "Conversations" vous donne accès à une interface de chat directe avec votre agent — exactement ce que verront vos utilisateurs finaux.

Comment écrire de bonnes questions de test

Ne testez pas avec des questions trop faciles ou trop génériques. Simulez les vraies questions que vos visiteurs poseront :

• Questions de fond : "Est-ce que vous livrez en Belgique ?" / "Quelle est la composition du modèle XP-200 ?" / "Combien de temps pour rembourser un retour ?"
• Questions ambiguës : "Votre retour c'est comment ?" / "C'est livré quand ?" — vérifiez que l'agent demande des précisions plutôt que d'inventer.
• Questions hors périmètre : "Donnez-moi la météo de Paris" / "Traduis ce texte en anglais" — vérifiez que l'agent décline poliment et reste dans son rôle.
• Questions sur des informations manquantes : posez une question sur un sujet que vous n'avez pas indexé — l'agent doit dire qu'il ne sait pas, pas inventer.

Comment évaluer la qualité des réponses

Pour chaque réponse, évaluez trois critères :

• Pertinence : la réponse répond-elle à la question posée, sans digressions inutiles ?
• Fidélité aux sources : l'information donnée est-elle présente dans vos documents ? L'agent ne doit pas compléter avec des informations inventées.
• Ton : le style de la réponse correspond-il au prompt système ? Un agent configuré "chaleureux et concis" ne doit pas répondre de façon froide et longue.

Itérer sur le prompt système si nécessaire

Si les réponses ne correspondent pas à vos attentes, retournez dans les paramètres de l'agent pour modifier les instructions. Les ajustements les plus fréquents :

• L'agent est trop verbeux : ajoutez "Tes réponses ne dépassent pas 3 à 4 phrases, sauf si l'utilisateur demande plus de détails."
• L'agent invente des informations : ajoutez "Tu réponds UNIQUEMENT sur la base des documents disponibles dans ta base de connaissances. Si l'information n'est pas disponible, dis-le clairement."
• L'agent dérive hors sujet : précisez les sujets exclus dans votre prompt — "Ne réponds à aucune question hors du périmètre [X]."
• Le ton ne convient pas : décrivez précisément ce que vous attendez — "Tu tutoies l'utilisateur" / "Tu utilises des listes à puces pour les réponses avec plusieurs éléments."

Comptez 3 à 5 cycles de test-ajustement pour un agent bien calibré. C'est un investissement qui se rentabilise rapidement. Pour des techniques avancées de rédaction d'instructions, consultez notre guide du prompt engineering pour chatbots.

Étape 5 : Configurer les outils

L'onglet "Outils" permet d'activer des fonctionnalités complémentaires qui étendent les capacités de votre agent au-delà des simples réponses textuelles.

Le formulaire de contact — capture de leads intégrée

Lorsqu'un utilisateur exprime le souhait d'être contacté, rappelé ou d'obtenir un devis, l'agent peut déclencher automatiquement un formulaire de contact. C'est l'outil le plus puissant pour transformer votre chatbot en générateur de leads.

Pour l'activer : dans l'onglet "Outils", activez le formulaire de contact. Vous pouvez configurer les champs à collecter — nom, email, téléphone, message — selon vos besoins.

Une fois activé, l'agent détecte automatiquement les signaux d'intention de contact dans la conversation ("je voudrais être rappelé", "pouvez-vous me faire une offre ?", "j'aimerais parler à quelqu'un") et propose le formulaire au bon moment — sans intervention manuelle de votre part.

Pour aller plus loin sur la logique de capture et de qualification des leads par chatbot, notre article sur la génération de leads avec un chatbot IA détaille les meilleures pratiques.

Tester le déclenchement du formulaire

Dans l'onglet "Conversations", testez des formulations qui doivent déclencher le formulaire :

• "Je voudrais être contacté par votre équipe."
• "Est-ce que quelqu'un peut me rappeler ?"
• "J'aimerais avoir un devis personnalisé."

Vérifiez que le formulaire s'affiche dans ces cas, et qu'il ne s'affiche pas sur des questions informatives simples ("Quels sont vos délais de livraison ?"). Si le déclenchement est trop fréquent ou pas assez, ajustez le prompt système en précisant les conditions de déclenchement.

Note sur les plans et les limites

Certaines fonctionnalités avancées dépendent de votre plan. Le plan gratuit vous permet de tester l'ensemble des outils, mais avec un quota de messages limité. Les détails exacts des limites par plan sont disponibles sur la page tarifs. Il n'est pas nécessaire d'upgrader pour créer votre premier agent et valider le concept.

Étape 6 : Intégrer l'agent sur son site

Votre agent est configuré et testé. Il est temps de le déployer. Allez dans l'onglet "Connecter" de votre agent.

Récupérer le code d'intégration

Vous y trouverez un snippet JavaScript prêt à l'emploi. Il ressemble à ceci :

<script
  async
  src="https://heeya.fr/agent/{votre-agent-uuid}/embed.js"
  data-agent-name="Nom de votre assistant"
  data-position="bottom-right"
  data-color="#0d9488"
  data-text="Comment puis-je vous aider ?"
></script>

Les options de personnalisation disponibles

• data-agent-name : le nom affiché dans le widget sur votre site
• data-position : position du widget — bottom-right ou bottom-left
• data-color : couleur principale du widget au format hexadécimal — adaptez à votre charte graphique
• data-text : message d'accueil affiché dans la bulle avant que l'utilisateur ouvre le chat

Intégration sur un site HTML standard

Collez le snippet juste avant la balise de fermeture </body> de votre page. Le widget se chargera de façon asynchrone sans bloquer le rendu de votre page.

Intégration sur WordPress

Plusieurs méthodes sont possibles sur WordPress :

• Via le thème : ajoutez le snippet dans le fichier footer.php de votre thème, juste avant </body>.
• Via une extension : utilisez une extension de type "Insert Headers and Footers" (ex: WPCode) pour coller le script sans toucher au code du thème.

Intégration sur Shopify

Dans votre back-office Shopify, allez dans Boutique en ligne → Thèmes → Actions → Modifier le code. Ouvrez le fichier theme.liquid et collez le snippet juste avant </body>. Sauvegardez — le widget est actif sur toutes les pages de votre boutique.

Notre guide complet sur l'intégration d'un chatbot IA sur WordPress, Shopify et Wix couvre chaque plateforme en détail avec des captures d'écran.

Étape 7 : Suivre la performance via Analytics

Une fois votre agent en production, l'onglet "Analytics" vous donne une vue d'ensemble de l'activité : nombre de conversations, messages échangés, répartition dans le temps.

Que surveiller en priorité ?

• Volume de conversations : combien d'utilisateurs lancent une conversation ? Un volume faible peut indiquer un problème de visibilité du widget (position, couleur, message d'accueil peu engageant).
• Profondeur des conversations : combien d'échanges par session en moyenne ? Une profondeur faible peut signaler que les premières réponses ne satisfont pas les utilisateurs.
• Questions récurrentes sans réponse satisfaisante : relisez les conversations. Si un même type de question revient souvent et que l'agent répond mal, c'est un signal pour enrichir votre base de connaissances sur ce sujet précis.
• Déclenchements du formulaire de contact : combien de fois le formulaire est-il soumis ? C'est votre indicateur de conversion direct.

Utiliser les conversations pour améliorer l'agent

Les conversations réelles sont la meilleure source d'amélioration. Passez 15 minutes par semaine à lire les échanges les plus récents. Vous identifierez rapidement :

• Des lacunes dans la base de connaissances (questions auxquelles l'agent ne peut pas répondre faute de documents)
• Des formulations du prompt système à affiner (l'agent est trop formel, pas assez précis)
• Des nouveaux besoins utilisateurs à adresser (sujets non couverts qui reviennent fréquemment)

Pour aller plus loin sur les indicateurs à suivre, notre article sur les KPI d'un chatbot IA détaille les métriques clés et comment les interpréter.

Erreurs courantes et comment les éviter

Erreur 1 — Un prompt système trop vague

Symptôme : l'agent répond de façon générique, change de ton d'une réponse à l'autre, ou sort de son périmètre.
Solution : soyez explicite sur le rôle, le ton, les sujets couverts, et surtout les limites. "Tu es un assistant service client" n'est pas un prompt système — c'est un titre. Décrivez les comportements attendus avec des exemples concrets.

Erreur 2 — Uploader des documents trop volumineux et peu structurés

Symptôme : l'agent peine à retrouver des informations précises dans un long document, les réponses sont imprécises.
Solution : découpez vos documents par thème. Un fichier de 200 pages mélangé vaut moins que cinq fichiers de 40 pages bien ciblés. La structure interne (titres, sections) du document facilite également le découpage en chunks.

Erreur 3 — Ne pas tester avec des questions difficiles

Symptôme : l'agent semble fonctionner lors des tests, mais déçoit les vrais utilisateurs.
Solution : testez systématiquement avec des questions ambiguës, hors périmètre, ou portant sur des informations absentes de la base. Un agent robuste sait dire "je ne sais pas" sans inventer.

Erreur 4 — Ignorer les Analytics après le lancement

Symptôme : l'agent stagne en qualité malgré une utilisation croissante.
Solution : planifiez un rendez-vous hebdomadaire de 15 minutes pour relire les conversations récentes et identifier les améliorations à apporter. Un agent s'améliore en continu, pas seulement au lancement.

Erreur 5 — Activer le formulaire de contact sans condition

Symptôme : le formulaire se déclenche trop souvent, même pour des questions simples, ce qui frustre les utilisateurs.
Solution : dans votre prompt système, précisez explicitement les signaux qui doivent déclencher le formulaire. Exemples : "Propose le formulaire uniquement quand l'utilisateur exprime explicitement le souhait d'être contacté par un humain ou de recevoir un devis personnalisé."

Erreur 6 — Copier-coller un prompt générique trouvé en ligne

Symptôme : l'agent a un comportement impersonnel, sans cohérence avec votre marque.
Solution : utilisez les templates de ce guide comme point de départ, mais personnalisez systématiquement. Le nom de l'entreprise, les produits spécifiques, le ton de la marque — ces éléments font la différence entre un chatbot générique et un vrai représentant de votre enseigne.

Erreur 7 — Ignorer les limites du plan gratuit

Symptôme : l'agent cesse de répondre en cours de mois sans explication apparente.
Solution : consultez la page tarifs pour connaître les quotas du plan gratuit. Si votre usage dépasse ces limites, passez au plan adapté avant que le quota ne soit atteint. L'onglet "Paramètres" de votre agent vous indique votre consommation actuelle.

FAQ — Créer son premier agent IA avec Heeya

Conclusion

Créer un agent IA fonctionnel n'est plus l'apanage des équipes techniques. En 10 minutes avec Heeya, vous avez les outils pour déployer un chatbot qui répond précisément à vos utilisateurs, capture des leads qualifiés et s'améliore en continu grâce à vos retours.

La clé du succès n'est pas dans la configuration initiale, mais dans les cycles d'itération qui suivent. Relisez vos conversations, enrichissez votre base de connaissances, affinez votre prompt système. Un agent IA est un outil vivant, pas un déploiement figé.

Si vous souhaitez approfondir les possibilités de la plateforme, notre article sur la création de chatbot IA sur Heeya couvre les cas d'usage avancés et les options d'intégration avec vos outils existants. Et si vous démarrez sans avoir encore de base de connaissances structurée, notre guide sur la création d'un chatbot sans coder vous accompagne étape par étape.

Pour aller plus loin

• Qu'est-ce que le RAG ? Le guide complet en français
• Prompt engineering pour chatbots : maîtriser le prompt système
• Créer un assistant IA sans coder : guide no-code complet
• Intégrer un chatbot IA sur WordPress, Shopify et Wix
• KPI chatbot IA : comment mesurer la performance de votre agent
• Notre expertise RAG — architecture et mise en place