Tout sur Granetra

Granetra est un chatbot IA que vous formez sur votre propre contenu — un site web, un PDF ou un document Word — et que vous intégrez sur votre site avec une seule ligne de code. Il répond aux questions des clients dans votre voix, jour et nuit, en utilisant uniquement le matériel que vous lui avez fourni. Lorsqu'il ne sait vraiment pas quelque chose, il le dit au lieu de deviner, et il peut transférer la conversation à une personne réelle.

Cette documentation couvre l'ensemble du produit : création et formation de bots, personnalisation du widget, automatisation (déclencheurs proactifs, actions agentiques, flux de conversation, équipes d'agents IA, connecteurs MCP), conversations via le widget web et WhatsApp/Telegram/Slack, analytique, équipes, plans et facturation, et sécurité. Vous construisez contre l'API au lieu du tableau de bord ? Allez directement à API & webhooks ou à la référence développeur complète.

La boucle centrale

1. Former un bot sur votre contenu.
2. Personnaliser son apparence et sa façon de parler.
3. Intégrer une balise script sur votre site.
4. Surveiller les conversations et l'améliorer au fil du temps.

Un bot peut être formé à partir d'une ou plusieurs de ces sources à la fois, et vous pouvez en ajouter d'autres plus tard :

Le nombre de pages lues par synchronisation est un plafond, pas un quota que vous dépensez — chaque synchronisation commence à zéro. Une seule exécution s'arrête également à un budget temporel afin que la formation se termine rapidement, donc un site très vaste est lu aussi profondément que le permet ce budget plutôt que d'échouer complètement. La suppression d'un document dans Gérer les connaissances libère immédiatement son emplacement.

En coulisses, votre contenu est divisé en passages, transformé en embeddings et stocké afin que le bot puisse extraire le matériel le plus pertinent dans chaque réponse. Il ne répond jamais à partir de ce que vous ne lui avez pas donné, sauf si vous activez Raisonnement flexible (voir Comportement).

Maintenir les connaissances à jour

• Ajouter des connaissances — ajouter plus de PDFs, de documents Word ou d'URLs à un bot déjà formé sans recommencer.
• Re-synchroniser le site — re-crawler l'URL du site web d'origine et remplacer uniquement les connaissances provenant du site, laissant les fichiers téléchargés intacts. Disponible sur tous les plans. Sur Scale, vous pouvez également activer la re-synchronisation automatique (quotidienne, hebdomadaire ou mensuelle) dans Bot Studio → Comportement, afin que cela se fasse sans vous.
• Gérer les connaissances — voir chaque source formée et en retirer individuellement de la panel de connaissances d'un bot.

Tout ici se trouve dans Bot Studio → Personnaliser → Apparence :

• Logo — affiché sur le bouton de lancement et l'en-tête de chat. PNG, JPG ou WebP jusqu'à 2 Mo.
• Couleur du widget — votre couleur d'accent, utilisée dans tout le panneau.
• Mode couleur — clair, sombre ou automatique (suit la préférence claire/sombre de votre site).
• Thème du widget Plan de croissance — 12 préréglages prêts à l'emploi adaptés aux secteurs courants (Vitrine, Circuit, Soins, Immobilier, Campus, Conciergerie, Registre, Conseil, Pouls, Studio, Voyage, Mono). Chacun est livré avec une variante sombre et une variante claire, s'adaptant automatiquement au thème de votre site. En choisir un suggère également une couleur d'accent assortie, que vous pouvez changer par la suite. Laisser sur par défaut conserve l'apparence standard.
• Position du lanceur & style de bulle — en bas à gauche ou en bas à droite, éclat dégradé ou accent plat solide.
• Arrondi des coins, hauteur et largeur de la fenêtre — curseurs, avec le panneau se dockant automatiquement en plein écran sur mobile, quelles que soient vos réglages.
• Police personnalisée — correspond à la typographie de votre site, tant qu'elle est déjà chargée sur la page.
• CSS personnalisé Plan d'échelle — redéfinir n'importe quelle partie du widget avec vos propres règles, appliquées uniquement à l'intérieur du DOM isolé du widget (il ne peut pas fuir vers votre page, et votre page ne peut pas fuir à l'intérieur). Préfixez une règle avec .dark ou .light pour cibler un seul thème ; Bot Studio inclut un aperçu en direct avec son propre basculement sombre/claire.

