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

Новый тред

POST/messages/{id}/thread

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

В новый тред сразу попадают тот, кто его создал, автор сообщения, все, кто ставил на сообщение реакции, и участники чата, включившие уведомления о тредах. Упомянутых в родительском сообщении — и поимённо, и тегом — добавляет фоновая задача сразу после создания, поэтому в первом ответе их может ещё не быть. Общие упоминания вроде @all в тред никого не приводят, а упомянутого, которого нет в самом чате, тред не подхватит.

Пустой тред разговором ещё не является: сразу отправьте в него первое сообщение методом POSTНовое сообщение с entity_type: "thread" и id треда из ответа. Названия у треда нет, и удалить его нельзя ни через API, ни в приложении.

Если у сообщения уже был создан тред, то в ответе на запрос вернётся информация об уже созданном ранее треде. Но чтобы просто прочитать тред, метод не нужен: идентификатор существующего треда приходит в поле thread самого сообщения. Тред под сообщением, которое само лежит в треде, завести нельзя: вложенных тредов в Пачке нет, и метод отвечает 400 с кодом thread_message.

Параметры пути

id
integer, (int32)
*
Идентификатор сообщения
Пример:154332686

Ответ

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 add 154332686 \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 201
{  "data": {    "id": 265142,    "chat_id": 2637266155,    "message_id": 154332686,    "message_chat_id": 2637266154,    "updated_at": "2023-02-01T19:20:47.204Z"  }}