AWS Amazon Connect コネクタ構成ガイド
この記事では、Amazon Connectコネクタの構成方法について説明します。
API情報
このコネクタは以下のベンダーAPIを使用します:
- API名:Amazon Connect
- APIバージョン:v1.0
- APIエンドポイント:
https://connect.{REGION}.amazonaws.com - ドキュメント:Amazon Connect: StartOutboundVoiceContact
構成
コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します:
- 認証タイプ:(必須)使用する認証のタイプ。
- アクセスキー
- アクセスキー:(必須)IAMユーザーのアクセスキーを提供してください。関連するIAMポリシー(IAMユーザーまたは仮定されたロール用)は、データを送信したいストリームに対して
kinesis:PutRecord権限を付与する必要があります。 - シークレットキー:(必須)IAMユーザーのシークレットキーを提供してください。
- リージョン:(必須)使用しているAWS Connectのリージョンを選択してください。
- アクセスキー:(必須)IAMユーザーのアクセスキーを提供してください。関連するIAMポリシー(IAMユーザーまたは仮定されたロール用)は、データを送信したいストリームに対して
- STS
- STS - Assume Role: ARN:(必須)仮定するロールに割り当てられたAmazonリソースネーム。詳細については、IAMロールの切り替えを参照してください。
- STS - Assume Role: Session Name:(必須)仮定されたロールセッションの一意の識別子。
- STS - Assume Role: External ID:(オプション)第三者が顧客のアカウントでロールを仮定する際に使用する一意の識別子。詳細については、AWS: 第三者が所有するAWSアカウントへのアクセスを参照してください。
- リージョン:(必須)使用しているAWS Connectのリージョンを選択してください。
- アクセスキー
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| Start Outbound Voice Contact | ✓ | ✓ |
| Update Profile Attributes | ✓ | ✓ |
| Update Profile Attributes (Batch) | ✓ | ✓ |
アクションの名前を入力し、アクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
Start Outbound Voice Contact
パラメータ
| パラメータ | 説明 |
|---|---|
| Instance ID | (必須)Amazon Connectインスタンス識別子。 |
| Queue ID | 通話のキュー。キューを指定すると、発信者IDに表示される電話番号はキューで指定された電話番号です。キューを指定しない場合は、フローで定義されたキューが使用されます。Queue IDまたはSource Phone Numberのいずれかが必要です。 |
| Source Phone Number | Amazon Connectインスタンスに関連付けられた電話番号(E.164形式)。Queue IDまたはSource Phone Numberのいずれかが必要です。 |
| Contact Flow ID | (必須)発信通話のフローの識別子。 |
ベンダーパラメータ
| パラメータ | 説明 |
|---|---|
| Destination Phone Number | (必須)顧客の電話番号(E.164形式)。 |
| Campaign ID | 発信通信のキャンペーン識別子。値は1から100文字の長さである必要があります。 |
| Client Token | 重複したリクエストを防ぐための一意で大文字小文字を区別する識別子。提供されていない場合、AWS SDKがこのフィールドを埋めます。最大長は500文字です。 |
| Description | エージェントパネルの音声連絡説明。値は0から4096文字の長さである必要があります。 |
| Name | (必須)CCPに表示される音声連絡名。値は0から1024文字の長さである必要があります。 |
| Related Contact ID | タスク/チャットをリンクする関連contactId。値は1から256文字の長さである必要があります。 |
| Traffic Type | トラフィッククラス。可能な値:GENERALまたはCAMPAIGN。 |
留守番電話検出構成
| パラメータ | 説明 |
|---|---|
| Await Answer Machine Prompt | 留守番電話のプロンプトを待つかどうかを示すブール値。 |
| Enable Answer Machine Detection | 留守番電話検出が必要かどうかを示すブール値。trueの場合、Traffic TypeはCAMPAIGNでなければなりません。 |
| Attributes | 属性マップを使用したカスタムキーバリューペア。属性は標準のAmazon Connect属性であり、他の連絡先属性と同様にフローでアクセスできます。連絡先ごとにキーバリューペア全体で最大32,768 UTF-8バイトが可能です。属性キーには、英数字、ダッシュ、アンダースコアのみを含めることができます。 |
参照
| パラメータ | 説明 |
|---|---|
| Type | 参照のタイプ。可能な値:URL, NUMBER, STRING, DATE, EMAIL。 |
| Value | 参照の有効な値。たとえば、Contact Control Panel (CCP)でエージェントに表示されるフォーマットされたURL。タイプがDATEの場合、値はUnix Epoch時間形式でなければなりません。 |
Update Profile Attributes (Standard and Batched)
バッチ制限
このアクションでは、ベンダーへの大量データ転送をサポートするために、バッチリクエストを使用できます。リクエストは、次のいずれかの閾値が満たされるまでキューに入れられます:
- 最大リクエスト数:500
- 最古のリクエストからの最大時間:10分
- リクエストの最大サイズ:5 MB
パラメータ
| パラメータ | 説明 |
|---|---|
| Stream Name | (必須)データを送信するストリームを選択します。IAMポリシーがkinesis:ListStreams権限を付与していない場合は、カスタム値を手動で入力してください。 |
| Region Override | KinesisリージョンとConnectリージョンが異なる場合は、使用しているAWS Kinesisリージョンを選択します。 |
メッセージオプション
| パラメータ | 説明 |
|---|---|
| Partition Key | (必須)ストリーム内のどのシャードにデータレコードが割り当てられるかを決定します。 |
| Explicit Hash Key | (必須)データレコードが割り当てられるシャードを明示的に決定するために使用します。 |
| Sequence Number For Ordering | (必須)同じクライアントから同じパーティションキーへのメッセージに対して、厳密に増加するシーケンス番号を保証します。 |
メッセージデータ
| パラメータ | 説明 |
|---|---|
| Template Variables | (必須)テンプレートにデータ入力としてテンプレート変数を提供します。たとえば、items.nameのようにドット表記でネストされたテンプレート変数を名前付けします。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。詳細および使用例については、コネクターテンプレート変数を参照してください。 |
| Templates | (必須)データセクションで参照されるテンプレートを提供します。テンプレートは、サポートされるフィールドに名前で二重中括弧で挿入されます。たとえば、{{SomeTemplateName}}。詳細および使用例については、コネクターテンプレート変数を参照してください。 |
最終更新日 :: 2026年January月8日