Для разработчиков

Новый самостоятельный тред

POST/threads
threads:create

Заводит тред, который ни к чему не привязан: место для разговора, диалога с агентом или звонка, которому не нужен отдельный чат. Собрать в нём можно любых сотрудников.

Создатель треда становится его единственным участником, а поля message_id и message_chat_id в ответе возвращаются как null. Добавить в тред участников проще всего упоминанием: @ник или @тег в начале или в конце текста сообщения. Можно и методом POSTДобавление участников по chat_id треда.

Названия у треда нет, поэтому сразу отправьте в него первое сообщение — по нему сотрудники и поймут, о чём речь. Его адресуют id треда с entity_type: "thread". Удалить тред нельзя. Если обсуждать нужно конкретное сообщение в чате, заводите тред под ним методом POSTНовый тред, а если нужно постоянное место с названием — создайте его методом POSTНовый чат.

Ответ

201Created
The request has succeeded and a new resource has been created as a result.
data
object
*
Тред
id
integer, (int64)
*
Идентификатор треда. Чтобы написать в тред, передайте его в entity_id метода POSTНовое сообщение с entity_type: "thread".
Пример:265142
chat_id
integer, (int64)
*
Идентификатор чата треда. По нему читают сообщения треда методом GETСписок сообщений чата и работают с его участниками.
Пример:2637266155
message_id
nullableinteger, (int64)
*
Идентификатор сообщения, к которому был создан тред. null для самостоятельного треда, созданного без привязки к сообщению.
Пример:154332686
message_chat_id
nullableinteger, (int64)
*
Идентификатор чата сообщения. null для самостоятельного треда, созданного без привязки к сообщению.
Пример:2637266154
updated_at
string, (date-time)
*
Дата и время обновления треда (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:2023-02-01T19:20:47.204Z
Новый самостоятельный тред
pachca threads create \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 201
{  "data": {    "id": 265142,    "chat_id": 2637266155,    "message_id": null,    "message_chat_id": null,    "updated_at": "2023-02-01T19:20:47.204Z"  }}