• Message de bienvenue — la première chose que le bot dit lorsqu'un visiteur ouvre le chat.
• Message de secours — ce qu'il dit lorsqu'il ne peut pas aider.
• Email de transfert — où il dirige les visiteurs lorsqu'il est bloqué.
• Mode de raisonnement Plan de croissance — Grounded (par défaut) répond uniquement à partir de ce que vous l'avez formé. Flexible lui permet de raisonner un peu au-delà de vos documents pour des questions liées aux affaires, mais il n'invente jamais de prix, de dates ou de politiques spécifiques, et refuse toujours tout ce qui n'est pas lié à votre entreprise.
• Mémoire des visiteurs Plan de croissance — désactivée par défaut. Lorsqu'elle est activée, le bot se souvient des visiteurs récurrents à travers les sessions, pas seulement dans un seul onglet : il rappelle des faits durables qu'ils ont partagés et un court résumé des conversations précédentes, afin qu'un visiteur récurrent n'ait pas à se réexpliquer. Les souvenirs sont distillés uniquement à partir de ce qu'un visiteur a réellement tapé, et sont supprimés avec le bot. Les visiteurs peuvent également s'effacer à tout moment : lorsque la mémoire est activée, le widget affiche un lien discret "Oubliez-moi" sous la boîte de message qui efface tout ce que le bot a stocké à leur sujet, sans besoin de compte ou de ticket de support. Il reste visible sur les widgets en marque blanche également — un contrôle de confidentialité ne devrait pas disparaître parce que la marque l'a fait.
• Modèle IA Plan d'échelle — dirigez un bot vers OpenAI (le par défaut ajusté), Anthropic Claude, Groq, DeepSeek, Gemini, ou xAI. Chaque fournisseur propose une liste courte et vérifiée de modèles avec des indications de vitesse et de coût, de sorte qu'une faute de frappe ne puisse pas silencieusement envoyer votre bot vers un modèle qui n'existe pas. Besoin de quelque chose qui n'est pas sur la liste ? Utilisez "Demander un modèle différent ou supérieur" dans le même panneau et notre équipe l'examinera. Les embeddings pour l'entraînement fonctionnent toujours sur OpenAI, quel que soit le modèle de chat.
• Transfert à un humain en direct Plan d'échelle — ajoute un bouton "Parler à un humain". Voir Transfert à un humain ci-dessous.

Chaque bot comprend et répond automatiquement dans 95+ langues, détectant ce que le visiteur utilise — y compris en répondant dans l'écriture native d'une langue même lorsqu'un visiteur la tape phonétiquement en lettres latines.

Bot Studio → Connaissances liste chaque source sur laquelle un bot a été formé — fichiers et pages confondus — avec l'option de supprimer une seule. Pour en ajouter plus, utilisez Ajouter des connaissances ; pour rafraîchir ce qu'il sait d'un site web en direct, utilisez Re-synchroniser le site. Les deux sont couverts en détail sous Sources de formation ci-dessus.

Jusqu'à la limite d'automatisation de votre plan de règles par bot (Croissance 10, Échelle 20), de trois types :

• Inactif — se déclenche après un certain nombre de secondes sur la page.
• Intention de sortie — se déclenche lorsque la souris d'un visiteur se déplace vers la fermeture de l'onglet (bureau uniquement).
• Page — se déclenche après un délai sur toute URL contenant un fragment de votre choix.

Chaque règle se déclenche une fois par visiteur et par session de navigateur, et une seule carte teaser s'affiche par chargement de page, ce qui évite toute sensation de spam. Rien ne se déclenche pendant que le panneau de chat est déjà ouvert, en pleine conversation, ou lors d'un transfert en direct.

Enregistrez votre propre point de terminaison HTTPS comme un outil que le modèle de chat peut appeler en pleine conversation — une recherche de commande, vérification de disponibilité, création d'un ticket de support. Le modèle décide quand un outil est pertinent, l'appelle avec les paramètres que vous avez définis, et intègre le résultat réel dans sa réponse au lieu de deviner.

