Bitrix24 · Рабочие сценарии
Задачи, проекты и команда
Начните с accounts_list и account_capabilities, получите справочники выбранного портала, затем прочитайте нужные источники и вызовите конкретную рабочую операцию. При нескольких порталах передавайте account_id.
Задачи поддерживают комментарии, чек-листы, результаты и файлы Диска. Автор комментария — авторизованный сотрудник. ID файла Диска и прикреплённого объекта различаются.
task_chat_files_send получает чат по task_id и отправляет один файл до 25 MiB с подписью от имени сотрудника. Передайте имя, MIME, base64 или UTF-8 и request_id. Сотруднику нужен доступ к задаче и её чату. Передача файлов зависит от функций портала; новые операции чатов задач могут требовать дополнительных разрешений приложения.
Рабочие группы и проекты выбираются по ID. Структура компании доступна для чтения; перестройка подразделений и изменение прав не поддерживаются.
team_workload_report показывает текущие открытые задачи и дела, а также встречи за период. project_ids фильтрует задачи и календари проектов; встречи считаются только для явных участников. Связи CRM-дел с проектом недоступны и обозначаются в отчёте. Ошибка одного проекта сохраняет успешно полученные результаты других.
Пример запроса
Покажи текущие просрочки отдела и встречи участников проекта на следующей неделе. Укажи недоступные источники и подготовь задачи по согласованному списку действий.
Инструменты раздела · 26
Доступность операции зависит от возможностей портала, разрешений приложения и прав сотрудника.
tasks_list— list: tasks. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Чтение.tasks_get— get: tasks. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Чтение.tasks_create— create: tasks. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Операция записи.tasks_update— update: tasks. Дела CRM, задачи и комментарии таймлайна имеют отдельные поля и связи. Операция записи.tasks_complete— Завершить tasks по ID. Операция записи.task_comments_list— Комментарии доступной задачи. Чтение.task_comments_add— Добавить комментарий от имени авторизованного сотрудника. Вложения дополнительно требуют disk. Операция записи.task_checklist_get— Пункты чек-листа задачи. Чтение.task_checklist_add— Добавить пункт чек-листа доступной задачи. Операция записи.task_checklist_update— Изменить пункт чек-листа, включая завершение; родитель проверяется в этой задаче. Операция записи.task_results_list— Результаты доступной задачи через legacy REST. Чтение.task_results_add— Добавить текстовый результат задачи через REST 3.0; дополнительные scopes проверяются по порталу. Операция записи.task_files_list— Файлы задачи с отдельными ID файла Диска и прикреплённого объекта. Чтение.task_files_attach— Прикрепить доступный файл Диска к доступной задаче. Операция записи.task_chat_messages_list— Чат задачи: связь проверяется через REST 3.0, сообщения читаются через IM. Чтение.task_chat_messages_send— Отправить текст в чат задачи через REST 3.0 с Idempotency-Key. Операция записи.projects_list— Доступные рабочие группы и проекты. Чтение.projects_get— Карточка доступного проекта или группы. Чтение.projects_create— Создать проект или рабочую группу без изменения прав доступа. Операция записи.projects_update— Изменить название, описание или даты проекта без изменения прав. Операция записи.project_members_list— Участники доступного проекта. Чтение.project_activity_report— Фактическая сводка задач проекта, ответственных и просрочек. Чтение.departments_list— Структура компании с точными фильтрами по полям подразделения. Чтение.departments_get— Карточка подразделения без изменения структуры. Чтение.department_users_list— Доступные активные сотрудники выбранного подразделения. Чтение.task_chat_files_send— Отправить один файл до 25 MiB и подпись в чат доступной задачи через явный legacy REST im.v2.File.upload; чат определяется по task_id, request_id защищает от повтора. Операция записи.