モバイルチャットSDK

SDKを選ぶ

• iOS

  Swift Package Managerに対応したSwift SDKと、Xcodeのサンプル。

  iOSのソースとインストールiOSのIssue

• Android

  Kotlin SDKと、Gradleのサンプルアプリ。

  AndroidのソースとインストールAndroidのIssue

• React Native

  SonnyのiOS SDKとAndroid SDKを使う、TypeScript APIとサンプルアプリ。

  React NativeのソースとインストールReact NativeのIssue

アプリを接続する

1. モバイルが有効なSonny環境で、チャネル → ライブチャット → モバイルアプリ を開きます。オーナーまたは管理者が、プラットフォームとバンドルIDまたはアプリケーションIDごとにアプリキーを作成します。
2. リポジトリのREADMEに従ってSDKをインストールします。サイトIDと、そのビルドターゲット用の公開アプリキーで設定します。React Nativeでは、iOS用とAndroid用に別々のアプリキーが必要です。
3. チャットを全画面の会話として表示するか、アプリに埋め込みます。同時にアクティブにするチャット画面はひとつにしてください。
4. ログイン中の顧客には、サーバーで識別用のJWTを作成してSDKに渡します。ログアウト時に reset() を呼び出すと、新しい訪問者セッションが始まります。

アプリキーは公開される識別子です。識別用の署名シークレットや通知プロバイダーのキーは、サーバー上またはSonnyの保護された設定内に保管されます。

プッシュ通知

通知の許可とトークンの取得はアプリ側で行います。SDKは、iOSではAPNsトークン、AndroidではFCMトークンを受け取り、Sonnyの通知のタップを処理します。配信には、あなたのアプリ用の認証情報（APNsの署名キーとAppleのチームID／キーID、またはFirebaseプロジェクトのFCMサービスアカウント）が必要です。Sonnyエージェントアプリの認証情報は別のアプリのものです。このプレビュー期間中、プッシュ配信は検証中です。

1. モバイルアプリ で、アプリのプロバイダー認証情報をアップロードします。APNsの場合は、サンドボックスか本番かの環境をビルドに合わせてください。
2. アプリを開いて通知を許可し、そのトークンをSDKに渡します。設定のデバイス一覧を更新し、登録時刻でテスト用のデバイスを選びます。
3. アプリをバックグラウンドにして、テストプッシュを送信 を選択します。デバイスで受信を確認してください。設定のステータスには、プロバイダーによる受付または安全なエラーコードが表示されます。受付されただけでは、到着したとは限りません。
4. 会話をテストするには、訪問者が切断している間にエージェントまたはAIの返信を送ります。アプリがタップを handlePush に渡すと、返信の通知からその会話が開きます。一般的なテスト通知では会話は開きません。

問題の報告とコントリビュート

お使いのSDKのリポジトリでIssueを作成してください。バージョンまたはコミット、OSとフレームワークのバージョン、小さな再現手順を添えてください。各リポジトリはプルリクエストを受け付けており、コントリビューションとセキュリティ報告のガイドラインがあります。顧客データ、識別用のJWT、デバイストークン、秘密鍵は公開のIssueに含めないでください。