メニュー

Expand
ページを評価:

Conversation Service Resource

A Conversation Service is the top-level container for other resources in the Twilio Conversations REST API. All other Twilio Conversations resources, such as Conversations, Users, Messages, Bindings, and Credentials belong to a specific Service.

Services allow you to:

  • Create multiple, distinct environments (such as dev, stage, and prod) under a single Twilio account
  • REST API とクライアント API の両方を通じてリソースへのアクセスのスコープを設定する
  • Configure different Service instances with specific behaviors

A Service can also send HTTPS requests (webhooks) to URLs that you define to let you know of specific events. See what events you can subscribe to in our webhook reference.

Do not use Personally Identifiable Information (PII) for the friendlyName field.

Avoid using a person's name, home address, email, phone number, or other PII in the friendlyName field. Use some form of pseudonymized identifier, instead.

You can learn more about how we process your data in our privacy policy.

Service Defaults in the Twilio Console

You can use the REST API to configure your Conversation Service instances. (See the following examples.)

You can also find the default Conversation Service instance under Defaults in the Conversations Section of the Twilio Console.

You may have created non-default Conversation Service resources to separate messaging traffic, create development environments, etc. To access any non-default Conversation Service resources, the Service Sid (ISXXX) has to be a part of the url, as shown below:

https://conversations.twilio.com/v1/Services/ISXXX

https://conversations.twilio.com/v1/Services/ISXXX/Conversations

https://conversations.twilio.com/v1/Services/ISXXX/Conversations/CHXXX/Participants

https://conversations.twilio.com/v1/Services/ISXXX/Conversations/CHXXX/Messages

Service properties

The Service resource contains these properties:

Resource Properties in REST API format
account_sid
sid<AC> Not PII

The unique ID of the Account responsible for this service.

sid
sid<IS> Not PII

このリソースを一意に識別する 34 文字の文字列です。

friendly_name
文字列 PII MTL: 30 DAYS

The human-readable name of this service, limited to 256 characters. Optional.

date_created
date_time<iso8601> Not PII

このリソースの作成された日付です。

date_updated
date_time<iso8601> Not PII

このリソースが最後に更新された日付です。

url
url Not PII

An absolute API resource URL for this service.

links
uri_map Not PII

Contains absolute API resource URLs to access conversations, users, roles, bindings and configuration of this service.

Create a Service resource

post
https://conversations.twilio.com/v1/Services
パラメーター
Parameters in REST API format
friendly_name
必須
post 文字列 PII MTL: 30 DAYS

The human-readable name of this service, limited to 256 characters. Optional.

例 1
        
        
        

        Fetch a Service resource

        GET
        https://conversations.twilio.com/v1/Services/{Sid}
        パラメーター
        Parameters in REST API format
        sid
        Path
        GET sid<IS> Not PII

        このリソースを一意に識別する 34 文字の文字列です。

        例 1
              
              
              

              Read multiple Service resources

              GET
              https://conversations.twilio.com/v1/Services
              例 1
                    
                    
                    

                    Delete a Service resource

                    削除する
                    https://conversations.twilio.com/v1/Services/{Sid}
                    パラメーター
                    Parameters in REST API format
                    sid
                    Path
                    削除する sid<IS> Not PII

                    このリソースを一意に識別する 34 文字の文字列です。

                    例 1
                          
                          
                          
                          ページを評価:

                          ヘルプが必要ですか?

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

                                
                                
                                

                                フィードバックくださりありがとうございます!

                                We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

                                Sending your feedback...
                                🎉 Thank you for your feedback!
                                Something went wrong. Please try again.

                                Thanks for your feedback!

                                Refer us and get $10 in 3 simple steps!

                                ステップ1

                                Get link

                                Get a free personal referral link here

                                ステップ2:

                                Give $10

                                Your user signs up and upgrade using link

                                ステップ3

                                Get $10

                                1,250 free SMSes
                                OR 1,000 free voice mins
                                OR 12,000 chats
                                OR more