AskAIsVue d’ensemble de l’intégration
Les façons de connecter AskAIs aujourd’hui : votre site web, votre app, Telegram et les clients IA.
Les noms techniques comme
window.SingChatfont partie du widget et de l’API. Conservez-les tels quels dans votre code.
AskAIs est un service hébergé : votre espace de travail, votre boîte de réception, votre agent IA et votre base de connaissances se trouvent sur askais.com. Vous y reliez vos clients des façons décrites ci-dessous, et chaque conversation arrive dans la même boîte de réception partagée, où le même agent IA répond avec les mêmes connaissances et les mêmes réglages.
Façons de se connecter
| Où | Comment se connecter | Mises à jour |
|---|---|---|
| Votre site web | Une seule balise <script> | Aucune : chaque chargement de page récupère le widget actuel |
| Votre app iOS, Android, Flutter, React Native ou de bureau | Une WebView qui ouvre votre page de chat | Aucune : la WebView charge le widget actuel |
| Telegram | Un jeton de bot dans Paramètres → Channels | Aucune |
| Claude Code, Cursor ou Gemini CLI (pour votre équipe) | Le serveur MCP, avec une clé MCP | Aucune |
Votre site web
Ajoutez ce code avant </body>. Copiez votre App ID depuis Paramètres → Boîtes de réception ; il est public et peut être publié sans risque.
<script src="https://askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://askais.com"
async></script>⚠️ Chargez widget.js depuis askais.com
Ne téléchargez pas widget.js et ne l’intégrez pas à votre propre code. Chargé depuis askais.com, il exécute toujours la version actuelle ; une copie reste figée et passe à côté de chaque correctif et de chaque nouvelle fonctionnalité.
Apps mobiles et de bureau
Il n’y a pas de SDK à installer. Ouvrez https://askais.com/api/widget-embed?appId=YOUR_APP_ID dans une WebView : votre app affiche le même chat que votre site web, en plein écran. Ajoutez à l’URL l’ID, l’e-mail et le nom de l’utilisateur connecté pour que votre équipe sache à qui elle parle. La page Chat intégré à l’app contient le guide complet, avec du code pour Flutter, iOS, Android et JavaScript.
Visiteurs connectés et identité vérifiée
Pour les utilisateurs connectés, transmettez externalId, email et name afin que leurs chats les suivent d’un appareil à l’autre. Pour empêcher quiconque de se faire passer pour un autre utilisateur, transmettez aussi hmac : un HMAC-SHA256 de l’externalId, calculé sur votre serveur avec la clé secrète de la boîte de réception comme clé. La page Widget web explique comment faire.
Telegram
Créez un bot avec @BotFather, collez son jeton dans Paramètres → Channels et connectez-le. Les messages envoyés au bot arrivent dans la même boîte de réception, où l’agent IA et votre équipe y répondent.
Clients IA (MCP)
Le serveur MCP permet à Claude Code, Cursor ou Gemini CLI de travailler sur votre espace de travail : lire les conversations et y répondre, entraîner l’IA, modifier la FAQ et consulter les statistiques. Il est destiné à vous et à votre équipe, pas à vos clients. C’est un propriétaire ou un administrateur de l’espace de travail qui crée la clé MCP.
Non disponible aujourd’hui
- Des paquets SDK à installer (npm, pub.dev, CocoaPods, Gradle). Utilisez la balise script sur le Web et la page WebView dans les apps.
- Une API REST publique pour votre propre backend. Les clés API ne sont acceptées que par le serveur MCP.
- Des webhooks pour les événements de conversation ou de message. Paramètres → Webhooks permet d’enregistrer un endpoint et d’envoyer un ping de test signé, mais aucun événement n’est encore envoyé.
- Des méthodes JavaScript pour ouvrir ou fermer le widget, ou écouter ses événements.
window.SingChat.start()est la seule méthode fournie par le script.