手順1: CLIを使った電話番号の取得
はじめに
この手順では、Twilio CLIを用いてTwilioから電話番号を取得する方法を学びます。
なお、トライアルアカウントを利用した場合、いくつかの制限がある ことに注意してください。
- トライアルアカウント購入できる電話番号は１番号のみです。
- 電話/SMSの発信は登録された電話番号のみに行えます。
トライアルアカウントの制限についてはこちらをご覧ください。
この手順を進めるための前提条件
この手順を進めるためにはTwilio CLIをインストールしており、Twilioアカウントが登録されている必要があります。まだインストールが終わっていない場合は、ハンズオン: Twilio CLIをインストールを先に完了してください。
2-1. 購入可能な電話番号を表示
次のコマンドを実行し、SMS、音声通話が可能な米国地域番号の一覧を表示します。
twilio phone-numbers:buy:local --country-code US --sms-enabled --voice-enabled
選択肢から1つ選択しEnterキーを押すと購入の意思を確認されます。Yと入力し電話番号をAPI経由で購入します。
? Phone Number Region ISO Country Address Requirements
(Use arrow keys)
> +13xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
+13xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
+12xxxxxxxxx AL US none
(Move up and down to reveal more choices)
? Are you sure you want to purchase the phone number "+13xxxxxxxxx"? (Y/n)
リクエストが正常に処理されると、購入した番号の情報が表示されます。
Phone number successfully purchased!
SID Phone Number Friendly Name
PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +13xxxxxxxxx (3xx) xxx-xxxx
Twilioプロジェクトに検証済み電話番号が設定されていない場合は、電話番号の確認を促すエラーが表示されます。
» Error code 21404 from Twilio: Trial accounts must verify a phone number before purchasing a Twilio number.. See https
://www.twilio.com/docs/errors/21404 for more info.
この場合は、コンソールから番号を検証するボタンをクリックし、ご自身が所有する電話番号を登録してください。
トライアル版の場合、一度番号を購入したあと、別の番号を購入しようとすると下記のようなエラーメッセージが表示されます。
» Error code 21404 from Twilio: Trial accounts are allowed only one Twilio number. To purchase additional numbers, plea
se upgrade your account.. See https://www.twilio.com/docs/errors/21404 for more info.
続けて音声発信とSMSの送信を試してみましょう。
参考: 日本の番号について
日本の番号を購入する際のコマンドは下記の通りです。
$ twilio phone-numbers:buy:local --country-code JP --address-sid ADxxxxxxxxxxxxxxxxxxxx --bundle-sid BUxxxxxxxxxxxxxxxxxxx
現在、日本の番号を購入する場合は住所ならびに本人情報を本人書類を添えて登録し、本人確認が必要です。CLIではこのプロセスで発行されたBundle SidとAddress Sidを用いて番号を取得します。
Bundle Sidはコンソールで確認できます。また、Bundle Sidに紐づくAddress SidはそれぞれのBundle Sid内部に登録されているSupporting Documentsセクションで確認できます。
必要な情報が足りていない場合は次のようなエラーが表示されます。
Address Sid を指定していない場合
» Error code 21631 from Twilio: Phone Number Requires an Address but the 'AddressSid' parameter was empty.. See https://www.twilio.com/docs/errors/21631 for more info.
Bundle Sid を指定していない場合
» Error code 21649 from Twilio: To purchase or transfer this number you must provide a bundle compliant with the rules for the country and number type. More information here: https://www.twilio.com/docs/phone-numbers/regulatory/phone-numbers-regulatory-requirements-customers. See https://www.twilio.com/docs/errors/21649 for more info.