よくあるお問い合わせ (FAQ)

電話番号と Bundle SID

Avatar
聖健 小原
フォローする

電話番号

弊社が提供する日本の電話番号は 050/0120/0800 です。そのため 03/06/080/090 は提供していません。

E.164

Twilio の電話番号は E.164と呼ばれる形式を使います。

例えば 050-XXXX-YYYY であれば +8150XXXXYYYY になります。

+81 は国番号と呼ばれ、+1 はアメリカ、+81 は日本です。国番号の一覧は Wikipedia を参照ください。

電話番号の先頭の 0 （国内プレフィックス）を国番号に置き換えた形式が E.164 です。Twilio は世界中に受発信できるため E.164 を利用します。

E.164 の形式チェックには Google による google/libphonenumber が利用できます。

Bundle SID について

  • 犯罪収益移転防止法のため日本の電話番号の取得には書類申請が必要です (契約時の取引時確認とは別となります)。取引時確認と同様に登記簿謄本、免許証などの本人証明、取得が代表者ではない場合は委任状が必要になります。承認されると Bundle SID と Address SID が発行され、電話番号の取得に必要となります
  • 電話番号を取得する際に Bundle が必要な国は Phone Number Regulations をご参照ください。例えば、日本の電話番号の取得には Bundle が必要ですが、アメリカの電話番号は不要です
  • 現在、個人では電話番号を取得できません
  • Bundle は作成後、当社まで承認申請をいただくことにより有効化されます
  • 当社への承認申請が問題なければ 3 営業日以内に電話番号が取得可能です
    • Account SID 単位で Bundle SID が必要になります。そのためサブアカウントにも個別に Bundle SID の取得が必要です。親 Account SID と契約者が同じであれば同じ資料で構いません
    • 050 と 0120/0800 では別途 Bundle SID が必要です
      • 050 は National タイプ、0120/0800 には Toll-Free タイプの Bundle が必要です
      • 誤って Local タイプを選択した場合は National もしくは Toll-Free で再提出が必要です
    • 1 つの Bundle SID で同一 Account SID の電話番号が取得可能です

電話番号の取得手順は下記をご参照ください。

番号検索

API による電話番号の検索は AvailablePhoneNumber を利用します。

Find available local phone numbers by area code に条件指定がない場合はランダムな電話番号が 30 件検索できます。

$ twilio api:core:available-phone-numbers:local:list --country-code JP
Phone Number   Region  ISO Country  Address Requirements
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503188XXXX  null    JP           local
+81503628XXXX  null    JP           local
+81503628XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503628XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503184XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503138XXXX  null    JP           local
+81503204XXXX  null    JP           local
+81503204XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503138XXXX  null    JP           local
+81503188XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503623XXXX  null    JP           local
+81503184XXXX  null    JP           local

contains を利用することで例えば末尾 00 の番号を一覧することができます。

Address Requirements に any/local と混在していますが、Twilio 社の管理上の問題のため気にしなくて構いません (表記統一は依頼しています)。

$ twilio api:core:available-phone-numbers:local:list --country-code JP --contains 8150******00
Phone Number   Region  ISO Country  Address Requirements
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           local
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           local
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any
+8150XXXXXX00  null    JP           any

 

番号取得

番号の取得は IncomingPhoneNumber を利用します。

承認された Bundle SID と、その Bundle SID に紐付いた Address SID と希望する電話番号をご指定ください。

Provision a Phone Number with an AddressSid and a BundleSid

$ twilio api:core:incoming-phone-numbers:create \
    --address-sid ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
    --bundle-sid BUIXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
    --phone-number +8150XXXXXXXX

なお、テストクレデンシャルを利用することで無料で電話番号取得のテストが可能です。

注意点

  • 相手に通知する発信元番号には Twilio 番号 (050/0120/0800) しか使えません
  • 契約あたり同時通話は 100 回線までとなります。それ以上の利用は専用回線が必要なため営業までお問い合わせください
    • 同時通話 100 回線の制限は電話番号単位や Account SID 単位ではなく契約単位です
    • 発信は 1 秒 1 発信
    • 1 つの電話番号で 100 回線を扱えます
    • 通話は呼び出し中もカウントします。相手の応答に関係なく電話回線を利用しているためです
  • 100 番号以上が必要な場合は営業までご連絡ください。在庫の調整をいたします

その他、電話番号の詳細は下記を参照ください。

この記事は役に立ちましたか？
0人中0人がこの記事が役に立ったと言っています
他にご質問がございましたら、リクエストを送信してください

0 コメント

記事コメントは受け付けていません。