React Native アプリに AI チャットを追加する方法

Sell Whisper AI の React Native SDK をインストールし、Widget ID でクライアントを作成して、iOS と Android のアプリにチャット画面を表示します。

手順

この順番で進めてください

  1. パッケージをインストールする

    npm から @sellwhisper/chat-client と @sellwhisper/react-native を追加します。SDK は React Native 0.73 以降、Expo SDK 53 以降、iOS 15.1 以降、Android API レベル 24 以降に対応しています。

  2. Widget ID をコピーする

    ダッシュボードでエージェントを開いて「デプロイ」(Deploy)に進み、エージェントのチャットウィジェットを開きます。設定にある Widget ID は Web サイトの埋め込みで使うものと同じなので、アプリは同じエージェントとウィジェット設定を共有します。

  3. クライアントを作成し、アプリをラップする

    Widget ID と、起動をまたいで会話が保持されるよう AsyncStorage などのストレージアダプターを指定して SellWhisperClient を作成し、アプリを SellWhisperProvider でラップします。

  4. チャット画面を表示する

    チャットを表示したい場所に SellWhisperChatScreen を追加します。props でヘッダー、会話履歴、添付ファイル、音声メッセージをオンにできます。添付ファイルと音声メッセージには、オプションのピッカーパッケージとオーディオパッケージのインストールが必要です。

2 つのパッケージ

パッケージ用途
@sellwhisper/chat-clientヘッドレスクライアント:会話、メッセージ、イベントを扱い、React Native に依存しない
@sellwhisper/react-nativeReact Native と Expo 向けのプロバイダー、フック、既製のチャット画面

既製の画面を使う場合は両方をインストールします。独自のインターフェースを作る場合は、クライアントだけをインストールします。

アプリが Web サイトと共有するもの

アプリは、Web サイトの埋め込みと同じ Widget ID で接続します。つまり、エージェント、ナレッジベース、エスカレーションルールはそれぞれ 1 つで、エージェントのナレッジや指示への変更は、新しいリリースなしでアプリに反映されます。

オプション機能と必要なもの

機能必要なもの
起動をまたいだ会話履歴AsyncStorage などのストレージアダプター
添付ファイル画像またはドキュメントのピッカーパッケージ
音声メッセージ音声録音パッケージ
音声アシスタントオーディオパッケージと開発ビルド。Expo Go では動作しない
プッシュ通知アプリでのプッシュ設定と、SDK へのデバイス登録

リリース前に

  1. 実機でテストします。 シミュレーターだけでなく、iOS と Android の実機でビルドを実行します。
  2. 先にナレッジを追加します。 画面がどれだけ役立つかは、背後にあるエージェント次第です。Web サイトの内容で AI エージェントを学習させる方法をご覧ください。
  3. エスカレーションを設定します。 チームとのライブチャットはアプリでも機能します。いつ開始するかは、AI の会話を担当者に引き継ぐ方法に沿って決めてください。

インストールコマンド、コンポーネントの props、完全なサンプルは React Native SDK にあります。

よくある質問

よくある質問

SDK は Expo で動作しますか?
はい、Expo SDK 53 から対応しています。音声アシスタントには、Expo Go ではなく開発ビルドが必要です。
独自のチャットインターフェースを作れますか?
はい。@sellwhisper/chat-client は React Native に依存しないヘッドレスクライアントなので、これを使って独自のコンポーネントを動かせます。
担当者へのエスカレーションはアプリでも機能しますか?
はい。エスカレーションされた会話は、同じ画面でチームとのライブチャットとして続きます。アプリがバックグラウンドにあるときにもユーザーに届くようにするには、アプリでプッシュ通知を設定し、SDK でデバイスを登録します。

関連ドキュメント

はじめましょう

手順を実践してみましょう

無料で始められます。クレジットカードは不要です。