1. AWS と Twilio で
お手軽電話番号登録システムを
作った話
2020.09.12 Sat 18:00 @ JAWS SONIC 2020
Toru TAMURA @ JAWS-UG Shimane
#jawsug #jawssonic2020
※本内容はすべて個人の見解であり、所属する企業を代表するものではありません
1

2. 自己紹介
 田村 とおる (Toru TAMURA)
 1981.12生まれ / 鳥取県在住
 facebook: toru.tamura.1231
 Twitter: @toru1231
 GitHub: toru1231
 2006.04 〜 2007.07 図書館員
 2007.08 〜 NOW() Webエンジニア(Ruby, PHP, Perl and etc…)
＋α(インフラ周り(AWS,オンプレ限らず)とか、ほかにもPMっぽいことも)
 AWS コミュニティ参加
 2013.12 〜 NOW() JAWS-UG 島根支部 コアメンバー
 2017.11 JAWS FESTA 2017 中四国 運営スタッフ
 2018.03 JAWS DAYS 2018 LT登壇➚
 2019.03 JAWS DAYS 2019 当日スタッフ
2

3. 島根支部の紹介
 主な開催場所：松江オープンソースラボ
 島根支部は、4〜6ヶ月に1回の頻度で勉強会を開催しています。（コロナ禍のため今年は1月以降お休み中）
地域柄(RubyCity MATSUE)、参加者にRubyistが多い印象。
 最近は以下のようなハンズオン勉強会を行いました。
・ECSをつかったRuby on Railsアプリのビルドハンズオン(2019/3/30)
・Cognitoを使ってブラウザからS3へダイレクトファイルアップロード(2019/7/6)
・Amazon Transcribe と AWS Comprehed をつかった文章解析と音声合成
(2020/01/25)
 山陰の地酒や海の幸などを堪能できる懇親会も好評です。
https://jawsug-shimane.doorkeeper.jp/
3

4. 最初に
今回はDynamoDBやLambda、API Gatewayを使いましたがこ
れらの設定等については特に解説しません。
4

