TWtwilio
ConversationsV1Message

Add a new message to the conversation in a specific service

Changed on

Add a new message to the conversation in a specific service

post/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v1/Services/{ChatServiceSid}/Conversations/{ConversationSid}/Messages
  • Auth
    HTTP basic

Path parameters

ChatServiceSidstring required

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

ConversationSidstring required

The unique ID of the Conversation for this message.

Headers

X-Twilio-Webhook-Enabled'true' | 'false'

The X-Twilio-Webhook-Enabled HTTP request header

Request body application/x-www-form-urlencoded

Authorstring

The channel specific identifier of the message's author. Defaults to system.

Bodystring

The content of the message, can be up to 1,600 characters long.

DateCreatedstring date-time

The date that this resource was created. If you set this parameter, Twilio ignores any milliseconds in the timestamp.

DateUpdatedstring date-time

The date that this resource was last updated. null if the message has not been edited. If you set this parameter, Twilio ignores any milliseconds in the timestamp.

Attributesstring

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

MediaSidstring

The Media SID to be attached to the new Message.

ContentSidstring

The unique ID of the multi-channel Rich Content template, required for template-generated messages. Note that if this field is set, Body and MediaSid parameters are ignored.

ContentVariablesstring

A structurally valid JSON string that contains values to resolve Rich Content template variables.

Subjectstring

The subject of the message, can be up to 256 characters long.

Response

Created

account_sidstring nullable

The unique ID of the Account responsible for this message.

chat_service_sidstring nullable

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

conversation_sidstring nullable

The unique ID of the Conversation for this message.

sidstring nullable

A 34 character string that uniquely identifies this resource.

indexinteger

The index of the message within the Conversation.

authorstring nullable

The channel specific identifier of the message's author. Defaults to system.

bodystring nullable

The content of the message, can be up to 1,600 characters long.

attributesstring nullable

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

participant_sidstring nullable

The unique ID of messages's author participant. Null in case of system sent message.

date_createdstring date-time nullable

The date that this resource was created.

date_updatedstring date-time nullable

The date that this resource was last updated. null if the message has not been edited.

deliveryunknown
urlstring uri nullable

An absolute API resource URL for this message.

linksobject nullable

Contains an absolute API resource URL to access the delivery & read receipts of this message.

content_sidstring nullable

The unique ID of the multi-channel Rich Content template.

Changes

  • v192d1169c37c2Revision changes
    • breaking

      the response's property type changed from object to no type for status

    • breaking

      the / response's property type changed from object to no type for status

  • v1b4d0e634cd69Revision changes
    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the / response's property type changed from no type to object for status