お客様へのアウトバウンド発信に Amazon Connect StartOutboundVoiceContact API を使用する方法を教えてください。

解決策

注: AWS コマンドラインインターフェイス (AWS CLI) コマンドの実行中にエラーが発生した場合は、「AWS CLI で発生したエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。

アウトバウンドコンタクトフローを作成する

重要: コンタクトフローを作成するには、セキュリティプロファイルで定義された、十分な権限を持つユーザーとして Amazon Connect インスタンスにログインします。

次の手順を実行します。

1. アクセス URL を使用して Amazon Connect インスタンスにログインします (https://alias.awsapps.com/connect/login または https://alias.awsapps.com/connect/login)。
   注: alias をインスタンスのエイリアスに置き換えてください。
2. ナビゲーションペインで [ルーティング] にカーソルを合わせ、[コンタクトフロー] を選択します。
3. [コンタクトフロー] ページでテンプレートを選択します。[コンタクトフローの作成] をクリックし、コンタクトフローを最初から設計してもかまいません。
4. コンタクトフローデザイナーの [名前の入力] にコンタクトフローの名前を入力します (例: "Outbound calling.")。
5. [保存] を選択します。

詳細については、「Amazon Connect でフローデザイナーを使用してフローを作成する」を参照してください。

[プロンプトの再生] ブロックを追加する

通話中の、顧客向け音声プロンプトを構成するには、Amazon Connect のフローブロック: [プロンプトの再生] を使用します。

次の手順を実行します。

1. コンタクトフローデザイナーで [インタラクト] を展開します。
2. [プロンプトの再生] ブロックをキャンバスにドラッグアンドドロップします。
3. [プロンプトの再生] ブロックのタイトルを選択します。
4. [プロンプト] で [テキスト読み上げ (アドホック)] を選択します。
5. [テキストを入力] にメッセージを入力します (例: "Hello. This is a test call.")。
6. [解釈方法] が [テキスト] に設定されていることを確認します。
7. [保存] を選択します。

詳細については、「Amazon Polly を使用し、フローブロックのプロンプトにテキスト読み上げを追加する」および「Amazon Connect コンタクト属性を使用する」を参照してください。

[切断 / ハングアップ] フローブロックを追加する

発信メッセージの再生後に自動的に通話を終了するには、[切断 / ハングアップ] フローブロックを使用します。

次の手順を実行します。

1. [終了 / 転送] を選択します。
2. [切断 / ハングアップ] ブロックをドラッグし、[プロンプトの再生] ブロックの右にあるキャンバスにドロップします。

問い合わせブロックを接続する

次の順序で、コンタクトフローのすべてのコネクタをブロックに接続します。 [エントリポイント]、[プロンプトの再生]、[切断 / ハングアップ]

コンタクトフローを公開する前に、すべてのコネクタをブロックに接続する必要があります。

コンタクトフローを保存して公開する

次の手順を実行します。

1. [保存] を選択し、フローのドラフトを保存します。
2. [公開] を選択して、フローをすぐにアクティブ化します。

Amazon Connect のインスタンス ID とコンタクトフロー ID を取得する

次の手順を実行します。

1. コンタクトフローデザイナーで [追加のフロー情報の表示] を展開します。
2. ARN に表示される Amazon リソースネーム (ARN) をコピーします。コンタクトフローの ARN には、Amazon Connect のインスタンス ID とコンタクトフロー ID が含まれます。これらの ID は、StartOutboundVoiceContact API の呼び出しに必要です。

コンタクトフローの ARN 例:

arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact-flow/123a45b6-c7d8-9012-34e5-6fab789c012d

Amazon Connect に対する IAM アクセス許可を確認する

AWS Identity and Access Management (IAM) ポリシーを、connect:StartOutboundVoiceContact API の呼び出しを行う IAM ロールにアタッチします。

必要な権限を付与する JSON ポリシーの例:

{  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": "connect:StartOutboundVoiceContact",
      "Resource": "arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact/*"
    }
  ]
}

注: ARN を Amazon Connect インスタンスの ARN に置き換えてください。

StartOutboundVoiceContact API を呼び出す

AWS CLI コマンド start-outbound-voice-contact を実行して StartOutboundVoiceContactAPI を呼び出します。

aws connect start-outbound-voice-contact --region awsRegion --destination-phone-number phoneNumber --contact-flow-id contactFlowId --instance-id instanceId --source-phone-number instancePhoneNumber

注: awsRegion を Amazon Connect インスタンスの AWS リージョンに置き換えてください。phoneNumber を受信者の電話番号 (E.164 形式) に置き換えてください。contactFlowId をコンタクトフロー ID に、instanceId を Amazon Connect インスタンス ID に置き換えてください。instancePhoneNumber をコンタクトセンターの電話番号 (E.164 形式) に置き換えてください。

アクションが正常に行われた場合、コマンドの応答は ContactID を返します。失敗した場合は、エラーコードが返されます。

関連情報

Amazon Connect でプロンプトを作成する

Amazon Connect でアウトバウンド発信者 ID を設定する

Amazon Connect を使用して顧客へのアウトバウンド発信を自動化する