Skip to main content
このガイドは、Palette Calls で Amazon Connect を使って発信・着信できるようにするための設定手順です。

​
事前準備

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

​
1. AWS 側で Amazon Connect を準備

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

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

Palette はブラウザまたはホスト版 Calls ページで CCP を埋め込むため、Amazon Connect 側でオリジン許可が必要です。
  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 を選択する
ここで作成されるのは連携レコードの土台です。次の手順で Calls 設定を完了してください。

​
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. 保存する
保存後、Calls 画面を再読み込みし、埋め込み CCP で Amazon Connect にサインインします。

​
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 参考ドキュメント