Amazon Connect StartOutboundVoiceContact API を使用して、顧客に通話の発信を行うにはどうすればよいですか?

最終更新日: 2022 年 1 月 25 日

Amazon Connect を使用して、お客様に連絡するために通話の発信をプログラムしたいと考えています。Amazon Connect StartOutboundVoiceContact API を使用して通話の発信を自動化するにはどうすればよいですか?

簡単な説明

この記事の手順に従って、 StartOutboundVoiceContact API を使用して通話を開始できる設定例を作成できます。

この設定例では、Amazon Connect コンタクトセンターが通話先番号に電話をかけ、受信者に「Hello」と指定した名前で挨拶します。その後、通話は自動的に切断されます。

その他の設定例については、「Amazon Connect を使用したお客様への通話の発信の自動化」を参照してください。

解決方法

注: AWS Command Line Interface (AWS CLI) コマンドの実行中にエラーが発生した場合は、最新のバージョンの AWS CLI を使用していることを確認してください。

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

重要: 問い合わせフローを作成するには、セキュリティプロファイルで十分なアクセス許可を持つユーザーとして Amazon Connect インスタンスにログインする必要があります。

1. アクセス URL (https://alias.awsapps.com/connect/login -または- https://alias.awsapps.com/connect/login) を使用して Amazon Connect インスタンスにログインします。
注: alias をインスタンスのエイリアスに置き換えます。

2. ナビゲーションペインで、ルーティングにカーソルを合わせ、問い合わせフローを選択します。

3. [問い合わせフロー] ページで、テンプレートを選択するか、または [問い合わせフローの作成] をクリックして問い合わせフローを一スクラッチから設計します。

4. 問い合わせフローデザイナーの [名前の入力] で、問い合わせフローの名前を入力します。(例: 「アウトバウンドコール」。)

5. [保存] を選択します。

詳細については、「新しい問い合わせフローの作成」を参照してください。

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

通話中に顧客が聞く音声プロンプトを設定するには、[プロンプトの再生問い合わせブロック] を使用します。

1. 問い合わせフローデザイナーで、[Interact] (操作) を展開します。

2. [Play prompt] (プロンプトの再生) ブロックをキャンバスにドラッグアンドドロップします。

3. [再生プロンプト] ブロックのタイトルを選択します。ブロックの設定メニューが開きます。

4. [プロンプト] で、次の操作を行います。[テキスト読み上げ (臨時)] を選択します。[テキストの入力] で、次のように入力します。「Hello.This is a test call.」。[解釈する] が [テキスト] に設定されていることを確認します。[保存] を選択します。

詳細については、「テキスト読み上げ機能の追加プロンプト」および「Amazon Connect 問い合わせ属性の使用」を参照してください。

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

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

1. [Terminate /Transfer (終了/転送)] を選択します。

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

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

次の順序で、問い合わせフローのすべてのコネクタをブロックに接続します。

エントリポイント > プロンプトの再生 > 切断 / ハングアップ

重要: 問い合わせフローを公開する前に、すべてのコネクタをブロックに接続する必要があります。

問い合わせフローを保存して公開する

1. [保存] を選択して、フローのドラフトを保存します。

2. [公開] を選択して、フローをすぐにアクティブ化します。

Amazon Connect インスタンス ID と問い合わせフロー ID を取得する

1. 問い合わせフローデザイナーで、[追加のフロー情報の表示] を展開します。

2. [ARN] で、Amazon リソースネーム (ARN)をコピーします。問い合わせフロー ARN には、Amazon Connect インスタンス ID と問い合わせフロー ID が含まれます。StartOutboundVoiceContact API を呼び出すには、これらの ID が必要です。

問い合わせフロー ARN の例

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

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

まだ作成していない場合は、 connect:StartOutboundVoiceContact API の呼び出しを許可する AWS Identity and Access Management (AWS IAM) ポリシーを作成してアタッチします。

次のサンプルの JSON ポリシードキュメントでは、必要なアクセス許可が提供されています。

重要: instance ARN (「リソース」 値) を Amazon Connect インスタンスの ARN に置き換えてください。

{
  "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/*"
    }
  ]
}

StartOutboundVoiceContact API を呼び出す

AWS CLI で、次のコマンドを実行します。

重要: awsRegion を Amazon Connect インスタンスの AWS リージョンに置き換えてください。phoneNumber を E.164 形式の受信者の電話番号に置き換えます。contactFlowId を問い合わせフロー ID に置き換えます。instanceId を Amazon Connect インスタンス ID に置き換えます。instancePhoneNumber を E.164 形式のコンタクトセンターの電話番号に置き換えます。詳細については、AWS CLI コマンドリファレンスの start-outbound-voice-contact を参照してください。

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

コマンド応答は、アクションが成功すると ContactId を返し、失敗するとエラーコードを返します。

StartOutboundVoiceContact API に共通するエラーの詳細については、StartOutboundVoiceContact の「エラー」セクションを参照してください。