• Jusqu'à 6 paramètres par action, jusqu'à la limite d'automatisation de votre plan par bot.
• GET ou POST, avec un secret bearer optionnel envoyé en tant qu'en-tête d'autorisation.
• Un bouton "Tester le point de terminaison" intégré exécute une définition contre de vraies données d'exemple avant que vous ne l'enregistriez.
• Chaque appel est protégé contre l'accès à des adresses internes/privées, limité à 10 secondes et 4 000 caractères de réponse, et seuls les paramètres que vous avez déclarés sont jamais envoyés à votre point de terminaison.

Les actions peuvent également être gérées via l'API — voir API & webhooks.

Utile pour tout ce qui nécessite une séquence précise et répétable plutôt qu'une réponse libre — qualification d'un lead, réservation d'une démo, routage d'un remboursement. Un flux commence lorsque le message d'un visiteur contient l'une de ses phrases déclencheuses, et est construit à partir d'un petit ensemble de types de nœuds :

Tout ce qu'un flux ne couvre pas passe directement à la réponse normale de l'IA — les flux sont additifs, pas un remplacement de la base de connaissances.

Au lieu qu'un seul bot réponde à tout, définissez jusqu'à 8 spécialistes — Ventes, Support, Facturation, tout ce qui correspond à votre entreprise — chacun avec sa propre description de routage, des instructions de spécialiste optionnelles, ses propres autorisations d'outil, et éventuellement son propre modèle IA. Chaque message de visiteur est classé et répondu par le bon spécialiste, et le widget affiche une petite étiquette indiquant qui a répondu.

• Le routage est collant — la conversation reste avec un spécialiste jusqu'à ce que le sujet change clairement, de sorte qu'une question de suivi ne rebondit pas entre les agents.
• Les autorisations d'outil sont par agent — accordent à un spécialiste uniquement les actions agentiques et les connecteurs MCP qu'il devrait pouvoir utiliser. Un agent avec une liste d'autorisation vide n'obtient aucun outil.
• Ils peuvent transférer en pleine réponse — si une question appartient clairement à un coéquipier, le spécialiste la passe et ce coéquipier répond immédiatement, sous ses propres instructions, outils et modèle. Le visiteur n'a jamais besoin de demander deux fois et ne voit jamais le transfert.
• Chaque réponse est attribuée — votre boîte de réception de conversations étiquette chaque réponse avec le spécialiste qui l'a écrite, y compris après un transfert en pleine réponse, afin que vous puissiez auditer comment une conversation a évolué au sein de votre équipe.
• Les spécialistes ajoutent, jamais ne remplacent — votre base de connaissances, vos règles de sécurité et vos fondations s'appliquent de manière identique à chaque agent.
• Modèles — commencez à partir d'un spécialiste des ventes, du support ou de la facturation prêt à l'emploi, ou créez une équipe de départ entière en un clic, puis modifiez tout.

Si le routage ne peut pas décider, ou si vous n'avez pas d'agents définis, le bot répond simplement en tant que tel — exactement comme il le fait aujourd'hui.

MCP (Model Context Protocol) est la norme ouverte pour exposer des outils aux assistants IA. Connectez un serveur MCP une fois et votre bot découvre automatiquement tous les outils qu'il propose — pas d'enregistrement par point de terminaison, pas d'écriture de schéma. Ces outils peuvent ensuite être appelés en cours de conversation par le même mécanisme que les actions agentiques.

• Jusqu'à 3 serveurs par bot, chacun contribuant jusqu'à 25 outils.
• Serveurs HTTPS publics utilisant le transport HTTP Streamable, avec un jeton d'authentification optionnel pour les serveurs authentifiés.
• "Tester la connexion" liste tous les outils qu'un serveur expose avant que vous ne sauvegardiez, afin que vous sachiez exactement ce que votre bot gagne.
• Les outils sont mis en cache lorsque vous sauvegardez, donc connecter un serveur n'ajoute aucune latence aux conversations en direct. La nouvelle sauvegarde actualise la liste.
• Chaque connecteur peut être mis en pause indépendamment et peut être accordé à des agents spécifiques uniquement lorsque vous exécutez un Équipe d'agents IA.

