メニュー

Expand
ページを評価:

Service-Scoped Conversation Participant Resource

Each service-scoped Participant in a Conversation represents one real (probably human) participant in a non-default, service-scoped Conversation.

APIのベースURL

リファレンスドキュメントの URL はすべて、次のベース URL を使用しています。

https://conversations.twilio.com/v1

For Conversations applications that build on more than one Conversation Service instance, you will need to specify the Conversation Service SID in the REST API call:

GET /v1/Services/ISxx/Conversations/CHxx/Messages

Service-Scoped Conversation Participant Properties

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

The unique ID of the Account responsible for this participant.

chat_service_sid
sid<IS> Not PII

The SID of the Conversation Service the Participant resource is associated with.

conversation_sid
sid<CH> Not PII

The unique ID of the Conversation for this participant.

sid
sid<MB> Not PII

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

identity
文字列 PII MTL: 30 DAYS

A unique string identifier for the conversation participant as Conversation User. This parameter is non-null if (and only if) the participant is using the Conversation SDK to communicate. Limited to 256 characters.

attributes
文字列 PII MTL: 30 DAYS

An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. Note that if the attributes are not set "{}" will be returned.

messaging_binding
オブジェクト PII MTL: 30 DAYS

Information about how this participant exchanges messages with the conversation. A JSON parameter consisting of type and address fields of the participant.

role_sid
sid<RL> Not PII

The SID of a conversation-level Role to assign to the participant.

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 participant.

last_read_message_index
integer? Not PII

Index of last “read” message in the Conversation for the Participant.

last_read_timestamp
文字列 Not PII

Timestamp of last “read” message in the Conversation for the Participant.

Create a Service-Scoped Participant resource

post
https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants

Creating a Participant joins them with the Conversation, and the connected person will receive all subsequent messages.

パラメーター
Parameters in REST API format
chat_service_sid
Path
post sid<IS> Not PII

The SID of the Conversation Service the Participant resource is associated with.

conversation_sid
Path
post sid_like<CH> Not PII

The unique ID of the Conversation for this participant.

identity
オプション
post 文字列 PII MTL: 30 DAYS

A unique string identifier for the conversation participant as Conversation User. This parameter is non-null if (and only if) the participant is using the Conversation SDK to communicate. Limited to 256 characters.

messaging_binding.address
オプション
post 文字列 Not PII

The address of the participant's device, e.g. a phone or WhatsApp number. Together with the Proxy address, this determines a participant uniquely. This field (with proxy_address) is only null when the participant is interacting from an SDK endpoint (see the 'identity' field).

messaging_binding.proxy_address
オプション
post 文字列 Not PII

The address of the Twilio phone number (or WhatsApp number) that the participant is in contact with. This field, together with participant address, is only null when the participant is interacting from an SDK endpoint (see the 'identity' field).

date_created
オプション
post date_time<iso8601> Not PII

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

date_updated
オプション
post date_time<iso8601> Not PII

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

attributes
オプション
post 文字列 PII MTL: 30 DAYS

An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. Note that if the attributes are not set "{}" will be returned.

messaging_binding.projected_address
オプション
post 文字列 Not PII

The address of the Twilio phone number that is used in Group MMS. Communication mask for the Conversation participant with Identity.

role_sid
オプション
post sid<RL> Not PII

The SID of a conversation-level Role to assign to the participant.

x_twilio_webhook_enabled
ヘッダー
post ienum:webhook_enabled_type Not PII

The X-Twilio-Webhook-Enabled HTTP request header

例 1
        
        
        

        Fetch a Service-Scoped Participant resource

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

        The SID of the Conversation Service the Participant resource is associated with.

        conversation_sid
        Path
        GET sid_like<CH> Not PII

        The unique ID of the Conversation for this participant.

        sid
        Path
        GET sid<MB> Not PII

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

        例 1
              
              
              

              Read multiple Service-Scoped Participant resources

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

              The SID of the Conversation Service the Participant resource is associated with.

              conversation_sid
              Path
              GET sid_like<CH> Not PII

              The unique ID of the Conversation for participants.

              例 1
                    
                    
                    

                    Update a Service-Scoped Participant resource

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

                    The SID of the Conversation Service the Participant resource is associated with.

                    conversation_sid
                    Path
                    post sid_like<CH> Not PII

                    The unique ID of the Conversation for this participant.

                    sid
                    Path
                    post sid<MB> Not PII

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

                    date_created
                    オプション
                    post date_time<iso8601> Not PII

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

                    date_updated
                    オプション
                    post date_time<iso8601> Not PII

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

                    identity
                    オプション
                    post 文字列 PII MTL: 30 DAYS

                    A unique string identifier for the conversation participant as Conversation User. This parameter is non-null if (and only if) the participant is using the Conversation SDK to communicate. Limited to 256 characters.

                    attributes
                    オプション
                    post 文字列 PII MTL: 30 DAYS

                    An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. Note that if the attributes are not set "{}" will be returned.

                    role_sid
                    オプション
                    post sid<RL> Not PII

                    The SID of a conversation-level Role to assign to the participant.

                    messaging_binding.proxy_address
                    オプション
                    post 文字列 Not PII

                    The address of the Twilio phone number that the participant is in contact with. 'null' value will remove it.

                    messaging_binding.projected_address
                    オプション
                    post 文字列 Not PII

                    The address of the Twilio phone number that is used in Group MMS. 'null' value will remove it.

                    last_read_message_index
                    オプション
                    post integer? Not PII

                    Index of last “read” message in the Conversation for the Participant.

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

                    Timestamp of last “read” message in the Conversation for the Participant.

                    x_twilio_webhook_enabled
                    ヘッダー
                    post ienum:webhook_enabled_type Not PII

                    The X-Twilio-Webhook-Enabled HTTP request header

                    例 1
                          
                          
                          

                          Delete a Service-Scoped Conversation Participant resource

                          削除する
                          https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Participants/{Sid}

                          Deleting a participant removes them from the Coonversation; they will receive no new messages after that point.

                          パラメーター
                          Parameters in REST API format
                          chat_service_sid
                          Path
                          削除する sid<IS> Not PII

                          The SID of the Conversation Service the Participant resource is associated with.

                          conversation_sid
                          Path
                          削除する sid_like<CH> Not PII

                          The unique ID of the Conversation for this participant.

                          sid
                          Path
                          削除する sid<MB> Not PII

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

                          x_twilio_webhook_enabled
                          ヘッダー
                          削除する ienum:webhook_enabled_type Not PII

                          The X-Twilio-Webhook-Enabled HTTP request header

                          例 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. How could this documentation serve you better?

                                      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