Integration overview

AskAIs Customer Service, c'est un seul backend avec de nombreux SDK clients. Vous configurez votre espace de travail une seule fois, puis vous intégrez le chat partout — un site web, une application mobile ou n'importe quel service backend. Chaque client dialogue avec la même boîte de réception, le même agent IA et la même base de connaissances.

Un seul backend, toutes les plateformes

Quelle que soit la plateforme que vous utilisez, l'installation est courte et la conversation, le contact, les réponses de l'IA et les paramètres sont partagés. Voici comment chaque plateforme s'installe et — surtout — comment elle reçoit ses futures mises à jour :

Les plateformes en un coup d'œil

Tous les SDK sont-ils compatibles ?

Oui. Ce sont différentes portes d'entrée vers le même espace de travail AskAIs Customer Service, ils sont donc parfaitement interopérables :

• Même backend, même app-id : chaque client se connecte à la même boîte de réception dans votre espace de travail.
• Un même visiteur sur tous ses appareils : identifiez-le avec le même externalId et un chat démarré sur le web se poursuit dans votre application.
• Configuration partagée : votre agent IA, votre base de connaissances, vos horaires d'ouverture, vos réponses par mots-clés et vos FAQ se configurent une seule fois et s'appliquent à tous les canaux.

Web — l'intégration officielle (recommandée)

Insérez cette seule ligne avant </body>. C'est toute l'installation. L'app-id est public et peut être déployé sans risque ; copiez-le depuis Paramètres → Boîtes de réception.

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"
        async></script>

⚠️ Ne téléchargez pas et n'hébergez pas vous-même widget.js

Chargez toujours le widget depuis https://cs.askais.com/widget.js. Si vous téléchargez le fichier et l'hébergez vous-même, ou si vous le compilez dans votre propre bundle, vous le figez sur une version donnée — nos futures mises à jour de style, corrections de bugs et nouvelles fonctionnalités ne vous parviendront jamais. Chargé depuis cs.askais.com, le widget se met à jour automatiquement ; vous n'avez rien à changer.

Pilotez-le depuis votre page (facultatif)

Une fois le script chargé, un objet global window.SingChat est disponible :

// Open / close the widget
window.SingChat.open();
window.SingChat.close();

// Identify a logged-in user (so chats follow them across devices)
window.SingChat.identify({ externalId: "user_123", name: "Ada", email: "ada@acme.com" });

Applications mobiles (iOS / Android / Flutter / React Native)

Les SDK natifs sont compilés dans votre application, ils ne se mettent donc pas à jour automatiquement comme le widget web. Pour obtenir une nouvelle version, montez la version du SDK dans votre gestionnaire de paquets et publiez une nouvelle build de l'application. Le principe d'initialisation est le même partout — pointez vers https://cs.askais.com et identifiez-vous avec votre app-id :

// Swift Package Manager
.package(url: "https://github.com/singlink/singlink-ios", from: "0.1.0")

let client = SingChatClient(baseURL: "https://cs.askais.com")
try await client.identify(.deviceAnonymous(appId: "YOUR_APP_ID"))

N'importe quel backend ou langage

Aucun SDK requis — appelez directement la REST API pour identifier un contact et envoyer/recevoir des messages. Nous publions également des SDK générés à partir de notre spécification OpenAPI pour 30+ langages.

# Any backend / language — talk to the REST API directly
curl -X POST https://cs.askais.com/api/v1/auth/identify \
  -H 'Content-Type: application/json' \
  -d '{"appId":"YOUR_APP_ID","externalId":"user_123"}'

Aller plus loin

• Widget web — référence complète (événements, personnalisation, sécurité)
• SDK mobiles — iOS, Android, Flutter, React Native
• Tous les SDK et la génération de code
• Référence de la REST API