Chaque conversation de widget est sauvegardée dans votre boîte de réception des Conversations. Filtrez par bot, ou par le drapeau "Besoin d'attention", qui marque les conversations où la réponse du bot a obtenu une faible confiance par rapport à votre contenu entraîné — un signal fort qu'il n'avait pas de bonne réponse. Ouvrez n'importe quelle conversation pour lire la transcription complète, y compris quelles réponses ont été signalées.

"Réinitialiser les analyses" efface l'historique des conversations d'un bot de vos vues de tableau de bord sans toucher au nombre de conversations mensuelles de votre plan — l'utilisation est mesurée indépendamment, donc elle ne peut pas être réinitialisée en effaçant votre vue.

Connectez un canal dans Bot Studio → Déployer → Canaux et votre bot répond là avec exactement les mêmes connaissances, flux, équipe d'agents et mémoire des visiteurs que le widget du site web — et chaque conversation atterrit dans la même boîte de réception, étiquetée avec le canal d'où elle provient.

• WhatsApp — via l'API Meta Cloud, en utilisant votre propre application Meta.
• Telegram — via un bot que vous créez avec @BotFather. Gratuit et le plus rapide à configurer, donc c'est le plus facile à essayer en premier.
• Slack — répond aux messages directs et aux @mentions de votre application.

Vous apportez vos propres identifiants, donc il n'y a pas de compte de plateforme partagé et pas de vérification d'entreprise Meta à attendre. Chaque canal a un guide de configuration numéroté dans le panneau, un bouton "Vérifier la connexion" qui vérifie vos identifiants en direct avant que vous ne comptiez dessus, et un interrupteur de pause qui arrête le canal sans le déconnecter.

Transfert à un humain fonctionne aussi sur les canaux — rejoignez une conversation de canal depuis votre boîte de réception et votre réponse est livrée au visiteur dans son propre application. Un contact WhatsApp ou Telegram revenant est également reconnu par la mémoire des visiteurs, de la même manière qu'un visiteur de site web revenant.

Les photos et les notes vocales sont comprises, pas ignorées. Les clients sur ces plateformes envoient régulièrement une photo d'un reçu ou enregistrent une question rapide au lieu de taper. Votre bot lit les images — y compris tout texte, numéros de commande ou montants visibles — et transcrit les messages vocaux, puis répond à partir de vos connaissances comme d'habitude. Cela fonctionne quel que soit le modèle d'IA que votre bot est configuré pour. Les fichiers qu'il ne peut pas ouvrir (PDF, documents) sont reconnus et le client est invité à fournir les détails, plutôt que de ne recevoir aucune réponse.

Publicités Facebook & Instagram : le bot sait quelle annonce ils ont cliquée. Dirigez une annonce "Envoyer un message" vers votre numéro WhatsApp connecté et il n'y a rien d'autre à configurer. Lorsque quelqu'un appuie dessus, votre bot ouvre la conversation sachant déjà le titre de l'annonce — il répond donc immédiatement à propos de ce produit ou cours au lieu de demander à une personne qui vient de vous dire ce qu'elle veut de le répéter, ce qui est là où la plupart des chats générés par des annonces perdent des gens. Il les suit s'ils changent de sujet, et ne mentionne jamais l'annonce ou aucun suivi.

Chacune de ces conversations est étiquetée avec son annonce dans votre boîte de réception, et Analytique → Par annonce classe vos campagnes par conversations, engagement, emails capturés, et taux de réponse — à quel point le bot a réellement géré les personnes que chaque annonce a envoyées. Une campagne avec beaucoup de trafic et un faible taux de réponse signifie généralement que l'annonce promet quelque chose que votre bot n'a pas encore été formé à gérer, ce qui est un écart que le reporting de Meta ne peut jamais vous montrer. L'identifiant de l'annonce et l'identifiant de clic sont également transmis à votre CRM avec chaque lead, afin que vous puissiez rapporter les conversions à Meta.

