Message translations

Replyco keeps translations of ticket messages, for customers who write in another language than your team. Each translation belongs to one message, and a message can have several. You usually read translations together with the messages: GET /openapi/message/pagedthreadmessages/{threadId} gives each message’s latest translation in translatedText and translatedTo, and GET /openapi/message/threadmessages/{threadId} gives all of them in messageTranslations (see Messages). The operations below read translations on their own.

Fields that matter

Field	Meaning
id	The translation’s id.
messageId	The message it translates.
languageCode	The language of the translation, such as de.
translatedText	The translated message.
isHtml	true when translatedText is HTML rather than plain text.

Listing

GET /openapi/messagetranslate/paged returns one page of all your company’s translations. It cannot filter by message; read a message’s translations through the message operations instead.

Parameter	What it does	Default	Limits
sort	Send createdDate to order by when the translation was made.	none: an order that has no meaning	createdDate; other values are rejected with 400.
asc	true oldest first, false newest first.	true	—
page	The page to return, from 1.	1	Stop at pagesCount.
count	Translations per page.	10	At most 100; a larger value is rejected with 400.

curl "https://open-api.replyco.com/openapi/messagetranslate/paged?sort=createdDate&asc=false&count=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

{
  "totalRecords": 1,
  "pageSize": 20,
  "pagesCount": 1,
  "currentPage": 1,
  "data": [
    {
      "id": "5f7b9d1e-3a5c-4e7a-9c1e-6b8d0f2a4c6e",
      "messageId": "9a4e1c7b-2d3f-4b8a-8e6c-1f0a2b3c4d5e",
      "languageCode": "en",
      "translatedText": "My parcel arrived damaged. Can I get a refund?",
      "isHtml": false
    }
  ]
}

Each operation whose path ends in /paged allows one user 15 calls a minute (see Rate limits). GET /openapi/messagetranslate/{id} returns one translation, and answers 204 with no body for an unknown id.

Operations

Method	Path	Summary	Scopes
GET	/openapi/messagetranslate/paged	Get all records with paging	—
GET	/openapi/messagetranslate/{id}	Get element by id	—

Errors

Status	Meaning	Returned by
401	Unauthorized	GET /openapi/messagetranslate/paged, GET /openapi/messagetranslate/{id}

Related

• Messages: messages with their translations.
• API reference: MessageTranslateModel.