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.

Étapes

Suivez cet ordre

  1. 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.

  2. 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.

  3. 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.

  4. 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-clientLe client headless : conversations, messages et événements, sans dépendance à React Native
@sellwhisper/react-nativeLe 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 lancementsUn adaptateur de stockage tel qu’AsyncStorage
Pièces jointesUn package de sélection d’images ou de documents
Messages vocauxUn package d’enregistrement audio
Assistant vocalUn package audio et un build de développement ; il ne fonctionne pas dans Expo Go
Notifications pushLes notifications push configurées dans votre application, et l’appareil enregistré auprès du SDK

Avant la mise en production

  1. Testez sur un appareil. Exécutez votre build sur un vrai appareil iOS et un vrai appareil Android, pas seulement dans un simulateur.
  2. 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.
  3. 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.

FAQ

Questions fréquentes

Le SDK fonctionne-t-il avec Expo ?
Oui, à partir d’Expo SDK 53. L’assistant vocal nécessite un build de développement plutôt qu’Expo Go.
Puis-je créer ma propre interface de chat ?
Oui. @sellwhisper/chat-client est un client headless sans dépendance à React Native : vous pouvez donc vous en servir pour piloter vos propres composants.
L’escalade vers une personne fonctionne-t-elle dans l’application ?
Oui. Une conversation escaladée se poursuit en chat en direct avec votre équipe sur le même écran. Pour joindre les utilisateurs quand l’application est en arrière-plan, configurez les notifications push dans votre application et enregistrez l’appareil auprès du SDK.

Documentation associée

Commencer

Mettez ces étapes en pratique

Commencez gratuitement, sans carte bancaire.