Connectez votre propre système

Aperçu

Canaux et intégrations → Système propre (/fr/integrations/own-system) est destiné aux boutiques qui conservent les comptes clients dans leur propre système (par exemple un portail logistique) et ne souhaitent pas copier ces données dans OrderInChat.

• Vous intégrez le widget OrderInChat sur vos pages connectées.
• Votre serveur signe un jeton à durée de vie courte pour l'utilisateur connecté et le fournit au widget.
• Lorsque ce client demande des informations sur son propre compte (par exemple "Où est ma commande ?"), l'IA appelle vos propres outils MCP en lecture seule avec le jeton de cet utilisateur, dans le chat texte et lors des appels vocaux initiés depuis le widget.
• OrderInChat ne vérifie que votre signature. Il ne crée jamais d'identités, ne lit jamais votre base de données et ne stocke pas ce que vos outils retournent.

Disponible sur les plans payants (Starter, Pro, Ultra). Les visiteurs sans jeton valide sont anonymes : l'IA répond à partir de votre base de connaissances et leur demande de se connecter pour des questions de compte.

Faites-le construire par l'IA de votre développeur

Sous À donner à l'IA de votre développeur, cliquez sur Copier les instructions et collez le texte tel quel dans l'assistant IA de vos développeurs (Claude Code, Cursor, ChatGPT…). Il est en anglais et décrit précisément quoi construire — l'endpoint de jeton, le serveur MCP signé et le code du widget — avec l'ID de votre boutique et vos adresses. Il demande à l'IA de terminer par la liste des valeurs à saisir sur cette page. Aucun secret n'y figure : créez les secrets de signature sur cette page et enregistrez-les vous-même sur votre serveur.

1. Jeton de connexion utilisateur

Votre serveur signe un JWT pour l'utilisateur connecté :

Choisissez comment OrderInChat le vérifie :

• URL JWKS (ES256 ou RS256) — l'adresse HTTPS de vos clés publiques.
• Clé publique (ES256 ou RS256) — collez la clé publique PEM.
• Secret partagé (HS256) — au moins 32 caractères, stocké de manière chiffrée.

Collez un jeton d'exemple sous Tester un jeton pour le vérifier avant de passer en production. Un jeton invalide ou expiré ne fait jamais échouer le chat — le visiteur est simplement traité comme anonyme.

2. Votre serveur MCP

Entrez l'adresse de votre serveur MCP (HTTP Streamable, tools/list et tools/call). Test et Live ont chacun leur propre adresse et secret de signature ; Mode actif choisit lequel l'IA utilise.

Cliquez sur Créer pour obtenir un secret de signature. Il est affiché une seule fois — conservez-le sur votre serveur. Révoquer le supprime immédiatement (les appels dans ce mode s'arrêtent jusqu'à ce que vous en créiez un nouveau).

Chaque requête qu'OrderInChat envoie à votre serveur contient :

• X-OIC-Timestamp — secondes Unix
• X-OIC-Signature — v1= + HMAC-SHA256 hex de timestamp.body avec votre secret de signature
• X-OIC-User-Token — le jeton de l'utilisateur, inchangé (vérifiez-le vous-même et ne renvoyez que les données de cet utilisateur)
• X-OIC-Mode — test ou live

Rejetez les requêtes dont la signature ne correspond pas ou dont le timestamp est plus ancien que 5 minutes. OrderInChat n'a pas d'adresse IP fixe, utilisez donc la signature au lieu d'une liste blanche d'IP.

3. Outils

Cliquez sur Découvrir les outils pour lire les outils que votre serveur répertorie, puis activez ceux que l'IA peut utiliser. Autorisez uniquement les outils en lecture seule. Les outils qui apparaissent plus tard commencent désactivés jusqu'à ce que vous les activiez.

• Chat texte : un appel d'outil peut prendre jusqu'à 8 secondes.
• Appels vocaux : jusqu'à 3 secondes ; l'assistant dit d'abord un court "laissez-moi vérifier". Si votre serveur est lent, il dit qu'il ne peut pas vérifier pour le moment.
• Ce que vos outils retournent est traité comme des données uniquement, jamais comme des instructions, et n'est pas enregistré dans l'historique du chat.

4. Intégrer le widget

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken est appelé lorsque le jeton est sur le point d'expirer. Après le chargement du script, vous pouvez également utiliser OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (lors de la déconnexion) et OrderInChat.onTokenRefresh(fn).

Avec un jeton valide et l'assistant vocal activé, l'en-tête du widget affiche un bouton téléphone. L'appel se déroule dans le widget et est facturé à partir des crédits IA comme tout appel de site Web (les appels d'outils sont inclus dans l'appel). L'audio des appels Web n'est pas enregistré.

Personnaliser ouvre les réglages du widget dans un nouvel onglet. À chaque chargement de page, le code lit l'apparence du widget chez OrderInChat (via data-tenant-id) : vos modifications enregistrées s'appliquent aussitôt, sans recoller le code. Le profil de widget choisi pour votre vitrine est utilisé (sinon le profil actif ou le premier) ; aucun nouveau profil n'est créé.

5. Tester la connexion

Sous Outils, Tester la connexion lance des contrôles fixes sur votre adresse MCP de Test avec le secret de signature de test. Aucune IA n'intervient et rien n'est enregistré. Il vérifie que :

• l'adresse est en https public (pas localhost ni une adresse de réseau privé) ;
• un tools/list correctement signé fonctionne ;
• une requête avec une mauvaise signature est rejetée ;
• une signature correcte avec un horodatage de plus de 5 minutes est rejetée ;
• tools/call sur un outil activé sans jeton utilisateur renvoie une erreur et aucune donnée ;
• avec un jeton d'exemple collé dans Tester un jeton, tools/call fonctionne — et à quelle vitesse (au-delà de 2 secondes, c'est trop lent pour les appels vocaux ; ceux-ci abandonnent après 3 secondes).

Seuls les outils détectés et activés sont appelés, avec des arguments vides ; le jeton d'exemple ne sert qu'à ce test et n'est jamais enregistré. Chaque point en échec indique comment le corriger. Copier les résultats pour votre développeur copie un rapport en anglais à coller à votre développeur ou à son IA ; relancez le test jusqu'à ce que plus rien n'échoue.

Ce que votre équipe voit

• Boîte de réception → Web : le nom et l'email du client provenant du jeton, ou Utilisateur #ID lorsque vous n'envoyez aucun des deux. Chaque réponse de l'IA montre lequel de vos outils elle a utilisé et si cela a fonctionné — jamais les données.
• Boîte de réception → Appels : les appels du widget apparaissent sous Site Web de la boutique et dans Live pendant qu'ils se déroulent ; la transcription montre chaque étape de l'outil (nom et résultat uniquement).
• Clients : une carte client est créée ou réutilisée pour chaque ID utilisateur (ID utilisateur de la boutique), de sorte que les chats et les appels de la même personne soient liés.