TWtwilio
ConversationsV2Communication

Create Communication

Changed on

Create a Communication.

post/v2/Conversations/{ConversationId}/Communications

Request

  • Base URL
    https://conversations.twilio.com
  • URL
    https://conversations.twilio.com/v2/Conversations/{ConversationId}/Communications
  • Auth
    HTTP basic

Request body

channelIdstring
resourceIdstring

External resource identifier for this Communication (e.g. MessageSid for SMS/RCS/WhatsApp, TranscriptionSid + MessageIndex for Voice). If a Communication with the same resourceId already exists in the Conversation, it is updated instead of a new one being created.

occurredAtstring date-time

Timestamp when this Communication occurred. If omitted, the server uses the current time.

Example request

{
  "resourceId": "SM12345678901234567890123456789012"
}

Response

Created

idstring required

Communication ID.

conversationIdstring required

Conversation ID.

accountIdstring required

Account ID.

channelIdstring

Channel-specific reference ID.

resourceIdstring

External resource identifier for this Communication (e.g. MessageSid for SMS/RCS/WhatsApp, TranscriptionSid + MessageIndex for Voice). When set, used for Communication deduplication/uniqueness within a Conversation.

createdAtstring date-time

Timestamp when this Communication was created.

updatedAtstring date-time

Timestamp when this Communication was last updated.

occurredAtstring date-time

ISO 8601 timestamp when the communication occurred.

Example response

{
  "id": "conv_communication_00000000000000000000000001",
  "conversationId": "conv_conversation_00000000000000000000000001",
  "accountId": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "author": {
    "address": "+18005550100",
    "channel": "SMS",
    "participantId": "conv_participant_00000000000000000000000001"
  },
  "content": {
    "type": "TEXT",
    "text": "Hello, I need help with my order"
  },
  "resourceId": "SM12345678901234567890123456789012",
  "recipients": [
    {
      "address": "+18005550102",
      "channel": "SMS",
      "participantId": "conv_participant_00000000000000000000000002",
      "deliveryStatus": "DELIVERED"
    }
  ],
  "createdAt": "2023-07-01T12:15:00Z",
  "updatedAt": "2023-07-01T12:15:05Z"
}

Changes

  • v24c4068f28797Revision changes
    • info

      added the new optional request property

  • v2623775ae5ff1Revision changes
    • warning

      added the new VIDEO enum value to the / response property for the response status

    • warning

      added the new VIDEO enum value to the ////// response property for the response status

    • info

      added the new VIDEO enum value to the request property /

    • info

      added the new VIDEO enum value to the request property //