Amazon Connect セットアップ

事前準備

• 管理者権限のある Amazon Connect インスタンス
• Amazon Connect 側で少なくとも1つのキュー、ルーティングプロファイル、エージェントユーザー
• 着信を受ける場合は Amazon Connect で取得済みの電話番号
• Palette Web と macOS ホスト版 Calls ページで利用する HTTPS オリジン

1. AWS 側で Amazon Connect を準備

1. インスタンスを作成、または既存インスタンスを開く
2. 着信が必要なら電話番号を取得する
3. Palette からの発信に使うキューを作成、または既存キューを確認する
4. エージェントに音声対応可能なルーティングプロファイルと権限を付与する
5. 連携前に、各エージェントが CCP にサインインしてテスト着信を処理できることを確認する

2. オリジン許可と CCP v2 URL の確認

1. Amazon Connect のアプリ連携設定で、Palette のオリジンを許可リストに追加する
2. 許可する URL は HTTPS のみを使用する
3. CCP v2 URL（ccp-v2）を控える

• https://your-instance.my.connect.aws/ccp-v2/
• https://your-instance.awsapps.com/connect/ccp-v2/

3. Palette で連携サービスを作成

1. Palette で ワークスペース > 連携サービス を開く
2. Amazon Connect を選択する

4. Calls 画面で設定を完了

1. Palette の 連絡先 > Calls を開く
2. Amazon Connect 設定項目を入力する
   • CCP URL: Amazon Connect の ccp-v2 URL
   • Instance ID: Amazon Connect インスタンスID
   • Region: 例 us-west-2
   • Default Queue ID: 既定の発信キュー
   • Default Caller ID: 発信時に表示する番号
   • Default Outbound Flow ID: 専用フローがある場合のみ設定
   • Hosted Calls URL: macOS ホスト版 Calls で必須
   • Allowed Origin Status: オリジン許可の確認状態
   • Default Country Code: 電話番号正規化の既定国コード
3. 保存する

5. 発着信テスト

1. Palette Calls からテスト発信できる
2. 外部電話から着信し、Palette 側で受け取れる
3. 通話ログが作成され、既存の連絡先または会社に関連付く
4. macOS アプリ利用時は、Hosted Calls URL で Calls ウィンドウが正しく開く

トラブルシューティング

• 埋め込み CCP が表示されない場合は、Amazon Connect 側のオリジン許可と ccp-v2 URL を確認してください。
• macOS アプリで着信できない場合は、Hosted Calls URL が HTTPS で有効か確認してください。
• Amazon Connect では通話が見えるのに Palette に反映されない場合は、ワークスペース > 連携サービス の Amazon Connect 連携と Calls 設定の保存内容を再確認してください。

AWS 参考ドキュメント

• Amazon Connect インスタンスを作成
• アプリ連携の許可オリジンを追加
• CCP v2 と Streams へのアップグレード
• ルーティングプロファイル・キュー・ユーザー設定
• CCP で発信する
• amazon-connect-streams README