COLUMN

2024.09.04 ｜ Writer：くらち

Amazon ConnectとAWS Lambdaでかんたん設定！〜アラート発生時の電話通知の設定手順をわかりやすく解説〜

こんにちは。今回はAWS初学者の方に向けて Amazon Connect を使用したアラート発生時にシステム管理者に電話通知するための設定手順をわかりやすく解説していきます。

1. はじめに
2. 今回Amazon Connect でやりたいこと
3. Amazon Connect でアラート発生時の電話通知を実装してみる: 3-1. 前提; 3-2. Amazon Connect の設定; 3-3. AWS Lambda の設定; 3-4. Amazon SNS の設定
4. Amazon Connect の動作確認
5. Amazon Connect でアラート発生時の電話通知を実装まとめ

1. はじめに

AWSではAmazon CloudWatch と Amazon SNSを組み合わせることで、障害アラートをメール通知する方法がよく知られていますが、重要なシステムではメール通知だけではなく電話でも通知したいというケースもあるかと思います。

そこで今回は主にAmazon Connect とAWS Lambda を使用して、アラートを電話通知させるための設定手順を解説していきます。

それでは早速見ていきましょう！

Amazon Connect に関するご相談や機能の詳しいご説明をご希望の方はお気軽にNTT東日本までお問い合わせください。

2. 今回 Amazon Connectでやりたいこと

EC2インスタンスのCPU使用率がCloudWatchAlarmで設定した閾値を超えた場合に、システム管理者へ電話通知(自動音声通知)する仕組みを実装していきます。

今回使用するAWSサービスの全体像はAmazon Connect、AWS Lambda、Amazon SNS、Amazon CloudWatch、Amazon EC2、Amazon VPCとなります。

構成図は以下の通りです。

Amazon Connect に関するご相談や機能の詳しいご説明をご希望の方はお気軽にNTT東日本までお問い合わせください。

3. Amazon Connect でアラート発生時の電話通知を実装してみる

この章では具体的な設定手順について解説していきます。

3-1. 前提

まず前提として本コラムで設定手順を解説するAWSサービスは以下となります。

Amazon Connect
AWS Lambda
Amazon SNS

上記が本コラムの主題となりますので、検証で使用する以下のAWSサービスの設定手順は割愛しております。ご了承ください。

VPC、サブネットをはじめとするネットワーク
EC2インスタンス
CloudWatchAlarm

また Amazon Connect の仕様上、090、080、070番号への発信はデフォルトで許可されていません。そのため検証の際の通知先はご自宅で使用されている電話番号やAmazon Connect でもう一つ受信用の電話番号を取得し、Amazon Connect で電話を受ける形で検証いただければと思います。

3-2. Amazon Connect の設定

それでは早速 Amazon Connect インスタンスを作成していきます。

Amazon Connect コンソールの左ペインで「インスタンス」を押下し、「インスタンスを追加する」を押下します。

ID管理では「Amazon Connect にユーザーを保存」を選択します。

アクセスURLに任意の文字列を入力し「次へ」を押下します。

管理者を追加では「管理者を指定」を選択し、名前・ユーザー名・パスワード・Eメールなど必要事項を入力します。

「次へ」を押下します。

テレフォニーオプションでは着信と発信の両方を許可し「次へ」を押下します。

データストレージではCustomer Profiles を有効化のチェックを外し「次へ」を押下します。

設定内容を確認し「インスタンスの作成」を押下します。

作成したインスタンスのステータスが「アクティブ」になったことを確認し、インスタンスにログインするため「アクセスURL」を押下します。

ログイン画面が表示されたら先ほど設定したユーザー名・パスワードを入力し、「サインイン」を押下します。

ログインができたら電話通知をするためのフローを作成していきます。

左ペインのルーティング > フローを押下します。

「フローを作成」を押下します。

以下の画像を参照し、フローを作成していきます。

「プロンプトの再生」のブロックを押下すると、右側に設定画面が開きます。

「テキスト読み上げまたはチャットテキスト」、「手動で設定」を選択します。

自動音声で流したい文章を入力し、「保存」を押下します。

一連のフローの設定が完了したら「保存」を押下し「公開」を押下します。

これでフローの作成は完了です。

後の設定手順で本フローのARNを使用するため、ARNを確認していきます。

「このフローについて」を押下し、「ARNを表示」を押下します。

フローのARNが表示されるため、メモしておきます。

次に電話番号を取得します。

左ペインからチャネル > 電話番号を押下します。

「電話番号の取得」を押下します。

チャンネルを選択では「音声」を選択します。

「料金無料通話」のタブを選択し、国/地域は「Japan +81」を選択し、表示された番号一覧から任意の番号を選択します。

コンタクトフロー/IVRで先ほど作成したフローを選択します。

「保存」を押下します。

これでAmazon Connect の設定は完了です。

3-3. AWS Lambda の設定

続いてLambda関数を作成していきます。

関数名は任意の文字列を入力し、ランタイムはNode.js 20.xとします。

「関数の作成」を押下します。

コードソースは以下を入力します。

ContactFlowId、InstanceIdは上の手順でメモした値に置き換えます。

ContactFlowId 値は、ARNの中で /contact-flow/ の後の一意の ID です。

Instance ID は /instance/ と /contact-flow/ の間にある一意の ID です。

DestinationPhoneNumber には Amazon Connect インスタンスからコール可能な電話番号を E.164 形式で設定します。(例: +811234567890)

SourcePhoneNumber は Amazon Connect インスタンスで取得した電話番号を E.164 形式で設定します。

これらの値は Lambda 内の環境変数オプションを使用して宣言することもできます。

import { ConnectClient, StartOutboundVoiceContactCommand } from "@aws-sdk/client-connect";
const client = new ConnectClient();

export const handler = async (event, context) => {

  const input = { 
      ContactFlowId: "作成したフローのID", 
      DestinationPhoneNumber: "通知先の電話番号", 
      InstanceId: "使用しているAmazon ConnectインスタンスのID", 
      SourcePhoneNumber: "発信元の電話番号" 
  };

  const command = new StartOutboundVoiceContactCommand(input);
  const response = await client.send(command);
  return response;

};

次にAWS Lambda が Amazon Connect のAPIを呼び出すために必要なIAMポリシーを作成していきます。

作成したIAMポリシーをLambda関数で設定されているIAMロールに追加します。

{ 
	"Version": "2012-10-17", 
	"Statement": [
		{
			"Sid": "VisualEditor0", 
			"Effect": "Allow", 
			"Action": "connect:StartOutboundVoiceContact", 
			"Resource": "*"
		}
	]
}