---
metadata:
- name: generator
content: Diplodoc Platform v5.44.0
alternate:
- https://yandex.ru/dev/tasks-api/doc/ru/reference/message-threads/post-message-threads-compose.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/tasks-api/doc/ru/llms.txt
# Отправить уведомление исполнителям
Напишите нам, если не нашли ответ в Справке. Вы можете приложить скриншоты или видео, чтобы ускорить помощь:
Написать в чат Написать в Telegram
```bash
POST /message-threads/compose
```
Рассылает уведомление исполнителям.
- [Указать адресатов списком](#body).
- [Отобрать исполнителей с помощью фильтра](#body).
{% note alert "Ограничение" %}
Вы можете отправить не более **1** уведомления в день всем исполнителям и не более **100 000** уведомлений в день отдельным исполнителям.
См. полный список ограничений на странице [Ограничение количества запросов](https://yandex.ru/dev/tasks-api/doc/ru/rate-limiting.md).
{% endnote %}
## Примеры запросов {#request}
{% list tabs %}
- cURL
```bash
curl -X POST 'https://tasks.yandex.ru/api/v1/message-threads/compose' \
-H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
-H 'Content-Type: application/json' \
-d '{"topic":{"EN":"Thank you!"},"text":{"EN":"Amazing job! We have just trained our first model."},"recipients_select_type":"ALL","answerable":false}'
```
- Python
```python
import requests
url = "https://tasks.yandex.ru/api/v1/message-threads/compose"
headers = {
'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
'Content-Type': 'application/json'
}
payload = {
"topic": {
"EN": "Thank you!"
},
"text": {
"EN": "Amazing job! We have just trained our first model."
},
"recipients_select_type": "ALL",
"answerable": False
}
response = requests.post(url, headers=headers, json=payload)
print(response.text)
```
- Nodejs
```js
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://tasks.yandex.ru/api/v1/message-threads/compose',
'qs': {},
'headers': {
'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
'Content-Type': 'application/json'
},
'body': JSON.stringify({
"topic": {
"EN": "Thank you!"
},
"text": {
"EN": "Amazing job! We have just trained our first model."
},
"recipients_select_type": "ALL",
"answerable": false
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
```
{% endlist %}
## Заголовки {#headers}
#|
|| **Заголовок** | **Описание** ||
|| {% include [reusables-auth-nh](../../_includes/reusables/auth-nh.md) %} | [API-токен](https://yandex.ru/dev/tasks-api/doc/ru/access.md#token) для авторизации аккаунта. В качестве префикса добавьте `OAuth`.
||
|| `Content-Type` | Указывает формат данных (`application/json`) в передаваемом теле запроса. ||
|#
## Тело и параметры запроса {#body}
{% list tabs %}
- Уведомление со списком адресатов
```json
{
"topic": {
"EN": "You have got a bonus!"
},
"text": {
"EN": "The bonus was awarded for good job!"
},
"recipients_select_type": "DIRECT",
"recipients_ids": [
"2225cfb24c15b7d691818f5ac9d07f70"
],
"answerable": false
}
```
- Уведомление с фильтром
```json
{
"topic": {
"EN": "You have got a bonus!"
},
"text": {
"EN": "The bonus was awarded for good job!"
},
"recipients_select_type": "FILTER",
"recipients_filter": {
"and": [
{
"category": "skill",
"key": "2022",
"operator": "GT",
"value": 90
}
]
},
"answerable": false
}
```
{% endlist %}
#|
||**Параметр**| **Описание**||
|| `topic`[*](*required_value) | _object_
Заголовок уведомления. Можно указать заголовок на нескольких языках (уведомление придет на языке исполнителя).
Формат:
```json
{
"EN": "Title in English",
"RU": "Заголовок на русском"
}
```
||
|| `answerable`[*](*required_value) | _boolean_
Возможность ответить на уведомление:
- `false` — исполнитель не может ответить на уведомление.||
|| `text`[*](*required_value) | _object_
Текст уведомления. Можно указать текст на нескольких языках (уведомление придет на языке исполнителя).
Формат:
```json
{
"EN": "Message text in English",
"RU": "Текст уведомления на русском"
}
```
||
|| `recipients_select_type`[*](*required_value) | _string_
Способ указания адресатов:
- `DIRECT` — указать идентификаторы
исполнителей.
- `FILTER` — отобрать исполнителей с помощью [фильтра](https://yandex.ru/dev/tasks-api/doc/ru/filters/index.md).
- `ALL` — отправить уведомление всем исполнителям, которые хотя бы раз пытались выполнять ваши задания.||
|| `recipients_ids` | _object (**обязательный при условии**)_
**Обязателен**, если `recipients_select_type=DIRECT`.
Список идентификаторов исполнителей, которым будет отправлено уведомление.||
|| `recipients_filter` | _object (**обязательный при условии**)_
**Обязателен**, если `recipients_select_type=FILTER`.
[Фильтр](https://yandex.ru/dev/tasks-api/doc/ru/filters/index.md) для отбора адресатов.||
|#
## Ответ {#response}
В ответ вы получите параметры уведомления.
{% cut "Пример ответа" %}
```json
{
"items": [
{
"id": "643933af08583e0a19c2167e",
"topic": {
"EN": "Test bonus"
},
"interlocutors_inlined": true,
"interlocutors": [
{
"id": "6c6e20dc86cca2ae787afcb2629de162",
"role": "REQUESTER",
"myself": true
},
{
"id": "a1b0b42923c429daa2c764d7ccfc364d",
"role": "USER"
}
],
"messages_inlined": true,
"messages": [
{
"text": {
"EN": "Thank you"
},
"from": {
"id": "6c6e20dc86cca2ae787afcb2629de162",
"role": "REQUESTER",
"myself": true
},
"created": "2023-04-14T11:06:23.096"
}
],
"compose_details": {
"recipients_select_type": "DIRECT",
"recipients_ids": [
"a1b0b42923c429daa2c764d7ccfc364d"
]
},
"meta": {},
"folders": [
"UNREAD",
"IMPORTANT"
],
"answerable": false,
"created": "2023-04-14T11:06:23.096"
}
],
"has_more": true
}
```
{% endcut %}
#|
||**Параметр**| **Описание**||
|| `id` | _string_
Идентификатор уведомления.||
|| `topic` | _object_
Заголовок уведомления.||
|| `interlocutors_inlined` | _boolean_
Доступ к сведениям об отправителе и адресатах.
- `true` — сведения доступны в поле `interlocutors`.
- `false` — сведения доступны по отдельному запросу.||
|| [interlocutors[]](#interlocutors-section) | _array of objects_
Сведения об отправителе и адресатах, отсортированные по идентификаторам. Полный список параметров приведен в таблице [Сведения об отправителе и адресатах](#interlocutors-section).||
|| `messages_inlined` | _boolean_
Доступ к тексту уведомлению:
- `true` — текст уведомления доступен в свойстве `messages`.
- `false` — текст уведомления доступен по отдельному запросу.||
|| [messages[]](#messages-section) | _array of objects
Информация об уведомлении.
||
|| `answerable` | _boolean_
Возможность ответить на уведомление:
- `false` — исполнитель не может ответить на уведомление.||
|| `folders[]` | _array of strings_
Папки, в которых находится уведомление:
- `INBOX` — Входящие.
- `OUTBOX` — Отправленные.
- `AUTOMATIC_NOTIFICATION` — Уведомления.
- `IMPORTANT` — Важные.
- `UNREAD` — Непрочитанные.||
|| `created` | _string_
Дата создания уведомления.||
|#
### Сведения об отправителе и адресатах ('interlocutors[]') {#interlocutors-section}
#|
||**Параметр**| **Описание**||
|| `id` | _string_
Идентификатор отправителя или адресата.||
|| `role` | _string_
Роль отправителя или адресата в Яндекс Заданиях:
- `USER` — исполнитель.
- `REQUESTER` — заказчик.
- `ADMINISTRATOR` — администратор.
- `SYSTEM` — для уведомлений, отправленных автоматически.||
|| `myself` | _boolean_
Маркер отправителя или адресата с вашим идентификатором. Если идентификатор принадлежит вам, указывается значение `true`.||
|#
### Информация об уведомлении ('messages[]') {#messages-section}
#|
||**Параметр**| **Описание**||
|| `text` | _object_
Текст уведомления.||
|| `from` | _string_
Сведения об отправителе уведомления.||
|| `from.id` | _string_
Идентификатор отправителя.||
|| `from.role` | _string_
Роль отправителя в Яндекс Заданиях:
- `USER` — исполнитель.
- `REQUESTER` — заказчик.
- `ADMINISTRATOR` — администратор.
- `SYSTEM` — уведомление было отправлено автоматически.||
|| `from.myself` | _boolean_
Маркер отправителя с вашим идентификатором. Если отправитель — это вы, указывается значение `true`.||
|| `created` | _string_
Дата создания уведомления.||
|#
### Детали POST-запроса ('compose_details') {#compose-details-section}
#|
||**Параметр**| **Описание**||
|| `recipients_select_type` | _string_
Способ указания адресатов:
- `DIRECT` — указать идентификаторы исполнителей.
- `FILTER` — отобрать исполнителей с помощью [фильтра](https://yandex.ru/dev/tasks-api/doc/ru/filters/index.md).
- `ALL` — отправить уведомление всем исполнителям, которые хотя бы раз пытались выполнять ваши задания.||
|| `recipients_ids` | _object_
Список идентификаторов исполнителей, которым будет отправлено уведомление.||
|| `recipients_filter` | _object_
[Фильтр](https://yandex.ru/dev/tasks-api/doc/ru/filters/index.md) для отбора адресатов.||
|#
[](https://yandex.ru/support/tasks-requester/ru/guide/troubleshooting/support/)
[*required_value]: Обязательный параметр
{% included (../../_includes/reusables/auth-nh.md) %}
`Authorization`
{% endincluded %}