Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Contents

Get Content

Retrieves the content from the given id.

get/cx/social-messaging/v1/contents/{contentId}

Path parameters

contentIdstring required

Response

Successful response.

authorIdentityIdstring required

Identity identifier of the author of content.

Not mandatory on creation, by default it uses the token's user first identity on channel.

autoSubmittedboolean required

Auto submitted content:

  • won't reopen tasks or interventions
  • can be used to send automatic messages like asking an user to follow on twitter, sending a survey, etc,
  • doesn't get included in statistics
bodystring required

The content's body.

On creation this field is mandatory except for WhatsApp content using templates.

The following are the max length restrictions for the different channels supported. Channel and max length

  • Apple Messages For Business (max length 10000)
  • Email (max length 262144)
  • RingCX Digital Messaging (max length 1024)
  • Facebook (max length 8000)
  • GoogleBusinessMessages (max length 3000)
  • Google My Business (max length 4000)
  • Instagram (max length 950)
  • Instagram Messaging (max length 1000)
  • LinkedIn (max length 3000)
  • Messenger (max length 2000)
  • Twitter (max length 280)
  • Viber (max length 7000)
  • WhatsApp (max length 3800)
  • Youtube (max length 8000)
bodyInputFormat'Text' | 'Html' required

Values can be Text or Html.

categoryIdsstring[] required

List of the category identifiers of the content.

contextDataContentContextData

Additional data of the content.

The contextData hash keys are the custom fields keys.

creationTimestring date-time required

Creation time of the resource.

createdFrom'Synchronizer' | 'Interface' | 'Api' | 'AutoSurvey' | 'AutoResponseTrigger' | 'AutoRequestEmail' required

Created from of the content.

creatorIdstring required

RC user id of the creator

foreignCategoriesstring[]

External categories of the content.

Present only if the content has foreignCategories.

idstring required

Identifier of the content.

inReplyToAuthorIdentityIdstring required

The identity identifier of the content to which this content is a reply to.

inReplyToContentIdstring required

The content identifier to which this content is a reply to.

On creation, if omitted, a new discussion will be created. If the channel does not support to initiate discussion this parameter is mandatory.

interventionIdstring required

The intervention identifier of the content.

languagestring required

Language of the content.

publicboolean required

True if the content is publicly visible on the remote channel (default).

Private content is NOT supported on every channel.

publishedboolean required

True if the content is published on the remote channel.

ratinginteger required

Rating of the content.

Present only if the content supports rating and rating is filled.

remotelyDeletedboolean required

True if the content has been deleted on the remote channel.

sourceIdstring required

Identifier of the channel.

On creation if inReplyToContentId is specified, the channel will be determined from it. Otherwise, this parameter is mandatory.

sourceType'AppleMessagesForBusiness' | 'Email' | 'EngageMessaging' | 'Facebook' | 'GoogleBusinessMessages' | 'GoogleMyBusiness' | 'Instagram' | 'InstagramMessaging' | 'Linkedin' | 'Messenger' | 'Twitter' | 'Viber' | 'WhatsApp' | 'Youtube' required

Type of the channel.

sourceUristring uri required

External Uri of the content channel.

status'New' | 'Assigned' | 'Replied' | 'UserReply' | 'UserInitiated' | 'Ignored' required

Content status.

synchronizationStatusstring required

Synchronization status.

synchronizationErrorstring required

Synchronization error details.

threadIdstring required

Content thread identifier of the content.

titlestring required

Applicable to Email channels only.

The subject of the email.

This field is mandatory when initiating a discussion.

type'Album' | 'AuthenticateMessage' | 'AuthenticateResponse' | 'Carousel' | 'CarouselMessage' | 'Comment' | 'ContactMessage' | 'Content' | 'Email' | 'FormMessage' | 'FormResponse' | 'HsmMessage' | 'Link' | 'ListMessage' | 'Media' | 'Message' | 'OutboundMessage' | 'PaymentMessage' | 'Photo' | 'PostbackMessage' | 'PrivateTweet' | 'PromptMessage' | 'Question' | 'Review' | 'ReviewResponse' | 'RichLinkMessage' | 'SelectMessage' | 'Status' | 'TemplateMessage' | 'TimePickerMessage' | 'Tweet' | 'Video' | 'VideoCallRequestMessage' required

Type of the content.

lastModifiedTimestring date-time required

The time when the last modification was completed.

capabilitiesSupportedstring[] required

Types of structured messages that can be used to reply to this type of message.

Example response

{
  "attachments": [
    {
      "contentType": "image/jpeg",
      "creationTime": "2023-02-04T12:43:07Z",
      "filename": "0.jpeg",
      "id": "54085e5b7aa58d8b5d00006c",
      "size": 217571,
      "lastModifiedTime": "2023-02-04T12:43:07Z",
      "uri": "https://example.digital.ringcentral.com/files/attachments/54085e5b7aa58d8b5d00006c"
    }
  ],
  "authorIdentityId": "541014e17aa58d8ccf000023",
  "body": "Body of the content",
  "categoryIds": [
    "541014e17aa58d8ccf000023",
    "541014e17aa58d8ccf002023"
  ],
  "contextData": {
    "test1": "value1",
    "test2": "value2"
  },
  "creationTime": "2023-02-04T12:43:07Z",
  "creatorId": "2683222036",
  "foreignCategories": [
    "foreign_category_id"
  ],
  "id": "541014e17aa58d8ccf000023",
  "inReplyToAuthorIdentityId": "541014e17asdd8ccf000023",
  "inReplyToContentId": "123414e17asdd8ccf000023",
  "interventionId": "123415437asdd8ccf000023",
  "language": "En",
  "published": true,
  "rating": 4,
  "sourceId": "fff415437asdd8ccf000023",
  "synchronizationStatus": "success",
  "title": "An email title",
  "type": "Email",
  "lastModifiedTime": "2023-02-04T12:43:07Z"
}