Twilioでは、REST APIを使用して電話番号の検索とプロビジョニング(購入)の両方を行えます。これにより、ユーザーは必要に応じてTwilioアプリケーションに新しい電話番号をプログラム的に追加できます。このガイドは、REST APIを使用してTwilio電話番号を検索し、プロビジョニングするプロセスをお客様に説明することを目的としています。
お知らせ 複数の電話番号をプロビジョニングするには、Twilioプロジェクトをアップグレードする必要があります。
注: 複数の電話番号を保有するためには、Twilioプロジェクトをアップグレードする必要があります。
Twilio電話番号の検索を行う
利用可能な電話番号を検索するには、適切なAvailablePhoneNumbers REST APIリソースにHTTP GETリクエストを行い、2つの必要な情報を入力します。
- Country : 2文字の ISO3166 国コード (すべて大文字)、発信国を表す。
- Phone Number Type : 取得したい電話番号の種類。
Local
、Mobile
、またはTollFree
。
APIリソースは、この2つの情報を以下のような形式でURLに含めます。
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{CountryCode}/{PhoneNumberType}.json
また、URLの後にパラメータを追加することで、検索対象を絞り込むことも可能です。以下は、cURLスクリプトの例です。
curl -X GET https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AvailablePhoneNumbers/US/Local.json?AreaCode=212 \
-u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
この例では、市外局番(212)の下にある米国内の電話番号のリストを要求しています。
このスクリプトを動作させるには、以下の内容を更新し、ターミナルウィンドウに貼り付けてください。
- 1行目 : Account SIDと country code, 電話番号タイプおよび追加パラメーター(英語)をアップデート
- 2行目 : Account SID と Auth Token(英語)をアップデート
各パラメータの詳細、およびヘルパーライブラリのコードサンプルについては、以下のリソースを参照してください。
Twilio電話番号のプロビジョンを行う
Twilio Phone Numbersは、IncomingPhoneNumbers REST APIリソースにHTTP POSTリクエストを行うことで、プロジェクトにプロビジョニングできます。ユーザーは、コンソールまたは REST API 経由で見つかった特定の既知の利用可能な電話番号をプロビジョニングするか、特定の 3 桁の市外局番からランダムに利用可能な電話番号をプロビジョニングできます(米国とカナダのみ)。
cURL スクリプトの例:
curl -X POST https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/IncomingPhoneNumbers.json \
--data-urlencode "PhoneNumber=+12125551234" \
--data-urlencode "AddressSid=ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
このサンプルではs example will provision the phone number (212)555-1234
をあなたのTwilioプロジェクト ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
に割り当てます。
このスクリプトを動作させるには、以下の更新を行い、ターミナルウィンドウに貼り付けてください。
- 1行目 : ご利用アカウントのAccount SID にアップデート
- 2行目 : 欲しい番号を E.164 formattingでアップデート
- 3行目 : 有効な Address SID もしくは Identity SID (法規制の必要に応じて(英語)) にアップデート
- 4行目 : Account SID と Auth Token(英語)をアップデート
可能な各パラメータの詳細とヘルパーライブラリのコードサンプルについては、IncomingPhoneNumber resource (Twilio Docs)をご覧ください。
注 : 多くの国で、電話番号のコンプライアンスに関するID文書が要求されています。これらの規制を満たす電話番号のプロビジョニングのリクエストには、有効なAddressSid
またはIdentitySid
パラメータを含める必要があります。これらの要件が適用される国や電話番号の種類については、電話番号規制のサイト(英語)をご覧ください。
電話番号のプロビジョニングが完了すると、お客様のプロジェクトには、毎月の料金が課金されます。
コンソールからTwilio電話番号の検索・プロビジョンを行う
TwilioのConsoleでは、弊社の在庫を検索して電話番号を購入するのにも使用できます。詳しくは、電話番号をコンソールから購入する方法をご覧ください。