Retour au tableau de bord

Documentation

Apprenez à utiliser Asyntai

Connectez votre site

Lisez pages, produits et commandes directement depuis votre plateforme

Ouvrir la fenêtre de connexion
Forfaits Standard, Pro et Enterprise

Aperçu

Connecter votre site donne à l'IA une clé en lecture seule sur votre plateforme. Au lieu d'explorer vos pages de l'extérieur, nous les demandons directement à votre plateforme.

Cela atteint du contenu hors de portée d'un robot d'exploration. Les pages derrière une connexion, les pages profondes que rien ne relie et les sites derrière un mur anti-robots passent tous. Les prix et les stocks restent à jour, car nous les relisons au lieu de nous fier à ce que la page indiquait le jour de l'exploration.

Lecture seule. Rien n'est créé, modifié ni supprimé sur votre site. Chaque appel que nous faisons est une lecture.

Les trois types de données

C'est vous qui choisissez ce que vous partagez. Chaque choix correspond à ce que l'assistant pourra ensuite répondre.

Choix Ce que cela apporte Ce à quoi l'assistant peut répondre
Pages Le contenu de votre site, synchronisé automatiquement. Les questions sur vos conditions, vos services, vos cours, vos guides et toute autre page rédigée.
Produits Prix actuels, stocks, liens et images. Ce que vous vendez, son prix, s'il est en stock, et un lien pour l'acheter.
Commandes Suivi du statut des commandes pour vos clients. Où en est la commande d'un client, quand elle a été expédiée et ce qu'elle contenait.

Quelles plateformes fonctionnent

Toutes. Quelle que soit la base de votre site, l'assistant peut répondre à partir de vos pages, de vos produits et de vos commandes.

Certaines plateformes se lisent directement avec une clé API. Pour les autres, les mêmes données arrivent par une exploration, un flux de produits, le contexte utilisateur ou vos propres outils. Vous n'avez pas à déterminer votre cas : ouvrez la fenêtre, choisissez votre plateforme, cochez ce que vous voulez partager, et les étapes qui vous concernent s'affichent.

Voir les étapes pour votre plateforme

Vous avez créé votre site vous-même ? Choisissez Personnalisé / sans CMS dans la fenêtre. Un site fait main, une installation headless ou toute plateforme que nous ne citons pas fonctionnent de la même façon.
Deux identifiants pour une boutique WooCommerce. WooCommerce lit les produits et les commandes. Les pages viennent du WordPress sous-jacent, qui a besoin de son propre mot de passe d'application. La fenêtre vous indique quand une deuxième clé est nécessaire.

Comment connecter

  1. Ouvrez votre tableau de bord et repérez Connectez votre site, à côté d'Ajouter à la base de connaissances.
  2. Choisissez votre plateforme dans la liste. Sélectionnez Personnalisé / sans CMS si vous avez créé le site vous-même.
  3. Cochez ce que vous voulez partager : pages, produits, commandes ou n'importe quelle combinaison.
  4. Appuyez sur Continuer. Vous voyez alors les étapes rédigées pour votre plateforme et vos choix.
  5. Suivez les étapes dans l'administration de votre plateforme pour créer la clé.
  6. Collez la clé dans les champs en bas de la même fenêtre et appuyez sur Connecter.

Ce qui se passe quand vous appuyez sur Connecter

Nous vérifions l'identifiant avant de l'enregistrer. Une clé erronée n'est jamais enregistrée.

  1. Nous effectuons un appel réel vers votre plateforme avec l'identifiant que vous avez collé.
  2. En cas d'échec, l'erreur s'affiche sous le bouton et les champs restent modifiables pour que vous puissiez corriger.
  3. En cas de succès, nous enregistrons la connexion et commençons à lire votre contenu.
  4. La fenêtre indique ensuite le résultat : combien d'éléments sont arrivés, ou exactement ce qui a échoué.
La première lecture s'exécute en arrière-plan. Vous pouvez fermer la fenêtre, elle se termine toute seule.

Rester à jour

Nous relisons votre contenu selon un calendrier, si bien qu'un changement de prix ou une nouvelle page atteint l'assistant sans aucune action de votre part.

Seul ce qui a changé est réindexé. Nous comparons le contenu de chaque élément à ce que nous détenons déjà, une page inchangée ne coûte donc rien. Vous pouvez aussi appuyer sur Synchroniser maintenant sur la page de réglages de la plateforme à tout moment.

Autorisations et accès

Ce qu'une clé peut voir dépend de la plateforme, et la différence compte.

Magento, Shopify, WooCommerce et BigCommerce accordent les droits ressource par ressource. Si vous cochez uniquement les produits, la clé n'atteint effectivement que les produits.

WordPress et Moodle ne fonctionnent pas ainsi. Un mot de passe d'application WordPress hérite des droits du compte qui l'a créé, et un jeton Moodle voit ce que voit son utilisateur. Il n'y a aucune liste de portées à cocher. Utilisez un compte qui n'a pas plus d'accès que le contenu auquel vous voulez répondre, et n'oubliez pas que les articles privés et protégés par mot de passe passeront aussi.

De notre côté, nous ne lisons que des routes de contenu, et uniquement en GET. Nous n'écrivons jamais.

Se connecter sans clé API

Chaque choix dispose aussi d'une voie qui ne demande aucune clé. Elles fonctionnent sur toutes les plateformes, et la fenêtre les propose à côté des étapes.

Au lieu de Utiliser Ce que cela fait
Pages Explorer Nous lisons l'ensemble de votre site et conservons le contenu dans la base de connaissances.
Produits Flux de données en temps réel Indiquez-nous l'URL d'un flux de produits public. Les prix et les stocks restent synchronisés à partir de là.
Commandes Contexte utilisateur ou Outils personnalisés Envoyez les informations du client connecté depuis votre site, ou branchez votre propre point de terminaison que l'assistant peut appeler.

Déconnexion

Ouvrez la page de réglages de la plateforme depuis la fenêtre et appuyez sur Déconnecter. Cela supprime l'identifiant enregistré et efface tout ce que cette clé a apporté à votre base de connaissances. Le contenu venu d'autres sources reste intact.

Vous pouvez aussi révoquer la clé sur votre plateforme. La synchronisation suivante échoue alors et signale une erreur d'authentification, et rien de nouveau n'est lu.

Dépannage

Ce que vous voyez Ce que cela signifie en général
Échec de l'authentification La clé est erronée, expirée ou révoquée. Sur WordPress, cela arrive aussi quand on colle le mot de passe de connexion habituel au lieu d'un mot de passe d'application.
Terminé, mais nous n'avons rien trouvé à lire L'identifiant fonctionne, mais le compte associé ne voit aucun contenu. Choisissez un compte ayant accès aux pages ou aux produits auxquels vous voulez répondre.
Connecté, mais nous n'avons pas pu lire votre contenu La clé a été acceptée, puis la lecture a échoué. L'erreur exacte renvoyée par votre plateforme s'affiche avec le message.
Une autorisation manque La clé a été créée sans l'une des ressources indiquées dans les étapes. Recréez-la avec toutes les autorisations nommées par la fenêtre.