Amazon Connect StartOutboundVoiceContact API を使用して顧客へのアウトバウンドコールを行うにはどうすればよいですか?

最終更新日: 2020 年 9 月 28 日

顧客にアウトバウンドコールをしたいと考えています。Amazon Connect StartOutboundVoiceContact API を使用してこれを行うにはどうすればよいですか?

簡単な説明

この記事の手順に従って、AWS コマンドラインインターフェイス (AWS CLI) を使用して呼び出しを開始する基本的なセットアップ例を作成できます。この設定を使用して発信した通話は、指定した名前を使用して通話受信者に挨拶し、通話は切断されます。

いくつかのセットアップ例など、アウトバウンドコールの自動化に関する詳細なチュートリアルについては、 Amazon Connect を使用した顧客へのアウトバウンドコールの自動化を参照してください。

解決方法

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

アウトバウンドコールの問い合わせフローを作成する

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

アクセス URL (https://alias.awsapps.com/connect/login) を使用して、Amazon Connect インスタンスにログインします。
注意: alias をインスタンスのエイリアスに置き換えます。
左ナビゲーションバーで、[Routing] (ルーティング) を一時停止し、[Contact flows] (コンタクトフロー) を選択します。
[Contact flows] の下で、テンプレートを選択するか、または [Create contact flow] をクリックして問い合わせフローを一から設計します。詳細については、「新しい問い合わせフローの作成」を参照してください。
問い合わせフローデザイナーの [Enter a name] に、問い合わせフローの名前を入力します。(例: 「アウトバウンドコール」。)
[Save] (保存) を選択します。

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

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

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

[Disconnect / hang up] (切断/ハングアップ) ブロックを追加する

問い合わせフローデザイナーから [Terminate / Transfer] (終了/転送) を選択し、[Disconnect / hang up] (切断/ハングアップ) ブロックをキャンバスにドラッグアンドドロップします。

ブロックを接続する

問い合わせフローデザイナーで、各ブロックから次のブロックに矢印を次の順序でドラッグします。

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

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

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

[Save] (保存) を選択します。
[Save flow] ダイアログで、[Save] を選択します。
[Publish] を選択します。
[Publish] (公開) ダイアログで、[Publish] (公開) を選択します。

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

問い合わせフローデザイナーで、[Show additional flow information] (追加のフロー情報の表示) を展開します。
[ARN] で、Amazon リソースネーム (ARN)をコピーします。次のようになります。
arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact-flow/123a45b6-c7d8-9012-34e5-6fab789c012d

ARN には、Amazon Connect インスタンス ID と問い合わせフロー ID が含まれます。これらの ID は、後で AWS CLI コマンドで必要になります。

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

まだ作成していない場合は、 connect:StartOutboundVoiceContactアクションの実行を許可する AWS Identity and Access Management (AWS IAM) ポリシーを作成してアタッチします。この JSON ポリシードキュメントには、必要なアクセス許可を付与します。

注意: インスタンス ARN (「Resource」) を前の手順のインスタンス ARN に置き換えます。

StartOutboundVoiceContact API を呼び出す

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

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

$ 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 形式のコンタクトセンターの電話番号に置き換えます。詳細については、AWS CLI コマンドリファレンスの start-outbound-voice-contact を参照してください。

Amazon Connect コンタクトセンターが宛先番号に電話をかけ、受信者に「Hello」と指定した名前の挨拶をして、通話の接続を切断します。