メニュー

Expand
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 のマスター アカウントが一時停止された場合、サブアカウントも一時停止されます。

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

認証

You can use your master account credentials (AccountSid and AuthToken) to access Twilio's REST API for your master account as well as any of your subaccounts. You may also use a subaccount's AccountSid and AuthToken to access the resources of that subaccount. You can not use a subaccount's credentials to access the resources of your master Twilio account or any other subaccounts.

If you're authenticating the helper libraries, pass in your master Account SID and master Auth Token as the first two credentials, and the appropriate Subaccount SID as the third parameter.

国際通話

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

パーミッション

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

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

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

/2010-04-01/Accounts

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

POSTパラメーター

オプションパラメーター

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

Names in REST API format
friendly_name
オプション
post 文字列 PII MTL: 30 DAYS

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

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

        
        
        
        

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

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

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

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

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

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

              
              
              
              

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

                    
                    
                    
                    

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

                    In order to make calls and send messages using a subaccount, use the subaccount's Account SID and Auth Token, as shown in lines 7 and 8 of the following code sample:

                          
                          
                          
                          

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

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

                          You can iterate over all of the calls and sum up the product of price and duration. In this example you can see how to obtain the price.

                                
                                
                                
                                

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

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

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

                                      
                                      
                                      
                                      

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

                                            
                                            
                                            
                                            

                                            Note that you must use your master 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.

                                                  
                                                  
                                                  
                                                  

                                                  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)を記載する必要があります。

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

                                                  Transfer a phone number from your primary account AC00000000000000000000000000000001 to subaccount AC00000000000000000000000000000002:

                                                        
                                                        
                                                        
                                                        
                                                        Rate this page:

                                                        ヘルプが必要ですか?

                                                        誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。