Skip to content
Home/
REST API Reference
/
/
Conversation Part

Conversation Part

A Conversation Part represents a message in the conversation.

typestring

Always conversation_part

Example:"conversation_part"
idstring

The id representing the conversation part.

Example:"3"
part_typestring

The type of conversation part.

Example:"comment"
bodystring or null

The message body, which may contain HTML.

Example:"<p>Okay!</p>"
created_atinteger, (date-time)

The time the conversation part was created.

Example:1663597223
updated_atinteger, (date-time)

The last time the conversation part was updated.

Example:1663597260
notified_atinteger, (date-time)

The time the user was notified with the conversation part.

Example:1663597260
assigned_toobject or null(Reference)

The id of the admin that was assigned the conversation by this conversation_part (null if there has been no change in assignment.)

authorobject(Conversation part author)

The object who initiated the conversation, which can be a Contact, Admin or Team. Bots and campaigns send messages on behalf of Admins or Teams.

attachmentsArray of objects(Conversation part attachments)

A list of attachments for the part.

external_idstring or null

The external id of the conversation part

Example:"abcd1234"
redactedboolean

Whether or not the conversation part has been redacted.

Example:false
email_message_metadataobject or null(Email Message Metadata)

Contains metadata if the message was sent as an email

statestring

Indicates the current state of conversation when the conversation part was created.

Enum:"open""closed""snoozed"
Example:"open"
tagsArray of objects or null(Tag)

A list of tags objects associated with the conversation part.

event_details(Part type - conversation_attribute_updated_by_workflow (object or null)) or (Part type - conversation_attribute_updated_by_admin (object or null)) or (Part type - custom_action_started (object or null)) or (Part type - custom_action_finished (object or null)) or (Part type - operator_workflow_event (object or null))(Event details of Workflow & actions)
Any of:

Contains details about the workflow that was triggered and any Custom Data Attributes (CDAs) that were modified during the workflow execution for conversation part type conversation_attribute_updated_by_workflow.

app_package_codestring or null

The app package code if this part was created via API. null if the part was not created via API.

Example:"test-integration"
{
  "type": "conversation_part",
  "id": "3",
  "part_type": "comment",
  "body": "<p>Okay!</p>",
  "created_at": 1663597223,
  "updated_at": 1663597260,
  "notified_at": 1663597260,
  "assigned_to": {
    "type": "contact",
    "id": "1a2b3c"
  },
  "author": {
    "type": "admin",
    "id": "274",
    "name": "Operator",
    "email": "operator+abcd1234@intercom.io"
  },
  "attachments": [
    { … }
  ],
  "external_id": "abcd1234",
  "redacted": false,
  "email_message_metadata": {
    "subject": "Question about my order",
    "email_address_headers": [ … ]
  },
  "state": "open",
  "tags": [
    { … }
  ],
  "event_details": {
    "workflow": { … },
    "attribute": { … },
    "value": { … }
  },
  "app_package_code": "test-integration"
}