Activez cela dans Bot Studio → Comportement et un bouton "Parler à un humain" apparaît dans le widget. Lorsque un visiteur l'utilise — ou que vous intervenez sans y être invité — vous recevez un email instantanément, et vos réponses apparaissent dans leur fenêtre de chat en quelques secondes. Renvoyez la conversation au bot dès que vous avez terminé, et le visiteur peut toujours revenir au bot lui-même aussi.

Cliquer sur ce bouton ouvre une page de chat dédiée en plein écran dans un nouvel onglet, portant la conversation jusqu'à présent afin que rien ne soit répété. Les visiteurs déjà connectés à Granetra entrent directement dans le chat — ils ne sont jamais invités à se reconnecter. Un visiteur anonyme est invité à s'inscrire ou à se connecter sur cette page d'abord, puis revient directement dans le même chat. Cela prend quelques secondes pour eux et vous donne une vraie adresse email sur la conversation — donc s'ils ferment l'onglet avant que vous ne répondiez, vous pouvez toujours faire un suivi.

Tout reste une seule conversation : vous répondez depuis la même boîte de réception, et le widget sur le site du client continue d'afficher vos réponses aussi, donc un visiteur peut passer librement entre les deux onglets.

• Volume de conversation et taux de réponse au fil du temps, par jour ou par semaine.
• Les principales questions que les visiteurs posent réellement, classées par fréquence.
• Décomposition des sujets et un simple entonnoir : commencé → engagé → résolu.
• Opportunités manquées — questions auxquelles le bot n'a pas pu répondre à plusieurs reprises, le signal le plus clair sur ce qu'il faut ajouter à ses connaissances ensuite.
• Satisfaction des visiteurs par pouce en l'air/en bas, et pistes — moments où un visiteur a été dirigé vers votre e-mail de transfert parce que le bot ne pouvait pas aider.
• Une courte liste d'actions suggérées basée sur des règles.

En haut de l'Analytics, vous trouverez un panneau de trafic du site web : visiteurs, pages vues, sessions et pages par visite avec des comparaisons de périodes précédentes, une chronologie que vous pouvez consulter quotidiennement, hebdomadairement, mensuellement ou annuellement, vos pages les plus consultées, d'où provient le trafic, répartition par appareil, et un compte en direct du nombre de personnes sur votre site en ce moment.

Il n'y a rien à installer. Le widget de chat que vous avez déjà intégré effectue la mesure, ce qui signifie également qu'il mesure les pages sur lesquelles le widget est installé — pas nécessairement chaque page de votre site. Si vous souhaitez une couverture complète, ajoutez le widget sur tout le site.

Il est conçu pour respecter la vie privée par défaut : aucun nouveau cookie n'est défini, les chaînes de requête et les fragments d'URL sont supprimés avant que quoi que ce soit ne soit stocké (donc les jetons de session ou les adresses e-mail dans vos propres URL ne sont jamais enregistrés), et les référents sont réduits à un domaine de base. Les données de trafic sont conservées pendant 400 jours.

Invitez des coéquipiers depuis le Dashboard → Équipe. Chaque compte commence avec sa propre équipe personnelle ; inviter quelqu'un partage vos bots, conversations et paramètres avec eux sous un rôle :

Les sièges (membres plus invitations en attente) évoluent avec votre plan — Growth inclut jusqu'à 3, Scale jusqu'à 10. Chaque changement apporté à un bot, un membre ou un paramètre est enregistré dans le journal d'activité de l'équipe.

Tous les prix affichés sont mensuels ; payer annuellement permet d'économiser 20 %. Besoin de quelque chose de plus grand, d'un volume personnalisé ou d'un DPA signé ? Voir Entreprise.

Chaque plan payant — Starter, Growth et Scale — porte un badge vérifié à côté de votre nom de compte dans le tableau de bord, afin que quiconque voit votre profil ou votre liste d'administrateurs sache qu'il s'agit d'un vrai compte Granetra abonné. Le personnel de Granetra (comptes principaux) le porte par défaut, quel que soit le plan.

La facturation est gérée par Polar, notre commerçant de référence — vos informations de paiement ne touchent jamais directement les serveurs de Granetra. Gérez votre abonnement (mettez à jour votre carte, changez de plan, annulez, consultez les factures) à tout moment depuis le tableau de bord → Gérer la facturation, qui ouvre le portail sécurisé hébergé de Polar.

