React Native アプリに AI チャットを追加する方法
Sell Whisper AI の React Native SDK をインストールし、Widget ID でクライアントを作成して、iOS と Android のアプリにチャット画面を表示します。
この順番で進めてください
パッケージをインストールする
npm から @sellwhisper/chat-client と @sellwhisper/react-native を追加します。SDK は React Native 0.73 以降、Expo SDK 53 以降、iOS 15.1 以降、Android API レベル 24 以降に対応しています。
Widget ID をコピーする
ダッシュボードでエージェントを開いて「デプロイ」(Deploy)に進み、エージェントのチャットウィジェットを開きます。設定にある Widget ID は Web サイトの埋め込みで使うものと同じなので、アプリは同じエージェントとウィジェット設定を共有します。
クライアントを作成し、アプリをラップする
Widget ID と、起動をまたいで会話が保持されるよう AsyncStorage などのストレージアダプターを指定して SellWhisperClient を作成し、アプリを SellWhisperProvider でラップします。
チャット画面を表示する
チャットを表示したい場所に SellWhisperChatScreen を追加します。props でヘッダー、会話履歴、添付ファイル、音声メッセージをオンにできます。添付ファイルと音声メッセージには、オプションのピッカーパッケージとオーディオパッケージのインストールが必要です。
2 つのパッケージ
| パッケージ | 用途 |
|---|---|
@sellwhisper/chat-client | ヘッドレスクライアント:会話、メッセージ、イベントを扱い、React Native に依存しない |
@sellwhisper/react-native | React Native と Expo 向けのプロバイダー、フック、既製のチャット画面 |
既製の画面を使う場合は両方をインストールします。独自のインターフェースを作る場合は、クライアントだけをインストールします。
アプリが Web サイトと共有するもの
アプリは、Web サイトの埋め込みと同じ Widget ID で接続します。つまり、エージェント、ナレッジベース、エスカレーションルールはそれぞれ 1 つで、エージェントのナレッジや指示への変更は、新しいリリースなしでアプリに反映されます。
オプション機能と必要なもの
| 機能 | 必要なもの |
|---|---|
| 起動をまたいだ会話履歴 | AsyncStorage などのストレージアダプター |
| 添付ファイル | 画像またはドキュメントのピッカーパッケージ |
| 音声メッセージ | 音声録音パッケージ |
| 音声アシスタント | オーディオパッケージと開発ビルド。Expo Go では動作しない |
| プッシュ通知 | アプリでのプッシュ設定と、SDK へのデバイス登録 |
リリース前に
- 実機でテストします。 シミュレーターだけでなく、iOS と Android の実機でビルドを実行します。
- 先にナレッジを追加します。 画面がどれだけ役立つかは、背後にあるエージェント次第です。Web サイトの内容で AI エージェントを学習させる方法をご覧ください。
- エスカレーションを設定します。 チームとのライブチャットはアプリでも機能します。いつ開始するかは、AI の会話を担当者に引き継ぐ方法に沿って決めてください。
インストールコマンド、コンポーネントの props、完全なサンプルは React Native SDK にあります。