Premiers pas

Integration overview

Un seul backend, toutes les plateformes. Intégrez une fois, et tout reste à jour.

AskAIs, c'est un seul backend avec de nombreuses façons de se connecter. 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. Vos clients peuvent aussi vous joindre via des canaux entrants comme Telegram et WhatsApp. Chaque client et chaque canal 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

Plateforme	Installation	Mode de mise à jour
Site web	`<script src="…/widget.js">`	Automatique, chaque chargement de page récupère la dernière version
iOS (WebView)	`WebView embed`	Automatique, la WebView charge le dernier widget
Android (WebView)	`WebView embed`	Automatique, la WebView charge le dernier widget
Flutter (SDK natif)	`pub (local package)`	Montez la version du SDK, publiez une nouvelle build de l'application
React Native (WebView)	`WebView / REST`	Automatique, la WebView charge le dernier widget
N'importe quel backend	`REST API / OpenAPI`	Votre propre service, à chaque déploiement

Tous les clients et canaux fonctionnent-ils ensemble ?

Oui. Ce sont différentes portes d'entrée vers le même espace de travail AskAIs, 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.
Des canaux entrants aussi, pas seulement des intégrations : en plus du widget web et in-app, vos clients peuvent vous joindre sur Telegram et WhatsApp (les deux en service de bout en bout), et chaque message arrive dans la même boîte de réception ; un emplacement X est prêt.
Configuration partagée : votre agent IA (hébergé par la plateforme ou avec votre propre clé), 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://singchat.org/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://singchat.org"
        async></script>

⚠️ Ne téléchargez pas et n'hébergez pas vous-même widget.js
Chargez toujours le widget depuis https://singchat.org/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 singchat.org, 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 : SDK Flutter ou intégration WebView

Pour le mobile, vous avez trois options réelles. Premièrement, le SDK natif du widget Flutter offre une interface de chat complète et personnalisable (bulle flottante et écran de chat natif, pas une WebView) ; ajoutez-le à votre pubspec et publiez. Deuxièmement, sur iOS et Android (et React Native), vous pouvez intégrer le widget web complet dans une WebView, la même expérience que sur le site, et il reste à jour tout seul. Troisièmement, pilotez la REST API avec des webhooks signés et affichez votre propre interface. Il n'existe pas de SDK de chat natif iOS, Android ou React Native distinct à installer ; ce sont là les voies prises en charge.

# Flutter, native chat widget (floating bubble + native chat UI, not a WebView).
# In your app's pubspec.yaml (download and unzip the SDK package first):
dependencies:
  singchat_widget:
    path: ../singchat_widget

# iOS / Android / React Native without Flutter: load the hosted web widget in a
# WKWebView / WebView (same experience as the website), or drive the REST API
# with signed webhooks and render your own chat UI.

N'importe quel backend ou langage

Aucun SDK requis, appelez directement la REST API pour identifier un contact et envoyer ou recevoir des messages, et vérifiez les événements entrants avec des webhooks signés. Toute l'API suit une spécification OpenAPI publiée, vous pouvez donc générer un client dans votre propre langage ou simplement appeler les points de terminaison directement.

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

Aller plus loin

PrécédentDémarrage rapide SuivantMCP server (AI agents)