• L'utilisation des conversations se réinitialise à chaque cycle de facturation mensuel, que vous payiez mensuellement ou annuellement.
• La mise à niveau prend effet immédiatement ; la rétrogradation prend effet lors de votre prochain renouvellement.
• La facturation entreprise est basée sur des factures avec un DPA dédié — voir Entreprise.

• Vos données vous appartiennent — votre base de connaissances est uniquement utilisée pour répondre à vos propres visiteurs. Elle n'est jamais vendue ni partagée.
• Chiffré de bout en bout — tout est chiffré en transit (TLS) et au repos.
• Jamais utilisé pour entraîner des modèles d'IA — votre contenu et vos conversations ne sont jamais réinjectés dans l'entraînement d'un modèle.
• Conforme au RGPD par conception — exportez ou supprimez définitivement votre compte et toutes ses données à tout moment depuis les Paramètres, sans ticket de support requis.
• Protection du compte — l'authentification à deux facteurs et une vue complète des sessions actives (voir et déconnecter tout appareil) sont disponibles pour chaque compte, gratuitement.

Tous les détails se trouvent dans notre Politique de confidentialité et Conditions d'utilisation.

Une API REST et des webhooks signés pour automatiser tout ce que fait le tableau de bord : lister vos bots, lire des conversations et des transcriptions, envoyer un message de chat et obtenir une réponse, et gérer des actions agentiques — le tout avec une clé d'accès limitée. Les webhooks livrent un POST signé et réessayé dès qu'une conversation commence, qu'un visiteur demande un humain, ou qu'un lead est capturé. Les clés peuvent également comporter une liste d'IP autorisées et rapporter l'utilisation par clé.

Lisez la référence complète de l'API

Le widget n'apparaît pas sur mon site

Confirmez que la balise script est présente et placée avant </body>, et que le statut du bot est "Prêt" (pas "En formation" ou "Échoué"). Si vous avez défini une liste de "Sites autorisés" dans Bot Studio → Accès, assurez-vous que le domaine sur lequel vous testez est inclus — sinon, le widget refuse silencieusement de se charger là-bas par conception.

La formation échoue, ou un site web ne peut pas être exploré

Certains sites bloquent les crawlers automatisés, et les pages entièrement rendues avec JavaScript ne peuvent pas être lues de cette manière. Essayez plutôt un export PDF ou Word du même contenu — cela résout presque toujours le problème.

Le bot continue de dire qu'il ne sait pas

Vérifiez que le contenu que vous attendez qu'il connaisse est bien répertorié dans la base de connaissances. Ajoutez plus de matériel source avec "Ajouter des connaissances", ou activez "Raisonnement flexible" (Growth+) pour qu'il puisse raisonner un peu au-delà de vos documents exacts.

Un visiteur est invité à s'inscrire en cours de chat

En tant que mesure de sécurité, un visiteur anonyme qui atteint 5 messages dans une conversation sans laisser d'informations de contact est invité à se connecter ou à créer un compte gratuit pour continuer. Cela ne s'applique pas si la personne est déjà un utilisateur connecté de Granetra — cela n'affecte que les visiteurs de sites web véritablement anonymes.

J'ai atteint ma limite de conversation mensuelle

Votre compteur d'utilisation sur le tableau de bord montre exactement où vous en êtes et quand il se réinitialise. Mettez à niveau votre plan à tout moment pour une limite plus élevée — consultez Plans.

Connecté ? Utilisez le bouton "Vous avez trouvé un bug ?" dans la barre latérale de votre tableau de bord pour signaler un problème directement à notre équipe. Pour toute autre question, envoyez un e-mail à granetra@gmail.com — ou ouvrez simplement la bulle de chat dans le coin de cette page. C'est un vrai bot Granetra, formé sur cette documentation même.

Déjà utilisateur de Granetra ? Nous aimerions vraiment savoir comment ça se passe — copiez votre ID de bot depuis n'importe quelle carte de bot et laissez un avis sur notre page d'avis.