このガイドでは、Amazon ConnectをSanka Callsに接続し、発信・着信のテスト、通話ログの確認、顧客照合、トラブルシューティング、AIに依頼する前のチェックポイントを説明します。
Sanka Callsでできること
Sanka Callsでは、Amazon Connectを使って通話の発信、着信、履歴確認を行えます。設定後は、次の操作を行えます。
- Sankaからキューと発信番号を選んで発信します。
- ブラウザまたはデスクトップ用ホストCallsウィンドウで通話に応答し、通話を管理します。
- 方向、ステータス、通話時間、電話番号、キュー、担当者、メモ、ディスポジションを含む通話ログを確認します。
- 電話番号をもとに、通話を取引先担当者や会社に関連付けます。
- 複数の顧客レコードが同じ電話番号に一致した場合は、候補を確認して正しい関連付けを選びます。
- 必要に応じて、通話内容を取引、チケット、タスク、受注、請求書などの関連レコードに紐づけます。
サポート自動化で通話ログを使う場合は、通話ステータス、メモ、顧客の関連付けが正しいことが重要です。Sankaが電話番号を確実に照合できない場合は、顧客を推測せず、人が確認する状態として扱ってください。
事前準備
- 管理者権限のあるAmazon Connectインスタンスを用意します。
- Amazon Connect側で少なくとも1つのキュー、ルーティングプロファイル、エージェントユーザーを用意します。
- 着信を受ける場合は、Amazon Connectで電話番号を取得します。
- Sanka Webとデスクトップ用ホストCallsウィンドウで使うHTTPSオリジンを用意します。
- Sankaで連携サービスを作成し、Calls設定を保存できるワークスペース管理者権限を用意します。
- 通話ログに関連付ける取引先担当者、会社、関連レコードを閲覧・更新できる権限を確認します。
AIに設定チェックリストを作成してもらう
通話設定を変更する前に、Sankaに接続したClaudeまたはCodexへチェックリスト作成を依頼します。ワークスペースとAmazon Connectの設定を確認するまでは、AIに発信、発信番号の変更、顧客メモの更新を依頼しないでください。
/sanka Amazon ConnectをSanka Callsに接続するためのチェックリストを作成してください。必要なAmazon Connectインスタンス情報、キューと発信番号の選択、Sankaワークスペース権限、期待される通話ログの動作、実行すべきテスト通話を含めてください。まだ設定変更や顧客レコード更新は行わないでください。
Amazon Connectを準備します
Amazon Connect管理コンソールで次を確認します。
- インスタンスを作成するか、既存インスタンスを開きます。
- 着信が必要な場合は電話番号を取得します。
- Sankaからの発信に使うキューを作成するか、既存キューを確認します。
- エージェントに、音声対応できるルーティングプロファイルとセキュリティプロファイルを付与します。
- Sankaに接続する前に、各エージェントがContact Control Panelへサインインし、テスト通話を処理できることを確認します。
Sankaのオリジンを許可し、CCP v2を使います
Sankaは、ブラウザまたはデスクトップ用ホストCallsウィンドウでAmazon ConnectのContact Control Panelを読み込みます。そのため、Amazon Connect側でSankaのオリジンを許可する必要があります。
- Amazon Connectのアプリケーション連携設定で、Sanka Webのオリジンを許可済みオリジンに追加します。
- HTTPSオリジンのみを使用します。
- インスタンスのContact Control Panel v2 URLを控えます。
例:
https://your-instance.my.connect.aws/ccp-v2/
https://your-instance.awsapps.com/connect/ccp-v2/
連携サービスを作成して設定します
- Sankaで ワークスペース > 連携サービス を開きます。
- Amazon Connect を選択し、ワークスペース連携を作成します。
- 取引先担当者 > Calls を開きます。
- Calls設定を入力します。
- CCP URL: Amazon Connectの
ccp-v2 URLを入力します。
- Instance ID: Amazon ConnectインスタンスIDを入力します。
- Region: 例として
us-west-2を入力します。
- Default queue: 既定の発信用キューを入力します。
- Default caller ID: Amazon Connectで対応している場合に表示する発信番号を入力します。
- Default outbound flow: 専用の発信用フローを使う場合に入力します。
- Hosted Calls URL: エージェントがデスクトップ用ホストCallsウィンドウを使う場合に入力します。
- Allowed origin status: Amazon Connectのオリジン確認状態を記録します。
- Default country code: 電話番号照合で使う既定国番号を入力します。
- 設定を保存し、Calls画面を再読み込みして、必要に応じてAmazon Connectにサインインします。
期待動作を検証します
チームに展開する前に、次を確認します。
- Sanka Callsからテスト発信します。
- 外部電話からAmazon Connectで取得した番号へ発信し、Sankaで着信が表示されることを確認します。
- 通話中の状態が、着信中、通話中、完了、不在、失敗として正しく表示されることを確認します。
- 通話ログに、方向、電話番号、通話時間、キュー、担当者、メモ、ディスポジションが表示されることを確認します。
- 電話番号が1つのレコードに明確に一致する場合、正しい取引先担当者または会社に関連付くことを確認します。
- 同じ電話番号が複数の取引先担当者または会社に一致する場合、Sankaが関連候補の確認を求めることを確認します。
- デスクトップアプリを使う場合は、ホストCallsウィンドウを開き、設定したHTTPS URLから読み込めることを確認します。
ログを検索すべてのアクションすべての日付
通話の問題をプロダクト不具合として扱う前に、これらのチェックポイントを確認します。多くの失敗は、Amazon Connectのログイン、オリジン、キュー、発信番号、電話番号照合の設定で説明できます。
通話を顧客に関連付けます
Sankaは電話番号を正規化し、取引先担当者と会社の電話番号項目と比較します。既定国番号を設定すると、市内形式の番号と国際形式の番号を一貫して比較しやすくなります。
電話番号が1つの取引先担当者または会社に明確に一致する場合、通話は自動で関連付くことが期待されます。複数のレコードが同じ電話番号を持つ場合、Sankaは関連候補を表示し、確認が必要な通話として扱います。この状態では、メモ、ディスポジション、フォローアップタスクを保存する前に、正しい取引先担当者または会社を選択してください。
発信者を特定できない場合は、顧客を確認できるまで通話を未確定のままにします。チームが発信者の本人確認とワークスペースの同意ルールを確認するまでは、通話だけを根拠に新しい取引先担当者を作成しないでください。
メモ、ディスポジション、関連レコードを確認します
選択した通話パネルで、次を確認または更新します。
- メモ: 会話内容の要点を簡潔に記録します。
- ディスポジション: 応答済み、不在、フォローアップ必要、解決済みなどの結果を記録します。
- 取引先担当者と会社: 通話に関連する顧客レコードを確認します。
- 関連レコード: フォローアップで使う取引、チケット、タスク、受注、請求書などを紐づけます。
サポート業務では、メモで事実と推測を分けて記録します。たとえば、配信設定とメッセージ履歴を確認するまでは、「メール送信が壊れています」ではなく、「顧客が請求書メールを受信していないと報告しました」と記録する方が安全です。
よくある問題を確認します
| 問題 | 確認すること |
|---|
| 埋め込みContact Control Panelが表示されません | SankaのオリジンがAmazon Connectで許可されていること、URLがccp-v2を使っていること、エージェントがAmazon Connectにサインインしていることを確認します。 |
| デスクトップCallsウィンドウが開きません | ホストCalls URLがHTTPSで、Amazon Connectパネルを読み込めるページを指していることを確認します。 |
| 発信に失敗します | 既定キュー、発信番号、発信用フロー、エージェントのルーティングプロファイル、Amazon Connect権限を確認します。 |
| 着信がSankaに表示されません | Amazon Connect連携とCalls設定を保存済みで、エージェントがサインインし、着信番号が想定キューにルーティングされていることを確認します。 |
| 間違った顧客に関連付いています | 取引先担当者と会社に重複した電話番号がないか確認し、関連候補を確認または修正します。 |
| メモやディスポジションを保存できません | ユーザーがCallsワークスペースにアクセスでき、関連する顧客レコードを更新できる権限を持つことを確認します。 |
| フォローアップタスクやワークフローが動きません | 対象の通話ステータスまたは関連レコードに対して、ワークフローやアクションが設定されているか確認します。Callsは、設定済みの自動化がない限りフォローアップ作業を作成しません。 |
AIに安全に確認させます
顧客から通話に関する問い合わせがあった場合、AIはまず設定、権限、照合、ワークフロー、期待動作のどれに該当するかを分類します。設定と通話ログのチェックポイントを確認するまでは、プロダクト不具合だと断定しないようにします。
/sanka この通話問題について、返信文やコード変更を作成する前に確認してください。Amazon Connectログイン、許可済みオリジン、キュー、発信番号、ホストCalls URL、国番号、電話番号照合、ユーザー権限、関連ワークフローで説明できるかを確認してください。期待動作、不足している証跡、次に確認すべき内容を要約してください。証跡からプロダクトの動作が誤っていると判断できるまで、顧客メモの更新やコード変更案の作成は行わないでください。
AIは、確認できたステータス、照合状態、次にユーザーが取るべき操作を含めて、顧客返信の下書きを作成できます。通話メモの変更、関連付けの変更、フォローアップタスクの作成、プロダクトコード変更の提案を行う前には、人の確認を挟んでください。
関連ガイド
Amazon Connect参考ドキュメント