Comment ajouter un chat IA à une application React Native
Installez le SDK React Native de Sell Whisper AI, créez un client avec votre Widget ID et affichez l’écran de chat dans votre application iOS et Android.
Suivez cet ordre
Installez les packages
Ajoutez @sellwhisper/chat-client et @sellwhisper/react-native depuis npm. Le SDK prend en charge React Native 0.73 ou version ultérieure, Expo SDK 53 ou version ultérieure, iOS 15.1 ou version ultérieure et le niveau d’API Android 24 ou supérieur.
Copiez votre Widget ID
Dans le tableau de bord, ouvrez l’agent, allez dans Déployer (Deploy) et ouvrez le widget de chat de l’agent. Le Widget ID figurant dans ses paramètres est celui qu’utilise l’intégration du site web : l’application partage donc le même agent et les mêmes réglages de widget.
Créez le client et enveloppez votre application
Créez un SellWhisperClient avec le Widget ID et un adaptateur de stockage tel qu’AsyncStorage pour que les conversations soient conservées entre les lancements, puis enveloppez votre application dans SellWhisperProvider.
Affichez l’écran de chat
Ajoutez SellWhisperChatScreen à l’endroit où le chat doit apparaître. Ses props activent l’en-tête, l’historique des conversations, les pièces jointes et les messages vocaux ; les pièces jointes et les messages vocaux nécessitent l’installation des packages optionnels de sélection de fichiers et d’audio.
Deux packages
| Package | À quoi il sert |
|---|---|
@sellwhisper/chat-client | Le client headless : conversations, messages et événements, sans dépendance à React Native |
@sellwhisper/react-native | Le provider, les hooks et l’écran de chat prêt à l’emploi pour React Native et Expo |
Installez les deux pour l’écran prêt à l’emploi. Installez le client seul pour créer votre propre interface.
Ce que l’application partage avec votre site web
L’application se connecte avec le même Widget ID que l’intégration de votre site web. Cela signifie un seul agent, une seule base de connaissances et un seul ensemble de règles d’escalade, et une modification des connaissances ou des instructions de l’agent atteint l’application sans nouvelle version.
Fonctionnalités optionnelles et ce qu’elles nécessitent
| Fonctionnalité | Nécessite |
|---|---|
| Historique des conversations entre les lancements | Un adaptateur de stockage tel qu’AsyncStorage |
| Pièces jointes | Un package de sélection d’images ou de documents |
| Messages vocaux | Un package d’enregistrement audio |
| Assistant vocal | Un package audio et un build de développement ; il ne fonctionne pas dans Expo Go |
| Notifications push | Les notifications push configurées dans votre application, et l’appareil enregistré auprès du SDK |
Avant la mise en production
- Testez sur un appareil. Exécutez votre build sur un vrai appareil iOS et un vrai appareil Android, pas seulement dans un simulateur.
- Ajoutez d’abord des connaissances. L’écran n’est utile que dans la mesure où l’agent qui se trouve derrière l’est. Consultez comment entraîner un agent IA sur votre site web.
- Configurez l’escalade. Le chat en direct avec votre équipe fonctionne dans l’application ; décidez quand il démarre avec comment transférer les conversations IA à un humain.
Les commandes d’installation, les props du composant et un exemple complet se trouvent dans SDK React Native.
Questions fréquentes
Le SDK fonctionne-t-il avec Expo ?
Puis-je créer ma propre interface de chat ?
L’escalade vers une personne fonctionne-t-elle dans l’application ?
Commencer
Mettez ces étapes en pratique
Commencez gratuitement, sans carte bancaire.