MessageConversationLog

RingCentral messages and CRM correspondents to log individually or as one shared conversation activity.

Properties

Property	Type	Required	Description
conversationId	one of: string, integer · int64	No	RingCentral conversation identifier.
conversationLogId	string	No	Client-generated shared conversation mapping identifier.
messages	array of RcMessage	Yes	RingCentral messages included in this logging request.
correspondents	array of MessageCorrespondent	Yes	External participants and their CRM associations.
owner	object of any	No	Conversation owner metadata used by supported connectors.
assignee	object of any	No	Conversation assignee metadata used by supported connectors.
rcAccessToken	string · password	No	RingCentral OAuth access token used only to download fax or MMS attachments. Treat as secret; do not log or persist it.

Example

{
  "conversationId": "string",
  "conversationLogId": "string",
  "messages": [
    {
      "id": "string",
      "uri": "https://example.com",
      "extensionId": "string",
      "attachments": [
        {}
      ],
      "availability": "Alive",
      "conversationId": "string",
      "conversation": {},
      "creationTime": "2026-01-01T00:00:00Z",
      "lastModifiedTime": "2026-01-01T00:00:00Z",
      "direction": "Inbound",
      "from": {
        "phoneNumber": "string",
        "extensionNumber": "string",
        "extensionId": "string",
        "name": "string",
        "location": "string",
        "recipientId": "string",
        "target": false,
        "messageStatus": "string"
      },
      "to": [
        {}
      ]
    }
  ],
  "correspondents": [
    {
      "phoneNumber": "string",
      "name": "string",
      "type": "string",
      "id": "string"
    }
  ],
  "owner": {
    "name": "string"
  },
  "assignee": {
    "name": "string"
  },
  "rcAccessToken": "string"
}