5. Twilioとはなんぞや
電話の発着信やテキストメッセージの送受信をはじめ、その他
の様々な通信機能をソフトウェア開発者がプログラムによって
利用することを可能にしている。TwilioのサービスはHTTPを
使ってアクセスするものであり、使用状況に応じて請求される
ものである。
2019年8月時点で16万社がTwilioサービスを使用している。日
本でもサービスが提供されており、KDDIウェブコミュニケー
ションズがその代理店となっている。
出典: Twilio – Wikipedia (https://ja.wikipedia.org/wiki/Twilio)
5

6. 今回の要件
• すでに会員情報のデータはあるが、電話番号を登録しても
らうことで呼び出しのときに電話呼び出しができるように
したい（スマホで呼び出しをするシステムを拡張）。
• PC、スマホがなくても電話機だけで登録ができるようにし
たい。
今回はユーザーの電話機からTwilioの電話番号にダイヤルして
もらってガイダンスに沿って会員番号を入れてもらう方法です
すめることにしました。
イタズラ登録を防ぐために会員番号と生年月日の２つでダブル
チェックすることにしました。
6

7. 仕組み
１
1: 利用者がTwilioの番号をダイヤルする
2: Twilioから発信元の電話番号とCall IDを含んだHTTPリクエストを投げる
3: 記録＆応答メッセージをTwiMLで返す
4: TwiMLに沿って音声ガイダンスが流れる
5: ガイダンスに沿ってダイヤルボタンを押す
6: 押された内容とCall Sidを含んだHTTPリクエストを投げる
7: Call Sidをキーにデータを検索や更新などする＆応答メッセージをTwiMLで返す
あとは5〜7を繰り返して会員番号、生年月日などを受け取る
２
３４
５ ６
７
7

8. AWS Cloud
1 2
3
4
5
A: 利用者がtwilioに電話する
B: twilioからAWS API Gatewayにアクセス
1: API GatewayからLambdaをキック
2: twilioからのパラメータをDynamoDBに記録
3: twilioからのパラメータをキーに情報を返す
4: LambdaからtwiMLを返す
5: 登録が完了したらRDSに保管する
C: API Gatewayからtwilioに twiML を返す
D: twilio から利用者にtwiMLに沿った音声ガイダンスが流れる
A B
C
D
8
構成図

9. TwilioからのHTTPリクエスト
Twilioからのリクエストはユーザーが操作した結果を送ってくれるが、
その都度都度の一つひとつのリクエストになるので、同じ通話中のも
のから発生したリクエストかどうかはパラメータを参照する必要があ
る。
通話ごとに一意となるCall Sidというパラメータがあるので
DynamoDBに記録するときはこれがプライマリーキー（パーティショ
ンキー）となるようにした。発信元電話番号をソートキーとした。
他に入力の進捗を管理するための項目も準備した。これがないとユー
ザーの操作で入力された値がどのタイミングのものなのか判定する材
料がTwilioからのリクエストには含まれないため。
9

10. 各リクエストの処理について
1: ユーザーがダイヤルした最初のリクエスト
Call Sidと発信元電話番号でDynamoDBにデータを作成する。
入力の進捗を判断するための項目に “1” を設定する。
ガイダンス:
こちらは会員登録専用番号です。あなたの会員番号８桁をプッシュボ
タンで入力してください。
10

11. 各リクエストの処理について
2: ユーザーがプッシュホンで８桁を入力したときのリクエスト
Call Sidと発信元電話番号でDynamoDBのデータを取得し、入力され
た８桁の番号をそのデータに追加して更新する。
入力の進捗を判断するための項目に “2” を設定する。
ガイダンス:
次にあなたの生年月日をプッシュボタンで入力してください。年は西
暦で入力してください。例えば昭和５６年なら１９８１と入力してく
ださい。
11

12. 各リクエストの処理について
3: ユーザーがプッシュホンで生年月日を入力したときのリクエスト
Call Sidと発信元電話番号でDynamoDBのデータを取得し、入力され
た生年月日をそのデータに追加して更新する。
入力の進捗を判断するための項目に “3” を設定する。
ガイダンス:
あなたの会員番号は１２３４１２３４、生年月日は１９８１年１２月
３１日でよろしいですか。良ければ１を、変更する場合は３を押して
ください。
12

13. 各リクエストの処理について
4-1: ユーザーがプッシュホンで１を入力したときのリクエスト
Call Sidと発信元電話番号でDynamoDBのデータを取得し、記録され
ている会員番号と生年月日、でRDSの会員情報を検索し、そのレコー
ドに発信元電話番号を登録する。
ガイダンス:
（登録完了）登録が完了しました。ご利用ありがとうございます。
（登録不可）入力された会員情報が見つかりませんでした。もう一度
会員番号の入力からやり直してください。
13

14. 各リクエストの処理について
4-2: ユーザーがプッシュホンで3を入力したときのリクエスト
Call Sidと発信元電話番号でDynamoDBのデータを取得し、入力の進
捗を判断するための項目に “1” を設定することで最初からやり直すよ
うにする。ほかの項目は更新などは行わずガイダンスだけを返す。
ガイダンス:
あなたの会員番号８桁をプッシュボタンで入力してください。
14

15. tips
Twilioの電話番号を取得するには個人認証とかあるけどTwilioエバンジェ
リストのQiita記事のおかげで困ることがなかった。
利用者の応答がどのステップまで進んでいるかを把握する必要があった。
Twilioの音声合成は Polly を使っているので、水樹ミズキさんに読み上げ
てもらうことができる。
音声部分についてはどんなイントネーションになるかはAWSコンソール
のPollyのところで試してみることができるからそっちでやるとラク。会
員番号とか一文字づつ読み上げてほしい場合は “<say-as>” を使うとよい。
15

16. 最後に
Twilioを使ってスマホを利用していない利用者もサービスの対象とす
ることができたので利用者の幅が広がった。
音声でガイダンスを流すだけでなく利用者からのプッシュホンからの
入力ができることでTwilioの使い方が一気に広がった。
→これまでは利用者に電話をかけてガイダンスを流すくらいのものと思っていた。
HTTPリクエストの処理についてはAPI GatewayとLambdaの組み合わ
せがEC2とかよりも断然ラク。
Lambdaの開発はAWSコンソールでやったけどCloud9にしておけばよ
かったかなと。
16

17. 最後まで楽しみましょう！！
17