メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

REST API: Subaccount

Twilio のサブアカウントは、アカウントが「所有」しているアカウントです。アカウントの利用者が Twilio を利用するたびにサブアカウントを使ってそれを独立させて、他のすべてのサブアカウントから分離された状態に維持することができます。これにより、各利用者の活動やリソースを簡単に管理できるようになります。

Important Notes:

  • 既定では、マスターアカウントは最大1,000のサブアカウントを持つことができます。さらにサブアカウントが必要な場合は、株式会社KDDIウェブコミュニケーションズのサポート窓口までご連絡ください。
  • Subaccounts will not have access to the API Explorer in their Twilio Console.
  • By default, closed subaccounts get deleted after the parent account is closed. To enable automatic deletion of subaccounts, 30-days after you closed them, please contact support.

課金

Twilio はすべてのサブアカウントの利用分を、直接マスター アカウントへ課金します。 すべてのアカウントの Twilio の残高は一括して管理されます。 Twilio のマスター アカウントが一時停止された場合、サブアカウントも一時停止されます。

サブアカウントの請求の計算にスキップ >>

認証

マスター アカウント のクレデンシャル (AccountSid と AuthToken) を使って Twilio の REST API にアクセスし、マスター アカウントと同じようにサブアカウントも操作することができます。 サブアカウントの AccountSid と AuthToken を使って、そのサブアカウントのリソースにアクセスすることもできます。サブアカウントのクレデンシャルを使って、マスター アカウントや他のサブアカウントのリソースにアクセスすることはできません。

国際通話

Twilio は現在、お客様が国際電話の不正利用のリスクを最小化するのに役立つ方法に取り組んでおり、Twilio サブアカウントで特定の国の宛先にダイヤルする方法を提供しています。ご質問がある場合はサポートにご連絡ください。

パーミッション

サブアカウントは、マスターアカウントの音声とSMSメッセージングのアクセス許可(地理による許可など)を引き継ぎます。電話番号を引き継ぐことはできません。

サブアカウントを作成する

新しいサブアカウントを作成するには、ユーザーの Accounts リスト リソース URI に HTTP POST リクエストを発行してください。

/2010-04-01/Accounts

リクエストが成功すると、Twilio は新しいAccount リソースの表現を返します。

POSTパラメーター

オプションパラメーター

サブアカウント作成のリクエストには、以下のパラメーターを含めることができます。

FriendlyName
オプション
post 文字列 Not PII

A human readable description of the account to create, defaults to SubAccount Created at {YYYY-MM-DD HH:MM meridian}

FriendlyName プロパティは、アカウントを整理して自分のシステムの情報へ関連付ける際に役立ちます。 たとえば、ある顧客について、自分のアプリケーションのデータベースのプライマリ キーを FriendlyName とするサブアカウントを作成したい場合があります。

