Twilioでは、アカウントとそのサブアカウント間、または同じアカウント内の2つのサブアカウント間で、ロングコードとショートコードの電話番号をお客様自身で移転することができます。このガイドでは、このプロセスの方法を説明します。
注: 現在、2つのアカウント間、または1つのアカウントと無関係なサブアカウント間の電話番号の移行に関する手動プロセスはサポートしていません。これらのリクエストの提出方法の詳細については、Twilio番号をアカウント間で移転するための手続きをご覧ください。
Hosted Numbers: 現在アカウントSID間でのHosted Numberの移行に関する手動プロセスはサポートしていません。別のアカウントSIDにHosted Numberを移転する場合は、Porting@Twilio.com までメールでご連絡ください。
WhatsAppが有効化された番号 : WhatsAppの送信者IDをそのまま引き継ぎたい場合は、サポートまでご連絡の上、WhatsAppの送信者IDを移転して下さい。WhatsApp 送信者の移行を行わずに番号をアカウント間で移転した場合、WhatsApp の利用登録を再度行う必要があります。
API リクエスト
移動させたい電話番号のIncomingPhoneNumber
REST APIリソースにHTTP POSTリクエストを行うことで、アカウントとそのサブアカウント間で電話番号を移動させることができます。このリクエストには、以下の情報を含める必要があります
- Phone Number SID: 移転したいPN SID (通常の電話番号・ロングコード もしくは SC SID (ショートコード
- 移転元 Account SID:
- 移転先 Account SID:
- Regulatory Bundle(必要な場合): 移転先のBundle (BU SID), もしくは Address (AD SID)、もしくは両方。 各国の Regulatory Bundle 要件(英語) 。
- アカウント認証情報: Account SID と Authトークン
cURL スクリプトのサンプル:
curl -X POST https://api.twilio.com/2010-04-01/Accounts/AC00000000000000000000000000000001/IncomingPhoneNumbers/PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json \
--data-urlencode "AccountSid=AC00000000000000000000000000000002" \
--data-urlencode "BundleSid=BUXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
--data-urlencode "AddressSid=ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-u AC00000000000000000000000000000001:your_auth_token
上記のサンプルでは電話番号 PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
をアカウント AC00000000000000000000000000000001
からサブアカウント AC00000000000000000000000000000002
へ移動しています。
このスクリプトを使えるようにするには、以下のように更新しターミナル・ウィンドウに貼り付けます。
- 1 行目 : 現在電話番号を保有するアカウントのAccount SIDに書き換えてください。
- 2行目 : 移転先アカウントの Account SID に書き換えてください。
- 3 & 4行目 : Bundle SID, Address SID を削除もしくは書き換えてください。各国の Regulatory Bundle 要件(英語)を参考にしてください。
- Line 5 : アカウントの Account SID と Auth トークン に書き換えてください。
ヘルパーライブラリのコードサンプルを含む詳細は、アカウント間で電話番号を移転する (Twilio Docs) をご覧ください。
注 : 多くの国では、規制遵守のために電話番号の身元確認書類の提出が義務付けられています。これらの規制を制定している国に基づく電話番号の移動リクエストは、受信側のアカウントまたはサブアカウントで作成された必要なAddressSidおよび/またはBundleSidが含まれていない場合、失敗します。これらの要件の影響を受ける国と電話番号の種類については、Regulatory Bundle 要件(英語)をご覧ください。
電話番号の移転が完了すると、電話番号の月額料金全額が移転先アカウントSIDに請求されます。詳細については、電話番号の課金ルールをご覧ください。
トラブルシューティング
電話番号を移動するAPIリクエストは、間違って実行するとエラーになる場合があります。リクエスト実行時にエラーが発生した場合は、以下を確認してください。
- 異なるアカウント間、またはアカウントと関係のないサブアカウント間で電話番号を移動するリクエストは、Error 21473 のレスポンスが返ります。これらのリクエストの送信については、Twilio番号をアカウント間で移転するための手続き を参照してください。
- 受信側のアカウントまたはサブアカウントに有効なRegulatory Bundleがない場合に電話番号の移動をリクエストすると、Error 21613 または Error 21649 のレスポンスが返ります。
- 間違った認証情報を使用して電話番号を移動しようとすると、Error 20003 が発生することがあります。サブアカウント間で電話番号を移動する場合でも、メインアカウントのAccount SIDとAuthトークンを使用する必要があります。
注: ショートコードSCIDリクエストは、APIからエラーレスポンスが返ることがありますが、リクエストは正しく終了します。
Consoleでの操作
現時点では、Consoleからアカウントとサブアカウント間で電話番号を移動することはできません。