Задачи и выплаты

Два метода передают в Polygram данные о сотрудниках из вашей системы: задачи для раздела Задачи и оклад для профиля сотрудника.

Чтобы узнать ID сотрудника, откройте Настройки, раздел Пользователи, и нажмите Скопировать ID под именем сотрудника.

Создать задачу

Создаёт задачу или обновляет задачу с тем же external_id.

POST /public/tasks

Тело запроса

Поле	Тип	Обязательное	Описание
`external_id`	строка	нет	ID задачи в вашей системе, 1–200 символов. Запрос с тем же ID обновляет задачу
`assignee_user_id`	строка или `null`	нет	ID сотрудника-исполнителя. Если не передать, задача будет общей и её увидят все сотрудники
`title`	строка	да	Заголовок, 1–200 символов
`body`	строка или `null`	нет	Описание, до 4000 символов
`due_at`	строка или `null`	нет	Срок в ISO 8601 с часовым поясом: `2026-10-20T18:00:00+05:00` или `2026-10-20T13:00:00Z`
`link`	строка или `null`	нет	Ссылка, до 500 символов. В задаче она открывается кнопкой Открыть
`task_type`	строка	нет	`GENERIC` (по умолчанию) или `EDITING`, регистр не важен. По задаче `EDITING` приходит уведомление о просрочке

{
  "external_id": "task-1042",
  "assignee_user_id": "cmf8k2l3m0000xy12ab34cd56",
  "title": "Связаться с клиентом по заказу 1042",
  "due_at": "2026-10-20T18:00:00+05:00",
  "task_type": "EDITING"
}

Ответ

201 Created.

{ "id": "cmga1b2c30000xy12ab34cd56" }

В id приходит ID задачи в Polygram. При обновлении по external_id возвращается ID той же задачи.

Обновление по external_id

Запрос с тем же external_id перезаписывает все поля задачи. Поля, которых нет в запросе, очищаются, а task_type становится GENERIC. Поэтому передавайте задачу целиком.

Статус при обновлении не меняется. Выполненная задача остаётся выполненной.

Без external_id каждый запрос создаёт новую задачу.

Ошибки

Код	Когда
400	Поля не прошли проверку или `assignee_user_id` не сотрудник этой компании
401	Ключ доступа не передан или неверный

Что видят сотрудники

Открытые задачи показываются в разделе Задачи над напоминаниями, в вебе и в мобильном приложении. Сотрудник видит свои задачи и общие.
Сотрудник отмечает задачу кнопкой Выполнено и возвращает кнопкой В работу. Выполненная задача пропадает из списка. Ваша система об этом не узнаёт.
Просроченный срок выделяется красным.
При создании задачи уведомление не приходит.

Задачи EDITING проверяются раз в 5 минут. Когда срок открытой задачи прошёл, исполнитель и руководители получают уведомление Просрочка по редактуре с заголовком задачи. Руководителями считаются владелец и роли с правом настраивать рабочие часы. Уведомление приходит один раз. Если перенести срок в будущее запросом с тем же external_id, при новой просрочке оно придёт снова.

Установить оклад

Записывает оклад сотрудника. Оклад видит только сам сотрудник в профиле мобильного приложения, в блоке Мой оклад.

POST /public/salary

Тело запроса

Поле	Тип	Обязательное	Описание
`user_id`	строка	да	ID сотрудника
`amount`	целое число или `null`	да	Сумма, 0 и больше. `null` очищает оклад вместе с валютой и подписью
`currency`	строка или `null`	нет	Валюта, 1–8 символов, например `KZT`
`note`	строка или `null`	нет	Подпись, до 120 символов, например Октябрь 2026

{
  "user_id": "cmf8k2l3m0000xy12ab34cd56",
  "amount": 350000,
  "currency": "KZT",
  "note": "Октябрь 2026"
}

Каждый запрос заменяет оклад целиком: если не передать currency и note, они очистятся.

Ответ

201 Created.

{ "success": true }

Ошибки

Код	Когда
400	Поля не прошли проверку или `user_id` не сотрудник этой компании
401	Ключ доступа не передан или неверный

Запрос с теми же данными можно повторять. Сотруднику уведомление не приходит.

Пример

curl -X POST https://api.polygram.chat/api/public/tasks \
  -H "X-Api-Key: ak_..." \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "task-1042",
    "title": "Связаться с клиентом по заказу 1042",
    "due_at": "2026-10-20T18:00:00+05:00"
  }'

curl -X POST https://api.polygram.chat/api/public/salary \
  -H "X-Api-Key: ak_..." \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "cmf8k2l3m0000xy12ab34cd56", "amount": 350000, "currency": "KZT" }'