Loading Code Sample...
      
      
          
          
          
          
        

      サブアカウントを使い始めよう

      サブアカウントは、Twilio を利用するたびにそれを独立させる非常に便利な方法であり、利用者、エージェント、または従業員の代わりに処理を実行します。

      Twilio を活用したホスティングサービスを運営している場合、登録した利用者ごとに Twilio のサブアカウントを作成できます。利用者がそのサービスのアカウントを解約する場合、単純に、関連付けられている Twilio のサブアカウントを無効化できます。

      サブアカウントでは親アカウントと同様に Twilio REST API, 電話番号の所有、Caller ID、アプリケーション、および SIP ドメインを利用できます。サブアカウントの通話、メッセージ、録音、およびトランスクリプションは、他のサブアカウントに影響を与えずに、管理できます。

      サブアカウントを検索する

      AccountSid を使って、REST API で特定のサブアカウントとそれに関連するリソースをクエリできます。

      Loading Code Sample...
          
          
              
              
              
              
            

          サブアカウントの AccoundSid が不明な場合も、FriendlyName がわかれば、FriendlyName クエリ文字列フィルターで Accounts リストリソースをクエリできます。

          Loading Code Sample...
              
              
                  
                  
                  
                  
                

              サブアカウントによる発信

              サブアカウントを使用して電話をかけ、メッセージを送信するには、アカウントクレデンシャルをサブアカウントクレデンシャルで置き換える必要があるだけです。

              Loading Code Sample...
                  
                  
                      
                      
                      
                      
                    

                  サブアカウント利用の請求の計算

                  多くの場合、サブアカウントに発生した請求を計算できます。利用者のサブアカウントを作成し、毎月の使用料金を請求する必要があるとします。

                  次に、直近 30 日間の利用者の通話分数を計算する方法を示します。

                  Loading Code Sample...
                      
                      
                          
                          
                          
                          
                        

                      サブアカウントを一時停止する

                      一時停止中のサブアカウントは、電話をかける、受ける、SMS メッセージを送る、受け取ることができません。これは、利用者が支払わないときに、支払が正しく行われるまでそのアカウントを一時停止したい場合に便利です。ただし、サブアカウントが所有する電話番号は毎月請求されます。

                      To suspend a subaccount, POST the parameter 'Status' with the value 'suspended' to suspend an account.

                      Loading Code Sample...
                          
                          
                              
                              
                              
                              
                            

                          To reactivate a suspended subaccount, POST the value active for the Status parameter and we will restore the account to full service.

                          Loading Code Sample...
                              
                              
                                  
                                  
                                  
                                  
                                

                              Note that you must use your primary account's authentication credentials to suspend a subaccount. You cannot suspend your master account.

                              サブアカウントを削除する

                              If your customer closes their account with you, you can permanently close the associated Twilio subaccount by POSTing the parameter Status with the value closed to the subaccount resource URI.

                              Loading Code Sample...
                                  
                                  
                                      
                                      
                                      
                                      
                                    

                                  When you close a subaccount, Twilio will release all phone numbers assigned to it and shut it down completely. You can't ever use a closed account to make and receive phone calls or send and receive SMS messages. It's closed, gone, kaput – you cannot reopen a closed account.

                                  Your closed subaccount will still appear in your accounts list, and you will still have access to historical data for that subaccount, unless automatic deletion of closed subaccounts is enabled.

                                  If you have enabled automatic deletion of closed subaccounts through the Subaccounts settings page, we will delete all subaccount data 30 days after closure including previously closed subaccounts and those subaccounts will no longer appear on the Console.

                                  • Twilio has enabled this setting for all accounts created after July 5, 2018, and for all accounts without subaccounts
                                  • For all other accounts, account owners can turn this setting on through the Subaccounts settings page.

                                  サブアカウントを削除するには、マスターアカウントの認証クレデンシャルを使用する必要がありますので、注意してください。 また、自分のマスターアカウントを削除することはできません。

                                  アカウント間で電話番号を交換する

                                  サブアカウント間、またはマスター アカウントとサブアカウントの間で、電話番号を移動できます。 電話番号を移動する API リクエストは、必ずマスター アカウントのクレデンシャルを使用して発行してください。

                                  自分が管理する 2 つのアカウントの間で電話番号を移動するには、 IncomingPhoneNumber インスタンス リソース に HTTP POST リクエストを発行します。 POST のボディーの AccountSid パラメーターに、移動したい番号の所有者となるアカウントの AccountSid をセットします。 これにより、電話番号は元のアカウントから移動され、新しいアカウントの IncomingPhoneNumbers リスト リソースで使用可能になります。他のすべてのプロパティは引き継がれます。

                                  住所の必要な電話番号を移動したい場合、新しいサブアカウントに適切な住所(Address)を記載する必要があります。

                                  なお、前述の方法でサブアカウントを削除すると、このアカウントの電話番号はすべて開放されますので、電話番号を保持しておきたい場合は、事前にすべての番号をマスター アカウントへ移動しておくという方法もあります。

                                  ある電話番号を AC00000000000000000000000000000001 から AC00000000000000000000000000000002 へ移動します。

                                  Loading Code Sample...
                                      
                                      
                                          
                                          
                                          
                                          
                                        

                                      ヘルプが必要ですか?

                                      We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

                                      Loading Code Sample...