Amazon Connect StartOutboundVoiceContact API を使用して、お客様にアウトバウンドコールをするにはどうすればよいですか?

所要時間2分

Amazon Connect StartOutboundVoiceContact API を使用して、お客様に連絡するためのアウトバウンドコールをプログラムしたいと考えています。

簡単な説明

次の設定例で、StartOutboundVoiceContact API を使用して通話を開始することができます。この例では、Amazon Connect コンタクトセンターが通話先番号に電話をかけ、受信者に指定した名前で「Hello」と挨拶します。その後、通話は自動的に切断されます。その他の設定例については、「Automating outbound calling to customers using Amazon Connect」を参照してください。

解決策

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

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

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

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

詳細については、「フローを作成する」を参照してください。

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

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

問い合わせフローデザイナーで、[Interact] を展開します。
[プロンプトの再生] ブロックをキャンバスにドラッグアンドドロップします。
[プロンプトの再生] ブロックのタイトルを選択します。ブロックの設定メニューが開きます。
[プロンプト] で、次の手順を実行します。
[テキスト読み上げ (臨時)] を選択します。
[テキストの入力] で、「Hello.This is a test call.」と入力します。
[解釈する] が [テキスト] に設定されていることを確認します。
[保存] を選択します。

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

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

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

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

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

次の順序で、問い合わせフローのすべてのコネクタをブロックに接続します。
エントリポイント > プロンプトの再生 > 切断 / ハングアップ
重要: 問い合わせフローを公開する前に、すべてのコネクタをブロックに接続する必要があります。

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

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

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

問い合わせフローデザイナーで、[追加のフロー情報の表示] を展開します。
[ARN] で、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 ポリシーの例では、必要なアクセス許可を提供しています。

重要: インスタンス 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-flow/*"
    }
  ]
}

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 の「エラー」セクションを参照してください。