【前回】AmazonConnectによる自動電話通知(7.複数連絡先への電話通知〈構築⑦〉)
【次回】AmazonConnectによる自動電話通知(7.複数連絡先への電話通知〈構築⑨〉)
【簡易版】AmazonConnectによる自動電話通知(まとめ)
監視サーバーで障害を検知した際に、自動で電話通知できるようにしていきます。ネットワークエンジニアも利用することの多い監視サーバー(Zabbix)で障害検知し、AWS上のAmazonConnectを利用し自動電話を発信します。
今回は下記の条件を満たせるようにAWSの各サービスを利用して自動電話通知の仕組みを導入します。
- 複数の通知先を登録した連絡先リストを持たせる。
- 連絡先リストに優先度(通知順)を設定する。
- 優先度が高い人に最初に電話する。
- 応答が無かった場合、次の優先度の人に順番に電話する。
- 連絡先リストの最後まで電話しても応答が無かった場合、最初に戻って継続する。
自動電話通知フロー
電話に応答した場合のフロー
- EC2上の監視サーバーで障害を検知し、S3へトリガーファイルを格納
- S3のイベント通知機能で、SQS_1にメッセージを送信
- SQS_1をトリガーとして、Lambda_1を起動
- Lambda_1がDynamoDB_1から連絡先を取得し、AmazonConnectを起動
- Lambda_1がAmazonConnectを起動すると同時に、SQS_2へメッセージを送信
- AmazonConnectがユーザーへ自動電話通知を実施
- ユーザが正常応答し、AmazonConnectがLambda_2を起動
- Lambda_2が応答結果をDynamoDB_2に保存(応答OK)
- 60秒後にSQS_2をトリガーとしてLambda_3を起動
- Lambda_3がDynamoDB_2の応答結果を確認(正常応答しているため、何もせずに処理完了)
電話に応答しなかった場合のフロー
- EC2上の監視サーバーで障害を検知し、S3へトリガーファイルを格納
- S3のイベント通知機能で、SQS_1にメッセージを送信
- SQS_1をトリガーとして、Lambda_1を起動
- Lambda_1がDynamoDB_1から連絡先を取得し、AmazonConnectを起動
- Lambda_1がAmazonConnectを起動すると同時に、SQS_2へメッセージを送信
- AmazonConnectがユーザーへ自動電話通知を実施
- ユーザが正常応答せず、AmazonConnectがLambda_2を起動
- Lambda_2が応答結果をDynamoDB_2に保存(応答NG ※実際にはステータスを変更しない)
- 60秒後にSQS_2をトリガーとしてLambda_3を起動
- Lambda_3がDynamoDB_2の応答結果を確認
- 正常応答していないため、再度AmazonConnectを起動(以降、5から繰り返し)
Lambda_1の修正
Lambda_1を下記の通り修正します。
import json
import boto3
from boto3.dynamodb.conditions import Key, Attr
# boto3からDynamoDBへアクセスするためのオブジェクトを取得
dynamodb = boto3.resource('dynamodb')
# "amazonconnect-contact-list"へアクセスするためのオブジェクトを取得
contactlist = dynamodb.Table("amazonconnect-contact-list")
# "amazonconnect-response-status"へアクセスするためのオブジェクトを取得
responsestatus = dynamodb.Table("amazonconnect-response-status")
# CallStatusを"NG"に変更する関数
def status_ng():
response = responsestatus.update_item(
Key={
'No': 1,
'Name': "Response"
},
UpdateExpression="set CallStatus=:c",
ExpressionAttributeValues={
':c': "NG"
},
ReturnValues="UPDATED_NEW"
)
return response
# "amazonconnect-contact-list"の内容を返す関数
def operation_scan():
scanData = contactlist.scan()
items=scanData['Items']
return scanData["Items"]
# 指定されたプライオリティの電話番号を返す関数
def get_phone_number(json_contactinfo, now_priority):
for line in json_contactinfo:
if line['Priority']==now_priority:
phone_number = line['Phone']
return phone_number
def lambda_handler(event, context):
# 応答結果を初期化
status_ng()
# 電話番号リストを取得
contactinfo = operation_scan()
# 初回のプライオリティを"1"に設定
priority = 1
# 指定したプライオリティの電話番号を取得
phone_number = get_phone_number(contactinfo, priority)
# boto3からAmazonConnectへアクセスするためのオブジェクトを取得
connect = boto3.client('connect')
# AmzaonConnectの問い合わせフローを呼び出し電話発信
connect.start_outbound_voice_contact(
DestinationPhoneNumber=phone_number,
ContactFlowId='************************************',
InstanceId='************************************',
SourcePhoneNumber='+81**********',
)
# boto3からSQSへアクセスするためのオブジェクトを取得
sqs = boto3.resource('sqs')
# "amazonconnect-queue-confirm"へアクセスするためのオブジェクトを取得
name = 'amazonconnect-queue-confirm'
queue = sqs.get_queue_by_name(QueueName=name)
# 現在のプライオリティをセットしてステータス確認用のキューにメッセージ送信
response = queue.send_message(MessageBody=json.dumps({"priority": priority}))
ContactFlowId:問い合わせフローID
InstanceId:インスタンスID
SourcePhoneNumber:発信元の電話番号
※国番号をつけて記述(日本の050の番号の場合、+8150********)
Lambda_2の修正
Lambda_2を下記の通り修正します。
import boto3
import json
from boto3.dynamodb.conditions import Key, Attr
# boto3からDynamoDBへアクセスするためのオブジェクトを取得
dynamodb = boto3.resource('dynamodb')
# "amazonconnect-response-status"へアクセスするためのオブジェクトを取得
responsestatus = dynamodb.Table("amazonconnect-response-status")
# CallStatusを"OK"に変更する関数
def status_ok():
response = responsestatus.update_item(
Key={
'No': 1,
'Name': "Response"
},
UpdateExpression="set CallStatus=:c",
ExpressionAttributeValues={
':c': "OK"
},
ReturnValues="UPDATED_NEW"
)
return response
def lambda_handler(event, context):
# 通知先の電話番号を取得
destphone = event['Details']['ContactData']['CustomerEndpoint']['Address']
# ユーザーの応答結果を取得
pressnum = event['Details']['ContactData']['Attributes']['pressnum']
# ユーザーの応答結果がOKの場合、CallStatusをOKに変更し、通知成功のログを出力
if pressnum == "1":
status_ok()
print(destphone + "への通知に成功しました。")
# ユーザーの応答結果がOKの場合、通知失敗のログを出力
else:
print(destphone + "への通知に失敗しました。")
return {
'statusCode': 200
}
Lambda_3の作成(AmazonConnectの通知結果を確認する関数)
関数の作成
Lambdaの「関数の作成」をクリックします。
下記の通り入力し、「関数の作成」をクリックします。
オプション:一から作成を選択
関数名:任意の名前を入力 ※ここでは、”amazonconnect-status-confirm”としています。
ランタイム:Pythonを選択 ※ここでは、最新版の”Python 3.9″を選択しています。
関数が作成されたことを確認します。
アクセス権の追加(ロールの設定)
作成された関数の設定タブに移動し、実行ロールをクリックします。
「ポリシーをアタッチします」をクリックします。
“connect”で検索し、「AmazonConnect_FullAccess」にチェックを入れます。
“sqs”で検索し、「AmazonSQSFullAccess」にチェックを入れます。
“dynamo”で検索し、「AmazonDynamoDBFullAccess」にチェックを入れ、「ポリシーのアタッチ」をクリックします。
ポリシーがアタッチされたことを確認します。
トリガーの追加
「トリガーを追加」をクリックします。
作成したSQS_2を選択し、「追加」をクリックします。
トリガーが追加されていることを確認します。(設定タブ→トリガー)
コードの記述
Lambdaのコードを記述します。
import json
import boto3
from boto3.dynamodb.conditions import Key, Attr
# boto3からDynamoDBへアクセスするためのオブジェクトを取得
dynamodb = boto3.resource('dynamodb')
# "amazonconnect-contact-list"へアクセスするためのオブジェクトを取得
contactlist = dynamodb.Table("amazonconnect-contact-list")
# "amazonconnect-response-status"へアクセスするためのオブジェクトを取得
responsestatus = dynamodb.Table("amazonconnect-response-status")
# "amazonconnect-response-status"の内容を返す関数
def status_scan():
scanData = responsestatus.scan()
items=scanData['Items']
return scanData["Items"]
# "amazonconnect-contact-list"の内容を返す関数
def operation_scan():
scanData = contactlist.scan()
items=scanData['Items']
return scanData["Items"]
# 電話番号リストの行数を返す関数
def get_contactinfo_item_number(json_contactinfo):
count = 0
for line in json_contactinfo:
count += 1
return count
# 前回のプライオリティを返す関数
def get_before_priority(sqs_event):
record = sqs_event['Records'][0]
json_record = json.loads(record["body"])
priority = json_record["priority"]
return priority
# 指定されたプライオリティの電話番号を返す関数
def get_phone_number(json_contactinfo, now_priority):
for line in json_contactinfo:
if line['Priority']==now_priority:
phone_number = line['Phone']
return phone_number
def lambda_handler(event, context):
# 応答結果を確認
statustinfo = status_scan()
# 応答結果がNGの場合
if statustinfo[0]['CallStatus'] == "NG":
# 電話番号リストを取得
contactinfo = operation_scan()
# 電話番号リストの行数を取得
contactinfo_item_number = get_contactinfo_item_number(contactinfo)
# 前回のプライオリティを取得
before_priority = get_before_priority(event)
# 前回のプラオリティが電話番号リストの行数と同じ場合(リストの最後まで通知した場合)
if before_priority == contactinfo_item_number:
# プライオリティを1に設定(最初に戻る)
priority = 1
# 前回のプラオリティが電話番号リストの行数と異なる場合(リストの最後まで通知していない場合)
else:
# プライオリティに1を足す(次のプライオリティを設定)
priority = before_priority + 1
# 指定したプライオリティの電話番号を取得
phone_number = get_phone_number(contactinfo, priority)
# boto3からAmazonConnectへアクセスするためのオブジェクトを取得
connect = boto3.client('connect')
# AmzaonConnectの問い合わせフローを呼び出し電話発信
connect.start_outbound_voice_contact(
DestinationPhoneNumber=phone_number,
ContactFlowId='************************************',
InstanceId='************************************',
SourcePhoneNumber='+81**********',
)
# boto3からSQSへアクセスするためのオブジェクトを取得
sqs = boto3.resource('sqs')
# "amazonconnect-queue-confirm"へアクセスするためのオブジェクトを取得
name = 'amazonconnect-queue-confirm'
queue = sqs.get_queue_by_name(QueueName=name)
# 現在のプライオリティをセットしてステータス確認用のキューにメッセージ送信
response = queue.send_message(MessageBody=json.dumps({"priority": priority}))
ContactFlowId:問い合わせフローID
InstanceId:インスタンスID
SourcePhoneNumber:発信元の電話番号
※国番号をつけて記述(日本の050の番号の場合、+8150********)
以上で、AmazonConnectによる自動電話通知(7.複数連絡先への電話通知〈構築⑧〉)の説明は完了です!
【前回】AmazonConnectによる自動電話通知(7.複数連絡先への電話通知〈構築⑦〉)
【次回】AmazonConnectによる自動電話通知(7.複数連絡先への電話通知〈構築⑨〉)
【簡易版】AmazonConnectによる自動電話通知(まとめ)