Intégration web

Une ligne de script pour ajouter la fenêtre de chat à votre site, ainsi que les méthodes appelables et les règles linguistiques disponibles sur la page.

Dans ce qui suit, {API} désigne l'adresse du service, visible dans la page « Intégration » du back-office.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>

data-key est la clé publique, à copier depuis la page « Intégration » du back-office.
Sur la page « Intégration », enregistrez les sites autorisés à intégrer le widget (par exemple https://shop.example.com) : les autres sites qui obtiendraient votre clé publique ne pourront pas l'utiliser. À renseigner impérativement avant la mise en ligne.
En option, data-theme="dark" pour utiliser le style sombre.
En option, data-language="de" : si votre site est multilingue, transmettez la langue de la page courante ; le service client l'utilisera par défaut (le visiteur peut toujours changer). Les codes de langue pris en charge sont indiqués dans Aperçu de l'API publique.
En option, data-language="auto" : prend l'attribut <html lang> de la page comme langue par défaut, puis, lorsque la page change de langue (en modifiant l'attribut lang, sans rechargement, ce qui fonctionne aussi pour une application monopage), la fenêtre du service client suit automatiquement.

Depuis la page, vous pouvez appeler :

Méthode	Rôle
`AICS.open()` / `AICS.close()` / `AICS.toggle()`	Ouvrir, fermer la fenêtre du service client, par exemple sur un bouton « Contacter le service client »
`AICS.identify(userToken)`	Une fois le client connecté, indiquer au service client qui il est (voir Identifier les clients connectés)
`AICS.setLanguage(code)`	À appeler lorsque le site change de langue : la fenêtre du service client et les réponses suivantes suivent, par exemple `AICS.setLanguage("ja")` ; accepte aussi des formes comme `zh-Hans`, `pt-BR`
`AICS.reset()`	À appeler lorsque le client se déconnecte : démonte la fenêtre du service client et abandonne la session en cours ; recharger le script crée une nouvelle fenêtre anonyme, et le visiteur suivant ne voit pas la conversation du précédent

Langues

La fenêtre du service client s'affiche dans la langue correspondant à la localisation du visiteur (IP), y compris les textes de l'interface et le message de bienvenue ; si data-language est défini, la langue de la page est prioritaire. Si la localisation ne peut pas être déterminée, la « langue par défaut » définie dans le back-office est utilisée.
L'IA répond dans la langue utilisée par le client ; si le contenu envoyé par le client ne permet pas de déterminer la langue (emoji, numéro de commande), elle utilise la langue déterminée ci-dessus.
Le client peut changer de langue via le menu de langue en haut de la fenêtre, ou simplement demander à l'IA « Réponds en anglais, s'il te plaît ». L'IA continuera ensuite dans cette langue, même si le client écrit dans une autre langue.
Le changement de langue du site (via AICS.setLanguage ou, avec data-language="auto", la modification de <html lang>) compte aussi comme un choix du client ; entre toutes ces méthodes, c'est la dernière qui s'applique ; la langue par défaut présente au chargement de la page n'écrase pas la langue choisie par le client.
Dans le back-office, « Paramètres du bot → Langue », vous pouvez désactiver la détection par IP, modifier la langue par défaut et limiter les langues proposées.
Si le service est déployé derrière un proxy inverse ou un CDN, vous devez configurer TRUSTED_PROXIES ou COUNTRY_HEADER côté serveur, sinon l'IP réelle du visiteur ne sera pas disponible.

Cette page vous a-t-elle été utile ?

Dernière mise à jour: 31 octobre 2026