Автозапуск Бизнес-процессов

Штатный автозапуск: запуск БП только при изменении или добавления сущности.
Наше решение: позволяет запускать БП как в определенное время, так и с указанной периодичностью.
Можно также выбрать кратность запуска (однократно или многократно). 

Кнопка "Добавить БП" - после нажатия появляется меню настройки сценария автозапуска БП.
Доступные для настройки параметры: 

• Тип сущности (обязательно);
• ID сущности (обязательно);
• Шаблон БП (обязательно);
• Запускать периодически (опционально);
• Месяц запуска (опционально);
• Час запуска (опционально);
• Минута запуска (опционально);
• Тип запуска (опционально);
• Активировать шаблон автозапуска БП.

Тип сущности: выпадающий список, в котором нужно выбрать в каком типе сущности будет происходить автозапуск.
Этот параметр обязателен к заполнению.

Для каждого сценария можно выбрать только 1 тип сущности, с которым он будет работать.
Если вы хотите чтобы сценарий работал с другим типом сущности, то нужно настраивать сценарий для другого типа сущности отдельно.
Типы сущности, доступные к выбору: Лид, Сделка, Контакт, Компания, БП в живой Ленте, Универсальные списки, Смарт-процессы, Диск.

ID сущности: указывается идентификатор сущности, с которой будет работать БП.
Этот параметр обязателен к заполнению.

Шаблон БП: позволяет выбрать из списка БП, который есть на портале.
Этот параметр обязателен к заполнению.

Этот БП будет автоматически запускаться согласно настроенного вами сценария.

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

Месяц запуска, Час запуска, Минута запуска - позволяют указать месяц, час и минуту запуска БП.
Поля заполняются в числовом виде.
Т.е если вы хотите, чтобы БП запускался 9 марта в 14:38, то нужно заполнить поля как на скриншоте ниже.

Тип запуска: позволяет выбрать из выпадающего списка сколько раз будет запущен БП, один раз или несколько.
Варианты:

• Многократно;
• Однократно;

Активировать шаблон автозапуска БП: данный параметр служит для активации или деактивации сценария автозапуска.
Если параметр не активировать, то сценарий автозапуска работать не будет.

Статус: отображает статус активности сценария автозапуска.

• Зеленый - сценарий активен;
• Красный - сценарий не активен (отключен).

Данные БП: отображает краткий набор данных о сущности с которой работает БП.
Отображаемые данные:

• Тип сущности с которой работает БП;
• ID сущности;
• Название БП, который задействован в сценарии автозапуска.

Последнее редактирование: отображает данные о времени последнего редактирования сценария автозапуска и пользователя, который проводил редактирование.

Интервал запуска: отображает данные об интервале запуска БП, который задан в сценарии автозапуска.

Тип запуска: отображает сколько раз будет запущен БП согласно настроек сценария, один раз или несколько.

Следующий запуск: отображает дату и время следующего автозапуска БП.

Прошлый запуск: отображает дату и время предыдущего автозапуска БП в сценарии.

Статус запуска: отображает статус запуска БП, срабатывал ли автозапуск или нет.

Значек карандаша: позволяет отредактировать сценарий автозапуска.

Значок "урны": позволяет удалить сценарий автозапуска после подтверждения процедуры удаления.

Массовый запуск Бизнес-процессов

При работе с бизнес-процессами и сущностями, в Битрикс24 бывают сценарии при которых необходимо запустить БП (бизнес-процесс) для нескольких сущностей.
Можно запускать БП из меню в каждой сущности, но если их много, 50,100 и более, то это будет довольно затратно по времени, и не эффективно.
Именно для таких случаев мы разработали данный функционал.

Цветовая расшифровка статусов в таблице:

• Белый - шаблон сохранен, но не выполняется и не был запущен;
• Синий - шаблон выполняется;
• Зеленый - шаблон успешно завершил работу;
• Красный - шаблон завершил работу с ошибкой;
• Оранжевый - работа шаблона остановлена сотрудником.

Для того чтобы запустить множество сущностей, нужно эти сущности определить, для этого нужен раздел "Фильтр".

Для настройки шаблона массового запуска, нужно нажать кнопку "Добавить шаблон".
После этого откроется меню настройки шаблона, с активной вкладкой "Фильтр":

На этом этапе для дальнейшей настройки нужно выбрать тип сущности с которой будет работать шаблон, и выбрать из списка БП, который будет работать с указанным типом сущности.
После выбора типа сущности и БП, автоматически подгрузятся параметры настройки самого БП.

Выберите тип сущности: позволяет выбрать из выпадающего списка тип сущности, с которой будет работать шаблон массового запуска БП. Так же, выбор в этом поле определяет для поля "Список шаблонов БП", для какой сущности подгружать бизнес-процессы из конструктора БП.

Поддерживаются следующие типы сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• БП в живой ленте;
• Универсальные списки;
• Смарт-процессы.

Список шаблонов БП: позволяет выбрать из выпадающего списка, БП, которые будут запущены этим шаблоном массвого запуска после настройки.

Ограничить количество элементов до: позволяет указать максимальное количество элементов, с которыми шаблон будет работать за 1 проход.
Т.е если вам нужно обработать к примеру 150 элементов и в поле вы укажите 30, то шаблон за раз будет работать максимум с 30 элементами.
Это нужно для того, чтобы не "заливать" наше приложение либо сервер Б24 эвентами и не попасть в очередь или блокировку по лимиту.
Параметры фильтров Обновить : эта кнопка позволяет произвести обновление подгрузившихся параметров фильтра, в случае если это потребуется.

Кнопка Поиск по фильтру : активирует поиск сущностей по заранее заданным в фильтре параметрам.
После поиска будут отображены (если найдены) сущности с которыми будет работать шаблон массового запуска.

Набор фильтров состоит из кастомных и пользовательских полей, которые существуют в рамках выбранного типа сущности.
Если бы добавили новое кастомное поле в какую-то из сущностей и хотите чтобы она отобразилась в фильте, нужно воспользоваться кнопкой "Обновить".

Найденные фильтром элементы будут отображены во вкладке "Найдено".
После того, как фильтр нашел необходимые элементы и вы удалили (или нет) лишние, Вы можете сразу запустить шаблон массового запуска в работу, нажатием кнопки Выполнить запуск.
Вкладка "История операций" - отображает операции, время их выполнения и ФИО сотрудника, от имени которого эти операции были выполнены.

 

Статус: отображает статус выполнения шаблона.
Значение цветовой палитры статусов описано выше.

Шаблон БП: Отображает название БП, который работает в шаблоне массвого запуска.

Тип сущности: отображает тип сущности с которой работает шаблон массвого запуска.

Кол. найденных: отображает количество сущностей с которыми работает шаблон массвого запуска.

Последний запуск: отображает дату и время последнего запуска в формате год-месяц-день, часы-минуты-секунды.

Когда создан: отображает дату и время создания шаблона. 

Кем создан: отображает имя и ID пользователя, который создал шаблон.

Запуск БП по событию

Модуль "Запуск БП по событию" предназначен для автоматического запуска бизнес-процессов Битрикс24 при наступлении событий (создание, изменение, удаление сущностей) с возможностью фильтрации по полям сущности.
Результатом работы модуля является возможность настроить шаблоны, которые при срабатывании определённого события (например, добавление сделки, изменение задачи) проверяют условия фильтра по полям сущности и при совпадении запускают указанный бизнес-процесс.
Поддерживаются все основные сущности CRM: задачи, календарь, рабочие группы, лента новостей и другие.

Название функции	Описание и примеры использования
Создание шаблона запуска	Позволяет создать шаблон, связывающий событие Битрикс24 с бизнес-процессом. При наступлении события система проверяет все активные шаблоны для этого события и при совпадении фильтров запускает соответствующий БП. Как использовать: - Нажмите "Добавить шаблон"; - Выберите тип сущности (Сделка, Задача, Рабочие группы и др.); - Выберите событие (При добавлении, При изменении, При удалении); - Выберите шаблон бизнес-процесса для запуска; - При необходимости укажите условия фильтра по полям сущности. Важно: Для событий удаления фильтр недоступен, так как сущность уже удалена и данные для проверки получить невозможно.
Фильтрация по полям сущности	Позволяет указать условия, при выполнении которых бизнес-процесс будет запущен. Доступные поля зависят от типа сущности. Поддерживаются операторы сравнения: равно (=), не равно (!=, !), больше (>), меньше (<), больше или равно (>=), меньше или равно (<=), LIKE (%, =%), NOT LIKE (!%, !%=), IN (@), NOT IN (!@). Как использовать: - Заполните поля фильтра в блоке "Условия запуска БП"; - Для полей можно указать префикс оператора (например, >=ID для "ID больше или равно"); - Для оператора @ (IN) значение передаётся в виде JSON-массива. Примеры: NAME="Важная сделка", STAGE_ID@["C1:NEW","C1:PREPARATION"], ASSIGNED_BY_ID=user_1
Запуск БП в другой сущности	Позволяет запустить бизнес-процесс не в сущности события, а в связанной сущности. Например, при событии по задаче запустить БП по сделке, указав поле задачи, из которого брать ID сделки. Как использовать: - Выберите "Тип сущности для запуска" (например, Сделка); - Укажите "Поле, из которого брать ID" (например, UF_CRM_TASK для связи задачи со сделкой); - Выберите шаблон БП для целевой сущности. Важно: Если в запускаемом БП создан параметр с кодовым именем start_id, в него передаётся ID сущности, в которой сработало событие.
Поле "Участники группы/проекта"	Для сущности "Рабочие группы" доступно специальное поле фильтра. При его заполнении выполняется дополнительный запрос к API для проверки, входит ли указанный пользователь в состав участников группы. Поддерживаются форматы: ID пользователя (123), user_123, user-123, JSON-массив ID. Как использовать: - Выберите сущность "Рабочие группы" и событие (При добавлении или При редактировании); - В поле "Участники группы/проекта" укажите ID пользователя или user_123; - БП запустится только если указанный пользователь является участником группы. Операторы: = или @ — пользователь должен быть участником; != или !@ — пользователь не должен быть участником.
Комментарий к шаблону	Позволяет добавить заметки к шаблону для удобства. Комментарий не участвует в логике запуска и отображается в списке шаблонов. Как использовать: - Заполните поле "Комментарий" в форме создания или редактирования шаблона; - Текст будет виден в таблице шаблонов.
Активация и деактивация шаблона	Позволяет временно отключить шаблон без его удаления. Деактивированный шаблон не подписывается на событие и не запускает БП. Как использовать: - При создании или редактировании выберите "Неактивен" в поле "Активность сценария"; - Для повторной активации выберите "Активен".
История запусков	Система сохраняет историю запусков бизнес-процессов: дату, сущность, результат. Статус шаблона обновляется после каждого срабатывания (успешно запустилось, завершено с ошибкой). Статусы: Сохранено (0), Успешно запустилось (1), Завершено с ошибкой (2), Автозапуск выключен (3).

Модуль поддерживает следующие типы сущностей: Лид, Сделка, Компания, Контакт, Счёт, Коммерческое предложение, Смарт-процессы, Дело (активность), Задача, Товар, Реквизит, Банковский реквизит, Документ генератора, Тип смарт-процесса, Комментарий в таймлайн, Валюта, Единица измерения, Адресный реквизит, Календарь, Бронирование ресурсов, Лента новостей, Рабочие группы. Для каждой сущности доступны события добавления, изменения и удаления (в зависимости от типа).

Оператор	Описание
=	Равно, точное совпадение (по умолчанию)
!=, !	Не равно
>=, >, <=, <	Сравнение для числовых значений и дат
@	IN — значение входит в массив (значение передаётся как JSON-массив)
!@	NOT IN — значение не входит в массив
%	LIKE — поиск подстроки в любой позиции
=%	LIKE с явным %: мол% (начинается с), %мол (заканчивается на), %мол% (содержит)
!%, !%=	NOT LIKE — значение не содержит подстроку

Описание примера	Решение
Запуск БП при добавлении любой сделки	Создайте шаблон: тип сущности "Сделка", событие "При добавлении сделки", выберите нужный шаблон БП. Фильтр оставьте пустым — БП запустится для каждой новой сделки.
Запуск БП только для сделок в определённой стадии	Создайте шаблон для сущности "Сделка", событие "При изменении сделки". В фильтре укажите поле STAGE_ID со значением, например, C1:WON (для стадии "Успешно реализовано") или используйте оператор @ для нескольких стадий: @STAGE_ID со значением ["C1:NEW","C1:PREPARATION"].
Запуск БП при добавлении задачи определённому исполнителю	Создайте шаблон: тип сущности "Задача", событие "При добавлении задачи". В фильтре укажите RESPONSIBLE_ID=user_123 (подставьте ID нужного пользователя). БП запустится только для задач, назначенных этому пользователю.
Запуск БП при добавлении участника в рабочую группу	Создайте шаблон: тип сущности "Рабочие группы", событие "При редактировании рабочей группы". В поле "Участники группы/проекта" укажите user_5. БП запустится только если пользователь с ID 5 является участником изменённой группы.
Запуск БП по сделке при создании задачи	Создайте шаблон: тип сущности "Задача", событие "При добавлении задачи". В блоке "Запустить БП в другой сущности" выберите тип "Сделка", в поле "Поле, из которого брать ID" укажите UF_CRM_TASK (или другое поле связи задачи со сделкой). Выберите шаблон БП для сделок. БП запустится в связанной сделке.
Запуск БП только для лидов с определённым источником	Создайте шаблон: тип сущности "Лид", событие "При добавлении лида". В фильтре укажите SOURCE_ID=WEB (или другой код источника). БП запустится только для лидов с указанным источником.
Запуск БП при добавлении события в календарь	Создайте шаблон: тип сущности "Календарь", событие "При добавлении события календаря", выберите шаблон БП. При создании события в календаре БП будет запущен автоматически.
Запуск БП для сделок с суммой больше 100000	Создайте шаблон для сущности "Сделка", событие "При изменении сделки". В фильтре укажите >=OPPORTUNITY со значением 100000. БП запустится только при изменении сделок с суммой от 100000.
Запуск БП для дел (активностей) определённого типа	Создайте шаблон: тип сущности "Дело (активность)", событие "При добавлении дела". В фильтре укажите TYPE_ID=2 (звонок) или другой код типа. БП запустится только для дел указанного типа.
Временное отключение шаблона без удаления	Откройте шаблон на редактирование и выберите "Неактивен" в поле "Активность сценария". Шаблон перестанет срабатывать, но сохранится. Для возобновления выберите "Активен".

Модуль "Запуск БП по событию" предназначен для использования в веб-интерфейсе и может быть полезен в следующих сценариях:

• Автоматизация бизнес-процессов при создании или изменении сущностей CRM;
• Запуск БП только при выполнении условий (стадия сделки, ответственный, сумма и др.);
• Связывание событий в одной сущности с БП в другой (задача — сделка);
• Фильтрация по участникам рабочих групп при событиях с группами;
• Обработка событий календаря, ленты новостей, задач;
• Условный запуск БП по смарт-процессам с учётом типа и воронки;
• Массовая автоматизация без создания триггеров в каждом БП отдельно;
• Централизованное управление автозапуском через единый интерфейс;
• Отслеживание истории запусков и статусов шаблонов;
• Быстрое включение и отключение сценариев без изменения шаблонов БП.

Название поля	Описание и примеры использования
Активность сценария	Активен — шаблон подписан на событие и срабатывает. Неактивен — шаблон не срабатывает.
Тип сущности	Сущность Битрикс24, события которой отслеживаются: Сделка, Задача, Рабочие группы, Календарь и др.
Тип события	Конкретное событие: При добавлении, При изменении, При удалении. Список зависит от типа сущности.
Шаблон БП	Шаблон бизнес-процесса, который будет запущен при срабатывании события и прохождении фильтра.
Условия запуска БП	Поля фильтра с операторами. Пустой фильтр означает запуск при любых данных сущности.
Тип сущности для запуска	Необязательно. Если указан — БП запускается в другой сущности. Например, при событии по задаче запуск БП по сделке.
Поле, из которого брать ID	Код поля сущности события, содержащего ID целевой сущности. Например, UF_CRM_TASK для связи задачи со сделкой.
Комментарий	Заметки пользователя, не участвуют в логике. Отображаются в списке шаблонов.

Поиск по Бизнес-процессам

Модуль "Поиск по бизнес-процессам" предназначен для фильтрации и поиска шаблонов бизнес-процессов Битрикс24 по различным параметрам.
Результатом работы модуля является возможность быстрого поиска нужных шаблонов бизнес-процессов по ID, названию, типу сущности, наличию автозапуска, типу активити, заголовку активити, значению параметра в активити и другим критериям.
Модуль поддерживает сохранение параметров фильтрации для быстрого применения в будущем и автоматическое кэширование данных для повышения производительности.

Название функции	Описание и примеры использования
Фильтрация по ID бизнес-процесса	Позволяет найти шаблон бизнес-процесса по его уникальному идентификатору. Поиск выполняется по точному совпадению или частичному совпадению ID. Это полезно для быстрого поиска конкретного шаблона, если известен его идентификатор. Как использовать: - Введите ID бизнес-процесса в поле "ID бизнес-процесса"; - Система автоматически отфильтрует таблицу и покажет только шаблоны с указанным ID; - Поиск работает в реальном времени при вводе текста. ID бизнес-процесса является уникальным идентификатором и позволяет точно найти нужный шаблон.
Фильтрация по названию бизнес-процесса	Позволяет найти шаблоны бизнес-процессов по их названию. Поиск выполняется по частичному совпадению текста в названии шаблона. Это полезно для поиска шаблонов, когда известно примерное название или его часть. Как использовать: - Введите название или часть названия бизнес-процесса в поле "Название бизнес-процесса"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие указанный текст в названии; - Поиск не чувствителен к регистру и работает в реальном времени. Поиск выполняется по частичному совпадению, поэтому можно ввести только часть названия для поиска.
Фильтрация по типу сущности бизнес-процесса	Позволяет отфильтровать шаблоны бизнес-процессов по типу сущности, с которой они работают. Доступны все типы сущностей, присутствующие в шаблонах на портале: Сделка, Лид, Контакт, Компания, Смарт-процесс, Универсальные списки, Универсальные списки в группе, Живая лента, Задачи. Как использовать: - Выберите нужный тип сущности из выпадающего списка "Тип сущности бизнес-процесса"; - Система автоматически отфильтрует таблицу и покажет только шаблоны выбранного типа сущности; - Для отображения всех типов выберите опцию "Все типы". Информация о типах: Список типов сущностей формируется автоматически на основе всех шаблонов, присутствующих на портале.
Фильтрация по автозапуску	Позволяет отфильтровать шаблоны бизнес-процессов по наличию или отсутствию активной опции автозапуска в его настройках, а так же типу автозапуска. Это полезно для поиска шаблонов с определенным режимом автозапуска. Как использовать: - Выберите нужный вариант автозапуска из выпадающего списка "Автозапуск"; - Система автоматически отфильтрует таблицу и покажет только шаблоны с выбранным типом автозапуска; - Для отображения всех шаблонов выберите опцию "Любой". Варианты автозапуска: Без автозапуска; Создание; Изменение; Создание и изменение.
Фильтрация по пользователю, изменившему бизнес-процесс	Позволяет найти шаблоны бизнес-процессов, которые последний раз изменял конкретный пользователь. Список пользователей формируется автоматически на основе всех пользователей, которые когда-либо изменяли шаблоны на портале. Это полезно для отслеживания работы конкретного сотрудника или команды. Как использовать: - Выберите пользователя из выпадающего списка "Кто изменил бизнес-процесс"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, которые последний раз изменял выбранный пользователь; - Для отображения всех шаблонов выберите опцию "Все пользователи"; - Так же доступен ручной ввод ФИО пользователей. Информация о пользователях: Список пользователей формируется автоматически на основе данных о последних изменениях шаблонов.
Фильтрация по типу штатных активити Битрикс24	Позволяет найти шаблоны бизнес-процессов, содержащие стандартные активити Б24. Поиск выполняется по типу активити (например, "Создать задачу", "Отправить письмо", "Условие" и другие), путем выбора необходимого активити из выпадающего списка с разделами. Как использовать: - Выберите тип активити из выпадающего списка "Тип штатных активити Битрикс24"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие выбранный тип активити; Информация об активити: Список типов активити формируется автоматически на основе всех активити, присутствующих в шаблонах на портале.
Фильтрация по заголовку активити	Позволяет найти шаблоны бизнес-процессов, содержащие активити с определенным заголовком (названием). Поиск выполняется по точному или частичному совпадению заголовка активити. Это полезно для поиска шаблонов, использующих активити с конкретными названиями. Как использовать: - Введите заголовок активити или его часть в поле "Заголовок активити"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие активити с указанным заголовком; - Поиск работает в реальном времени при вводе текста. Поиск выполняется по частичному совпадению, поэтому можно ввести только часть заголовка для поиска.
Фильтрация по значению параметра в активити	Позволяет найти шаблоны бизнес-процессов, содержащие активити с определенным значением параметра. Поиск выполняется по значению любого параметра в любом поле активити шаблона. Это полезно для поиска шаблонов, использующих конкретные значения параметров (например, определенные адреса электронной почты, названия полей, значения переменных и другие). Как использовать: - Введите значение параметра в поле "Значение параметра в активити"; - Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие активити с указанным значением параметра; - Поиск работает в реальном времени при вводе текста. Поиск выполняется по всем параметрам всех активити в шаблоне, поэтому можно найти шаблоны по любому значению параметра.
Сохранение параметров фильтрации	Позволяет сохранить текущие параметры фильтрации для быстрого применения в будущем. Система поддерживает сохранение до 10 наборов параметров фильтрации. Каждый сохраненный набор можно назвать для удобства идентификации. Это полезно для часто используемых комбинаций фильтров. Как использовать: - Заполните нужные поля фильтрации; - Нажмите кнопку "Сохранить параметры фильтра"; - Введите название для сохраненного набора параметров; - Сохраненный набор появится в списке справа от фильтров; - Для применения сохраненных параметров кликните на нужный набор в списке. ВАЖНО! Система ограничивает количество сохраненных наборов параметров до 10. При достижении лимита необходимо удалить один из существующих наборов перед сохранением нового.
Редактирование сохраненных параметров фильтрации	Позволяет изменить название сохраненного набора параметров фильтрации. Это полезно для переименования наборов при изменении их назначения или для исправления опечаток в названиях. Как использовать: - Найдите нужный набор параметров в списке справа от фильтров; - Нажмите на иконку карандаша рядом с названием набора; - Введите новое название и нажмите на иконку сохранения или нажмите Enter; - Название будет обновлено. Редактирование изменяет только название набора параметров, сами параметры остаются неизменными.
Удаление сохраненных параметров фильтрации	Позволяет удалить сохраненный набор параметров фильтрации из списка. Это полезно для освобождения места при достижении лимита в 10 сохраненных наборов или для удаления устаревших наборов. Как использовать: - Найдите нужный набор параметров в списке справа от фильтров; - Нажмите на иконку корзины рядом с названием набора; - Подтвердите удаление в появившемся модальном окне; - Набор будет удален из списка. ВАЖНО! Удаление набора параметров выполняется безвозвратно. После удаления набор нельзя восстановить.
Очистка параметров фильтрации	Позволяет быстро очистить все поля фильтрации и сбросить все примененные фильтры. Это полезно для начала нового поиска с нуля или для просмотра всех шаблонов без фильтрации. Как использовать: - Нажмите кнопку "Очистить параметры фильтра"; - Все поля фильтрации будут очищены; - Таблица автоматически обновится и покажет все шаблоны без фильтрации. Очистка параметров фильтрации не удаляет сохраненные наборы параметров из списка.
Обновление списка шаблонов бизнес-процессов	Позволяет обновить список шаблонов бизнес-процессов, загрузив актуальные данные с портала Битрикс24. Система кэширует список шаблонов для повышения производительности, но при необходимости можно принудительно обновить данные, удалив кэш и загрузив свежую информацию. При обновлении список шаблонов обновляется в реальном времени, включая новые созданные шаблоны и изменения в существующих. Как использовать: - Нажмите кнопку "Обновить список шаблонов БП"; - Система автоматически удалит кэш и загрузит актуальный список шаблонов; - Обновленный список отобразится в таблице на странице. Кэширование: Система автоматически кэширует список шаблонов для повышения скорости работы. Кэш обновляется при каждом обновлении списка или автоматически при изменениях в шаблонах.
Сортировка таблицы результатов	Позволяет сортировать таблицу результатов фильтрации по различным столбцам. Доступна сортировка по ID, названию, типу сущности, дате изменения, количеству активити и другим параметрам. Это полезно для упорядочивания результатов поиска. Как использовать: - Нажмите на заголовок столбца для сортировки по возрастанию; - Повторное нажатие изменит направление сортировки на убывание; - Третье нажатие отменит сортировку и вернет исходный порядок. Сортировка применяется к текущим результатам фильтрации, а не ко всем шаблонам.

Комбинированная фильтрация:
Позволяет использовать несколько фильтров одновременно для точного поиска нужных шаблонов бизнес-процессов. Все фильтры работают совместно, и результат показывает только шаблоны, соответствующие всем указанным критериям. Это полезно для сложных поисковых запросов.

Как использовать:
- Заполните несколько полей фильтрации одновременно;
- Система автоматически применит все фильтры и покажет только шаблоны, соответствующие всем критериям;
- Результаты обновляются в реальном времени при изменении любого фильтра.

Описание примера	Решение
Поиск шаблона бизнес-процесса по известному ID	Если известен ID нужного шаблона бизнес-процесса, введите его в поле "ID бизнес-процесса". Например, для поиска шаблона с ID 123 введите "123" в поле фильтрации. Система автоматически отфильтрует таблицу и покажет только шаблон с указанным ID.
Поиск всех шаблонов для работы со сделками	Для поиска всех шаблонов бизнес-процессов, работающих со сделками, выберите "CRM Сделка" в поле "Тип сущности бизнес-процесса". Система автоматически отфильтрует таблицу и покажет только шаблоны, работающие со сделками.
Поиск шаблонов с автозапуском при создании	Для поиска всех шаблонов, которые автоматически запускаются при создании сущности, выберите "Создание" в поле "Автозапуск". Система автоматически отфильтрует таблицу и покажет только шаблоны с автозапуском при создании.
Поиск шаблонов, измененных конкретным пользователем	Для поиска всех шаблонов, которые последний раз изменял конкретный пользователь, выберите нужного пользователя в поле "Кто изменил бизнес-процесс". Например, выберите "Иванов Иван Иванович" для поиска всех шаблонов, которые он последний раз изменял.
Поиск шаблонов, содержащих активити "Отправить письмо"	Для поиска всех шаблонов, содержащих активити типа "Отправить письмо", выберите "Отправить письмо" в поле "Тип штатных активити Битрикс24". Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие это активити.
Поиск шаблонов с определенным значением параметра	Для поиска шаблонов, содержащих активити с определенным значением параметра, введите это значение в поле "Значение параметра в активити". Например, для поиска шаблонов, использующих адрес электронной почты "manager@example.com", введите "manager@example.com" в поле фильтрации.
Комбинированный поиск шаблонов для сделок с автозапуском	Для поиска шаблонов, работающих со сделками и имеющих автозапуск при создании, выберите "CRM Сделка" в поле "Тип сущности бизнес-процесса" и "Создание" в поле "Автозапуск". Система автоматически отфильтрует таблицу и покажет только шаблоны, соответствующие обоим критериям.
Сохранение часто используемых параметров фильтрации	Для сохранения часто используемых параметров фильтрации заполните нужные поля фильтрации, например, выберите "CRM Сделка" в типе сущности и "Создание" в автозапуске. Нажмите кнопку "Сохранить параметры фильтра" и введите название, например "Сделки с автозапуском". В будущем можно быстро применить эти параметры, кликнув на сохраненный набор в списке справа.
Поиск шаблонов по части названия	Для поиска шаблонов по части названия введите часть названия в поле "Название бизнес-процесса". Например, для поиска всех шаблонов, содержащих слово "обработка" в названии, введите "обработка" в поле фильтрации. Система автоматически найдет все шаблоны с этим словом в названии.
Поиск шаблонов с несколькими типами активити	Для поиска шаблонов, содержащих один из нескольких типов активити, выберите несколько типов активити в поле "Тип штатных активити Битрикс24". Например, выберите "Отправить письмо" и "Создать задачу". Система автоматически отфильтрует таблицу и покажет только шаблоны, содержащие хотя бы один из выбранных типов активити.
Быстрый сброс всех фильтров	Для быстрого сброса всех примененных фильтров и просмотра всех шаблонов нажмите кнопку "Очистить параметры фильтра". Все поля фильтрации будут очищены, и таблица автоматически обновится, показывая все шаблоны без фильтрации.
Обновление списка после создания новых шаблонов	После создания новых шаблонов бизнес-процессов нажмите кнопку "Обновить список шаблонов БП" для загрузки актуального списка. Система автоматически удалит кэш и загрузит свежие данные с портала, включая новые созданные шаблоны.
Сортировка результатов по дате изменения	Для упорядочивания результатов фильтрации по дате последнего изменения нажмите на заголовок столбца "Дата изменения". Первое нажатие отсортирует по возрастанию (старые сверху), второе нажатие - по убыванию (новые сверху). Это полезно для поиска недавно измененных шаблонов.

Модуль "Поиск по бизнес-процессам" предназначен для использования в веб-интерфейсе и может быть полезен в следующих сценариях:

• Быстрый поиск конкретного шаблона бизнес-процесса по ID или названию;
• Фильтрация шаблонов по типу сущности для работы только с определенными типами бизнес-процессов;
• Поиск шаблонов с определенным режимом автозапуска для анализа автоматизации процессов;
• Отслеживание работы конкретных пользователей через фильтрацию по изменившему пользователю;
• Поиск шаблонов, использующих определенные типы активити для анализа функциональности;
• Поиск шаблонов по значению параметра для нахождения шаблонов с конкретными настройками;
• Комбинированный поиск по нескольким критериям для точного нахождения нужных шаблонов;
• Сохранение часто используемых параметров фильтрации для быстрого применения в будущем;
• Анализ структуры бизнес-процессов на портале через фильтрацию и сортировку;
• Обновление списка шаблонов после изменений для работы с актуальными данными.

Сохранение БП

Модуль "Сохранение БП" предназначен для управления резервными копиями шаблонов бизнес-процессов Битрикс24.
Результатом работы модуля является возможность сохранения, просмотра, восстановления и управления резервными копиями шаблонов БП для последующего использования или восстановления после случайного удаления или изменения.

Название функции	Описание и примеры использования
Сохранение резервной копии шаблона БП	Позволяет сохранить полную резервную копию шаблона бизнес-процесса в базу данных. Сохраняются все параметры шаблона: структура активити, переменные, константы, параметры, настройки автозапуска и другие данные. При сохранении автоматически проверяется лимит резервных копий согласно тарифу пользователя. Если лимит достигнут, система выводит предупреждение с предложением удалить часть существующих копий или приобрести другой тариф. При каждом сохранении в журнал операций записывается информация о пользователе, который выполнил операцию, и дате сохранения. Как использовать: - Откройте список шаблонов БП на странице модуля; - Найдите нужный шаблон в таблице; - Нажмите на иконку дискеты в столбце "Резервная копия"; - В появившемся всплывающем окне нажмите кнопку "Сохранить резервную копию"; - Система автоматически сохранит копию с указанием текущей даты и пользователя. Важно: Система ограничивает количество резервных копий согласно тарифному плану. При достижении лимита необходимо удалить часть существующих копий или приобрести другой тариф. Механизм не работает с роботами, только бизнес-процессы из конструктора БП. Созданные в конструкторе БП шаблоны вручную, приложение может только "клонировать" и ничего более, даже удалить. А вот с клонами, пользователь может уже полноценно работать. Такие БП, созданные вручную, будут отображены в виде "серой" дискетки.
Просмотр списка сохраненных копий	Позволяет просмотреть все сохраненные резервные копии для конкретного шаблона БП. Для каждого шаблона можно сохранить несколько версий копий, и все они будут отображаться в списке с указанием даты сохранения и пользователя, который выполнил операцию. В таблице списка копий отображается информация: ID копии, название шаблона, дата сохранения, пользователь, который сохранил копию, и доступные действия. Как использовать: - Найдите шаблон БП в основной таблице; - Нажмите на иконку дискеты, чтобы открыть список резервных копий; - В модальном окне будет отображена таблица со всеми сохраненными копиями шаблона. Информация о копиях: Каждая копия содержит полную информацию о состоянии шаблона на момент сохранения, включая все активити, переменные, константы и настройки.
Восстановление шаблона из резервной копии	Позволяет восстановить шаблон БП из ранее сохраненной резервной копии. При восстановлении все текущие настройки шаблона заменяются настройками из выбранной копии. Операция восстановления создает запись в журнале операций для отслеживания изменений. Восстановление выполняется через REST API метод bizproc.workflow.template.update, что гарантирует корректность данных. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке (сортировка по дате сохранения - самые новые сверху); - Нажмите кнопку "Восстановить" рядом с нужной копией; - Подтвердите операцию восстановления; - Система автоматически восстановит шаблон из выбранной копии. Важно: Операция восстановления заменяет все текущие настройки шаблона. Рекомендуется сохранить текущую версию перед восстановлением, если есть риск потерять важные изменения. "Заменить" (восстановить) можно ТОЛЬКО БП, которые были созданы приложением. Созланные в конструкторе БП бизнес-процессы восстановить НЕЛЬЗЯ. Чтобы БП, которые были созданы в конструкторе можно было восстанавливать, их нужно "Клонировать", и клон оригинального БП уже можно восстановить при необходимости.
Скачивание резервной копии в формате .bpt	Позволяет скачать резервную копию шаблона БП в стандартном формате .bpt для последующего использования на другом портале или в качестве архива. Файл .bpt содержит полную информацию о шаблоне в сжатом формате и может быть импортирован в любой портал Битрикс24. Имя файла формируется автоматически и включает домен портала, ID шаблона и метку времени. Операция скачивания также фиксируется в журнале операций. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке; - Нажмите кнопку "Скачать" рядом с нужной копией; - Файл автоматически загрузится в папку загрузок браузера; - Имя файла будет в формате: домен_портала_ID_шаблона_время.bpt. Формат файла: Файл .bpt представляет собой сжатый архив с сериализованными данными шаблона в формате JSON, который может быть импортирован в Битрикс24 через интерфейс бизнес-процессов.
Клонирование БП	Позволяет создать новый шаблон БП на основе сохраненной резервной копии существующего шаблона. Это полезно для копирования настроек одного шаблона в другой или для создания вариаций одного шаблона для разных сценариев. При создании нового шаблона автоматически добавляется префикс с названием приложения и датой создания к оригинальному названию шаблона. Новый шаблон создается с теми же параметрами, что и исходный: типом сущности, настройками автозапуска, структурой активити и всеми переменными. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите нужную копию в списке; - Нажмите кнопку "Клонировать" рядом с нужной копией; - Система автоматически создаст новый шаблон на основе выбранной копии; - Новый шаблон появится в списке шаблонов БП с названием в формате: "Оригинальное название [Лаборатория роботов - дата и время]". Важно: Новый шаблон создается как полностью независимый и не связан с исходным шаблоном. Все последующие изменения в новом шаблоне не влияют на оригинальный шаблон или резервную копию.
Удаление резервных копий	Позволяет удалить отдельную резервную копию шаблона БП из базы данных. Операция удаления создает запись в журнале операций для аудита. При удалении копии она полностью удаляется из базы данных и не может быть восстановлена. Также доступна функция массового удаления всех резервных копий для конкретного шаблона БП. Это полезно для освобождения места при достижении лимита резервных копий. Как использовать: - Откройте список резервных копий для нужного шаблона; - Найдите копию, которую нужно удалить; - Нажмите кнопку "Удалить" рядом с нужной копией; - Подтвердите операцию удаления; - Копия будет удалена из базы данных. Массовое удаление: Для удаления всех копий конкретного шаблона используйте функцию "Удалить шаблон со всеми копиями" в основном списке шаблонов.
Фильтрация шаблонов БП	Позволяет фильтровать список шаблонов БП по различным критериям для быстрого поиска нужных шаблонов. Доступны фильтры: по ID бизнес-процесса, по названию, по типу сущности, по пользователю, который последним изменял шаблон, по наличию резервных копий, по шаблонам, созданным приложением, и по удаленным шаблонам. Фильтры могут использоваться как отдельно, так и в комбинации друг с другом. Система поддерживает сохранение параметров фильтрации для быстрого применения в будущем. Как использовать: - Заполните нужные поля фильтрации в верхней части страницы; - Используйте выпадающие списки для выбора типа сущности или пользователя; - Установите флажки для показа только шаблонов с копиями, удаленных шаблонов или шаблонов, созданных приложением; - Результаты фильтрации автоматически применяются к таблице шаблонов; - Используйте кнопку "Очистить параметры фильтра" для сброса всех фильтров. - Используйте кнопку "Обновить список шаблонов БП" для обновления списка доступных в системе БП. Сохранение фильтров: Система позволяет сохранить до 10 последних наборов параметров фильтрации для быстрого применения в будущем.
Просмотр истории операций	Позволяет просмотреть полную историю всех операций с резервными копиями шаблонов БП. В истории отображаются все действия: создание копии, восстановление шаблона, скачивание файла, создание нового шаблона, замена шаблона и удаление копий. Для каждой операции записывается тип операции, пользователь, который выполнил действие, ID шаблона БП, описание операции, дата и время выполнения. История доступна как в общем виде для всех шаблонов, так и по конкретному шаблону БП. Система поддерживает пагинацию для удобной навигации по большому количеству записей. Как использовать: - Нажмите кнопку "История операций" в верхней части страницы для просмотра общей истории; - Для просмотра истории конкретного шаблона откройте список его резервных копий; - В модальном окне будет отображена таблица с историей операций; - Используйте пагинацию для просмотра предыдущих или следующих страниц; - История отсортирована по дате - самые новые операции сверху. Информация в истории: Каждая запись содержит полную информацию об операции, включая тип операции (Создание, Обновление, Восстановление, Скачивание, Замена, Удаление), пользователя, ID шаблона и описание действия.
Обновление списка шаблонов БП	Позволяет обновить список шаблонов БП, загрузив актуальные данные с портала Битрикс24. Система кэширует список шаблонов для повышения производительности, но при необходимости можно принудительно обновить данные, удалив кэш и загрузив свежую информацию. При обновлении список шаблонов обновляется в реальном времени, включая новые созданные шаблоны и изменения в существующих. Как использовать: - Нажмите кнопку "Обновить список шаблонов БП" в верхней части страницы; - Система автоматически удалит кэш и загрузит актуальный список шаблонов; - Обновленный список отобразится в таблице на странице. Кэширование: Система автоматически кэширует список шаблонов для повышения скорости работы. Кэш обновляется при каждом обновлении списка или автоматически при изменениях в шаблонах.
Работа с удаленными шаблонами	Позволяет просматривать и работать с шаблонами БП, которые были удалены из портала Битрикс24, но имеют сохраненные резервные копии. Удаленные шаблоны отображаются в основной таблице с пометкой "Удален" и могут быть восстановлены или использованы для создания новых шаблонов. Это полезно для восстановления случайно удаленных шаблонов или для анализа удаленных шаблонов. Как использовать: - Установите флажок "Удаленные шаблоны" в блоке фильтров; - В таблице будут отображены только шаблоны, удаленные из портала, но имеющие резервные копии; - Для удаленных шаблонов доступны функции просмотра копий, скачивания и создания нового шаблона; - Функция восстановления недоступна для удаленных шаблонов, так как они не существуют на портале. Важно: Удаленные шаблоны можно использовать только для создания новых шаблонов или скачивания резервных копий. Прямое восстановление удаленного шаблона невозможно, так как шаблон отсутствует на портале.
Удаление шаблона БП	Позволяет удалить шаблон БП непосредственно из портала Битрикс24 через REST API. Операция удаления выполняется окончательно и необратимо. Система позволяет удалять только шаблоны, которые были созданы этим приложением. Для шаблонов, созданных другими способами, функция удаления недоступна для предотвращения случайного удаления важных шаблонов. Как использовать: - Найдите нужный шаблон в списке; - Убедитесь, что шаблон был создан этим приложением (иконка удаления будет активной); - Нажмите на иконку корзины в столбце "Удалить"; - Подтвердите операцию удаления; - Шаблон будет удален из портала Битрикс24. Важно: Удаление шаблона БП выполняется безвозвратно. Рекомендуется сохранить резервную копию перед удалением, если есть вероятность, что шаблон понадобится в будущем.

Описание примера	Решение
Создание резервной копии перед важными изменениями шаблона БП	Перед внесением изменений в шаблон БП сохраните его резервную копию. Откройте список шаблонов, найдите нужный шаблон, нажмите на иконку дискеты и выберите "Сохранить резервную копию". После сохранения можно безопасно вносить изменения в шаблон, зная, что при необходимости можно восстановить предыдущую версию.
Восстановление шаблона после неудачных изменений	Если после изменений шаблон работает некорректно, восстановите его из резервной копии. Откройте список копий нужного шаблона, найдите нужную версию (обычно самая последняя перед изменениями), нажмите "Восстановить" и подтвердите операцию. Шаблон будет восстановлен в состояние на момент сохранения копии.
Создание копии шаблона для другого отдела	Для создания шаблона для другого отдела на основе существующего используйте функцию "Создать новый шаблон". Откройте список резервных копий исходного шаблона, выберите нужную копию и нажмите "Создать новый шаблон". Новый шаблон будет создан с теми же настройками, и его можно будет адаптировать под нужды отдела без изменения оригинального шаблона.
Экспорт шаблона БП для использования на другом портале	Для переноса шаблона БП на другой портал скачайте его резервную копию в формате .bpt. Откройте список копий нужного шаблона, выберите нужную копию и нажмите "Скачать". Файл будет загружен в папку загрузок. Затем этот файл можно импортировать на другой портал Битрикс24 через интерфейс бизнес-процессов.
Восстановление случайно удаленного шаблона БП	Если шаблон был случайно удален, используйте фильтр "Удаленные шаблоны" для поиска. Установите флажок "Удаленные шаблоны" в фильтрах, найдите нужный шаблон в списке. Откройте его резервные копии и используйте функцию "Создать новый шаблон" для восстановления. Новый шаблон будет создан на основе последней сохраненной копии.
Архивирование старых резервных копий	Для освобождения места при достижении лимита резервных копий скачайте старые копии в формате .bpt для архивации. Откройте список копий шаблона, отсортируйте по дате (старые внизу), скачайте нужные копии и сохраните их локально. Затем удалите скачанные копии из системы для освобождения места.
Отслеживание изменений в шаблонах БП через историю операций	Для аудита и отслеживания изменений используйте функцию просмотра истории операций. Нажмите кнопку "История операций" в верхней части страницы для просмотра всех операций или откройте историю конкретного шаблона через список его копий. История покажет всех пользователей, которые работали с шаблоном, и все выполненные операции.
Быстрый поиск шаблонов определенного типа сущности	Для поиска всех шаблонов определенного типа сущности используйте фильтр "Тип сущности бизнес-процесса". Выберите нужный тип из выпадающего списка (например, "CRM Сделка" или "CRM Контакт"), и в таблице будут отображены только шаблоны этого типа. Это упрощает работу с большим количеством шаблонов.
Поиск шаблонов, измененных конкретным пользователем	Для поиска шаблонов, которые изменял конкретный пользователь, используйте фильтр "Кто изменил бизнес-процесс". Выберите пользователя из выпадающего списка, и в таблице будут отображены только шаблоны, которые последний раз изменял этот пользователь. Это полезно для отслеживания работы команды или конкретного сотрудника.
Работа только с шаблонами, имеющими резервные копии	Для фильтрации только шаблонов с сохраненными резервными копиями установите флажок "Шаблоны с копиями" в блоке фильтров. В таблице будут отображены только шаблоны, для которых были созданы резервные копии. Это помогает быстро найти шаблоны, у которых есть возможность восстановления.

Модуль "Сохранение БП" предназначен для использования в веб-интерфейсе и может быть полезен в следующих сценариях:

• Создание резервных копий перед важными изменениями шаблонов БП для возможности отката изменений;
• Восстановление шаблонов после неудачных изменений или случайного удаления;
• Копирование шаблонов БП между отделами или порталами Битрикс24;
• Архивирование старых версий шаблонов для хранения истории изменений;
• Экспорт и импорт шаблонов БП для использования на других порталах;
• Аудит и отслеживание изменений в шаблонах БП через журнал операций;
• Быстрый поиск и фильтрация шаблонов по различным критериям;
• Управление версиями шаблонов БП для поддержания различных вариантов одного процесса;
• Восстановление работы бизнес-процессов после ошибок или сбоев;
• Создание тестовых копий шаблонов для экспериментов без риска потери рабочей версии.

Бизнес-процессы

Запуск бизнес-процесса для Лида

Данное активити позволяет запускать бизнес-процесс для сущности "Лид" после выбора необходимых БП из списка.


Бизнес-процесс: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнес-процесса для лида".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

ID сущности: в данном пункте указывается ID сущности "Лид" для которой будут запущены активити, выбранные в п. меню "Бизнес-процесс".

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр,указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для лида". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID лида, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID лида).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.
Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Компании

Данное активити позволяет запускать бизнес-процесс для сущности "Компания" после выбора необходимых БП из списка.

 
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.
Схема: Название переменной:содержимое. Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Контакта

Данное активити позволяет запускать бизнес-процесс для сущности "Контакт" после выбора необходимых БП из списка.


Бизнесс-процес: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнесс-процесса для Контакта".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

ID сущности: в данном пункте указывается ID сущности "Контакт" для которой будут запущены активити, выбранные в п. меню "Бизнесс-процесс".

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Сделки

Данное активити позволяет запускать бизнес-процесс для сущности "Сделка" после выбора необходимых БП из списка.


Бизнес-процесс: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнесс-процесса для сделки".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Задание в карточке сущности

Активити (робот) "Задание в карточке сущности" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Запрос подтверждения или выбора варианта действия у ответственного прямо в карточке лида, сделки, контакта или компании;
• Согласование перехода сделки на следующую стадию с кнопками "Одобрить" и "Отклонить";
• Опрос по лиду (например, "Готовы к встрече?" — Да / Нет / Перенести);
• Фиксация решения по счёту или предложению в карточке CRM;
• Задание в карточке элемента смарт-процесса с ожиданием нажатия кнопки пользователем;
• Ограничение видимости формы только определённым сотрудникам;
• Сбор комментария или делегирование выполнения другому пользователю из карточки сущности.

Активити (робот) добавляет в выбранную сущность CRM пользовательское поле с формой задания. В карточке сущности отображается заголовок, описание и до трёх кнопок. После нажатия кнопки пользователем бизнес-процесс продолжает работу; в возвращаемых параметрах доступны номер кнопки, ID пользователя, комментарий и данные о делегировании.


Поле "Задание для ответственного" (или "Задание в карточке") должно быть отображено в карточке сущности.
Если поле не отображается, результат работы активити не будет передан в процесс.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип сущности	Тип сущности CRM, в которой будет отображаться форма задания. Поддерживаются: Лид, Сделка, Контакт, Компания, Счет, Предложение, а также смарт-процессы (отображаются как "Смарт: Название смарт-процесса"). Пример: для сделки выберите "Сделка"; для элемента смарт-процесса — нужный пункт из списка "Смарт: ...".
Идентификатор сущности	Обязательное поле. ID сущности, в карточке которой появится форма задания. Примеры: - {=Document:ID} — текущая сущность документа (сделка, лид и т.д.); - 123 — конкретный ID сущности.
Файлы формы	Публичные ссылки на файлы для скачивания, отображаются в форме задания. Можно добавить несколько полей кнопкой "Добавить".
Разрешить делегирование другому пользователю	Да/Нет. Позволяет ответственному за сущность перепоручить выполнение задания другому пользователю через форму.
Разрешить комментарий пользователя	Да/Нет. При "Да" в форме появляется поле для ввода комментария перед отправкой ответа.
Кому видна форма	Ограничение круга пользователей, которым отображается форма в карточке. Выбираются только пользователи (не группы). Если поле пустое — форма видна всем. Если заполнено — только выбранным; при настройке необходимо добавить и себя, чтобы видеть форму.
Цвет рамки	Цвет рамки вокруг блока задания в виде шестнадцатеричного кода (например, #FFFFFF).
Анимация рамки	Да/Нет. Включение мигания рамки задания в карточке сущности.
Заголовок формы	Текст заголовка задания, отображаемый в карточке.
Описание формы	Текст описания задания.
Текст кнопки 1, 2, 3	Названия кнопок (например, "Да", "Нет", "Перенести"). Кнопки расположены внизу формы. Необходимо указать текст хотя бы для одной кнопки.
Цвет текста и цвет фона кнопок 1, 2, 3	Цвета в виде шестнадцатеричного кода (например, #FFFFFF для текста, #d2f95f для фона).
Делать отладочные сообщения в журнал БП	Да/Нет. Включает отладочные сообщения в журнал бизнес-процесса. Рекомендуется использовать только при необходимости из-за расхода запросов и снижения скорости.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора; при недостаточных правах активити может не сработать.
Устанавливать текст статуса / Текст статуса	Позволяет выводить в истории статус шага процесса; полезно при отладке.
Ожидать ответа	Управляется системой; определяет, ожидает ли процесс ответа от активити.
Период ожидания. Время ожидания ответа от приложения	Время в секундах, минутах, часах или днях (не менее 5 минут, желательно не более 1 часа). По истечении этого времени активити завершается, если ответ не получен.

Описание примера	Решение
Согласование перехода сделки на стадию "Выставлен счёт". Форма только у менеджера. Кнопки: "Одобрить", "Отклонить".	Тип сущности: Сделка. Идентификатор сущности: {=Document:ID}. Заголовок: "Счёт выставлен?". Описание: "Подтвердите переход на стадию". Кнопка 1: "Одобрить", Кнопка 2: "Отклонить". В "Кому видна форма" указать ответственного за сделку или нужного пользователя.
Опрос по лиду "Готовы к встрече?" с тремя вариантами ответа.	Тип сущности: Лид. Идентификатор сущности: {=Document:ID}. Заголовок: "Готовы к встрече?". Кнопки: "Да", "Нет", "Перенести". Разрешить комментарий: Да — для указания желаемой даты переноса.
Подтверждение оплаты по счёту в карточке счёта.	Тип сущности: Счет. Идентификатор сущности: {=Document:ID}. Заголовок: "Оплата получена?". Кнопка 1: "Да", Кнопка 2: "Нет". После "Да" в процессе — обновление статуса счёта или уведомление.
Согласование предложения (коммерческого) в карточке предложения.	Тип сущности: Предложение. Идентификатор сущности: {=Document:ID}. Заголовок: "Согласовать предложение?". Кнопки: "Согласовано", "На доработку". Разрешить комментарий: Да.
Задание в карточке элемента смарт-процесса (например, "Заявка"). Ответственный должен нажать "В работе" или "Отказать".	Тип сущности: выбрать "Смарт: Заявка" (или нужный смарт-процесс). Идентификатор сущности: {=Document:ID}. Заголовок: "Взять в работу?". Кнопка 1: "В работе", Кнопка 2: "Отказать".
Задание в карточке компании — подтверждение реквизитов.	Тип сущности: Компания. Идентификатор сущности: {=Document:ID}. Заголовок: "Реквизиты проверены?". Описание: "Проверьте ИНН и адрес". Кнопки: "Подтверждаю", "Требуются правки". Разрешить комментарий: Да.
Задание в карточке контакта — выбор способа связи.	Тип сущности: Контакт. Идентификатор сущности: {=Document:ID}. Заголовок: "Как связаться?". Кнопки: "Позвонить", "Написать", "Встреча". Дальше в процессе — ветвление по номеру кнопки.
Форма только для руководителя отдела — видна только выбранному пользователю.	В параметре "Кому видна форма" указать одного или нескольких пользователей (руководителя). Остальные форму не увидят; активити будет ждать ответа от кого-то из указанных.
Делегирование задания другому сотруднику из карточки.	Включить "Разрешить делегирование другому пользователю" — Да. В форме появится возможность выбрать другого пользователя; его ID вернётся в параметре "Пользователь-делегат".
Задание с прикреплённым файлом (инструкция или договор) для скачивания.	В "Файлы формы" добавить публичную ссылку на файл. В форме отобразится ссылка "Файл 1"; пользователь может открыть файл перед нажатием кнопки.

Группы

Управление группами

Добавление группы (проекта)

Данное активити позволяет создавать группу или проект с настройками, указанными в активити.

Название	Описание
Название группы:	в данном поле указывается название группы (проекта)
Владелец группы:	Владельцем группы (проекта) будет тот пользователь, от имени которого произошел запуск активити. Если данный вариант вам не подходит, то в следующем активити можно запустить смену владельца группы (проекта).
Описание группы:	в данном указывается описание группы (проекта)
Видна ли группа в списке:	Выбор из выпадающего списка: да/нет. Позволяет выбрать видна ли группа в списке групп.
Открыта ли группа для свободного вступления:	позволяет открыть и закрыть свободное вступление в группу
Ключевые слова (через запятую):	В данном пункте указываются ключевые слова.
Кто может приглашать пользователей?:	Выбор из выпадающего списка тех, кто может приглашать кого-либо в группу. Это могут быть пользователи, модераторы, владелец группы.
Кто может писать в группу?:	Выбор из выпадающего списка тех, кто может писать в группу. Это могут быть пользователи, модераторы, владелец группы.
Тип группы:	Выбор из выпадающего списка типа группы:обычная группа, либо проект.
Дата старта проекта:	В данном пункте указывается дата начала проекта.
Дата окончания проекта:	В данном пункте указывается дата окончания проекта.
Пригласить пользователей в группу (укажите через точку с запятой):	В данном поле указываются пользователи, которые будут приглашены в группу. Выбор пользователей происходит из выпадающего меню.
Текст приглашения:	В данном пункте указывается текст приглашения, который пользователи получат при приглашении в группу.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
   

Поиск группы

Данное активити позволяет искать группу или проект с настройками, указанными в активити.

  Активити (робот) "Поиск групп" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск групп по названию, описанию или ключевым словам;
• Поиск групп владельца по ID пользователя;
• Фильтрация групп по дате создания или обновления;
• Поиск открытых или закрытых групп;
• Поиск проектов (тип группы);
• Получение списка ID групп для массовых операций;
• Проверка существования группы с заданными параметрами;
• Поиск групп по количеству участников;
• Фильтрация по правам (кто может приглашать, кто может писать);
• Интеграция с процессами - поиск группы для добавления участников.

Название поля	Описание и примеры использования
ID	Поиск по точному ID или с оператором. Примеры: 42, >=50, %123
Название группы (NAME)	Название группы. Примеры: %Проект (содержит), =Группа 1 (точно)
Описание группы (DESCRIPTION)	Описание. Пример: %сделка
Код пользователя-владельца группы (OWNER_ID)	Владелец группы. Тип: user. Примеры: {=User:ID}, {=Document:ASSIGNED_BY_ID}
Видима ли группа в списках (VISIBLE)	Выпадающий список, значения: да/нет. Пример: да
Открыта ли группа для свободного вступления (OPENED)	Выпадающий список, значения: да/нет. Пример: нет
Является ли группа архивной (CLOSED)	Выпадающий список, значения: да/нет. Пример: нет
Является ли группа активной (ACTIVE)	Выпадающий список, значения: да/нет. Пример: да
Ключевые слова (KEYWORDS)	Множественное значение. Пример: проект, 2024
Количество членов группы (NUMBER_OF_MEMBERS)	Количество участников. Примеры: >=5, =10
Дата создания, Дата изменения, Дата последней активности в группе (DATE_CREATE, DATE_UPDATE, DATE_ACTIVITY)	Даты создания, обновления, активности. Тип datetime. Пример: >=1699000000
Кто имеет право на прием в группу новых членов, Кто имеет право на написание сообщений членам группы (INITIATE_PERMS, SPAM_PERMS)	Права приглашения и записи. A, E или K. Пример: E
Ограничить количество результатов до (limit_result)	Максимум ID в результате. Пример: 10
Запускать от имени	Сотрудник с правами на поиск групп.

Описание примера	Решение
Найти группы текущего пользователя	OWNER_ID - {=User:ID}
Найти группы по названию	NAME - %Проект (содержит "Проект")
Найти открытые группы	OPENED - Y, limit_result - 5
Найти группу по ID	ID - {=Variable:GROUP_ID}
Найти группы ответственного за сделку	OWNER_ID - {=Document:ASSIGNED_BY_ID}
Найти группы, созданные за последний месяц	DATE_CREATE - >= (укажите timestamp, например через переменную)
Найти группы с ключевым словом	KEYWORDS - сделка или KEYWORDS - {=Document:ID}
Получить первую найденную группу	OWNER_ID - {=User:ID}, limit_result - 1. Используйте search_result_first_string.
Найти активные неархивные группы	ACTIVE - Y, CLOSED - N
Массовая обработка найденных групп	Передайте search_results_array в итератор. Обрабатывайте каждую группу в цикле.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Возвращаемые параметры данного активити (робота):
- Соответствует условиям (math_search_results) - Y при наличии результатов, N если группы не найдены.
- Количество найденных (count_search) - число найденных групп.
- Результат поиска массив (search_results_array) - массив ID групп. Для итератора.
- Результат поиска строка (search_results_string) - ID через запятую.
- Первый результат (search_result_first_string) - ID первой группы.
- Последний результат (search_result_last_string) - ID последней группы.
- Сообщение об ошибке (s_error_logs) - описание или количество найденных.

При отсутствии результатов, параметр "Соответствие условиям" = N.
Проверяйте перед использованием массивов.

Ограничения и рекомендации:

Хотя бы один параметр:
Необходимо указать минимум один критерий поиска.
Иначе активити (робот) завершится с ошибкой "Не указаны параметры поиска".

Операторы в значениях:
Используйте префиксы: = (равно), != (не равно), >=, <=, >, <, % (содержит), !% (не содержит).
Для OWNER_ID формат определяется автоматически.

Ограничить количество результатов ДО:
Ограничивает количество ID в результате.
Полезно для получения только первых N групп.

Смена владельца группы

Активити (робот) "Смена владельца группы" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Передача владения группой при смене ответственного за проект;
• Перевод группы новому владельцу при реорганизации;
• Смена владельца при увольнении сотрудника;
• Передача группы при смене владельца сделки или лида;
• Автоматическая смена владельца при достижении этапа процесса;
• Передача прав при создании дубликата группы;
• Смена владельца при переводе проекта в другой отдел;
• Передача группы новому менеджеру при переназначении;
• Централизация управления группами под одного владельца;
• Смена владельца при слиянии групп или проектов.

Название поля	Описание и примеры использования
ID группы	Обязательный параметр. Идентификатор группы, для которой меняется владелец. Примеры: - {=Variable:GROUP_ID}, {=A12345:i_group_id}, 42
Владелец группы	Обязательный параметр. Пользователь, который станет новым владельцем. Тип: user. Примеры: - {=Document:ASSIGNED_BY_ID} - ответственный за документ; - {=Variable:NEW_OWNER_ID} - из переменной; - {=User:ID} - текущий пользователь; - user_5 - конкретный пользователь.
Запускать от имени	Должен быть текущим владельцем группы или иметь права администратора портала.

Описание примера	Решение
Передать группу новому ответственному за сделку	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Document:ASSIGNED_BY_ID}
Смена владельца при смене владельца лида	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Document:ASSIGNED_BY_ID}. Запуск при обновлении лида.
Передать группу при переводе сотрудника	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Variable:SUCCESSOR_ID}
Передать группу создателю процесса	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Template:TargetUser}
Смена владельца при достижении этапа	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Variable:STAGE_OWNER}. Условие - статус этапа.
Передать группу из результата поиска	i_group_id - {=A12345:search_result_first_string}, i_ownerID - {=Variable:NEW_OWNER}
Массовая смена владельца нескольких групп	i_group_id - {=Iterator:Value}, i_ownerID - {=Variable:NEW_OWNER}. Итератор по ID групп.
Передать группу при переназначении менеджера	i_group_id - {=Variable:PROJECT_GROUP_ID}, i_ownerID - {=Document:ASSIGNED_BY_ID}
Смена владельца при увольнении	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Variable:REPLACEMENT_USER_ID}
Передать группу из поля документа	i_group_id - {=Document:UF_GROUP_ID}, i_ownerID - {=Variable:NEW_OWNER_ID}

Смена владельца группы

Активити (робот) "Смена владельца группы" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Передача владения группой при смене ответственного за проект;
• Перевод группы новому владельцу при реорганизации;
• Смена владельца при увольнении сотрудника;
• Передача группы при смене владельца сделки или лида;
• Автоматическая смена владельца при достижении этапа процесса;
• Передача прав при создании дубликата группы;
• Смена владельца при переводе проекта в другой отдел;
• Передача группы новому менеджеру при переназначении;
• Централизация управления группами под одного владельца;
• Смена владельца при слиянии групп или проектов.

Название поля	Описание и примеры использования
ID группы	Обязательный параметр. Идентификатор группы, для которой меняется владелец. Примеры: - {=Variable:GROUP_ID}, {=A12345:i_group_id}, 42
Владелец группы	Обязательный параметр. Пользователь, который станет новым владельцем. Тип: user. Примеры: - {=Document:ASSIGNED_BY_ID} - ответственный за документ; - {=Variable:NEW_OWNER_ID} - из переменной; - {=User:ID} - текущий пользователь; - user_5 - конкретный пользователь.
Запускать от имени	Должен быть текущим владельцем группы или иметь права администратора портала.

Описание примера	Решение
Передать группу новому ответственному за сделку	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Document:ASSIGNED_BY_ID}
Смена владельца при смене владельца лида	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Document:ASSIGNED_BY_ID}. Запуск при обновлении лида.
Передать группу при переводе сотрудника	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Variable:SUCCESSOR_ID}
Передать группу создателю процесса	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Template:TargetUser}
Смена владельца при достижении этапа	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Variable:STAGE_OWNER}. Условие - статус этапа.
Передать группу из результата поиска	i_group_id - {=A12345:search_result_first_string}, i_ownerID - {=Variable:NEW_OWNER}
Массовая смена владельца нескольких групп	i_group_id - {=Iterator:Value}, i_ownerID - {=Variable:NEW_OWNER}. Итератор по ID групп.
Передать группу при переназначении менеджера	i_group_id - {=Variable:PROJECT_GROUP_ID}, i_ownerID - {=Document:ASSIGNED_BY_ID}
Смена владельца при увольнении	i_group_id - {=Variable:GROUP_ID}, i_ownerID - {=Variable:REPLACEMENT_USER_ID}
Передать группу из поля документа	i_group_id - {=Document:UF_GROUP_ID}, i_ownerID - {=Variable:NEW_OWNER_ID}

Изменение группы (проекта)

Данное активити позволяет изменять группу или проект с настройками, указанными в активити.

Название	Описание
ID группы:	В данном пункте указывается ID группы (проекта) в котором будут произведены изменения.
Название группы:	В данном поле указывается название группы (проекта)
Описание группы:	В данном указывается описание группы (проекта)
Видна ли группа в списке:	Выбор из выпадающего списка: да/нет. Позволяет выбрать видна ли группа в списке групп.
Открыта ли группа для свободного вступления:	Позволяет открыть и закрыть свободное вступление в группу
Ключевые слова (через запятую):	В данном пункте указываются ключевые слова.
Кто может приглашать пользователей?:	Выбор из выпадающего списка тех, кто может приглашать кого-либо в группу. Это могут быть пользователи, модераторы, владелец группы.
Кто может писать в группу?:	Выбор из выпадающего списка тех, кто может писать в группу. Это могут быть пользователи, модераторы, владелец группы.
Тип группы:	Выбор из выпадающего списка типа группы:обычная группа, либо проект.
Дата старта проекта:	В данном пункте указывается дата начала проекта.
Дата окончания проекта:	В данном пункте указывается дата окончания проекта.
Пригласить пользователей в группу (укажите через точку с запятой):	В данном поле указываются пользователи, которые будут приглашены в группу. Выбор пользователей происходит из выпадающего меню.
Текст приглашения:	В данном пункте указывается текст приглашения, который пользователи получат при приглашении в группу.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени.
Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Участники групп

Удаление участника(ов) из группы

Активити (робот) "Удаление участника(ов) из группы" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое исключение сотрудников из рабочей группы при завершении проекта;
• Удаление участников при смене роли или переводе в другое подразделение;
• Очистка состава группы от неактивных пользователей;
• Синхронизация группы с актуальным списком участников проекта;
• Массовое удаление участников при архивации группы;
• Исключение пользователя из группы при отзыве доступа;
• Управление составом группы на основе данных из CRM;
• Автоматизация при увольнении сотрудника;
• Обновление состава группы при изменении владельца сущности;
• Удаление участников по результатам проверки прав доступа.

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Идентификатор рабочей группы, из которой удаляются участники. Примеры: - {=Variable:GROUP_ID}, {=A12345:search_result_first_string}, 42
ID пользователя (или массив ID)	Обязательный параметр. Идентификатор(ы) пользователей, которые удаляются из группы. Поддерживается массив - можно указать несколько ID. Примеры: - {=Variable:USER_ID} - один пользователь; - {=A12345:members_array} - массив участников из активити (робота) "Получить список участников группы"; - user_1, user_2, user_3 - несколько пользователей через запятую; - {=Iterator:Value} - для каждого пользователя из итератора.
Запускать от имени	Сотрудник с правами на удаление участников. Рекомендуется администратор.

Описание примера	Решение
Удалить одного пользователя из группы	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_TO_REMOVE}
Удалить нескольких участников за один вызов	group_id - 42, list_users - user_1, user_2, user_3 (массив ID)
Удалить всех модераторов кроме владельца	group_id - {=Variable:GROUP_ID}, list_users - {=A12345:moderators_array}. Предварительно получите список через "Получить список участников группы".
Удалить пользователя при завершении проекта	group_id - {=Variable:PROJECT_GROUP_ID}, list_users - {=Document:ASSIGNED_BY_ID}
Удалить участников через итератор	group_id - {=Variable:GROUP_ID}, list_users - {=Iterator:Value}. Выполнится для каждого ID.
Исключить бывшего ответственного из группы	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:OLD_OWNER_ID}
Удалить всех обычных участников (кроме владельца и модераторов)	group_id - {=Variable:GROUP_ID}, list_users - {=A12345:members_array}
Очистить группу от определённого списка	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USERS_TO_REMOVE} (массив из предыдущего активити)
Удалить текущего пользователя из группы	group_id - {=Variable:GROUP_ID}, list_users - {=User:ID}
Удалить контакт-владельца при смене сделки	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:PREVIOUS_CONTACT_USER_ID}

Добавление участника(ов) в группу

Активити (робот) "Добавление участника(ов) в группу" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое добавление сотрудников в рабочую группу при создании проекта;
• Включение участников в группу по результатам поиска или другого активити (робота);
• Массовое добавление пользователей в группу при определённых условиях;
• Синхронизация состава группы с данными из CRM или других сущностей;
• Добавление ответственного за сделку в группу проекта;
• Автоматическое формирование рабочих групп при создании задач;
• Интеграция с процессами онбординга новых сотрудников;
• Добавление участников в группу на основе роли или подразделения;
• Управление доступом к группам через бизнес-процессы;
• Автоматизация добавления в группу при смене владельца сущности.

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Указывается идентификатор рабочей группы, в которую добавляется пользователь. Примеры: - {=Variable:GROUP_ID} - ID группы из переменной предыдущего активити (робота); - {=A12345:search_result_first_string} - ID из результата активити (робота) "Поиск групп"; - 42 - конкретный ID группы; - {=Document:UF_CRM_GROUP_ID} - ID группы из поля документа.
ID пользователя	Обязательный параметр. Указывается идентификатор пользователя (или массив ID), который добавляется в участники группы. При множественном значении добавляется только первый пользователь. Примеры: - {=User:ID} - текущий пользователь; - {=Document:ASSIGNED_BY_ID} - ответственный за документ; - {=Variable:USER_ID} - ID из переменной; - user_1 - в формате user_ID; - {=Iterator:Value} - для каждого пользователя из итератора.
Запускать от имени	Сотрудник, с правами которого выполняется действие. Рекомендуется выбирать администратора системы.

Описание примера	Решение
Добавить ответственного за сделку в группу проекта	group_id - {=Variable:PROJECT_GROUP_ID}, list_users - {=Document:ASSIGNED_BY_ID}
Добавить текущего пользователя в группу	group_id - {=Variable:GROUP_ID}, list_users - {=User:ID}
Добавить пользователя из результата поиска групп	group_id - {=A12345:search_result_first_string}, list_users - {=Variable:NEW_MEMBER_ID}
Добавить участника при создании группы	group_id - {=A12345:i_group_id}, list_users - {=Template:TargetUser}. Используйте ID созданной группы из активити (робота) "Создание группы".
Добавить пользователя по ID из CRM	group_id - 42, list_users - {=Document:CONTACT_ID}. При добавлении контакта используйте соответствующий user_id.
Добавить нескольких пользователей через итератор	В итератор передайте массив ID. group_id - {=Variable:GROUP_ID}, list_users - {=Iterator:Value}. Активити (робот) выполнится для каждого элемента.
Добавить владельца лида в группу	group_id - {=Variable:GROUP_ID}, list_users - {=Document:ASSIGNED_BY_ID}
Добавить пользователя из переменной предыдущего шага	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_TO_ADD}
Добавить создателя процесса в группу	group_id - {=Variable:GROUP_ID}, list_users - {=Template:TargetUser}
Добавить пользователя в группу по ID из поля формы	group_id - {=Document:ID}, list_users - {=Variable:FORM_USER_ID}

Получить список участников группы

Активити (робот) "Получить список участников группы" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение состава рабочей группы для уведомлений или рассылок;
• Проверка наличия пользователя в группе перед добавлением;
• Разделение участников по ролям для дальнейшей обработки;
• Передача списка участников в итератор для массовых операций;
• Аналитика и отчётность по составу групп;
• Уведомление модераторов или владельца группы;
• Синхронизация состава группы с внешними системами;
• Проверка прав доступа на основе роли в группе;
• Автоматизация при назначении задач участникам группы;
• Получение владельца группы для передачи прав или уведомления.

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Идентификатор группы, для которой получается список участников. Примеры: - {=Variable:GROUP_ID}, {=A12345:i_group_id}, 42
Формат пользователей	Необязательный параметр. 1 - числовой ID (по умолчанию), user_1 - формат user_ID. Выбор влияет на формат возвращаемых значений. Примеры: - 1 - для передачи в активити, ожидающие числовой ID; - user_1 - для полей типа "Пользователь" в Битрикс24.
Запускать от имени	Сотрудник с правами на просмотр состава группы.

Описание примера	Решение
Получить список для уведомления всех участников	group_id - {=Variable:GROUP_ID}, user_format - 1. Объедините members_array, moderators_array и owner_id для рассылки.
Уведомить только модераторов группы	group_id - {=Variable:GROUP_ID}. Используйте возвращаемый moderators_array.
Получить владельца группы для передачи задач	group_id - {=Variable:GROUP_ID}. Используйте owner_id.
Проверить, есть ли пользователь в группе	group_id - {=Variable:GROUP_ID}. Проверьте вхождение {=User:ID} в members_array, moderators_array или owner_id.
Удалить всех участников кроме владельца	group_id - {=Variable:GROUP_ID}. Передайте members_array и moderators_array в активити (робот) "Удаление участника(ов) из группы".
Назначить задачу первому модератору	group_id - {=Variable:GROUP_ID}. Используйте первый элемент moderators_array.
Итерация по участникам для массовой рассылки	group_id - {=Variable:GROUP_ID}. Передайте members_array в итератор, в цикле отправляйте уведомления.
Получить ID в формате user_ для поля "Пользователь"	group_id - {=Variable:GROUP_ID}, user_format - user_1
Проверить состав группы после добавления	group_id - {=Variable:GROUP_ID}. Вызовите после "Добавление участника(ов) в группу" для проверки.
Получить участников из найденной группы	group_id - {=A12345:search_result_first_string}. Сначала "Поиск групп", затем получение состава.

Пригласить участника в группу

Активити (робот) "Пригласить участника в группу" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Приглашение новых участников в рабочую группу с персональным сообщением;
• Автоматическое приглашение при создании проекта или группы;
• Приглашение с поясняющим текстом о целях группы;
• Интеграция с процессами онбординга - приглашение с инструкциями;
• Приглашение сотрудников по результатам поиска или отбора;
• Массовые приглашения с индивидуальным текстом через итератор;
• Приглашение контрагентов (экстранет) с описанием условий доступа;
• Уведомление о приглашении с контактной информацией;
• Приглашение при смене владельца проекта;
• Приглашение с указанием сроков или условий участия.

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Идентификатор группы, в которую приглашается пользователь. Примеры: - {=Variable:GROUP_ID}, {=A12345:i_group_id}, 42
ID пользователя	Обязательный параметр. ID пользователя, которому отправляется приглашение. Примеры: - {=Document:ASSIGNED_BY_ID}, {=Variable:NEW_MEMBER_ID}, user_1
Текст приглашения	Необязательный параметр. Персональное сообщение, которое увидит приглашаемый. Может содержать инструкции, сроки, контакты. Примеры: - Добро пожаловать в группу проекта "Название"! Срок до {{=date('d.m.Y', {=System:Now})}}; - Вас приглашают в рабочую группу. Свяжитесь с координатором для уточнения деталей.
Запускать от имени	Сотрудник с правами на приглашение в группу.

Описание примера	Решение
Приглашение с приветствием при создании группы	group_id - {=A12345:i_group_id}, list_users - {=Variable:USER_ID}, message - Добро пожаловать в группу проекта!
Приглашение с указанием дедлайна	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Проект до {{=date('d.m.Y', {=Variable:DEADLINE})}}
Приглашение ответственного за сделку	group_id - {=Variable:GROUP_ID}, list_users - {=Document:ASSIGNED_BY_ID}, message - Вас добавляют в группу по сделке
Массовое приглашение через итератор	group_id - {=Variable:GROUP_ID}, list_users - {=Iterator:Value}, message - Общее приглашение в рабочую группу
Приглашение с контактами координатора	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Координатор: {=Variable:COORDINATOR_NAME}, тел. {=Variable:PHONE}
Приглашение при смене владельца	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:NEW_OWNER_ID}, message - Вы назначены новым владельцем группы
Приглашение с инструкцией по доступу	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Инструкция: 1. Примите приглашение 2. Ознакомьтесь с материалами
Приглашение из результата поиска групп	group_id - {=A12345:search_result_first_string}, list_users - {=Variable:USER_ID}, message - Приглашение в найденную группу
Приглашение создателя процесса	group_id - {=Variable:GROUP_ID}, list_users - {=Template:TargetUser}, message - Вы создали группу, примите приглашение
Приглашение с названием проекта	group_id - {=Variable:GROUP_ID}, list_users - {=Variable:USER_ID}, message - Группа: {=Variable:PROJECT_NAME}

Запрос на вступление в группу

Активити (робот) "Запрос на вступление в группу" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическая подача заявки на вступление от имени текущего пользователя;
• Запрос на вступление при определённых условиях в бизнес-процессе;
• Подача заявки с пояснительным текстом о причинах вступления;
• Интеграция с процессами согласования доступа к группам;
• Запрос при срабатывании триггера (создание сделки, задача и т.д.);
• Массовые заявки на вступление в несколько групп через итератор;
• Запрос с указанием роли или целей участия;
• Автоматизация для пользователей, прошедших обучение;
• Запрос при достижении определённого статуса в процессе;
• Подача заявки с контактными данными для связи.

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Идентификатор группы, в которую подаётся заявка на вступление. Примеры: - {=Variable:GROUP_ID}, {=A12345:search_result_first_string}, 42
Текст запроса	Необязательный параметр. Текст заявки, который увидят модераторы. Можно указать причины вступления, цели, контакты. Примеры: - Прошу принять в группу проекта "Название" в качестве участника; - Завершил обучение, прошу доступ к группе.
Запускать от имени	Пользователь, от имени которого подаётся заявка. Обычно {=User:ID} или {=Template:TargetUser}.

Описание примера	Решение
Запрос при создании сделки	group_id - {=Variable:PROJECT_GROUP_ID}, message - Вступление по сделке {=Document:ID}. Запуск при создании сделки.
Запрос от создателя процесса	group_id - {=Variable:GROUP_ID}, message - Заявка от инициатора процесса
Запрос при достижении этапа	group_id - {=Variable:GROUP_ID}, message - Этап пройден. Условие: статус документа = определённое значение.
Запрос в несколько групп через итератор	group_id - {=Iterator:Value}, message - Общая заявка. В итератор передать массив ID групп.
Запрос с указанием роли	group_id - {=Variable:GROUP_ID}, message - Прошу принять в качестве участника проекта
Запрос из найденной группы	group_id - {=A12345:search_result_first_string}, message - Заявка в группу по результатам поиска
Запрос при выполнении задачи	group_id - {=Variable:GROUP_ID}, message - Задача выполнена, прошу доступ. Триггер - завершение задачи.
Запрос с контактами	group_id - {=Variable:GROUP_ID}, message - Тел: {=Variable:PHONE}, email: {=Variable:EMAIL}
Запрос в группу по полю документа	group_id - {=Document:UF_GROUP_ID}, message - Заявка по документу {=Document:ID}
Запрос после согласования	group_id - {=Variable:GROUP_ID}, message - Согласование пройдено. Условие - после подписания.

Изменить роль участника

Активити (робот) "Изменить роль участника" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Повышение участника до модератора при определённых условиях;
• Передача прав администратора при смене ответственного за проект;
• Понижение роли при смене обязанностей;
• Назначение модераторов при создании группы;
• Автоматическая смена ролей при реорганизации;
• Установка роли по результатам оценки или аттестации;
• Назначение владельца при переводе проекта;
• Ротация модераторов по графику;
• Изменение роли при смене статуса в CRM;
• Управление правами доступа через бизнес-процессы.

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Идентификатор группы, в которой изменяется роль. Примеры: - {=Variable:GROUP_ID}, {=A12345:i_group_id}, 42
ID пользователя	Обязательный параметр. Участник, которому назначается новая роль. Примеры: - {=Variable:USER_ID}, {=Document:ASSIGNED_BY_ID}, {=A12345:owner_id}
Роль участника	Обязательный параметр. A - администратор, E - модератор, K - участник. Примеры: - A - передать владение группы; - E - назначить модератором; - K - понизить до участника.
Запускать от имени	Должен иметь права владельца или администратора группы.

Описание примера	Решение
Назначить модератора при создании группы	group_id - {=A12345:i_group_id}, user_id - {=Variable:MODERATOR_ID}, role - E
Передать владение группы новому ответственному	group_id - {=Variable:GROUP_ID}, user_id - {=Variable:NEW_OWNER_ID}, role - A
Понизить модератора до участника	group_id - {=Variable:GROUP_ID}, user_id - {=Variable:USER_ID}, role - K
Назначить модератором ответственного за сделку	group_id - {=Variable:GROUP_ID}, user_id - {=Document:ASSIGNED_BY_ID}, role - E
Передать владение при смене владельца сделки	group_id - {=Variable:GROUP_ID}, user_id - {=Document:ASSIGNED_BY_ID}, role - A
Повысить первого модератора до владельца	group_id - {=Variable:GROUP_ID}, user_id - {=A12345:moderators_array} (первый элемент), role - A
Назначить модераторов из списка участников	group_id - {=Variable:GROUP_ID}, user_id - {=Iterator:Value}, role - E. Итератор по списку ID.
Понизить роль при переводе в другой проект	group_id - {=Variable:OLD_GROUP_ID}, user_id - {=Variable:USER_ID}, role - K
Назначить владельца из результата поиска	group_id - {=Variable:GROUP_ID}, user_id - {=Variable:SELECTED_OWNER}, role - A
Сделать участником бывшего модератора	group_id - {=Variable:GROUP_ID}, user_id - {=Variable:EX_MODERATOR_ID}, role - K

Живая лента

Добавление сообщения в живую ленту

Данное активити позволяет добавлять сообщения в живую ленту 


Описание параметров активити

Название поля	Описание и примеры использования
ID автора сообщения (только один)	Данное поле позволяет указать ID автора сообщения. Можно указывать в форматах: {=Variable:AUTHOR_ID} или [U1].
Получатели сообщения (сотрудники)	Данное поле позволяет выбрать получателей сообщения, указав их ID, либо передав в поле массив с ID пользователей. Пример: {=Variable:RECIPIENTS_USERS} или [U1, U5, U10].
Получатели сообщения (группы)	Позволяет указать ID групп, проектов или отделов, (можно указать несколько) тогда все сотрудники вышеперечисленных структур получат сообщение в разделе "Лента". Чтобы указать получателями группу или подразделение, нужно: 1. Рядом с полем "получатели сообщения" нажать "...". 2. Выбрать пункт категории "пользователей" (как на скриншоте). 3. Выбрать пункт "Группы социальной сети". 4. Выбрав пункт "Группы социальной сети", нужно выбрать фильтр справа "Мои группы". 5. Выбрать нужную Вам группу/подразделение. Категории получателей: [DR2] - Department Recursive (сотрудники отдела с ID = 2 и его подотделов); [SG3_A] - где индекс А, обозначает администратора (владельца) группы соцсети с ID = 3); [SG3_E] - где индекс E, обозначает модераторов группы соцсети с ID = 3); [SG3_K] - где индекс K, обозначает всех членов группы соцсети с ID = 3); Пример: Приложение Лаборатория БП: Все члены группы [SG3_K] Если не поставить галочку "для публикации" в настройках группы, то все сообщения будут сначала поступать на модерацию и не будут общедоступны для просмотра. Если вы пытались добавить сообщение в Группу используя "доп. параметры" и при этом активити пишет, что сообщение добавлено, но в Группе его нет, то нужно удалить индекс категории получателей, т.е [SG3_K] изменить на [SG3]. Это связанно с изменением подстановочных кодов со стороны Б24. Пример: "Все члены группы [SG309_K];" изменяем на "Все члены группы [SG309];"
Заголовок сообщения	Данное поле позволяет указать заголовок сообщения. Пример: {=Variable:TITLE} или "Важное объявление".
Текст сообщения	В данном поле указывается текст сообщения. Пример: {=Variable:MESSAGE_TEXT}.
Важное сообщение	Позволяет выбрать, является ли данное сообщение важным или нет. Варианты: да/нет.
Дата(время) до которого сообщение будет важным	Позволяет указать дату и время, до наступления которых сообщение будет находиться в статусе "Важно". Пример: {=Variable:IMPORTANT_DATE} или {{=dateadd({=System:Now}, "7d")}}.
Прикрепить файл(ы) к сообщению (ID файлов с диска)	В данном поле указывается ID файлов, расположенных на диске, которые должны быть прикреплены к сообщению. Можно указать несколько ID через запятую или использовать массив. Пример: {=Variable:FILE_IDS}.
Добавить видео в сообщение	В данном поле необходимо указать код видео Youtube. Пример: Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g.
Размер видео	В данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Примеры использования активити

Описание примера	Решение
Создание объявления о корпоративном мероприятии для всего отдела продаж с важным сообщением на 7 дней	Параметры: Получатели сообщения (группы) - [DR5] (отдел продаж), Заголовок сообщения - "Корпоративное мероприятие", Текст сообщения - "Приглашаем всех сотрудников отдела на мероприятие...", Важное сообщение - да, Дата(время) до которого сообщение будет важным - {{=dateadd({=System:Now}, "7d")}}, ID автора сообщения - {=User:ID}
Уведомление руководителю проекта о завершении этапа работы	Параметры: Получатели сообщения (сотрудники) - [U10] (ID руководителя), Заголовок сообщения - "Этап завершен", Текст сообщения - "Этап работы по проекту {=Document:TITLE} завершен", ID автора сообщения - {=User:ID}
Публикация отчета для группы проекта с прикрепленным файлом	Параметры: Получатели сообщения (группы) - [SG15] (ID группы проекта), Заголовок сообщения - {=Variable:REPORT_TITLE}, Текст сообщения - {=Variable:REPORT_TEXT}, Прикрепить файл(ы) к сообщению - {=Variable:REPORT_FILE_ID}, ID автора сообщения - {=User:ID}
Рассылка важного объявления всем авторизованным пользователям с видео-инструкцией	Параметры: Получатели сообщения (группы) - [UA], Заголовок сообщения - "Важное объявление", Текст сообщения - "Ознакомьтесь с новой инструкцией...", Важное сообщение - да, Добавить видео в сообщение - jWlAPx4Z40g, ID автора сообщения - {=User:ID}
Уведомление модераторов группы о новой заявке на вступление	Параметры: Получатели сообщения (группы) - [SG20_E] (модераторы группы 20), Заголовок сообщения - "Новая заявка на вступление", Текст сообщения - "Пользователь {=Variable:USER_NAME} подал заявку на вступление в группу", ID автора сообщения - {=User:ID}
Ежедневный отчет о продажах для руководства отдела	Параметры: Получатели сообщения (сотрудники) - {=Variable:MANAGERS_LIST}, Заголовок сообщения - "Отчет о продажах за {{=date('d.m.Y')}}", Текст сообщения - "Общая сумма продаж: {=Variable:SALES_SUM}, Количество сделок: {=Variable:DEALS_COUNT}", ID автора сообщения - {=User:ID}
Объявление о выходном дне для администраторов группы	Параметры: Получатели сообщения (группы) - [SG25_A] (администраторы группы 25), Заголовок сообщения - "Выходной день", Текст сообщения - "Уважаемые администраторы, {{=dateadd({=System:Now}, '1d')}} - выходной день", Важное сообщение - да, ID автора сообщения - {=User:ID}
Уведомление о новом сотруднике во все отделы компании	Параметры: Получатели сообщения (группы) - [UA], Заголовок сообщения - "Добро пожаловать, {=Variable:NEW_EMPLOYEE_NAME}!", Текст сообщения - "В компанию пришел новый сотрудник {=Variable:NEW_EMPLOYEE_NAME} на должность {=Variable:POSITION}", ID автора сообщения - {=User:ID}
Рассылка технического задания для группы разработки с несколькими файлами	Параметры: Получатели сообщения (группы) - [SG30] (группа разработки), Заголовок сообщения - "Техническое задание: {=Document:TITLE}", Текст сообщения - {=Variable:TASK_DESCRIPTION}, Прикрепить файл(ы) к сообщению - {=Variable:ATTACHED_FILES}, ID автора сообщения - {=User:ID}
Критическое уведомление для всего технического отдела с ограничением времени важности	Параметры: Получатели сообщения (группы) - [DR8] (технический отдел), Заголовок сообщения - "Критическое уведомление", Текст сообщения - "Требуется немедленное внимание к проблеме {=Variable:ISSUE_ID}", Важное сообщение - да, Дата(время) до которого сообщение будет важным - {{=dateadd({=System:Now}, "2h")}}, ID автора сообщения - {=User:ID}

Сценарий работы робота


Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Обновить пост в живой ленте

Данное активити (робот) позволяет обновлять существующие сообщения в живой ленте и группе (проект).

Название поля	Описание и примеры использования
ID поста для обновления	Данное поле является обязательным и позволяет указать ID сообщения в живой ленте, которое необходимо обновить. Пример: {=Variable:POST_ID} или 12345.
ID автора сообщения (только один)	Данное поле позволяет изменить автора сообщения. Поле необязательное - если не указано, автор останется прежним. Пример: {=Variable:AUTHOR_ID} или [U1].
Получатели сообщения (сотрудники)	Данное поле позволяет изменить получателей сообщения, указав их ID, либо передав в поле массив с ID пользователей. Если не указано, список получателей останется прежним. Пример: {=Variable:RECIPIENTS_USERS} или [U1, U5, U10].
Получатели сообщения (группы)	Позволяет изменить список групп, проектов или отделов (можно указать несколько), тогда все сотрудники вышеперечисленных структур получат доступ к сообщению в разделе "Лента". Если не указано, список получателей останется прежним. Чтобы указать получателями группу или подразделение, нужно: 1. Рядом с полем "получатели сообщения" нажать "...". 2. Выбрать пункт категории "пользователей" (как на скриншоте). 3. Выбрать пункт "Группы социальной сети". 4. Выбрав пункт "Группы социальной сети", нужно выбрать фильтр справа "Мои группы". 5. Выбрать нужную Вам группу/подразделение. Категории получателей: [DR2] - Department Recursive (сотрудники отдела с ID = 2 и его подотделов); [SG3_A] - где индекс А, обозначает администратора (владельца) группы соцсети с ID = 3); [SG3_E] - где индекс E, обозначает модераторов группы соцсети с ID = 3); [SG3_K] - где индекс K, обозначает всех членов группы соцсети с ID = 3); Пример: Приложение Лаборатория БП: Все члены группы [SG3_K] Если не поставить галочку "для публикации" в настройках группы, то все сообщения будут сначала поступать на модерацию и не будут общедоступны для просмотра. Если вы пытались обновить сообщение в Группе используя "доп. параметры" и при этом активити пишет, что сообщение обновлено, но изменений в Группе нет, то нужно удалить индекс категории получателей, т.е [SG3_K] изменить на [SG3]. Это связанно с изменением подстановочных кодов со стороны Б24. Пример: "Все члены группы [SG309_K];" изменяем на "Все члены группы [SG309];"
Заголовок сообщения	Данное поле позволяет изменить заголовок сообщения. Если не указано, заголовок останется прежним. Пример: {=Variable:TITLE} или "Обновленное объявление".
Текст сообщения	В данном поле указывается новый текст сообщения. Если не указано, текст останется прежним. Пример: {=Variable:MESSAGE_TEXT}.
Прикрепить файл(ы) к сообщению (ID файлов с диска)	В данном поле указывается ID файлов, расположенных на диске, которые должны быть прикреплены к сообщению. При обновлении новые файлы заменят старые. Пример: {=Variable:FILE_IDS}.
Добавить видео в сообщение	В данном поле необходимо указать код видео Youtube. При обновлении новые видео заменят старые. Пример: Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g.
Размер видео	В данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Обновление текста объявления о корпоративном мероприятии	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:UPDATED_TEXT}, Заголовок сообщения - "Обновленное объявление о мероприятии".
Изменение получателей сообщения при изменении состава проекта	Параметры: ID поста для обновления - {=Variable:POST_ID}, Получатели сообщения (группы) - [SG15] (новая группа проекта). Старые получатели заменятся новыми.
Добавление файлов к существующему посту	Параметры: ID поста для обновления - {=Variable:POST_ID}, Прикрепить файл(ы) к сообщению - {=Variable:NEW_FILES}. Новые файлы заменят старые.
Обновление важного объявления с изменением даты окончания важности	Параметры: ID поста для обновления - {=Variable:POST_ID}, Заголовок сообщения - {=Variable:UPDATED_TITLE}, Текст сообщения - {=Variable:UPDATED_MESSAGE}.
Замена видео в посте на новую версию	Параметры: ID поста для обновления - {=Variable:POST_ID}, Добавить видео в сообщение - jWlAPx4Z40g (новый код видео). Старое видео будет заменено.
Исправление ошибки в тексте опубликованного поста	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:CORRECTED_TEXT}. Только текст изменяется, остальное остается без изменений.
Изменение автора поста при передаче ответственности	Параметры: ID поста для обновления - {=Variable:POST_ID}, ID автора сообщения - {=Variable:NEW_AUTHOR_ID}. Автор поста изменяется на нового ответственного.
Расширение аудитории поста добавлением нового отдела	Параметры: ID поста для обновления - {=Variable:POST_ID}, Получатели сообщения (группы) - [DR8] (новый отдел). Полностью заменяет список получателей.
Обновление отчета проекта с новыми данными и файлами	Параметры: ID поста для обновления - {=Variable:POST_ID}, Текст сообщения - {=Variable:UPDATED_REPORT}, Прикрепить файл(ы) к сообщению - {=Variable:REPORT_FILES}.
Исправление некорректного заголовка при публикации	Параметры: ID поста для обновления - {=Variable:POST_ID}, Заголовок сообщения - {=Variable:CORRECTED_TITLE}. Обновляется только заголовок.

Получить посты из живой ленты

Данное активити (робот) позволяет получить список пользователей, которые видят важное сообщение в живой ленте.
Результатом работы является получение массива ID пользователей, имеющих доступ к просмотру указанного важного поста.

Название поля	Описание и примеры использования
ID поста	В данном поле указывается числовой идентификатор поста, являющегося важным сообщением в живой ленте. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Что такое важное сообщение: Важное сообщение - это пост в живой ленте, у которого установлен флаг "Важное сообщение" и, возможно, указана дата окончания важности. Такие сообщения выделяются особым образом в интерфейсе Битрикс24 и отображаются в верхней части ленты. Данное активити возвращает список пользователей, которые: - Имеют права на просмотр этого сообщения; - Входят в список получателей (напрямую или через группы/отделы); - Видят это сообщение как важное в своей ленте. Как получить ID важного поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" с фильтрацией; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста с параметром "Важное сообщение = Y"; - Из возвращаемых параметров роботов, срабатывающих при создании важных постов.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Анализ охвата важных объявлений и информационных сообщений	Параметры: ID поста - {=Variable:IMPORTANT_POST_ID}. Результат: Массив результатов (массив ID пользователей), Количество результатов для анализа охвата.
Отслеживание, кто видит критически важную информацию	Параметры: ID поста - {=Variable:CRITICAL_POST_ID}. Результат: Массив результатов для проверки того, кто имеет доступ к критической информации.
Автоматическая отправка дополнительных уведомлений пользователям из списка	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и отправки персональных уведомлений каждому пользователю.
Создание отчётов о распространении важной информации	Параметры: ID поста - {=Variable:INFO_POST_ID}. Результат: Количество результатов, Результаты через запятую для формирования отчёта о количестве информированных сотрудников.
Формирование списков для последующей рассылки или создания задач	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в активити создания задач или рассылки сообщений.
Проверка корректности настройки получателей важного сообщения	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов, Соответствует условиям (Y/N) для проверки наличия получателей.
Интеграция с системами аналитики для отслеживания информированности сотрудников	Параметры: ID поста - {=Variable:ANALYTICS_POST_ID}. Результат: Результаты через запятую для передачи данных в системы аналитики.
Автоматическое создание задач для каждого пользователя из списка получателей	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и создания задачи каждому получателю.
При публикации важного объявления о корпоративных изменениях - формирование списка для HR-отдела	Параметры: ID поста - {=Variable:HR_POST_ID}. Результат: Массив результатов, Количество результатов для передачи HR-отделу списка информированных сотрудников.
Контроль доступа пользователей к важной информации о проекте	Параметры: ID поста - {=Variable:PROJECT_POST_ID}. Результат: Первый результат, Последний результат, Количество результатов для контроля доступа.

Активити "Получить пользователей важного сообщения" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Анализ охвата важных объявлений и информационных сообщений;
• Отслеживание, кто видит критически важную информацию;
• Автоматическая отправка дополнительных уведомлений пользователям из списка;
• Создание отчётов о распространении важной информации;
• Формирование списков для последующей рассылки или создания задач;
• Проверка корректности настройки получателей важного сообщения;
• Интеграция с системами аналитики для отслеживания информированности сотрудников;
• Автоматическое создание задач для каждого пользователя из списка получателей.

Удалить пост из живой ленты

Данное активити (робот) позволяет удалять сообщения из живой ленты.
Результатом работы является удаление указанного поста из живой ленты портала.

Название поля	Описание и примеры использования
ID пользователя, удаляющего сообщение	В данном поле указывается ID пользователя, от имени которого будет выполнено удаление поста. Можно указывать в форматах: {=User:ID}, [1] или [U1].
ID поста	В данном поле указывается числовой идентификатор сообщения, которое необходимо удалить. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Автоматическое удаление устаревших объявлений по истечении срока	Параметры: ID поста - {=Variable:OLD_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Используется в роботе с условием проверки даты окончания важности поста.
Удаление сообщений при изменении статуса сделки	Параметры: ID поста - {=Variable:RELATED_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Робот срабатывает при изменении статуса сделки и удаляет связанные сообщения.
Очистка ленты от тестовых сообщений	Параметры: ID поста - {=Variable:TEST_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Используется для массового удаления тестовых сообщений после завершения тестирования.
Удаление сообщений при выполнении определённых условий в бизнес-процессе	Параметры: ID поста - {=Variable:POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Условное удаление постов в зависимости от логики бизнес-процесса.
Автоматическое удаление временных уведомлений через определенный период	Параметры: ID поста - {=Variable:TEMP_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. Робот, срабатывающий по расписанию для удаления временных сообщений старше заданной даты.
Удаление дублирующихся сообщений при создании новой версии поста	Параметры: ID поста - {=Variable:DUPLICATE_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. При создании обновленной версии поста предыдущая версия удаляется автоматически.
Удаление сообщений с ошибками после их исправления	Параметры: ID поста - {=Variable:ERROR_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. После публикации исправленной версии сообщения, ошибочное сообщение удаляется.
Очистка постов при архивации проекта	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. При переводе проекта в архив все связанные посты удаляются для очистки ленты.
Удаление персональных сообщений при увольнении сотрудника	Параметры: ID поста - {=Variable:PERSONAL_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. При деактивации пользователя его персональные сообщения удаляются.
Удаление служебных сообщений после выполнения задачи	Параметры: ID поста - {=Variable:SERVICE_POST_ID}, ID пользователя, удаляющего сообщение - {=User:ID}. После завершения задачи служебные посты автоматически удаляются.

Активити "Удалить пост из живой ленты" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое удаление устаревших объявлений по истечении срока;
• Удаление сообщений при изменении статуса сделки или другой сущности;
• Очистка ленты от тестовых сообщений;
• Удаление сообщений при выполнении определённых условий в бизнес-процессе.

Расшарить пост в живой ленте

Данное активити (робот) позволяет расшарить (поделиться) пост в живой ленте, добавляя новых адресатов к существующему сообщению.
Результатом работы является расширение списка получателей поста без изменения его содержимого.

Название поля	Описание и примеры использования
ID поста для расшаривания	В данном поле указывается числовой идентификатор поста, который необходимо расшарить. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Как получить ID поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" для поиска нужного сообщения; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста (возвращает ID созданного поста); - Из возвращаемых параметров роботов, срабатывающих при создании постов.
ID пользователя, добавляющего адресатов	В данном поле можно указать ID пользователя, от имени которого будет выполнено расшаривание поста. Это необязательный параметр. Если не указан, действие выполняется от имени текущего пользователя. Можно указывать в форматах: {=User:ID}, [1] или [U1].
Новые получатели сообщения (сотрудники)	Данное поле позволяет выбрать новых получателей сообщения из числа сотрудников, указав их ID, либо передав в поле массив с ID пользователей. Это необязательный параметр, но должен быть указан хотя бы один тип получателей (сотрудники или группы). Форматы указания сотрудников: - [1] - пользователь с ID=1; - [U1] - пользователь с ID=1 (альтернативный формат); - Можно передать массив: [1, 5, 10] - несколько пользователей. Пример: {=Variable:NEW_USERS} или [U1, U5, U10].
Новые получатели сообщения (группы)	Данное поле позволяет указать ID групп, проектов или отделов (можно указать несколько), тогда все сотрудники вышеперечисленных структур получат доступ к сообщению в разделе "Лента". Это необязательный параметр, но должен быть указан хотя бы один тип получателей (сотрудники или группы). Категории получателей (группы и структуры): [SG2] - Группа социальной сети с ID = 2 (рабочая группа/проект); [DR3] - Department Recursive - сотрудники отдела с ID = 3 и его подотделов; [U2] - Конкретный пользователь с ID = 2; [UA] - Все авторизованные пользователи портала; [SG3_A] - Администратор (владелец) группы соцсети с ID = 3; [SG3_E] - Модераторы группы соцсети с ID = 3; [SG3_K] - Все члены группы соцсети с ID = 3. Примеры: - [SG5] - расшарить для группы с ID=5; - [DR2] - расшарить для отдела с ID=2 и всех его подотделов; - [UA] - расшарить для всех авторизованных пользователей; - [SG10_K] - расшарить для всех членов группы с ID=10.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Постепенное расширение аудитории важных объявлений по мере развития проекта	Параметры: ID поста для расшаривания - {=Variable:PROJECT_POST_ID}, Новые получатели сообщения (группы) - [DR5] (отдел), ID пользователя, добавляющего адресатов - {=User:ID}. По мере готовности проекта аудитория расширяется поэтапно.
Автоматическое добавление новых сотрудников к существующим информационным постам	Параметры: ID поста для расшаривания - {=Variable:INFO_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:NEW_EMPLOYEES}, ID пользователя, добавляющего адресатов - {=User:ID}. При приёме нового сотрудника он автоматически получает доступ к важным постам.
Расшаривание отчётов и результатов работы дополнительным заинтересованным лицам	Параметры: ID поста для расшаривания - {=Variable:REPORT_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:STAKEHOLDERS}, ID пользователя, добавляющего адресатов - {=User:ID}. После публикации отчёта он расшаривается дополнительным лицам.
Добавление к обсуждению новых участников при изменении статуса задачи или сделки	Параметры: ID поста для расшаривания - {=Variable:DISCUSSION_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:NEW_PARTICIPANTS}, ID пользователя, добавляющего адресатов - {=User:ID}. При изменении статуса сделки к обсуждению добавляются новые участники.
Автоматическое расширение видимости поста при достижении определённых условий	Параметры: ID поста для расшаривания - {=Variable:POST_ID}, Новые получатели сообщения (группы) - [SG15] (группа проекта), ID пользователя, добавляющего адресатов - {=User:ID}. При достижении 50% готовности пост расшаривается всей команде проекта.
Включение руководства в обсуждение при возникновении критических ситуаций	Параметры: ID поста для расшаривания - {=Variable:CRITICAL_POST_ID}, Новые получатели сообщения (сотрудники) - [U100] (руководитель), ID пользователя, добавляющего адресатов - {=User:ID}. При критической ситуации руководитель автоматически подключается к обсуждению.
Добавление внешних пользователей (extranet) к проектным обсуждениям	Параметры: ID поста для расшаривания - {=Variable:PROJECT_POST_ID}, Новые получатели сообщения (сотрудники) - {=Variable:EXTRANET_USERS}, ID пользователя, добавляющего адресатов - {=User:ID}. Внешние пользователи добавляются к обсуждению проекта.
Расшаривание постов в новые отделы при реорганизации структуры компании	Параметры: ID поста для расшаривания - {=Variable:POST_ID}, Новые получатели сообщения (группы) - [DR8] (новый отдел), ID пользователя, добавляющего адресатов - {=User:ID}. При реорганизации посты расшариваются новым отделам.
Эскалация проблем - постепенное подключение специалистов при нерешенной проблеме	Параметры: ID поста для расшаривания - {=Variable:ISSUE_POST_ID}, Новые получатели сообщения (сотрудники) - [U5] (технический директор), ID пользователя, добавляющего адресатов - {=User:ID}. Если проблема не решена за 4 часа, подключается технический директор.
Постепенное информирование: от руководства к исполнителям	Параметры: ID поста для расшаривания - {=Variable:POST_ID}, Новые получатели сообщения (группы) - [SG10_K] (все члены группы), ID пользователя, добавляющего адресатов - {=User:ID}. Сначала пост для руководителей, затем для всей группы исполнителей.

Активити "Расшарить пост в живой ленте" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Постепенное расширение аудитории важных объявлений по мере развития проекта;
• Автоматическое добавление новых сотрудников к существующим информационным постам;
• Расшаривание отчётов и результатов работы дополнительным заинтересованным лицам;
• Добавление к обсуждению новых участников при изменении статуса задачи или сделки;
• Автоматическое расширение видимости поста при достижении определённых условий;
• Включение руководства в обсуждение при возникновении критических ситуаций;
• Добавление внешних пользователей (extranet) к проектным обсуждениям;
• Расшаривание постов в новые отделы при реорганизации структуры компании.

Добавить комментарий к посту

Данное активити (робот) позволяет добавлять комментарии к постам в живой ленте.
Результатом работы является создание комментария к указанному посту с возможностью прикрепления файлов.

Название поля	Описание и примеры использования
ID автора комментария	В данном поле можно указать ID пользователя, который будет автором комментария. Это необязательный параметр. Если не указан, автором станет текущий пользователь. Пример: {=User:ID} или [U1].
ID поста	В данном поле указывается числовой идентификатор поста, к которому необходимо добавить комментарий. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Как получить ID поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" для поиска нужного сообщения; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста (возвращает ID созданного поста); - Из возвращаемых параметров роботов, срабатывающих при создании постов.
Текст комментария	В данном поле указывается текст комментария, который будет добавлен к посту. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:COMMENT_TEXT}.
Прикрепить файл(ы) к комментарию (ID файлов с диска)	В данном поле указывается массив ID файлов, расположенных на диске Битрикс24, которые должны быть прикреплены к комментарию. Это необязательный параметр. Можно прикрепить до 20 файлов за один раз. Пример: {=Variable:FILE_IDS}. Как получить ID файла с диска: - Использовать активити для работы с диском (например, "Загрузить файл на диск"); - Взять из результатов других активити, работающих с файлами; - Использовать в цепочке с активити загрузки файлов; - Найти ID файла в URL при просмотре файла на диске. Файлы скачиваются с диска, кодируются в base64 и прикрепляются к комментарию.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Автоматическое комментирование постов при изменении статуса сделки	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Статус сделки изменен на: {=Document:STAGE_ID}. Ответственный: {=Document:ASSIGNED_BY_PRINTABLE}", ID автора комментария - {=User:ID}.
Добавление уведомлений о выполнении определённых действий в виде комментариев	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Задача '{=Document:TITLE}' выполнена. Результат: {=Variable:RESULT}", ID автора комментария - {=User:ID}.
Фиксация результатов работы роботов непосредственно в обсуждении поста	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Робот завершил обработку. Обработано записей: {=Variable:PROCESSED_COUNT}", Прикрепить файл(ы) - {=Variable:REPORT_FILE_ID}, ID автора комментария - {=User:ID}.
Создание отчётов и информирование команды о статусе процессов	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Ежедневный отчёт за {{=date('d.m.Y')}}: Выполнено задач: {=Variable:COMPLETED}, В работе: {=Variable:IN_PROGRESS}", Прикрепить файл(ы) - {=Variable:REPORT_FILES}, ID автора комментария - {=User:ID}.
Автоматизация общения в проектных группах при наступлении определённых событий	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, Текст комментария - "Событие: {=Variable:EVENT_NAME}. Участники: {=Variable:PARTICIPANTS}", ID автора комментария - {=User:ID}.
Прикрепление сгенерированных документов или отчётов к обсуждению в виде комментариев	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Сгенерирован документ: {=Variable:DOCUMENT_NAME}", Прикрепить файл(ы) - {=Variable:GENERATED_DOCUMENT_ID}, ID автора комментария - {=User:ID}.
Создание цепочки взаимосвязанных комментариев при многоступенчатых процессах	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Этап {=Variable:STAGE_NUMBER}: {=Variable:STAGE_STATUS}. Следующий шаг: {=Variable:NEXT_STEP}", ID автора комментария - {=User:ID}.
Комментирование с техническим заданием при создании проекта	Параметры: ID поста - {=Variable:PROJECT_POST_ID}, Текст комментария - "Техническое задание проекта '{=Document:TITLE}': {=Variable:TASK_DESCRIPTION}", Прикрепить файл(ы) - {=Variable:TASK_FILE_ID}, ID автора комментария - {=User:ID}.
Добавление комментария с напоминанием о дедлайнах	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Напоминание: дедлайн задачи '{=Document:TITLE}' наступит {{=dateadd({=Document:DEADLINE}, '-1d')}}. Ответственный: {=Document:RESPONSIBLE_BY_PRINTABLE}", ID автора комментария - {=User:ID}.
Информирование о результатах автоматической обработки данных	Параметры: ID поста - {=Variable:POST_ID}, Текст комментария - "Обработка завершена. Обработано: {=Variable:PROCESSED}, Ошибок: {=Variable:ERRORS}. Лог прикреплен.", Прикрепить файл(ы) - {=Variable:LOG_FILE_ID}, ID автора комментария - {=User:ID}.

Активити "Добавить комментарий к посту" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое комментирование постов при изменении статуса сделки или задачи;
• Добавление уведомлений о выполнении определённых действий в виде комментариев;
• Фиксация результатов работы роботов непосредственно в обсуждении поста;
• Создание отчётов и информирование команды о статусе процессов;
• Автоматизация общения в проектных группах при наступлении определённых событий;
• Прикрепление сгенерированных документов или отчётов к обсуждению в виде комментариев;
• Создание цепочки взаимосвязанных комментариев при многоступенчатых процессах.

Получить пользователей важного сообщения

Данное активити (робот) позволяет получить список пользователей, которые видят важное сообщение в живой ленте.
Результатом работы является получение массива ID пользователей, имеющих доступ к просмотру указанного важного поста.

Название поля	Описание и примеры использования
ID поста	В данном поле указывается числовой идентификатор поста, являющегося важным сообщением в живой ленте. Это обязательный параметр. Пример: {=Variable:POST_ID} или 12345. Что такое важное сообщение: Важное сообщение - это пост в живой ленте, у которого установлен флаг "Важное сообщение" и, возможно, указана дата окончания важности. Такие сообщения выделяются особым образом в интерфейсе Битрикс24 и отображаются в верхней части ленты. Данное активити возвращает список пользователей, которые: - Имеют права на просмотр этого сообщения; - Входят в список получателей (напрямую или через группы/отделы); - Видят это сообщение как важное в своей ленте. Как получить ID важного поста: ID поста можно получить несколькими способами: - Использовать активити "Получить посты из живой ленты" с фильтрацией; - Взять из URL при просмотре поста в браузере; - Использовать в цепочке с активити добавления поста с параметром "Важное сообщение = Y"; - Из возвращаемых параметров роботов, срабатывающих при создании важных постов.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Описание примера	Решение
Анализ охвата важных объявлений и информационных сообщений	Параметры: ID поста - {=Variable:IMPORTANT_POST_ID}. Результат: Массив результатов (массив ID пользователей), Количество результатов для анализа охвата.
Отслеживание, кто видит критически важную информацию	Параметры: ID поста - {=Variable:CRITICAL_POST_ID}. Результат: Массив результатов для проверки того, кто имеет доступ к критической информации.
Автоматическая отправка дополнительных уведомлений пользователям из списка	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и отправки персональных уведомлений каждому пользователю.
Создание отчётов о распространении важной информации	Параметры: ID поста - {=Variable:INFO_POST_ID}. Результат: Количество результатов, Результаты через запятую для формирования отчёта о количестве информированных сотрудников.
Формирование списков для последующей рассылки или создания задач	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в активити создания задач или рассылки сообщений.
Проверка корректности настройки получателей важного сообщения	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов, Соответствует условиям (Y/N) для проверки наличия получателей.
Интеграция с системами аналитики для отслеживания информированности сотрудников	Параметры: ID поста - {=Variable:ANALYTICS_POST_ID}. Результат: Результаты через запятую для передачи данных в системы аналитики.
Автоматическое создание задач для каждого пользователя из списка получателей	Параметры: ID поста - {=Variable:POST_ID}. Результат: Массив результатов для использования в итераторе и создания задачи каждому получателю.
При публикации важного объявления о корпоративных изменениях - формирование списка для HR-отдела	Параметры: ID поста - {=Variable:HR_POST_ID}. Результат: Массив результатов, Количество результатов для передачи HR-отделу списка информированных сотрудников.
Контроль доступа пользователей к важной информации о проекте	Параметры: ID поста - {=Variable:PROJECT_POST_ID}. Результат: Первый результат, Последний результат, Количество результатов для контроля доступа.

Активити "Получить пользователей важного сообщения" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Анализ охвата важных объявлений и информационных сообщений;
• Отслеживание, кто видит критически важную информацию;
• Автоматическая отправка дополнительных уведомлений пользователям из списка;
• Создание отчётов о распространении важной информации;
• Формирование списков для последующей рассылки или создания задач;
• Проверка корректности настройки получателей важного сообщения;
• Интеграция с системами аналитики для отслеживания информированности сотрудников;
• Автоматическое создание задач для каждого пользователя из списка получателей.

Дата, время и календарь

Удаление события календаря

Данное активити позволяет удалить событие в календаре, ID которого вы укажите в настройках.

Сценарий работы активити бизнес-процесса

Тип календаря: в данном поле можно выбрать из выпадающего списка тип календаря:пользовательский/для групп.

Идентификатор владельца календаря: в данном поле указывается ID владельца календаря.

Идентификатор события: в данном поле указывается ID события, которое планируется изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Изменение события календаря

Данное активити позволяет изменять события календаря, ID которого вы укажите в настройках.

Название	Описание
ID события:	В данном поле указывается ID события, которое планируется изменить.
Тип календаря:	В данном поле можно выбрать из выпадающего списка тип календаря:пользовательский/для групп.
Идентификатор владельца календаря:	В данном поле указывается ID владельца календаря.
Дата начала события:	В данном поле указывается дата начала изменяемого события
Дата завершения события:	В данном поле указывается дата завершения изменяемого события
Идентификатор календаря:	В данном поле указывается ID календаря, который планируется изменить.

Название	Описание
Наименование события:	В данном поле указывается наименование изменяемого события.
Описание события:	В данном поле указывается описание изменяемого события.
Цвет фона события:	В данном поле указывается цвет фона изменяемого события в формате HTML.
Цвет текста события:	В данном поле указывается цвет текста изменяемого события в формате HTML.
Доступность на время события:	В данном поле указывается доступность на время события участника этого события.
Важность события:	В данном поле указывается важность изменяемого события.
Место проведения:	В данном поле указывается место проведения изменяемого события.
НАПОМИНАНИЕ (за сколько):	В данном поле указывается напоминание (за сколько) для изменяемого события.
НАПОМИНАНИЕ (единица измерения):	В данном поле указывается напоминание (единица измерения) для изменяемого события .

Список участников события: в поле указываются участники создаваемого события.
Поле является множественным.
Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].

Название	Описание
Организатор события:	В данном поле указывается организатор события, указывается его ID или данный пользователь выбирается из списка пользователей портала.
Создать встречу:	Варианты: да/нет. Позволяет параллельно измененному событию создать встречу.
ВСТРЕЧА: Текст приглашения:	В данном поле указывается текст приглашения для встречи.
ВСТРЕЧА: признак открытой встречи:	В данном поле указывается, будет - ли открыта встреча или нет.
ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников:	В данном поле указывается наличие флага оповещения об отказе или согласии участников, приглашенных на встречу.
ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события):	В данном поле указывается флаг для повторного подтверждения об повторном подтверждении участия в событии.
Делать отладочные сообщения в журнал БП:	В данном поле указывается, будет ли сделано отладочное сообщение в журнале БП или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Добавить событие календаря

Данное активити позволяет добавлять события в календарь, ID которого вы укажите в настройках.

Тип календаря: в данном поле нужно выбрать тип календаря. Это может быть календарь сотрудника (user), календарь группы (group) либо календарь Компании (company).

Идентификатор владельца календаря: в данном поле следует указывать id сотрудника, либо id группы (ID группы указывается именно цифрой и никак иначе).
Значение указывается простой цифрой (без квадратных скобок). 

Дата начала события: в данном поле требуется указать, когда начнётся планируемое событие.

Дата завершения события: в данном поле требуется указать, когда завершится планируемое событие.

Идентификатор календаря: в данном поле требуется указать id календаря пользователя, группы, компании или переговорной комнаты.

Чтобы понять, какое значение сюда требуется прописать, необходимо:

1. Для календаря пользователя (или Компании).
Перейдите в список календарей и нажмите "Настройки"

Далее необходимо нажать F12 в браузере и навести курсор на список календарей выбора по умолчанию для приглашений.

2. Для календаря группы.
Перейдите в календарь группы и нажмите F12.
Нажмите на инструмент выбора блока и наведите на календарь.

В классе bxec-sect: содержится id календаря.

Значение даты передается без времени: эта опция позволит устанавливать даты события без указания времени.

Наименование события: в данном поле вы указываете тему создаваемого события.

Описание события: в данном поле вы указываете текстовое описание создаваемого события.

Цвет фона события: в данном поле вы указываете цвет создаваемого события в календаре. Применяется код цвета HTML.

Доступность на время события: в данном поле вы определяете отметку занятости, которая будет отображаться в планировщике событий.

Важность события: в данном поле вы можете выбрать категорию важности создаваемого события в календаре.

Частное событие: при указании значения "да" в данном поле, Вы ограничиваете видимость содержания создаваемого события. В календаре будет отображаться что событие есть, но прочесть другим сотрудникам его не получится.

Место проведения: в данном поле вы можете указать место проведения создаваемого события.
Данные заполняются текстом.

НАПОМИНАНИЕ (за сколько): в данном поле вы можете указать, что система должна Вас уведомить за какое-то время. Значение указывается в целых числах.

НАПОМИНАНИЕ (единица измерения): в данном поле вы можете указать, в каких единицах измерения вести отсчет времени до напоминания (дни, часы, минуты)

Список участников события: в данном поле указываются участники создаваемого события. Поле является множественным. Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].

Организатор события: в данном поле указывается организатор создаваемого события.  Значение указывается простой цифрой (без квадратных скобок). Это поле важно заполнять, когда это событие календаря типа встреча и в него будут приглашаться другие участники.
Создать встречу: данное поле позволяет создавать событие тип встреча, на которую приглашаются участники.

ВСТРЕЧА: Текст приглашения - в данном поле указывается описание для события типа встреча.

ВСТРЕЧА: признак открытой встречи - в данном поле указывается тип события. Встреча может быть общедоступная или закрытая.

ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников - данная опция позволит (с помощью системного механизма Битрикс24) отправить оповещение о событии.

ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события) - в данной опции (с помощью системного механизма Битрикс24) указывается необходимость повторно уведомлять участников события если в него будут вноситься изменения.

Привязать к сущности CRM: параметр позволяет осуществить привязку события к сущности CRM, которую вы указали в поле.
Поддерживаются следующие типы сущностей:

• Лид (L);
• Сделка (D);
• Контакт (C);
• Компания (CO);
• Счёт (SI);
• Предложение (Q);
• Смарт-процесс (Txx_YY)

Пример заполнения поля: 

• Лид - L_1234
• Сделка - D_1234
• Контакт - С_1234
• Компания - CO_1234
• Счет - SI_1234
• Предложение - Q_1234
• Смарт-процесс - T87_53 , где 53, это ID смарт-процесса, а T87 - код смарт-процесса

Коды смарт-процессов - поле позволяет посмотреть уникальный код для каждого СП в системе.
Каждый код уникален и на разных порталах эти коды будут разные.
Коды отображаются в формате: Название СП - код СП
Пример: Расчет и смета - T87

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Получить список календарей

Данное активити позволяет получить идентификаторы календарей Пользователя, Групп, Компании и Переговорных комнат.


Тип календаря: позволяет выбрать из списка тип календаря, ID которого необходимо получить.
Доступны следующие варианты календарей:

• Календарь пользователя;
• Календарь группы;
• Календарь компании;
• Календарь переговорной комнаты.

Идентификатор владельца календаря: в этом поле нужно указать ID владельца календаря.
Ограничить количество результатов до: позволяет указать количество выводимых результатов до указанного значения.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Ближайший день недели

Данное активити позволяет задавать повторение какого-либо процесса заранее заданный промежуток дня/времени с помощью возврата параметра день недели/время либо другого указанного параметра. 
Т.е если сегодня четверг 21.02, то выставив в параметре "День недели (условие)": 6 , мы получим 6й день недели относительно текущей недели, т.е субботу 23.02. Однако если выставить в четверг 21.02 , значение параметра "День недели (условие)" 2, то мы получим вторник 26.02,т.е дату, расположенную на следующей неделе.

День недели (условие):   1: понедельник, 2: вторник, 3: среда, 4: четверг, 5: пятница, 6: суббота, 7: воскресенье.

Дата для расчета: в этом поле указывается дата для расчета ближайшего дня недели. Дата указывается в формате ДД.ММ.ГГГГ.
Если в сущности, в поле тип "дата и время" указано время, то в активити поле "Время" можно не заполнять.
Если в  сущности, в поле тип "дата и время" время не указано, т.е по умолчанию 00:00:00, то нужно заполнить поле "Время" в настройках активити, иначе вы получите результат (к примеру) 23,04,2021 00:00:00.

Время: Указывается время к которому будет возвращено ближайшее значение ближайшего дня недели, в формате ЧЧ:ММ.
Например: 11:00.
Если не корректно заполнить данное поле, то активити вернет в результатах не корректные данные.

Часовой пояс: указывается часовой пояс, используемый в пункте "Время", в формате "+3".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.           

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Ближайший день месяца

Данное активити позволяет задавать повторение какого-либо процесса в определенный промежуток дня/времени с помощью возврата параметра день месяца/время либо другого указанного параметра. 

День месяца (условие): Позволяет выбрать из выпадающего списка нужный день месяца. Выбрав 1: первое число месяца, 15: пятнадцатое число месяца.

Время: Указывается время к которому будет возвращено ближайшее значение ближайшего дня месяца, в формате ЧЧ:ММ.
Например: 11:00.
Если не корректно заполнить данное поле, то активити вернет в результатах не корректные данные.

Часовой пояс: указывается часовой пояс, используемый в пункте "Время", в формате "+3"

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Дела

Системные дела

Добавление привязки к CRM сущности

Позволяет добавить привязку к сущностям CRM

Сценарий работы активити бизнес-процесса

Идентификатор дела: в данном поле нужно указать ID дела, которое будет привязано к сущности CRM.

Идентификатор типа CRM сущности: в этом поле нужно выбрать из выпадающего списка тип сущности, к которой будет осуществлена привязка. Этот список содержит список сущностей, к которым дело всегда имеет привязку. Для привязки дела к некоторым дополнительным типам сущностей, необходимо иметь привязку к основным. 

Идентификатор CRM сущности: в данном поле указывается ID CRM сущности к которой будет привязано дело.

Идентификатор типа CRM сущности 2: это поле, в отличии от поля "Идентификатор типа CRM сущности" имеет меньше вариантов в выпадающем списке в виду того, что в данном поле выбирается дополнительная сущность для привязки, т.е оно не обязательно к заполнению.

Идентификатор CRM сущности 2: в этом поле указывается ID второй CRM сущности, к которой дело будет привязано.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Создание своего дела в CRM

Активити (робот) "Создание своего дела в CRM" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое создание дел при изменении статуса сделки или лида;
• Создание напоминаний и задач для ответственных сотрудников;
• Автоматизация планирования дел на основе данных из других сущностей CRM;
• Создание дел при поступлении заявок или обращений клиентов;
• Планирование дел с привязкой к сделкам, контактам, компаниям или смарт-процессам;
• Автоматическое создание дел для контроля выполнения обязательств;
• Создание дел для напоминаний о важных событиях и дедлайнах;
• Автоматизация создания дел при интеграции с внешними системами;
• Создание дел для отслеживания этапов работы с клиентами;
• Планирование регулярных дел и напоминаний.

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязано создаваемое дело. Это обязательный параметр. Варианты выбора: - 1 - Лид (CRM_LEAD); - 2 - Сделка (CRM_DEAL); - 3 - Контакт (CRM_CONTACT); - 4 - Компания (CRM_COMPANY); - Смарт-процессы - для привязки к смарт-процессам (требует указания конкретного смарт-процесса в поле "Смарт-процессы"). Примеры использования: - Для создания дела, привязанного к сделке, выберите значение "2"; - Для создания дела, привязанного к лиду, выберите значение "1"; - При выборе "Смарт-процессы" необходимо дополнительно указать конкретный смарт-процесс в поле "Смарт-процессы".
Смарт-процессы	В данном поле указывается конкретный смарт-процесс, к которому будет привязано дело. Это необязательный параметр, который используется только при выборе типа сущности "Смарт-процессы". Важно: Это поле активно только при выборе типа сущности "Смарт-процессы". Для обычных CRM-сущностей (лид, сделка, контакт, компания) это поле не используется. Примеры: - Выберите нужный смарт-процесс из выпадающего списка (список формируется автоматически на основе настроек вашего портала); - Список доступных смарт-процессов загружается автоматически при установке активити (робота).
ID Сущности	В данном поле указывается числовой идентификатор (ID) сущности, к которой будет привязано создаваемое дело. Это обязательный параметр. Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
Заголовок дела	В данном поле указывается текстовый заголовок создаваемого дела. Это обязательный параметр. Примеры: - Позвонить клиенту; - Подготовить коммерческое предложение для сделки #{=Document:ID}; - Встреча с {=Document:COMPANY_TITLE} - {=Variable:MEETING_DATE}; - Напоминание: оплата по сделке {=Document:TITLE}; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к заголовку из переменной. Рекомендации: - Используйте информативные заголовки, которые помогут быстро понять суть дела; - Можно включать переменные и поля из текущей сущности для персонализации; - Максимальная длина заголовка ограничена настройками CRM вашего портала.
Содержание дела	В данном поле указывается содержание и описание создаваемого дела. Это обязательный параметр. Поддерживается форматирование BB-код. Примеры: - Необходимо связаться с клиентом для уточнения деталей сделки; - [b]Важно:[/b] Проверить документы по сделке #{=Document:ID}. Сумма: {=Document:OPPORTUNITY} руб.; - Подготовить договор для компании {=Document:COMPANY_TITLE}. Контактное лицо: {=Document:CONTACT_NAME}; - ={{={=Variable:DESCRIPTION} & "[br]Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных с форматированием; - [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Ссылка на сделку[/url] - добавить ссылку на сущность. Форматирование BB-код: - [b]жирный текст[/b] - жирное начертание; - [i]курсив[/i] - курсивное начертание; - [u]подчёркнутый[/u] - подчёркнутый текст; - [br] - перенос строки; - [url=ссылка]текст[/url] - ссылка. Важно: Если поле "Содержание дела" пустое, активити (робот) завершится с ошибкой. Обязательно укажите описание дела.
Дата начала	В данном поле указывается дата и время начала выполнения дела. Это необязательный параметр. Если не указано, дата начала будет установлена автоматически. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "1d")}} - установить дату начала через 1 день от текущего момента; - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}} - установить дату начала через 2 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:BEGINDATE}, "1h")}} - установить дату начала через 1 час от даты начала сделки; - 15.01.2025 10:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта времени начала; - Учитывайте рабочие дни и часы при планировании дел; - Если дата начала не указана, система установит текущую дату и время.
Дата завершения	В данном поле указывается дата и время завершения выполнения дела. Это необязательный параметр. Если не указано, дата завершения не будет установлена. Примеры: - ={{=dateadd({=System:Now}, "3d")}} - установить дату завершения через 3 дня от текущего момента; - ={{=workdateadd({=System:Now}, "5d", {=Document:ASSIGNED_BY_ID})}} - установить дату завершения через 5 рабочих дней с учётом рабочего времени ответственного; - ={{=dateadd({=Variable:DATE_START}, "2h")}} - установить дату завершения через 2 часа от даты начала (из переменной); - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить дату завершения на 1 день раньше даты закрытия сделки; - 20.01.2025 18:00:00 - указать конкретную дату и время завершения. Рекомендации: - Дата завершения должна быть позже даты начала; - Используйте функции работы с датами для автоматического расчёта дедлайнов; - Учитывайте рабочие дни при планировании сроков выполнения дел.
Ответственный за дело	В данном поле указывается сотрудник, который должен выполнить дело и отчитаться о проделанной работе. Это обязательный параметр. Выбирается из выпадающего списка или указывается вручную. Форматы указания пользователя: - Числовой ID: 1, 25, 100; - Формат с префиксом: [U1], [U25]; - Формат user_ID: user_1, user_25; - Можно использовать переменные из предыдущих активити (роботов) или полей сущности. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственного из текущей сущности (сделки, лида и т.д.); - [U1] - назначить пользователя с ID 1; - user_25 - назначить пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота); - {=User:ID} - назначить текущего пользователя, запустившего бизнес-процесс. Как получить ID пользователя: - Из полей CRM-сущностей (ответственный, контакт и т.д.); - Из результатов активити (робота) поиска пользователей; - Использовать текущего пользователя через системные переменные ({=User:ID}); - Из справочника сотрудников портала.
Важное дело	В данном поле указывается статус, уведомляющий о том, что выполнение данного дела в приоритете. Это необязательный параметр (варианты: да/нет). Варианты выбора: - Да (Y) - дело помечается как важное (высокий приоритет); - Нет (N) - дело имеет обычный приоритет. Примеры использования: - Установите "Да" для дел, требующих срочного выполнения; - Используйте условие: если {=Document:OPPORTUNITY} > 1000000, то установить "Да"; - Важные дела отображаются с особым выделением в интерфейсе CRM и имеют приоритет в уведомлениях. Рекомендации: - Не помечайте все дела как важные, иначе теряется смысл приоритизации; - Используйте важные дела для критических задач и дедлайнов.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Создание дела для ответственного при изменении стадии сделки	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Заголовок дела - "Проверить документы по сделке #{=Document:ID}", Содержание дела - "Сделка переведена на стадию 'Выставлен счёт'. Необходимо проверить все документы. Сумма: {=Document:OPPORTUNITY} руб.", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "1d")}}, Важное дело - Да.
Создание напоминания о звонке клиенту через 2 рабочих дня	Параметры: Тип сущности - 3 (Контакт), ID Сущности - {=Document:ID}, Заголовок дела - "Позвонить клиенту {=Document:NAME}", Содержание дела - "Необходимо связаться с клиентом для уточнения деталей. Телефон: {=Document:PHONE}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "2d 2h", {=Document:ASSIGNED_BY_ID})}}, Важное дело - Нет.
Создание важного дела для подготовки коммерческого предложения	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Заголовок дела - "Подготовить КП для сделки {=Document:TITLE}", Содержание дела - "[b]Важно:[/b] Необходимо подготовить коммерческое предложение для компании {=Document:COMPANY_TITLE}. Сумма сделки: {=Document:OPPORTUNITY} руб. Срок: до {=Document:CLOSEDATE}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=Document:CLOSEDATE}, "-3d")}}, Важное дело - Да.
Создание дела для встречи с клиентом на основе данных из лида	Параметры: Тип сущности - 1 (Лид), ID Сущности - {=Document:ID}, Заголовок дела - "Встреча с клиентом {=Document:TITLE}", Содержание дела - "Запланирована встреча с клиентом. Компания: {=Document:COMPANY_TITLE}, Контакт: {=Document:NAME}, Телефон: {=Document:PHONE}. Адрес встречи: {=Variable:MEETING_ADDRESS}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=Variable:MEETING_DATE}, Дата завершения - ={{=dateadd({=Variable:MEETING_DATE}, "2h")}}, Важное дело - Да.
Автоматическое создание дела при поступлении заявки с сайта	Параметры: Тип сущности - 1 (Лид), ID Сущности - {=Document:ID}, Заголовок дела - "Обработка заявки #{=Document:ID}", Содержание дела - "Поступила новая заявка с сайта. Источник: {=Document:SOURCE_ID}. [url={=System:HostUrl}/crm/lead/details/{=Document:ID}/]Открыть лид[/url]", Ответственный за дело - {=Variable:MANAGER_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "4h")}}, Важное дело - Да.
Создание дела для контроля оплаты по сделке	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Заголовок дела - "Контроль оплаты по сделке {=Document:TITLE}", Содержание дела - "Необходимо проверить оплату по сделке. Сумма: {=Document:OPPORTUNITY} руб. Компания: {=Document:COMPANY_TITLE}. Дата закрытия: {=Document:CLOSEDATE}", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - ={{=dateadd({=Document:CLOSEDATE}, "1d")}}, Дата завершения - ={{=dateadd({=Document:CLOSEDATE}, "2d")}}, Важное дело - Да.
Создание дела для подготовки отчёта по компании	Параметры: Тип сущности - 4 (Компания), ID Сущности - {=Document:ID}, Заголовок дела - "Подготовить отчёт по компании {=Document:TITLE}", Содержание дела - "Требуется подготовить отчёт по работе с компанией. Количество сделок: {=Variable:DEALS_COUNT}, Общая сумма: {=Variable:TOTAL_AMOUNT} руб.", Ответственный за дело - {=Variable:REPORT_MANAGER_ID}, Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "3d")}}, Важное дело - Нет.
Создание дела для напоминания о дедлайне задачи	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Variable:DEAL_ID}, Заголовок дела - "Напоминание: дедлайн задачи", Содержание дела - "До дедлайна задачи '{=Variable:TASK_TITLE}' осталось менее 24 часов. Ответственный: {=Variable:TASK_RESPONSIBLE}", Ответственный за дело - {=Variable:TASK_RESPONSIBLE}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=Variable:TASK_DEADLINE}, "-1d")}}, Важное дело - Да.
Создание дела для смарт-процесса при изменении статуса	Параметры: Тип сущности - Смарт-процессы, Смарт-процессы - {=Variable:SMART_TYPE}, ID Сущности - {=Document:ID}, Заголовок дела - "Обработка элемента смарт-процесса", Содержание дела - "Элемент смарт-процесса переведён в новый статус. Требуется обработка. [url={=System:HostUrl}/crm/configs/bp/CRM_DYNAMIC_{=Variable:SMART_TYPE}/{=Document:ID}/]Открыть элемент[/url]", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "1d")}}, Важное дело - Нет.
Массовое создание дел для всех найденных сделок через итератор	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Iterator:Value}, Заголовок дела - "Контроль сделки #{=Iterator:Value}", Содержание дела - "Создано дело для контроля сделки. Необходимо проверить статус и связаться с клиентом.", Ответственный за дело - {=Document:ASSIGNED_BY_ID}, Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "7d")}}, Важное дело - Нет.

Удаление дела

Активити (робот) "Удаление дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Удаление дел по их ID;
• Удаление дел по типу сущности и ID сущности;
• Удаление дел по типу провайдера (звонок, письмо, встреча и т.д.);
• Удаление дел по ответственному за дело;
• Массовое удаление дел, соответствующих определённым критериям;
• Очистка старых или неактуальных дел;
• Удаление дел после выполнения определённых условий в бизнес-процессе;
• Автоматическое удаление дел при изменении статуса сделки или лида;
• Удаление дел при интеграции с внешними системами;
• Очистка дел для оптимизации работы с CRM.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела или несколько идентификаторов дел, которые нужно удалить. Это необязательный параметр, поддерживается множественный выбор. Если указан, то все остальные параметры игнорируются (приоритет у ID дела). Примеры: - {=Variable:ACTIVITY_ID} - удалить дело с ID из переменной предыдущего активити (робота); - 123 - удалить дело с ID 123; - {=A1988_22222_92566_99999:search_results_array} - использовать массив ID дел из результата активити (робота) "Поиск дел"; - {=Iterator:Value} - удалить дело для каждого ID из итератора; - 123, 456, 789 - удалить несколько дел с указанными ID (множественный выбор). Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если указан параметр "ID дела", то все остальные параметры (Тип сущности, ID сущности, Тип дела, Ответственный за дело) игнорируются. Активити (робот) будет удалять только указанные дела.
Ответственный за дело	В данном поле указывается сотрудник, дела которого нужно удалить. Это необязательный параметр, используется как дополнительный фильтр при удалении дел по типу сущности и ID сущности. Если указан, то будут удалены только дела указанного ответственного. Примеры: - {=Document:ASSIGNED_BY_ID} - удалить дела ответственного из текущей сущности; - {=User:ID} - удалить дела текущего пользователя; - [U1] - удалить дела пользователя с ID 1; - user_25 - удалить дела пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации дел по ответственному при удалении по типу сущности; - Для удаления всех дел конкретного сотрудника, связанных с определённой сущностью; - Для очистки дел при смене ответственного. Важно: Этот параметр работает только если не указан параметр "ID дела". Если указан "ID дела", этот параметр игнорируется. Для задач (OWNER_TYPE_ID = 3) фильтр по ответственному не применяется.
Тип сущности	В данном поле указывается тип сущности CRM, дела которой нужно удалить. Это необязательный параметр, используется только если не указан "ID дела". Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для удаления дел, привязанных к лидам; - Сделка (D) - для удаления дел, привязанных к сделкам; - Контакт (C) - для удаления дел, привязанных к контактам; - Компания (CO) - для удаления дел, привязанных к компаниям; - Предложение (Q) - для удаления дел, привязанных к предложениям; - Заказ (O) - для удаления дел, привязанных к заказам; - Счёт (SI) - для удаления дел, привязанных к счетам; - СМАРТ: [название смарт-процесса] - для удаления дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - удалить все дела, привязанные к сделкам; - Контакт (C) - удалить все дела, привязанные к контактам; - СМАРТ: Заявки - удалить все дела, привязанные к смарт-процессу "Заявки". Когда использовать: - Для массового удаления дел по типу сущности; - Для очистки дел при удалении сущности; - Для фильтрации дел перед удалением по другим критериям.
ID сущности	В данном поле указывается идентификатор сущности CRM, дела которой нужно удалить. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID дела". Примеры: - {=Document:ID} - удалить дела текущей сущности из документа (сделка, лид, контакт, компания); - 123 - удалить дела сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для удаления всех дел конкретной сущности; - Для очистки дел при удалении или изменении сущности; - Для удаления дел при завершении работы с сущностью.
Тип дела (провайдера)	В данном поле указывается тип дела (провайдера), который нужно удалить. Это необязательный параметр, используется как дополнительный фильтр при удалении дел по типу сущности и ID сущности. Выбирается из выпадающего списка. Варианты выбора: - Универсальное (CRM_TODO) - универсальные дела; - Встреча (CRM_MEETING) - дела типа "Встреча"; - Звонок (VOXIMPLANT_CALL) - дела типа "Звонок"; - Письмо (CRM_EMAIL) - дела типа "Письмо"; - Задачи (TASKS) - задачи (старые дела для обратной совместимости); - Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации; - Чат (IMOPENLINES_SESSION) - дела типа "Чат"; - Обзвон (CALL_LIST) - дела типа "Обзвон"; - SMS (CRM_SMS) - дела типа "SMS"; - CRM форма (CRM_WEBFORM) - дела типа "CRM форма"; - Визит (VISIT_TRACKER) - дела типа "Визит"; - Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты"; - Доставка (CRM_DELIVERY) - дела типа "Доставка"; - Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания"; - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp"; - Оплата (CRM_PAYMENT) - дела типа "Оплата"; - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса"; - И другие типы дел. Примеры использования: - Звонок - удалить только дела типа "Звонок"; - Письмо - удалить только дела типа "Письмо"; - Встреча - удалить только дела типа "Встреча". Когда использовать: - Для фильтрации дел по типу при удалении по сущности; - Для удаления только определённого типа дел; - Для очистки дел конкретного типа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Удаление одного дела по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) удалит дело с указанным ID.
Массовое удаление дел из результата поиска	Параметры: ID дела - {=A1988_22222_92566_99999:search_results_array}, Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) удалит все дела из массива результатов поиска. Используйте итератор для обработки большого количества дел.
Удаление всех дел сделки	Параметры: ID дела - не указывается, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) найдёт и удалит все дела, привязанные к указанной сделке.
Удаление только звонков контакта	Параметры: ID дела - не указывается, Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Тип дела - Звонок (VOXIMPLANT_CALL), Ответственный за дело - не указывается. Активити (робот) найдёт и удалит только дела типа "Звонок", привязанные к указанному контакту.
Удаление дел ответственного по сделке	Параметры: ID дела - не указывается, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Тип дела - не указывается, Ответственный за дело - {=Document:ASSIGNED_BY_ID}. Активити (робот) найдёт и удалит все дела указанного ответственного, привязанные к сделке.
Удаление дел через итератор	Параметры: ID дела - {=Iterator:Value}, Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Для каждого ID дела из итератора активити (робот) удалит соответствующее дело. Полезно для массовой обработки.
Удаление нескольких конкретных дел	Параметры: ID дела - 123, 456, 789 (множественный выбор), Тип сущности - не указывается, ID сущности - не указывается, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) удалит все указанные дела за один запуск.
Удаление всех писем лида	Параметры: ID дела - не указывается, Тип сущности - Лид (L), ID сущности - {=Document:ID}, Тип дела - Письмо (CRM_EMAIL), Ответственный за дело - не указывается. Активити (робот) найдёт и удалит все дела типа "Письмо", привязанные к указанному лиду.
Удаление дел смарт-процесса	Параметры: ID дела - не указывается, Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Тип дела - не указывается, Ответственный за дело - не указывается. Активити (робот) найдёт и удалит все дела, привязанные к указанному элементу смарт-процесса.
Очистка дел при удалении сущности	Параметры: ID дела - не указывается, Тип сущности - {=Variable:ENTITY_TYPE}, ID сущности - {=Variable:ENTITY_ID}, Тип дела - не указывается, Ответственный за дело - не указывается. Используйте перед удалением сущности для очистки всех связанных дел.

Завершение дел

Активити (робот) "Завершение дел" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое закрытие выполненных дел после завершения бизнес-процесса;
• Массовое закрытие дел по определённым критериям;
• Закрытие всех дел, назначенных конкретному ответственному;
• Автоматизация очистки завершённых задач и дел;
• Закрытие дел после выполнения определённых условий в бизнес-процессе;
• Очистка старых неактуальных дел;
• Автоматическое закрытие дел при изменении статуса сделки или лида;
• Закрытие дел после получения подтверждения выполнения;
• Автоматизация закрытия дел при интеграции с внешними системами;
• Массовое закрытие дел для оптимизации работы с CRM.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела или несколько идентификаторов дел, которые нужно закрыть. Это необязательный параметр, поддерживается множественный выбор. Если указан, то будут закрыты только указанные дела. Если не указан, но указан параметр "Ответственный", то будут закрыты все дела указанного ответственного. Примеры: - {=Variable:ACTIVITY_ID} - закрыть дело с ID из переменной предыдущего активити (робота); - 123 - закрыть дело с ID 123; - {=A1988_22222_92566_99999:search_results_array} - использовать массив ID дел из результата активити (робота) "Поиск дел"; - {=Iterator:Value} - закрыть дело для каждого ID из итератора; - 123, 456, 789 - закрыть несколько дел с указанными ID (множественный выбор). Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если указан параметр "ID дела", то параметр "Ответственный" игнорируется. Для закрытия дел по ответственному необходимо оставить поле "ID дела" пустым.
Ответственный	В данном поле указывается сотрудник, все дела которого нужно закрыть. Это необязательный параметр, используется только если не указан параметр "ID дела". Если указан, то будут закрыты все дела указанного ответственного. Примеры: - {=Document:ASSIGNED_BY_ID} - закрыть все дела ответственного из текущей сущности; - {=User:ID} - закрыть все дела текущего пользователя; - [U1] - закрыть все дела пользователя с ID 1; - user_25 - закрыть все дела пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для массового закрытия всех дел конкретного сотрудника; - Для автоматической очистки дел при смене ответственного; - Для закрытия всех дел при завершении работы сотрудника над проектом. Важно: Этот параметр работает только если не указан параметр "ID дела". Если указаны оба параметра, приоритет имеет параметр "ID дела".
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Закрытие одного дела по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ответственный - не указывается. Активити (робот) закроет дело с указанным ID, установив флаг COMPLETED = 'Y'.
Массовое закрытие дел из результата поиска	Параметры: ID дела - {=A1988_22222_92566_99999:search_results_array}, Ответственный - не указывается. Активити (робот) закроет все дела из массива результатов поиска. Используйте итератор для обработки большого количества дел.
Закрытие всех дел ответственного сотрудника	Параметры: ID дела - не указывается, Ответственный - {=Document:ASSIGNED_BY_ID}. Активити (робот) найдёт и закроет все дела указанного ответственного сотрудника.
Закрытие дел после выполнения условия	Параметры: ID дела - {=Variable:COMPLETED_ACTIVITY_ID}, Ответственный - не указывается. Используйте в условии: если дело выполнено, то закрыть его через данное активити (робот).
Автоматическое закрытие дел при изменении статуса сделки	Параметры: ID дела - {=Variable:DEAL_ACTIVITY_ID}, Ответственный - не указывается. Используйте в бизнес-процессе сделки: при переводе сделки в статус "Закрыта" автоматически закрыть связанные дела.
Закрытие дел через итератор	Параметры: ID дела - {=Iterator:Value}, Ответственный - не указывается. Для каждого ID дела из итератора активити (робот) закроет соответствующее дело. Полезно для массовой обработки.
Закрытие нескольких конкретных дел	Параметры: ID дела - 123, 456, 789 (множественный выбор), Ответственный - не указывается. Активити (робот) закроет все указанные дела за один запуск.
Очистка дел текущего пользователя	Параметры: ID дела - не указывается, Ответственный - {=User:ID}. Активити (робот) закроет все дела текущего пользователя, запустившего бизнес-процесс.
Закрытие дел после получения подтверждения	Параметры: ID дела - {=Variable:CONFIRMED_ACTIVITY_ID}, Ответственный - не указывается. Используйте после активити (робота) получения подтверждения: если подтверждение получено, закрыть дело.
Массовое закрытие дел при завершении проекта	Параметры: ID дела - не указывается, Ответственный - {=Variable:PROJECT_MANAGER_ID}. При завершении проекта закрыть все дела менеджера проекта.

Получение параметров дела

Активити (робот) "Получение данных дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение всех данных дела по его ID для дальнейшей обработки;
• Извлечение конкретных полей дела (тема, описание, ответственный и т.д.);
• Получение информации о файлах, прикреплённых к делу;
• Получение ссылок на файлы для скачивания или просмотра;
• Проверка статуса и параметров дела перед выполнением операций;
• Извлечение данных дела для использования в других активити (роботах);
• Получение информации о записях звонков (ссылки на файлы записей);
• Автоматизация обработки данных дел в бизнес-процессах;
• Получение данных дела для аналитики и отчётности;
• Извлечение данных дела для интеграции с внешними системами.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, данные которого нужно получить. Это обязательный параметр. Если указан массив ID, будет обработан только первый элемент массива. Примеры: - {=Variable:ACTIVITY_ID} - получить данные дела с ID из переменной предыдущего активити (робота); - 123 - получить данные дела с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - получить данные дела, если ID дела совпадает с ID документа; - {=Iterator:Value} - получить данные дела для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует, активити (робот) завершится с ошибкой "Дело с указанным ID не найдено". Всегда проверяйте существование дела перед получением данных.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Получение всех данных дела по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт все доступные поля дела: ID, тема, описание, ответственный, даты создания и завершения, статус, тип дела и другие поля. Все данные будут доступны в возвращаемых параметрах активити (робота).
Получение данных дела из результата поиска	Параметры: ID дела - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) получит данные первого дела из результата поиска. Используйте для обработки найденных дел.
Получение информации о файлах дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт информацию о всех файлах, прикреплённых к делу: ID файлов (ids_files_url), ссылки для просмотра (array_files_url), ссылки для скачивания (array_files_load). Используйте массивы для итерации по файлам.
Получение ссылки на запись звонка	Параметры: ID дела - {=Variable:CALL_ACTIVITY_ID}. Активити (робот) вернёт ссылку на запись звонка в параметре file_url и ID файла записи в параметре file_id. Используйте для прослушивания записей звонков.
Проверка статуса дела перед выполнением операции	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Используйте возвращаемый параметр COMPLETED для проверки статуса дела (Y - выполнено, N - не выполнено) перед выполнением операций с делом.
Извлечение данных дела для использования в других активити	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Получите данные дела и используйте их в следующих активити (роботах). Например, используйте SUBJECT для создания нового дела или DESCRIPTION для отправки письма.
Получение данных дела через итератор	Параметры: ID дела - {=Iterator:Value}. Для каждого ID дела из итератора активити (робот) получит данные соответствующего дела. Полезно для массовой обработки дел.
Получение информации о ответственном за дело	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт ID ответственного за дело в параметре RESPONSIBLE_ID. Используйте для дальнейшей работы с ответственным.
Извлечение дат дела для планирования	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Активити (робот) вернёт дату начала (START_TIME) и дату завершения (END_TIME) дела. Используйте для планирования связанных дел или задач.
Получение данных дела для аналитики	Параметры: ID дела - {=Variable:ACTIVITY_ID}. Получите все данные дела и используйте их для создания отчётов, анализа эффективности работы или для передачи в системы аналитики.

Поиск дел

Активити (робот) "Поиск дел" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск дел по типу (звонок, письмо, встреча, задача и т.д.);
• Поиск дел, привязанных к конкретной сущности CRM (сделка, лид, контакт, компания);
• Фильтрация дел по различным параметрам (ответственный, дата создания, статус и т.д.);
• Поиск дел за определённый период времени;
• Поиск дел по ответственному за дело;
• Поиск дел в смарт-процессах;
• Автоматическое определение типа сущности по ID;
• Поиск дел с поддержкой множественных сущностей;
• Аналитика и отчётность по делам;
• Автоматизация процессов на основе найденных дел.

Название поля	Описание и примеры использования
Тип дела	В данном поле указывается тип дела (провайдера), который нужно найти. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Универсальное (CRM_TODO) - универсальные дела; - Встреча (CRM_MEETING) - дела типа "Встреча"; - Звонок (VOXIMPLANT_CALL) - дела типа "Звонок" (поддерживается поиск с альтернативными провайдерами); - Письмо (CRM_EMAIL) - дела типа "Письмо"; - Задачи (TASKS) - задачи (старые дела для обратной совместимости); - Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации; - Чат (IMOPENLINES_SESSION) - дела типа "Чат"; - Обзвон (CALL_LIST) - дела типа "Обзвон"; - SMS (CRM_SMS) - дела типа "SMS"; - CRM форма (CRM_WEBFORM) - дела типа "CRM форма"; - Визит (VISIT_TRACKER) - дела типа "Визит"; - Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты"; - Доставка (CRM_DELIVERY) - дела типа "Доставка"; - Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания"; - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp"; - Оплата (CRM_PAYMENT) - дела типа "Оплата"; - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса"; - И другие типы дел. Примеры: - Звонок - найти все дела типа "Звонок"; - Письмо - найти все дела типа "Письмо"; - Встреча - найти все дела типа "Встреча". Важно: Параметр "Тип дела" является обязательным. Без указания типа дела поиск не будет выполнен. Для звонков активити (робот) автоматически ищет дела с альтернативными провайдерами (CALL_LIST, CRM_CALL, TELEPHONY, PHONE) для более полного результата.
Тип сущности	В данном поле указывается тип сущности CRM, в которой нужно искать дела. Это необязательный параметр, поддерживается множественный выбор. Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для поиска дел, привязанных к лидам; - Сделка (D) - для поиска дел, привязанных к сделкам; - Контакт (C) - для поиска дел, привязанных к контактам; - Компания (CO) - для поиска дел, привязанных к компаниям; - Предложение (Q) - для поиска дел, привязанных к предложениям; - Заказ (O) - для поиска дел, привязанных к заказам; - Счёт (SI) - для поиска дел, привязанных к счетам; - СМАРТ: [название смарт-процесса] - для поиска дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - найти все дела, привязанные к сделкам; - Контакт (C) - найти все дела, привязанные к контактам; - Сделка (D), Контакт (C) - найти дела, привязанные к сделкам или контактам (множественный выбор); - СМАРТ: Заявки - найти дела, привязанные к смарт-процессу "Заявки". Особенности работы: - Если тип сущности не указан, но указан ID сущности, активити (робот) автоматически определит тип сущности по ID; - Поддерживается множественный выбор для поиска дел в нескольких типах сущностей одновременно; - Для смарт-процессов список формируется автоматически на основе настроек вашего портала.
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой нужно искать дела. Это необязательный параметр. Если указан без указания типа сущности, активити (робот) автоматически определит тип сущности по ID. Примеры: - {=Document:ID} - искать дела в текущей сущности из документа (сделка, лид, контакт, компания); - 123 - искать дела в сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Особенности работы: - Если тип сущности не указан, активити (робот) автоматически определит тип сущности по ID (проверяет лид, сделку, контакт, компанию, смарт-процессы); - Если указан тип сущности, используется указанный тип; - Можно использовать вместе с типом сущности для более точного поиска.
Ответственный	В данном поле указывается сотрудник, дела которого нужно найти. Это необязательный параметр, используется как дополнительный фильтр при поиске дел. Примеры: - {=Document:ASSIGNED_BY_ID} - искать дела ответственного из текущей сущности; - {=User:ID} - искать дела текущего пользователя; - [U1] - искать дела пользователя с ID 1; - user_25 - искать дела пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации дел по ответственному; - Для поиска дел конкретного сотрудника; - Для анализа работы конкретного пользователя.
Дата создания	В данном поле можно указать дату создания дела для фильтрации результатов. Это необязательный параметр. Поддерживаются различные операторы сравнения (=, !, >=, <=, >, <, %, !%). Примеры: - ={{=dateadd({=System:Now}, "-7d")}} - найти дела, созданные 7 дней назад; - >={{=dateadd({=System:Now}, "-30d")}} - найти дела, созданные за последние 30 дней; - <={{=dateadd({=System:Now}, "-1d")}} - найти дела, созданные до вчерашнего дня; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Операторы сравнения: - = - точное совпадение; - ! - не равно; - >= - больше или равно; - <= - меньше или равно; - > - больше; - < - меньше; - % - содержит (для строк); - !% - не содержит (для строк).
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Поиск всех звонков сделки	Параметры: Тип дела - Звонок (VOXIMPLANT_CALL), Тип сущности - Сделка (D), ID сущности - {=Document:ID}. Активити (робот) найдёт все звонки, привязанные к указанной сделке. Результат будет возвращён в параметре search_results_array.
Поиск писем контакта за последний месяц	Параметры: Тип дела - Письмо (CRM_EMAIL), Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Дата создания - >={{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все письма контакта, созданные за последний месяц.
Поиск дел с автоматическим определением типа сущности	Параметры: Тип дела - Универсальное (CRM_TODO), ID сущности - {=Variable:ENTITY_ID}, Тип сущности - не указывается. Активити (робот) автоматически определит тип сущности по ID и найдёт все универсальные дела, привязанные к этой сущности.
Поиск дел в нескольких типах сущностей	Параметры: Тип дела - Встреча (CRM_MEETING), Тип сущности - Сделка (D), Контакт (C) (множественный выбор), ID сущности - не указывается. Активити (робот) найдёт все встречи, привязанные к сделкам или контактам.
Поиск дел ответственного сотрудника	Параметры: Тип дела - Задача (новая) (CRM_TASKS_TASK), Ответственный - {=User:ID}, Тип сущности - не указывается, ID сущности - не указывается. Активити (робот) найдёт все задачи текущего пользователя.
Поиск дел смарт-процесса	Параметры: Тип дела - Универсальное (CRM_TODO), Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}. Активити (робот) найдёт все универсальные дела, привязанные к указанному элементу смарт-процесса "Заявки".
Поиск дел за определённый период	Параметры: Тип дела - Письмо (CRM_EMAIL), Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Дата создания - >={{=dateadd({=System:Now}, "-7d")}} и <={{=System:Now}}. Активити (робот) найдёт все письма сделки, созданные за последние 7 дней.
Поиск дел через итератор	Параметры: Тип дела - Звонок (VOXIMPLANT_CALL), Тип сущности - Контакт (C), ID сущности - {=Iterator:Value}. Для каждого ID контакта из итератора активити (робот) найдёт все звонки этого контакта.
Поиск дел с фильтрацией по теме	Параметры: Тип дела - Универсальное (CRM_TODO), Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Тема - %Важное%. Активити (робот) найдёт все универсальные дела сделки, тема которых содержит слово "Важное".
Поиск дел с использованием всех доступных полей	Параметры: Тип дела - Встреча (CRM_MEETING), Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Ответственный - {=Document:ASSIGNED_BY_ID}, Дата начала - >={{=System:Now}}, Статус - N. Активити (робот) найдёт все предстоящие встречи сделки, назначенные ответственному за сделку.

Изменение дела

Активити (робот) "Изменение дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Изменение данных дела по его ID;
• Обновление статуса дела (выполнено/не выполнено);
• Изменение ответственного за дело;
• Обновление темы и описания дела;
• Изменение дат начала и завершения дела;
• Изменение приоритета дела;
• Изменение типа сущности, к которой привязано дело;
• Автоматическое обновление дел при изменении статуса сделки или лида;
• Массовое обновление дел по определённым критериям;
• Автоматизация обновления дел при интеграции с внешними системами.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, данные которого нужно изменить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - изменить дело с ID из переменной предыдущего активити (робота); - 123 - изменить дело с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - изменить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - изменить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если ID дела не указан или указан неверно, активити (робот) завершится с ошибкой "Не указано ID дела".
Все доступные поля дела	Активити (робот) автоматически получает список всех доступных полей дела из CRM вашего портала и создаёт для каждого поля параметр, который можно заполнить для изменения значения. Это необязательные параметры. Доступные поля зависят от настроек вашего портала. Основные поля, которые обычно доступны: - Тема (SUBJECT) - тема дела; - Описание (DESCRIPTION) - описание дела; - Ответственный (RESPONSIBLE_ID) - ответственный за дело; - Дата начала (START_TIME) - дата и время начала дела; - Дата завершения (END_TIME) - дата и время завершения дела; - Выполнено (COMPLETED) - статус выполнения дела (Y/N); - Приоритет (PRIORITY) - приоритет дела; - Тип сущности (OWNER_TYPE_ID) - тип сущности, к которой привязано дело; - ID сущности (OWNER_ID) - ID сущности, к которой привязано дело; - И другие поля в зависимости от настроек портала. Примеры использования: - SUBJECT - "Новая тема дела" - изменить тему дела; - DESCRIPTION - "Обновлённое описание" - изменить описание дела; - COMPLETED - Y - отметить дело как выполненное; - RESPONSIBLE_ID - {=User:ID} - изменить ответственного на текущего пользователя; - START_TIME - ={{=dateadd({=System:Now}, "1d")}} - изменить дату начала на завтра; - OWNER_TYPE_ID - 2 - изменить тип сущности на "Сделка"; - OWNER_ID - {=Variable:DEAL_ID} - изменить ID сущности на значение из переменной. Типы полей: - Строка (string) - для текстовых полей; - Число (integer, double) - для числовых полей; - Дата/Время (datetime) - для полей с датой и временем; - Булево значение (boolean) - для полей с значениями Y/N; - Пользователь (user) - для полей с пользователями; - Тип сущности (crm_enum_ownertype) - для выбора типа сущности из списка. Важно: Не все поля дела доступны для изменения. Некоторые поля являются системными и не могут быть изменены (например, ID, PROVIDER_ID, PROVIDER_TYPE_ID). Список доступных полей формируется автоматически при установке активити (робота) на основе настроек вашего портала.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Отметить дело как выполненное	Параметры: ID дела - {=Variable:ACTIVITY_ID}, COMPLETED - Y. Активити (робот) отметит дело с указанным ID как выполненное.
Изменить ответственного за дело	Параметры: ID дела - {=Variable:ACTIVITY_ID}, RESPONSIBLE_ID - {=Document:ASSIGNED_BY_ID}. Активити (робот) изменит ответственного за дело на ответственного из текущей сущности.
Обновить тему и описание дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, SUBJECT - "Обновлённая тема", DESCRIPTION - "Обновлённое описание дела". Активити (робот) обновит тему и описание дела.
Изменить даты начала и завершения дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, START_TIME - ={{=dateadd({=System:Now}, "1d")}}, END_TIME - ={{=dateadd({=System:Now}, "2d")}}. Активити (робот) изменит дату начала на завтра, а дату завершения - на послезавтра.
Изменить приоритет дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, PRIORITY - 3. Активити (робот) изменит приоритет дела на высокий (3).
Изменить тип сущности и ID сущности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, OWNER_TYPE_ID - 2, OWNER_ID - {=Variable:DEAL_ID}. Активити (робот) изменит привязку дела на сделку с указанным ID.
Массовое обновление дел через итератор	Параметры: ID дела - {=Iterator:Value}, COMPLETED - Y. Для каждого ID дела из итератора активити (робот) отметит дело как выполненное. Полезно для массовой обработки.
Обновление дела после выполнения условия	Параметры: ID дела - {=Variable:ACTIVITY_ID}, COMPLETED - Y, SUBJECT - "Выполнено: " & {=Variable:ACTIVITY_SUBJECT}. Используйте в условии: если условие выполнено, то обновить дело через данное активити (робот).
Автоматическое обновление дела при изменении статуса сделки	Параметры: ID дела - {=Variable:DEAL_ACTIVITY_ID}, SUBJECT - "Сделка переведена в статус '{=Document:STAGE_ID}'", DESCRIPTION - "Статус сделки изменён. Новый статус: {=Document:STAGE_ID}". Используйте в бизнес-процессе сделки: при переводе сделки в новый статус автоматически обновить связанное дело.
Изменение нескольких полей одновременно	Параметры: ID дела - {=Variable:ACTIVITY_ID}, SUBJECT - "Новая тема", DESCRIPTION - "Новое описание", RESPONSIBLE_ID - {=User:ID}, COMPLETED - N, PRIORITY - 1, START_TIME - {=System:NowLocal}, END_TIME - ={{=dateadd({=System:Now}, "1d")}}. Активити (робот) обновит все указанные поля дела за один запрос.

Удаление привязки к CRM сущности

Активити (робот) "Удаление привязки дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Удаление привязок дел к сущностям CRM при изменении структуры данных;
• Очистка привязок дел перед переносом на другие сущности;
• Удаление привязок дел к удалённым или неактуальным сущностям;
• Массовое удаление привязок дел к определённым типам сущностей;
• Очистка привязок дел при миграции данных между порталами;
• Удаление привязок дел к смарт-процессам при изменении структуры процессов;
• Фильтрация и удаление привязок дел по типу дела (провайдеру);
• Автоматическая очистка привязок при обработке ошибок и исключений;
• Удаление привязок дел при интеграции с внешними системами;
• Очистка привязок дел для оптимизации структуры данных в CRM.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, привязки которого к сущностям CRM будут удалены. Это необязательный параметр, но если он указан, то другие параметры (тип сущности и ID сущности) не учитываются. Поддерживается множественное значение (можно указать несколько ID дел). Важно: Если указан ID дела, то параметры "Тип сущности (для поиска дел)", "ID сущности (для поиска дел)" и "Тип дела (дополнительный фильтр)" игнорируются. Используйте этот параметр для удаления привязок конкретного дела. Примеры: - {=Variable:ACTIVITY_ID} - удалить привязки дела с ID из переменной предыдущего активити (робота); - 123 - удалить привязки дела с ID 123; - 123, 456, 789 - удалить привязки нескольких дел одновременно (множественное значение); - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Iterator:Value} - удалить привязки дела для каждого ID из итератора. Важно: Если у дела только одна привязка, она не будет удалена (дело будет пропущено), так как дело всегда должно иметь хотя бы одну привязку к сущности CRM. ID таких дел будет возвращён в параметре skipped_activity_ids.
Тип сущности (для поиска дел)	В данном поле выбирается тип сущности CRM, по которой будут найдены дела для удаления привязок. Это необязательный параметр, используется только если не указан "ID дела". Выбирается из выпадающего списка. Варианты выбора: - L - Лид (CRM_LEAD); - D - Сделка (CRM_DEAL); - C - Контакт (CRM_CONTACT); - CO - Компания (CRM_COMPANY); - Q - Предложение (CRM_QUOTE); - O - Заказ (CRM_ORDER); - SI - Счёт (новый, CRM_SMART_INVOICE); - СМАРТ: [название смарт-процесса] - для поиска дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - D - найти все дела, привязанные к сделкам, и удалить у них привязки; - C - найти все дела, привязанные к контактам, и удалить у них привязки; - CO - найти все дела, привязанные к компаниям, и удалить у них привязки; - СМАРТ: Заявки - найти все дела, привязанные к смарт-процессу "Заявки", и удалить у них привязки. Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "ID сущности (для поиска дел)".
ID сущности (для поиска дел)	В данном поле указывается идентификатор сущности CRM, по которой будут найдены дела для удаления привязок. Это необязательный параметр, используется только если не указан "ID дела". Примеры: - {=Document:ID} - найти все дела, привязанные к текущей сущности из документа (сделка, лид, контакт, компания), и удалить у них привязки; - 123 - найти все дела, привязанные к сущности с ID 123, и удалить у них привязки; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Как работает в паре с "Тип сущности (для поиска дел)": - Если указаны оба параметра ("Тип сущности (для поиска дел)" и "ID сущности (для поиска дел)"), активити (робот) найдёт все дела, привязанные к указанной сущности, и удалит у них все привязки (кроме одной, если она единственная); - Если указан только "ID сущности (для поиска дел)" без "Типа сущности (для поиска дел)", активити (робот) завершится с ошибкой. Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "Тип сущности (для поиска дел)".
Тип дела (дополнительный фильтр)	В данном поле можно указать тип дела (провайдер) для дополнительной фильтрации при поиске дел. Это необязательный параметр, используется только если не указан "ID дела". Позволяет фильтровать дела по их типу перед удалением привязок. Варианты выбора: - Универсальное дело (CRM_TODO); - Встреча (CRM_MEETING); - Звонок (VOXIMPLANT_CALL); - Задача (старый формат) (TASKS); - Задача (новый формат) (CRM_TASKS_TASK); - Письмо (CRM_EMAIL); - Обзвон (CALL_LIST); - SMS (CRM_SMS); - Сообщение в живую ленту (CRM_LF_MESSAGE); - Комментарий в живую ленту (CRM_LF_COMMENT); - Визит (VISIT_TRACKER); - Дело через REST (конфигурируемое) (CONFIGURABLE_REST_APP); - Слоты календаря (CRM_CALENDAR_SHARING); - Доставка (CRM_DELIVERY); - Документ подписания (CRM_SIGN_DOCUMENT); - Дело через REST (устаревшее) (CRM_EXTERNAL_CHANNEL); - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION); - Оплата (CRM_PAYMENT); - Задание из бизнес-процесса (CRM_REQUEST); - Комментарий к задаче (CRM_TASKS_TASK_COMMENT); - Заполнение CRM-формы (CRM_WEBFORM); - Чат открытой линии (IMOPENLINES_SESSION); - Дело через REST приложение (REST_APP); - Документ складского учета (STORE_DOCUMENT); - Zoom-конференция (ZOOM); - Подписание документа с сотрудниками (CRM_SIGN_B2E_DOCUMENT); - Бронирование (CRM_BOOKING); - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW). Примеры: - Звонок - удалить привязки только у дел типа "Звонок"; - Письмо - удалить привязки только у дел типа "Письмо"; - Встреча - удалить привязки только у дел типа "Встреча". Когда использовать: - Когда нужно удалить привязки только у определённого типа дел; - Для фильтрации дел перед массовым удалением привязок; - Для более точного контроля над процессом удаления привязок.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Удаление всех привязок у конкретного дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) удалит все привязки у указанного дела (кроме одной, если она единственная).
Удаление привязок у всех дел, привязанных к сделке	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - D (Сделка), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) найдёт все дела, привязанные к указанной сделке, и удалит у них все привязки (кроме одной, если она единственная).
Удаление привязок только у звонков, привязанных к контакту	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - C (Контакт), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - Звонок. Активити (робот) найдёт все дела типа "Звонок", привязанные к указанному контакту, и удалит у них все привязки.
Удаление привязок у нескольких дел одновременно	Параметры: ID дела - 123, 456, 789 (множественное значение), Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) удалит все привязки у всех трёх указанных дел.
Удаление привязок у всех писем, привязанных к компании	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - CO (Компания), ID сущности (для поиска дел) - {=Variable:COMPANY_ID}, Тип дела (дополнительный фильтр) - Письмо. Активити (робот) найдёт все дела типа "Письмо", привязанные к указанной компании, и удалит у них все привязки.
Массовое удаление привязок через итератор	Параметры: ID дела - {=Iterator:Value}, Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Для каждого ID дела из итератора будет выполнено удаление всех привязок.
Удаление привязок у дел, привязанных к смарт-процессу	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - СМАРТ: Заявки, ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - не указывается. Активити (робот) найдёт все дела, привязанные к указанному элементу смарт-процесса "Заявки", и удалит у них все привязки.
Удаление привязок только у встреч, привязанных к сделке	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - D (Сделка), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - Встреча. Активити (робот) найдёт все дела типа "Встреча", привязанные к указанной сделке, и удалит у них все привязки.
Удаление привязок у дел после переноса на другую сущность	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности (для поиска дел) - не указывается, ID сущности (для поиска дел) - не указывается, Тип дела (дополнительный фильтр) - не указывается. Используется после привязки дела к новой сущности через активити (робот) "Привязка дела" для удаления старых привязок.
Очистка привязок у всех дел типа "Задание из бизнес-процесса"	Параметры: ID дела - не указывается, Тип сущности (для поиска дел) - D (Сделка), ID сущности (для поиска дел) - {=Document:ID}, Тип дела (дополнительный фильтр) - Задание из бизнес-процесса. Активити (робот) найдёт все дела типа "Задание из бизнес-процесса", привязанные к указанной сделке, и удалит у них все привязки.

Получить список CRM сущностей, привязанных к делу

Активити (робот) "Список привязок дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение списка всех сущностей, к которым привязано дело;
• Проверка наличия привязок дела к определённым типам сущностей;
• Анализ структуры связей дел с сущностями CRM;
• Получение ID сущностей для дальнейшей обработки в бизнес-процессе;
• Проверка привязок перед удалением или изменением связей;
• Получение списка привязок для массовой обработки дел;
• Аналитика и отчётность по связям дел с сущностями;
• Валидация данных перед выполнением операций с привязками;
• Получение информации о привязках для интеграции с внешними системами;
• Автоматизация процессов на основе информации о привязках дел.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, для которого нужно получить список привязок к сущностям CRM. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - получить список привязок дела с ID из переменной предыдущего активити (робота); - 123 - получить список привязок дела с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Document:ID} - получить список привязок дела, связанного с текущим документом (если ID дела совпадает с ID документа); - {=Iterator:Value} - получить список привязок для каждого ID дела из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует или не имеет привязок, активити (робот) завершится с ошибкой "Не найдены привязки для данного дела".
Ограничить количество результатов до	В данном поле можно указать максимальное количество результатов, которое будет возвращено. Это необязательный параметр. Если не указан, будут возвращены все найденные привязки. Примеры: - 5 - вернуть только первые 5 привязок; - 10 - вернуть только первые 10 привязок; - {=Variable:LIMIT} - использовать значение из переменной предыдущего активити (робота); - Если не указано - вернуть все найденные привязки. Когда использовать: - Когда нужно получить только первую привязку (указать 1); - Для ограничения количества результатов при большом количестве привязок; - Для оптимизации производительности при работе с большими массивами данных. Рекомендации: - Используйте этот параметр, если дело может иметь много привязок и вам нужны только первые N результатов; - Для получения только первой привязки используйте также параметр search_result_first_string из возвращаемых значений.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Получение списка всех привязок дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Активити (робот) вернёт все привязки дела в формате массива и строки (например, D_123,C_456,CO_789).
Получение только первой привязки дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - 1. Активити (робот) вернёт только первую привязку. Также можно использовать параметр search_result_first_string из возвращаемых значений.
Проверка привязок дела перед удалением	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте результат для проверки количества привязок (параметр count_search) перед удалением привязок через активити (робот) "Удаление привязки дела".
Получение ID сделки из привязок дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_array для поиска элементов с префиксом D_ (сделка) и извлечения ID сделки.
Получение списка привязок для массовой обработки	Параметры: ID дела - {=Iterator:Value}, Ограничить количество результатов до - не указывается. Для каждого ID дела из итератора будет получен список привязок для дальнейшей обработки.
Проверка наличия привязки к определённой сущности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_string для проверки наличия определённого префикса и ID (например, проверка наличия D_{=Document:ID}).
Получение всех контактов, привязанных к делу	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_results_array для фильтрации элементов с префиксом C_ (контакт) и извлечения ID контактов.
Ограничение результатов для оптимизации	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - 10. Активити (робот) вернёт только первые 10 привязок, что полезно при большом количестве привязок.
Получение последней привязки дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр search_result_last_string из возвращаемых значений для получения последней привязки.
Анализ структуры привязок для отчётности	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Ограничить количество результатов до - не указывается. Используйте параметр count_search для подсчёта количества привязок и search_results_array для анализа типов привязанных сущностей.

Привязка дела

Активити (робот) "Привязка дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Привязка дела к дополнительным сущностям CRM (сделка, лид, контакт, компания);
• Связывание дела с несколькими сущностями одновременно;
• Автоматическая привязка дел к смарт-процессам;
• Создание связей между делами и различными типами сущностей в процессе работы;
• Привязка дел к сущностям на основе данных из предыдущих активити (роботов);
• Массовая привязка дел к сущностям через итератор;
• Автоматизация создания связей при обработке заявок и обращений;
• Привязка дел к сущностям при интеграции с внешними системами;
• Создание дополнительных связей для аналитики и отчётности;
• Привязка дел к сущностям при изменении статусов и этапов работы.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, которое будет привязано к сущности CRM. Это необязательный параметр, но если он указан, то другие параметры (тип сущности и ID сущности) не учитываются. Поддерживается множественное значение (можно указать несколько ID дел). Важно: Если указан ID дела, то параметры "Тип сущности" и "ID сущности" игнорируются. Используйте этот параметр для прямой привязки конкретного дела к сущности. Примеры: - {=Variable:ACTIVITY_ID} - привязать дело с ID из переменной предыдущего активити (робота); - 123 - привязать дело с ID 123; - 123, 456, 789 - привязать несколько дел одновременно (множественное значение); - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=Iterator:Value} - привязать дело для каждого ID из итератора. Когда использовать: - Когда нужно привязать конкретное дело, ID которого известно; - Когда ID дела получен из предыдущего активити (робота); - Для массовой привязки нескольких конкретных дел к одной сущности.
Тип сущности	В данном поле выбирается тип сущности CRM, к которой будет привязано дело. Это необязательный параметр, используется только если не указан "ID дела". Выбирается из выпадающего списка. Варианты выбора: - L - Лид (CRM_LEAD); - D - Сделка (CRM_DEAL); - C - Контакт (CRM_CONTACT); - CO - Компания (CRM_COMPANY); - Q - Предложение (CRM_QUOTE); - O - Заказ (CRM_ORDER); - SI - Счёт (новый, CRM_SMART_INVOICE); - СМАРТ: [название смарт-процесса] - для привязки к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - D - привязать дело к сделке; - C - привязать дело к контакту; - CO - привязать дело к компании; - СМАРТ: Заявки - привязать дело к смарт-процессу "Заявки". Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "ID сущности".
ID сущности	В данном поле указывается идентификатор сущности CRM, к которой будет привязано дело. Это необязательный параметр, используется только если не указан "ID дела". Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Как работает в паре с "Тип сущности": - Если указаны оба параметра ("Тип сущности" и "ID сущности"), активити (робот) найдёт все дела, привязанные к указанной сущности, и привяжет их к новой сущности, указанной в этих параметрах; - Если указан только "ID сущности" без "Типа сущности", активити (робот) завершится с ошибкой. Важно: Этот параметр используется только если не указан "ID дела". Если указан "ID дела", то этот параметр игнорируется. Для работы этого параметра также необходимо указать "Тип сущности".
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Привязка конкретного дела к сделке по ID	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается (игнорируется), ID сущности - не указывается (игнорируется). Примечание: при указании ID дела другие параметры не учитываются. Для привязки к сделке используйте активити (робот) с указанием ID дела и ID сделки в других параметрах активити (робота) или используйте другой способ привязки.
Привязка всех дел от лида к сделке при конвертации	Параметры: ID дела - не указывается, Тип сущности - D (Сделка), ID сущности - {=Document:ID}. Активити (робот) найдёт все дела, привязанные к лиду (из которого запущен бизнес-процесс), и привяжет их к указанной сделке.
Привязка дела к контакту после создания дела	Параметры: ID дела - {=A1988_22222_92566_99999:new_id_activity}, Тип сущности - не указывается, ID сущности - не указывается. Используется ID дела из активити (робота) "Создание своего дела в CRM". Дело будет привязано к контакту, указанному в параметрах активити (робота) привязки.
Привязка нескольких дел к компании одновременно	Параметры: ID дела - 123, 456, 789 (множественное значение), Тип сущности - не указывается, ID сущности - не указывается. Все три дела будут привязаны к компании, указанной в других параметрах активити (робота).
Привязка дел к смарт-процессу при изменении статуса	Параметры: ID дела - не указывается, Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}. Активити (робот) найдёт все дела, привязанные к текущему элементу смарт-процесса, и привяжет их к новому элементу смарт-процесса.
Массовая привязка дел через итератор	Параметры: ID дела - {=Iterator:Value}, Тип сущности - не указывается, ID сущности - не указывается. Для каждого ID дела из итератора будет выполнена привязка к сущности, указанной в других параметрах активити (робота).
Привязка дела к контакту при создании сделки	Параметры: ID дела - не указывается, Тип сущности - C (Контакт), ID сущности - {=Document:CONTACT_ID}. Активити (робот) найдёт все дела, привязанные к сделке (из которой запущен бизнес-процесс), и привяжет их к контакту, указанному в сделке.
Привязка дела к компании при работе с лидом	Параметры: ID дела - не указывается, Тип сущности - CO (Компания), ID сущности - {=Variable:COMPANY_ID}. Активити (робот) найдёт все дела, привязанные к лиду (из которого запущен бизнес-процесс), и привяжет их к компании, ID которой указан в переменной.
Привязка дела к предложению при создании коммерческого предложения	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Тип сущности - не указывается, ID сущности - не указывается. Дело будет привязано к предложению, указанному в других параметрах активити (робота).
Привязка дел к счёту при выставлении счёта	Параметры: ID дела - не указывается, Тип сущности - SI (Счёт), ID сущности - {=Variable:INVOICE_ID}. Активити (робот) найдёт все дела, привязанные к сделке (из которой запущен бизнес-процесс), и привяжет их к созданному счёту.

Прочие операции с делами

Создание e-mail

Активити (робот) "Создание e-mail" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое создание входящих писем при получении сообщений из внешних систем;
• Создание исходящих писем для отправки клиентам;
• Автоматизация создания писем при изменении статуса сделки или лида;
• Создание писем с прикреплёнными файлами;
• Автоматическое создание писем при интеграции с почтовыми системами;
• Создание писем для напоминаний и уведомлений;
• Автоматизация создания писем при поступлении заявок с сайта;
• Создание писем для массовых рассылок через бизнес-процессы;
• Автоматическое создание писем при выполнении определённых условий;
• Создание писем для документооборота и согласования.

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязано создаваемое письмо. Это обязательный параметр. Варианты выбора: - Лид (1) - для привязки письма к лиду; - Сделка (2) - для привязки письма к сделке; - Контакт (3) - для привязки письма к контакту; - Компания (4) - для привязки письма к компании; - Смарт-процессы (5) - для привязки письма к смарт-процессу (требует указания конкретного смарт-процесса в поле "Смарт-процессы"). Примеры использования: - Для создания письма, привязанного к сделке, выберите значение "2"; - Для создания письма, привязанного к лиду, выберите значение "1"; - При выборе "Смарт-процессы" необходимо дополнительно указать конкретный смарт-процесс в поле "Смарт-процессы".
ID Сущности	В данном поле указывается числовой идентификатор (ID) сущности, к которой будет привязано создаваемое письмо. Это обязательный параметр. Примеры: - {=Document:ID} - привязать письмо к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать письмо к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
Смарт-процессы	В данном поле указывается конкретный смарт-процесс, к которому будет привязано письмо. Это необязательный параметр, который используется только при выборе типа сущности "Смарт-процессы". Важно: Это поле активно только при выборе типа сущности "Смарт-процессы". Для обычных CRM-сущностей (лид, сделка, контакт, компания) это поле не используется. Примеры: - Выберите нужный смарт-процесс из выпадающего списка (список формируется автоматически на основе настроек вашего портала); - Список доступных смарт-процессов загружается автоматически при установке активити (робота).
Тип сущность, которой принадлежит почта	В данном поле указывается тип сущности, которой принадлежит почтовый адрес. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Контакт (3) - почта принадлежит контакту; - Компания (4) - почта принадлежит компании. Примеры использования: - Контакт (3) - если почтовый адрес принадлежит контакту; - Компания (4) - если почтовый адрес принадлежит компании.
ID сущности, которой принадлежит почта	В данном поле указывается идентификатор сущности (контакта или компании), которой принадлежит почтовый адрес. Это обязательный параметр. Примеры: - {=Document:CONTACT_ID} - использовать ID контакта из текущей сущности; - {=Document:COMPANY_ID} - использовать ID компании из текущей сущности; - 123 - указать ID сущности напрямую; - {=Variable:ENTITY_ID} - использовать ID из переменной предыдущего активити (робота). Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности (контакт или компания).
Направление письма	В данном поле указывается направление письма: входящее или исходящее. Это обязательный параметр. Варианты выбора: - Входящее (1) - письмо получено от клиента или партнёра; - Исходящее (2) - письмо отправляется клиенту или партнёру. Примеры использования: - Входящее (1) - для создания писем, полученных от клиентов; - Исходящее (2) - для создания писем, которые будут отправлены клиентам. Особенности работы: - Для входящих писем используется статус из параметра "Статус письма"; - Для исходящих писем можно указать, нужно ли отправлять письмо сразу (параметр "Отправлять письмо").
Статус письма	В данном поле указывается статус письма: выполнено или не выполнено. Это обязательный параметр. Варианты выбора: - Не выполнено (N) - письмо не обработано или не отправлено; - Выполнено (Y) - письмо обработано или отправлено. Примеры использования: - Не выполнено (N) - для писем, которые требуют обработки; - Выполнено (Y) - для писем, которые уже обработаны или отправлены. Особенности работы: - Для входящих писем статус указывает, обработано ли письмо; - Для исходящих писем статус указывает, отправлено ли письмо (если параметр "Отправлять письмо" установлен в "Да").
Отправлять письмо	В данном поле указывается, нужно ли отправлять исходящее письмо сразу после создания. Это необязательный параметр (варианты: да/нет), используется только для исходящих писем. Варианты выбора: - Да (Y) - письмо будет отправлено сразу после создания; - Нет (N) - письмо будет создано, но не отправлено (можно отправить вручную позже). Примеры использования: - Да (Y) - для автоматической отправки писем клиентам; - Нет (N) - для создания писем, которые требуют проверки перед отправкой. Важно: Этот параметр работает только для исходящих писем (Направление письма = Исходящее). Для входящих писем этот параметр не применяется.
От кого (e-mail)	В данном поле указывается почтовый адрес отправителя письма. Это обязательный параметр. Примеры: - info@example.com - указать почтовый адрес напрямую; - {=Variable:SENDER_EMAIL} - использовать адрес из переменной предыдущего активити (робота); - {=Document:EMAIL} - использовать адрес из текущей сущности (если есть поле EMAIL). Важно: Почтовый адрес должен быть указан в корректном формате (например, user@example.com).
Кому (e-mail)	В данном поле указывается почтовый адрес получателя письма. Это обязательный параметр. Поддерживается указание адреса в формате массива с типом VALUE_TYPE = 'WORK' для автоматического определения рабочего адреса. Примеры: - client@example.com - указать почтовый адрес напрямую; - {=Document:EMAIL} - использовать адрес из текущей сущности; - {=Variable:RECIPIENT_EMAIL} - использовать адрес из переменной предыдущего активити (робота); - Массив с VALUE_TYPE = 'WORK' - для автоматического определения рабочего адреса из контакта или компании. Особенности работы: - Если указан массив с типом VALUE_TYPE = 'WORK', активити (робот) автоматически выберет рабочий адрес; - Если указана строка, используется указанный адрес напрямую.
Тема письма	В данном поле указывается тема (заголовок) письма. Это необязательный параметр. Примеры: - Ответ на ваше обращение; - Коммерческое предложение для сделки #{=Document:ID}; - Напоминание: оплата по сделке {=Document:TITLE}; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к теме из переменной. Рекомендации: - Используйте информативные темы, которые помогут быстро понять суть письма; - Можно включать переменные и поля из текущей сущности для персонализации.
Тип описания	В данном поле указывается формат описания письма. Это необязательный параметр. Варианты выбора: - Текст (1) - обычный текст без форматирования; - BBCODE (2) - форматирование BB-код; - HTML (3) - форматирование HTML. Примеры использования: - Текст (1) - для простых текстовых писем; - BBCODE (2) - для писем с форматированием (жирный текст, ссылки и т.д.); - HTML (3) - для писем с HTML-форматированием. Рекомендации: - Используйте BBCODE для стандартного форматирования; - Используйте HTML для сложного форматирования и дизайна.
Описание письма	В данном поле указывается содержание и описание письма. Это обязательный параметр. Поддерживается форматирование в зависимости от выбранного типа описания (текст, BB-код или HTML). Примеры: - Здравствуйте! Благодарим за обращение. Мы свяжемся с вами в ближайшее время.; - [b]Важно:[/b] Проверьте документы по сделке #{=Document:ID}. Сумма: {=Document:OPPORTUNITY} руб.; - Подготовьте договор для компании {=Document:COMPANY_TITLE}. Контактное лицо: {=Document:CONTACT_NAME}; - ={{={=Variable:DESCRIPTION} & "[br]Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных с форматированием; - [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Ссылка на сделку[/url] - добавить ссылку на сущность. Форматирование BB-код: - [b]жирный текст[/b] - жирное начертание; - [i]курсив[/i] - курсивное начертание; - [u]подчёркнутый[/u] - подчёркнутый текст; - [br] - перенос строки; - [url=ссылка]текст[/url] - ссылка. Важно: Если поле "Описание письма" пустое, активити (робот) завершится с ошибкой. Обязательно укажите содержание письма.
Приоритет	В данном поле указывается приоритет письма. Это необязательный параметр. Варианты выбора: - Низкий (1) - обычный приоритет; - Высокий (3) - высокий приоритет (важное письмо). Примеры использования: - Низкий (1) - для обычных писем; - Высокий (3) - для важных писем, требующих срочной обработки. Рекомендации: - Используйте высокий приоритет только для действительно важных писем; - Высокоприоритетные письма выделяются в интерфейсе CRM.
Дата начала	В данном поле указывается дата и время начала письма. Это необязательный параметр. Если не указано, дата начала будет установлена автоматически. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "1d")}} - установить дату начала через 1 день от текущего момента; - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}} - установить дату начала через 2 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:BEGINDATE}, "1h")}} - установить дату начала через 1 час от даты начала сделки; - 15.01.2025 10:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта времени начала; - Учитывайте рабочие дни и часы при планировании писем.
Дата завершения	В данном поле указывается дата и время завершения письма. Это необязательный параметр. Если не указано, дата завершения не будет установлена. Примеры: - ={{=dateadd({=System:Now}, "3d")}} - установить дату завершения через 3 дня от текущего момента; - ={{=workdateadd({=System:Now}, "5d", {=Document:ASSIGNED_BY_ID})}} - установить дату завершения через 5 рабочих дней с учётом рабочего времени ответственного; - ={{=dateadd({=Variable:DATE_START}, "2h")}} - установить дату завершения через 2 часа от даты начала (из переменной); - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить дату завершения на 1 день раньше даты закрытия сделки; - 20.01.2025 18:00:00 - указать конкретную дату и время завершения. Рекомендации: - Дата завершения должна быть позже даты начала; - Используйте функции работы с датами для автоматического расчёта дедлайнов.
Файлы	В данном поле указываются файлы, которые нужно прикрепить к письму. Это необязательный параметр, поддерживается множественный выбор (до 20 файлов за один запрос). Указывается ID файла на диске Битрикс24. Примеры: - 12345 - прикрепить файл с ID 12345 на диске; - {=Variable:FILE_ID} - использовать ID файла из переменной предыдущего активити (робота); - {=Document:FILES} - использовать файлы из текущей сущности (если есть поле FILES); - 12345, 67890, 11111 - прикрепить несколько файлов (множественный выбор). Как получить ID файла: - Из результата активити (робота) загрузки файла; - Из поля документа, если файл прикреплён к документу; - Из переменной, созданной в предыдущих шагах бизнес-процесса. Важно: Активити (робот) может прикрепить до 20 файлов за один запрос. Если указано больше 20 файлов, будут прикреплены только первые 20. Для прикрепления большего количества файлов используйте несколько запусков активити (робота) или итератор.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Создание входящего письма от клиента	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 1 (Входящее), Статус письма - N (Не выполнено), От кого (e-mail) - {=Document:EMAIL}, Кому (e-mail) - info@company.com, Тема письма - "Вопрос по сделке #{=Document:ID}", Тип описания - 2 (BBCODE), Описание письма - "Здравствуйте! У меня вопрос по сделке. [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Ссылка на сделку[/url]", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание исходящего письма с отправкой	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Коммерческое предложение для сделки #{=Document:ID}", Тип описания - 2 (BBCODE), Описание письма - "[b]Уважаемый клиент![/b] Предлагаем вам коммерческое предложение по сделке. Сумма: {=Document:OPPORTUNITY} руб.", Приоритет - 3 (Высокий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - {=Variable:PROPOSAL_FILE_ID}.
Создание письма с прикреплёнными файлами	Параметры: Тип сущности - 3 (Контакт), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Документы для ознакомления", Тип описания - 1 (Текст), Описание письма - "Прикрепляю документы для ознакомления. Прошу ознакомиться и дать обратную связь.", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - {=Variable:FILE_ID_1}, {=Variable:FILE_ID_2}, {=Variable:FILE_ID_3}.
Автоматическое создание письма при изменении статуса сделки	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Сделка переведена в статус '{=Document:STAGE_ID}'", Тип описания - 2 (BBCODE), Описание письма - "Уведомляем вас, что сделка #{=Document:ID} переведена в новый статус. [url={=System:HostUrl}/crm/deal/details/{=Document:ID}/]Открыть сделку[/url]", Приоритет - 3 (Высокий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма для смарт-процесса	Параметры: Тип сущности - 5 (Смарт-процессы), Смарт-процессы - {=Variable:SMART_TYPE}, ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Variable:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Variable:CLIENT_EMAIL}, Тема письма - "Обработка заявки", Тип описания - 2 (BBCODE), Описание письма - "Ваша заявка получена и находится в обработке. Номер заявки: {=Document:ID}", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма с HTML-форматированием	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Красивое письмо", Тип описания - 3 (HTML), Описание письма - "<h1>Заголовок</h1><p>Текст письма с <b>форматированием</b></p>", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма с планированием на будущее	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Напоминание о дедлайне", Тип описания - 2 (BBCODE), Описание письма - "Напоминаем, что дедлайн по сделке наступает {=Document:CLOSEDATE}", Приоритет - 3 (Высокий), Дата начала - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}}, Дата завершения - {=Document:CLOSEDATE}, Файлы - не указывается.
Массовое создание писем через итератор	Параметры: Тип сущности - 2 (Сделка), ID Сущности - {=Iterator:Value}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Variable:CONTACT_ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Variable:CLIENT_EMAIL}, Тема письма - "Уведомление по сделке #{=Iterator:Value}", Тип описания - 1 (Текст), Описание письма - "Создано автоматическое уведомление по сделке.", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма с автоматическим определением рабочего адреса	Параметры: Тип сущности - 3 (Контакт), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 3 (Контакт), ID сущности, которой принадлежит почта - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - Y (Выполнено), Отправлять письмо - Y (Да), От кого (e-mail) - info@company.com, Кому (e-mail) - массив с VALUE_TYPE = 'WORK', Тема письма - "Приветствие", Тип описания - 1 (Текст), Описание письма - "Здравствуйте! Рады приветствовать вас.", Приоритет - 1 (Низкий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - не указывается.
Создание письма для компании	Параметры: Тип сущности - 4 (Компания), ID Сущности - {=Document:ID}, Тип сущность, которой принадлежит почта - 4 (Компания), ID сущности, которой принадлежит почта - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - N (Не выполнено), Отправлять письмо - N (Нет), От кого (e-mail) - info@company.com, Кому (e-mail) - {=Document:EMAIL}, Тема письма - "Предложение для компании {=Document:TITLE}", Тип описания - 2 (BBCODE), Описание письма - "Предлагаем сотрудничество компании {=Document:TITLE}. [b]Наши преимущества:[/b] качество, надёжность, выгодные условия.", Приоритет - 3 (Высокий), Дата начала - {=System:NowLocal}, Дата завершения - не указывается, Файлы - {=Variable:PROPOSAL_FILE_ID}.

Поиск звонков в сущности

Активити (робот) "Поиск звонков в сущности" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск всех звонков, связанных с конкретной сущностью CRM (контакт, компания, лид);
• Фильтрация звонков по типу (входящий/исходящий), длительности и статусу;
• Поиск звонков за определённый период времени;
• Поиск звонков по номеру телефона клиента или оператора;
• Проверка наличия звонка с определёнными параметрами по ID звонка;
• Поиск звонков в контактах, привязанных к сделке;
• Поиск звонков в компании, привязанной к сделке;
• Аналитика и отчётность по звонкам клиентов;
• Автоматизация процессов на основе истории звонков;
• Проверка условий выполнения звонков для условной логики в бизнес-процессах.

Название поля	Описание и примеры использования
ID звонка (если заполнено, то ID сущности не учитывается)	В данном поле указывается идентификатор звонка для проверки его параметров. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие звонка указанным условиям (тип звонка, длительность, статус). Важно: Если указан ID звонка, активити (робот) работает в режиме проверки условий. Параметры "Тип сущности", "ID Сущности" и все фильтры игнорируются. Результат будет возвращён в параметре conditions (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:CALL_ID} - проверить звонок с ID из переменной предыдущего активити (робота); - 12345 - проверить звонок с ID 12345; - {=A1988_22222_92566_99999:calls_array} - использовать ID звонка из результата предыдущего поиска. Режим проверки условий: При указании ID звонка активити (робот) проверяет соответствие звонка указанным условиям: - Тип звонка (если указан); - Длительность звонка (если указана); - Статус звонка (если указан). Если все указанные условия выполнены, возвращается conditions = Y, иначе conditions = N.
Тип сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск звонков. Это необязательный параметр, используется только если не указан "ID звонка". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка (с ограничениями, см. важное примечание); - CONTACT - Контакт; - COMPANY - Компания; - СМАРТ: [название смарт-процесса] - для поиска звонков в смарт-процессах (список формируется автоматически на основе настроек вашего портала). Примеры: - CONTACT - искать звонки в контактах; - COMPANY - искать звонки в компаниях; - LEAD - искать звонки в лидах. Важно: Из-за архитектуры Битрикс24, данное активити (робот) не осуществляет поиск звонков напрямую в сделках, так как через REST-API связи сделки и звонка нет. Существует связь между делом типа "звонок" и сделкой, но не существует связи между фактически совершенным звонком и сделкой из-за отсутствия номера телефона у сделки. Для поиска звонков, связанных со сделкой, используйте параметры "Искать звонки, в контактах, привязанных к Сделке" или "Искать звонки, в компании, привязанной к Сделке".
Искать звонки, в контактах, привязанных к Сделке	В данном поле можно указать, нужно ли искать звонки в контактах, привязанных к сделке. Это необязательный параметр (варианты: да/нет), используется только если указан тип сущности "DEAL" (Сделка). Варианты выбора: - Да (Y) - искать звонки во всех контактах, привязанных к указанной сделке; - Нет (N) - не искать звонки в контактах сделки. Примеры использования: - Установите "Да" для поиска всех звонков, связанных с контактами сделки; - Используйте вместе с параметром "Искать звонки, в компании, привязанной к Сделке" для комплексного поиска. Важно: Этот параметр работает только при указании типа сущности "DEAL" (Сделка). Если указан "ID звонка", этот параметр игнорируется. Хотя бы один из параметров "Искать звонки, в контактах, привязанных к Сделке" или "Искать звонки, в компании, привязанной к Сделке" должен быть установлен в "Да" при работе со сделками.
Искать звонки, в компании, привязанной к Сделке	В данном поле можно указать, нужно ли искать звонки в компании, привязанной к сделке. Это необязательный параметр (варианты: да/нет), используется только если указан тип сущности "DEAL" (Сделка). Варианты выбора: - Да (Y) - искать звонки в компании, привязанной к указанной сделке; - Нет (N) - не искать звонки в компании сделки. Примеры использования: - Установите "Да" для поиска звонков, связанных с компанией сделки; - Используйте вместе с параметром "Искать звонки, в контактах, привязанных к Сделке" для комплексного поиска. Важно: Этот параметр работает только при указании типа сущности "DEAL" (Сделка). Если указан "ID звонка", этот параметр игнорируется. Хотя бы один из параметров "Искать звонки, в контактах, привязанных к Сделке" или "Искать звонки, в компании, привязанной к Сделке" должен быть установлен в "Да" при работе со сделками.
ID Сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск звонков. Это необязательный параметр, используется только если не указан "ID звонка". Примеры: - {=Document:ID} - искать звонки в текущей сущности из документа (контакт, компания, лид); - 123 - искать звонки в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Особенности работы: - Если указан ID сущности без указания ID звонка, активити (робот) вернёт массив ID найденных звонков; - Если указан ID сущности и ID звонка, ID сущности игнорируется (приоритет у ID звонка); - Для сделок используйте параметры поиска в контактах или компании сделки. Важно: Этот параметр используется только если не указан "ID звонка". Если указан "ID звонка", то этот параметр игнорируется. Для работы этого параметра также рекомендуется указать "Тип сущности".
ID ответившего (звонящего) оператора	В данном поле можно указать идентификатор оператора (пользователя портала), который отвечал на звонок или производил звонок. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - {=Document:ASSIGNED_BY_ID} - искать звонки оператора, ответственного за текущую сущность; - {=User:ID} - искать звонки текущего пользователя; - 25 - искать звонки оператора с ID 25; - [U1] - искать звонки оператора с ID 1 (формат с префиксом); - user_25 - искать звонки оператора с ID 25 (формат user_ID). Когда использовать: - Для фильтрации звонков конкретного оператора; - Для анализа работы конкретного сотрудника; - Для поиска звонков, выполненных определённым пользователем.
Номер на который поступил звонок	В данном поле можно указать номер телефона портала, на который поступил звонок. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - +78124243277 - искать звонки на номер +7 (812) 424-32-77; - 8124243277 - искать звонки на номер без префикса; - {=Variable:PORTAL_NUMBER} - использовать номер из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации звонков по номеру портала; - Для поиска звонков на конкретную линию; - Для анализа звонков на определённые номера.
Номер клиента на который звонили	В данном поле можно указать номер телефона клиента, на который происходил звонок или с которого поступил звонок. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - +79161234567 - искать звонки на номер клиента +7 (916) 123-45-67; - 89161234567 - искать звонки на номер без префикса; - {=Document:PHONE} - использовать номер телефона из текущей сущности; - {=Variable:CLIENT_PHONE} - использовать номер из переменной предыдущего активити (робота). Когда использовать: - Для поиска звонков конкретного клиента; - Для фильтрации звонков по номеру телефона; - Для анализа истории звонков с определённым номером.
Тип звонка	В данном поле можно указать тип искомого звонка: входящий или исходящий. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков или для проверки условий при указании ID звонка. Варианты выбора: - ИСХ (1) - исходящий звонок (звонок от оператора клиенту); - ВХ (2) - входящий звонок (звонок от клиента оператору). Примеры использования: - ИСХ - найти только исходящие звонки; - ВХ - найти только входящие звонки; - При указании ID звонка - проверить, соответствует ли тип звонка указанному значению. Когда использовать: - Для фильтрации звонков по типу (входящие/исходящие); - Для анализа активности операторов (исходящие звонки); - Для анализа входящей активности клиентов (входящие звонки).
Длительность звонка в секундах	В данном поле можно указать минимальную длительность звонка в секундах. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков или для проверки условий при указании ID звонка. Примеры: - 60 - найти звонки длительностью не менее 60 секунд (1 минута); - 300 - найти звонки длительностью не менее 300 секунд (5 минут); - {=Variable:MIN_DURATION} - использовать значение из переменной предыдущего активити (робота); - При указании ID звонка - проверить, соответствует ли длительность звонка указанному значению (точное совпадение). Особенности работы: - При поиске звонков: фильтр работает как "больше или равно" (>=), т.е. найдутся звонки с длительностью >= указанного значения; - При проверке по ID звонка: проверяется точное совпадение длительности (==). Когда использовать: - Для фильтрации коротких звонков (например, пропущенные или неудачные); - Для поиска длительных звонков (например, консультации); - Для проверки длительности конкретного звонка.
Статус звонка	В данном поле можно указать статус звонка, описывающий его состояние (отвечен, пропущен, отклонён и т.д.). Это необязательный параметр, используется как дополнительный фильтр при поиске звонков или для проверки условий при указании ID звонка. Поддерживается множественный выбор (можно указать несколько статусов). Варианты выбора: - 200 - Успешный звонок; - 304 - Пропущенный звонок; - 603 - Отклонено; - 603-S - Вызов отменен; - 403 - Запрещено; - 404 - Неверный номер; - 486 - Занято; - 484 - Данное направление не доступно; - 480 - Временно не доступен; - 402 - Недостаточно средств на счету; - 423 - Заблокировано. Примеры использования: - 200 - найти только успешные звонки; - 304, 603 - найти пропущенные и отклонённые звонки (множественный выбор); - При указании ID звонка - проверить, соответствует ли статус звонка указанному значению. Когда использовать: - Для фильтрации успешных звонков (статус 200); - Для поиска пропущенных звонков (статус 304); - Для анализа неудачных звонков (различные статусы ошибок); - Для проверки статуса конкретного звонка.
Выбрать звонки от указанной даты	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск звонков. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - {=System:NowLocal} - искать звонки с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать звонки за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать звонки за последний месяц; - 01.01.2025 00:00:00 - искать звонки с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска звонков за определённый период; - Для анализа звонков за последние дни/месяцы; - Для фильтрации звонков по дате начала.
Выбрать звонки до указанной даты	В данном поле можно указать дату и время, до которой будет осуществлён поиск звонков. Это необязательный параметр, используется как дополнительный фильтр при поиске звонков. Примеры: - {=System:NowLocal} - искать звонки до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать звонки до завтрашнего дня; - 31.12.2025 23:59:59 - искать звонки до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска звонков за определённый период (в паре с параметром "Выбрать звонки от указанной даты"); - Для анализа звонков до определённой даты; - Для фильтрации звонков по дате окончания периода поиска.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка соответствия звонка условиям по ID	Параметры: ID звонка - {=Variable:CALL_ID}, Тип звонка - ИСХ, Длительность звонка в секундах - 120, Статус звонка - 200. Активити (робот) проверит, соответствует ли звонок указанным условиям. Результат будет возвращён в параметре conditions (Y или N).
Поиск всех звонков контакта за последний месяц	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Выбрать звонки от указанной даты - ={{=dateadd({=System:Now}, "-1m")}}, Выбрать звонки до указанной даты - {=System:NowLocal}. Активити (робот) найдёт все звонки контакта за последний месяц.
Поиск успешных исходящих звонков компании	Параметры: Тип сущности - COMPANY, ID Сущности - {=Document:COMPANY_ID}, Тип звонка - ИСХ, Статус звонка - 200. Активити (робот) найдёт все успешные исходящие звонки компании.
Поиск звонков в контактах сделки	Параметры: Тип сущности - DEAL, ID Сущности - {=Document:ID}, Искать звонки, в контактах, привязанных к Сделке - Да. Активити (робот) найдёт все звонки во всех контактах, привязанных к указанной сделке.
Поиск длительных звонков (более 5 минут)	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Длительность звонка в секундах - 300. Активити (робот) найдёт все звонки контакта длительностью не менее 300 секунд (5 минут).
Поиск пропущенных входящих звонков	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Тип звонка - ВХ, Статус звонка - 304. Активити (робот) найдёт все пропущенные входящие звонки контакта.
Поиск звонков конкретного оператора	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, ID ответившего (звонящего) оператора - {=User:ID}. Активити (робот) найдёт все звонки контакта, выполненные текущим пользователем.
Поиск звонков по номеру телефона клиента	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Номер клиента на который звонили - {=Document:PHONE}. Активити (робот) найдёт все звонки контакта по указанному номеру телефона.
Поиск звонков в компании и контактах сделки	Параметры: Тип сущности - DEAL, ID Сущности - {=Document:ID}, Искать звонки, в контактах, привязанных к Сделке - Да, Искать звонки, в компании, привязанной к Сделке - Да. Активити (робот) найдёт все звонки в контактах и компании, привязанных к сделке.
Поиск звонков за рабочий день	Параметры: Тип сущности - CONTACT, ID Сущности - {=Document:ID}, Выбрать звонки от указанной даты - ={{=date('d.m.Y 09:00:00', {=System:Now})}}, Выбрать звонки до указанной даты - ={{=date('d.m.Y 18:00:00', {=System:Now})}}. Активити (робот) найдёт все звонки контакта за текущий рабочий день (с 9:00 до 18:00).

Поиск писем в сущности

Активити (робот) "Поиск писем" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск всех писем, связанных с конкретной сущностью CRM (контакт, компания, лид, сделка);
• Фильтрация писем по направлению (входящие/исходящие) и статусу;
• Поиск писем за определённый период времени;
• Проверка наличия письма с определёнными параметрами по ID письма;
• Поиск писем в смарт-процессах;
• Проверка статуса прочтения исходящих писем;
• Поиск необработанных входящих писем;
• Аналитика и отчётность по письмам клиентов;
• Автоматизация процессов на основе истории переписки;
• Проверка условий выполнения писем для условной логики в бизнес-процессах.

Название поля	Описание и примеры использования
ID письма	В данном поле указывается идентификатор письма для проверки его параметров. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие письма указанным условиям (направление, статус письма, статус дела). Важно: Если указан ID письма, активити (робот) работает в режиме проверки условий. Параметры "Тип сущности", "ID сущности" и все фильтры игнорируются. Результат будет возвращён в параметре math_search_results (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:LETTER_ID} - проверить письмо с ID из переменной предыдущего активити (робота); - 12345 - проверить письмо с ID 12345; - {=A1988_22222_92566_99999:search_results} - использовать ID письма из результата предыдущего поиска. Режим проверки условий: При указании ID письма активити (робот) проверяет соответствие письма указанным условиям: - Направление письма (обязательно указывается); - Статус письма (для входящих - статус дела, для исходящих - статус прочтения); - Статус дела (выполнено/не выполнено). Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.
Тип сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск писем. Это необязательный параметр, используется только если не указан "ID письма". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка; - CONTACT - Контакт; - COMPANY - Компания; - QUOTE - Предложение; - SMART_INVOICE - Счёт (новый); - ORDER - Заказ; - СМАРТ: [название смарт-процесса] - для поиска писем в смарт-процессах (список формируется автоматически на основе настроек вашего портала). Примеры: - CONTACT - искать письма в контактах; - DEAL - искать письма в сделках; - LEAD - искать письма в лидах. Когда использовать: - Для поиска всех писем конкретной сущности; - Для фильтрации писем по типу сущности перед применением других фильтров.
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск писем. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID письма". Примеры: - {=Document:ID} - искать письма в текущей сущности из документа (контакт, компания, лид, сделка); - 123 - искать письма в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для поиска всех писем конкретной сущности; - Для фильтрации писем по сущности перед применением других фильтров.
Направление письма	В данном поле указывается направление искомого письма: входящее или исходящее. Это обязательный параметр при поиске писем (если не указан ID письма). Варианты выбора: - Входящее (1) - письмо получено от клиента или партнёра; - Исходящее (2) - письмо отправлено клиенту или партнёру. Примеры использования: - Входящее (1) - найти только входящие письма; - Исходящее (2) - найти только исходящие письма. Особенности работы: - Для входящих писем проверяется статус дела (STATUS); - Для исходящих писем проверяется статус прочтения (READ_CONFIRMED в SETTINGS).
Статус письма	В данном поле указывается статус письма для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске писем или для проверки условий при указании ID письма. Варианты выбора: - Прочитано (1) - для исходящих писем: письмо прочитано получателем; - Не прочитано (2) - для исходящих писем: письмо не прочитано получателем; - Для входящих писем: статус дела (значение из поля STATUS). Примеры использования: - Прочитано (1) - найти только прочитанные исходящие письма; - Не прочитано (2) - найти только непрочитанные исходящие письма; - При указании ID письма - проверить, соответствует ли статус письма указанному значению. Особенности работы: - Для исходящих писем проверяется наличие ключа READ_CONFIRMED в SETTINGS; - Для входящих писем проверяется значение поля STATUS.
Статус дела	В данном поле указывается статус дела (выполнено или не выполнено) для фильтрации писем. Это необязательный параметр, используется как дополнительный фильтр при поиске писем или для проверки условий при указании ID письма. Варианты выбора: - Не выполнено (N) - дело не выполнено; - Выполнено (Y) - дело выполнено. Примеры использования: - Не выполнено (N) - найти только невыполненные письма; - Выполнено (Y) - найти только выполненные письма; - При указании ID письма - проверить, соответствует ли статус дела указанному значению. Когда использовать: - Для фильтрации необработанных писем; - Для поиска уже обработанных писем; - Для проверки статуса конкретного письма.
Дата создания от	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск писем. Это необязательный параметр, используется как дополнительный фильтр при поиске писем. Примеры: - {=System:NowLocal} - искать письма с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать письма за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать письма за последний месяц; - 01.01.2025 00:00:00 - искать письма с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска писем за определённый период; - Для анализа писем за последние дни/месяцы; - Для фильтрации писем по дате начала.
Дата создания до	В данном поле можно указать дату и время, до которой будет осуществлён поиск писем. Это необязательный параметр, используется как дополнительный фильтр при поиске писем. Примеры: - {=System:NowLocal} - искать письма до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать письма до завтрашнего дня; - 31.12.2025 23:59:59 - искать письма до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска писем за определённый период (в паре с параметром "Дата создания от"); - Для анализа писем до определённой даты; - Для фильтрации писем по дате окончания периода поиска.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка соответствия письма условиям по ID	Параметры: ID письма - {=Variable:LETTER_ID}, Направление письма - 2 (Исходящее), Статус письма - 1 (Прочитано), Статус дела - Y (Выполнено). Активити (робот) проверит, соответствует ли письмо указанным условиям. Результат будет возвращён в параметре math_search_results (Y или N).
Поиск всех входящих писем контакта	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все входящие письма контакта.
Поиск непрочитанных исходящих писем	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - 2 (Не прочитано), Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все непрочитанные исходящие письма контакта.
Поиск необработанных входящих писем	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - N (Не выполнено), Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все необработанные входящие письма сделки.
Поиск писем за последний месяц	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-1m")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все исходящие письма контакта за последний месяц.
Поиск писем в смарт-процессе	Параметры: Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все входящие письма элемента смарт-процесса.
Поиск прочитанных исходящих писем за рабочий день	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Направление письма - 2 (Исходящее), Статус письма - 1 (Прочитано), Статус дела - не указывается, Дата создания от - ={{=date('d.m.Y 09:00:00', {=System:Now})}}, Дата создания до - ={{=date('d.m.Y 18:00:00', {=System:Now})}}. Активити (робот) найдёт все прочитанные исходящие письма контакта за текущий рабочий день.
Проверка статуса конкретного письма	Параметры: ID письма - {=Variable:LETTER_ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - Y (Выполнено). Активити (робот) проверит, выполнено ли входящее письмо. Результат будет возвращён в параметре math_search_results.
Поиск писем через итератор	Параметры: Тип сущности - CONTACT, ID сущности - {=Iterator:Value}, Направление письма - 2 (Исходящее), Статус письма - не указывается, Статус дела - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Для каждого контакта из итератора активити (робот) найдёт все исходящие письма.
Поиск писем за определённый период с фильтрацией	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Направление письма - 1 (Входящее), Статус письма - не указывается, Статус дела - N (Не выполнено), Дата создания от - ={{=dateadd({=System:Now}, "-30d")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все необработанные входящие письма сделки за последние 30 дней.

Поиск встреч в сущности

Активити (робот) "Поиск встреч" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск всех встреч, связанных с конкретной сущностью CRM (контакт, компания, лид, сделка);
• Фильтрация встреч по ответственному, теме, описанию и месту проведения;
• Поиск встреч за определённый период времени;
• Проверка наличия встречи с определёнными параметрами по ID встречи;
• Поиск встреч в смарт-процессах;
• Проверка статуса встречи (выполнена/не выполнена);
• Поиск невыполненных встреч;
• Аналитика и отчётность по встречам клиентов;
• Автоматизация процессов на основе истории встреч;
• Проверка условий выполнения встреч для условной логики в бизнес-процессах.

Название поля	Описание и примеры использования
ID встречи	В данном поле указывается идентификатор встречи для проверки её параметров. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие встречи указанным условиям (статус встречи). Важно: Если указан ID встречи, активити (робот) работает в режиме проверки условий. Параметры "Тип сущности", "ID сущности" и все фильтры игнорируются. Результат будет возвращён в параметре math_search_results (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:MEETING_ID} - проверить встречу с ID из переменной предыдущего активити (робота); - 12345 - проверить встречу с ID 12345; - {=A1988_22222_92566_99999:search_results} - использовать ID встречи из результата предыдущего поиска. Режим проверки условий: При указании ID встречи активити (робот) проверяет соответствие встречи указанным условиям: - Статус встречи (если указан) - проверяется значение COMPLETED (N - не завершена, Y - завершена). Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.
Ответственный	В данном поле указывается сотрудник, ответственный за встречу. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - {=Document:ASSIGNED_BY_ID} - искать встречи ответственного из текущей сущности; - {=User:ID} - искать встречи текущего пользователя; - [U1] - искать встречи пользователя с ID 1; - user_25 - искать встречи пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации встреч по ответственному при поиске по сущности; - Для поиска всех встреч конкретного сотрудника, связанных с определённой сущностью; - Для анализа работы конкретного сотрудника.
Тип сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск встреч. Это необязательный параметр, используется только если не указан "ID встречи". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка; - CONTACT - Контакт; - COMPANY - Компания; - QUOTE - Предложение; - SMART_INVOICE - Счёт (новый); - ORDER - Заказ; - СМАРТ: [название смарт-процесса] - для поиска встреч в смарт-процессах (список формируется автоматически на основе настроек вашего портала). Примеры: - CONTACT - искать встречи в контактах; - DEAL - искать встречи в сделках; - LEAD - искать встречи в лидах. Когда использовать: - Для поиска всех встреч конкретной сущности; - Для фильтрации встреч по типу сущности перед применением других фильтров.
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск встреч. Это необязательный параметр, используется только если указан "Тип сущности" и не указан "ID встречи". Примеры: - {=Document:ID} - искать встречи в текущей сущности из документа (контакт, компания, лид, сделка); - 123 - искать встречи в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Когда использовать: - Для поиска всех встреч конкретной сущности; - Для фильтрации встреч по сущности перед применением других фильтров.
Статус встречи	В данном поле указывается статус встречи (выполнена или не выполнена) для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч или для проверки условий при указании ID встречи. Варианты выбора: - Не завершена (1) - встреча не завершена (COMPLETED = N); - Завершена (2) - встреча завершена (COMPLETED = Y). Примеры использования: - Не завершена (1) - найти только невыполненные встречи; - Завершена (2) - найти только выполненные встречи; - При указании ID встречи - проверить, соответствует ли статус встречи указанному значению. Когда использовать: - Для фильтрации невыполненных встреч; - Для поиска уже выполненных встреч; - Для проверки статуса конкретной встречи.
Тема встречи	В данном поле можно указать тему (заголовок) встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Презентация продукта - найти встречи с указанной темой; - {=Variable:MEETING_SUBJECT} - использовать тему из переменной предыдущего активити (робота); - Встреча с клиентом - найти встречи, содержащие указанный текст в теме. Когда использовать: - Для поиска встреч по конкретной теме; - Для фильтрации встреч по ключевым словам в теме.
Описание встречи	В данном поле можно указать описание встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Обсуждение условий договора - найти встречи с указанным описанием; - {=Variable:MEETING_DESCRIPTION} - использовать описание из переменной предыдущего активити (робота); - Консультация - найти встречи, содержащие указанный текст в описании. Когда использовать: - Для поиска встреч по содержанию описания; - Для фильтрации встреч по ключевым словам в описании.
Место проведения	В данном поле можно указать место проведения встречи для фильтрации. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч по типу сущности и ID сущности. Примеры: - Офис компании - найти встречи, проводимые в указанном месте; - {=Variable:MEETING_LOCATION} - использовать место из переменной предыдущего активити (робота); - Онлайн - найти встречи, проводимые онлайн. Когда использовать: - Для поиска встреч по месту проведения; - Для фильтрации встреч по локации.
Дата создания от	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск встреч. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч. Примеры: - {=System:NowLocal} - искать встречи с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать встречи за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать встречи за последний месяц; - 01.01.2025 00:00:00 - искать встречи с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска встреч за определённый период; - Для анализа встреч за последние дни/месяцы; - Для фильтрации встреч по дате начала.
Дата создания до	В данном поле можно указать дату и время, до которой будет осуществлён поиск встреч. Это необязательный параметр, используется как дополнительный фильтр при поиске встреч. Примеры: - {=System:NowLocal} - искать встречи до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать встречи до завтрашнего дня; - 31.12.2025 23:59:59 - искать встречи до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска встреч за определённый период (в паре с параметром "Дата создания от"); - Для анализа встреч до определённой даты; - Для фильтрации встреч по дате окончания периода поиска.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка соответствия встречи условиям по ID	Параметры: ID встречи - {=Variable:MEETING_ID}, Статус встречи - 2 (Завершена). Активити (робот) проверит, завершена ли встреча. Результат будет возвращён в параметре math_search_results (Y или N).
Поиск всех встреч контакта	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи контакта.
Поиск невыполненных встреч сделки	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - 1 (Не завершена), Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все невыполненные встречи сделки.
Поиск встреч ответственного за последний месяц	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - {=User:ID}, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-1m")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все встречи текущего пользователя с контактом за последний месяц.
Поиск встреч по теме	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - "Презентация", Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи сделки с указанной темой.
Поиск встреч в смарт-процессе	Параметры: Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Активити (робот) найдёт все встречи элемента смарт-процесса.
Поиск встреч за рабочий день	Параметры: Тип сущности - CONTACT, ID сущности - {=Document:ID}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=date('d.m.Y 09:00:00', {=System:Now})}}, Дата создания до - ={{=date('d.m.Y 18:00:00', {=System:Now})}}. Активити (робот) найдёт все встречи контакта за текущий рабочий день.
Проверка статуса конкретной встречи	Параметры: ID встречи - {=Variable:MEETING_ID}, Статус встречи - 1 (Не завершена). Активити (робот) проверит, не завершена ли встреча. Результат будет возвращён в параметре math_search_results.
Поиск встреч через итератор	Параметры: Тип сущности - CONTACT, ID сущности - {=Iterator:Value}, Ответственный - не указывается, Статус встречи - не указывается, Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - не указывается, Дата создания до - не указывается. Для каждого контакта из итератора активити (робот) найдёт все встречи.
Поиск встреч за определённый период с фильтрацией	Параметры: Тип сущности - DEAL, ID сущности - {=Document:ID}, Ответственный - {=Document:ASSIGNED_BY_ID}, Статус встречи - 1 (Не завершена), Тема встречи - не указывается, Описание встречи - не указывается, Место проведения - не указывается, Дата создания от - ={{=dateadd({=System:Now}, "-30d")}}, Дата создания до - {=System:NowLocal}. Активити (робот) найдёт все невыполненные встречи ответственного по сделке за последние 30 дней.

Поиск визитов в сущности

Активити (робот) "Поиск визитов в сущности" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск визитов, привязанных к конкретной сущности CRM (сделка, лид, контакт, компания);
• Проверка статуса визита по его ID;
• Фильтрация визитов по статусу (выполнено/не выполнено);
• Поиск визитов за определённый период времени;
• Поиск визитов по теме или описанию;
• Поиск визитов в смарт-процессах;
• Проверка соответствия визита определённым условиям;
• Аналитика и отчётность по визитам;
• Автоматизация процессов на основе найденных визитов;
• Проверка наличия визитов перед выполнением операций.

Название поля	Описание и примеры использования
ID визитов (если заполнено, то учитывается только статус)	В данном поле указывается идентификатор визита для проверки его статуса. Это необязательный параметр, но если он указан, то другие параметры поиска (тип сущности, ID сущности и фильтры) не учитываются. Активити (робот) проверит соответствие визита указанным условиям (статус визита). Важно: Если указан ID визита, активити (робот) работает в режиме проверки условий. Параметры "Тип Сущности", "ID сущности" и все фильтры игнорируются. Результат будет возвращён в параметре math_search_results (Y - соответствует условиям, N - не соответствует). Примеры: - {=Variable:VISIT_ID} - проверить визит с ID из переменной предыдущего активити (робота); - 12345 - проверить визит с ID 12345; - {=A1988_22222_92566_99999:search_results_array} - использовать ID визита из результата предыдущего поиска. Режим проверки условий: При указании ID визита активити (робот) проверяет соответствие визита указанным условиям: - Статус визита (если указан) - проверяется соответствие статуса (выполнено/не выполнено). Если все указанные условия выполнены, возвращается math_search_results = Y, иначе math_search_results = N.
Тип Сущности	В данном поле указывается тип сущности CRM, в которой будет осуществлён поиск визитов. Это необязательный параметр, используется только если не указан "ID визитов". Выбирается из выпадающего списка. Варианты выбора: - LEAD - Лид; - DEAL - Сделка; - CONTACT - Контакт; - COMPANY - Компания; - QUOTE - Предложение; - SMART_INVOICE - Счёт; - ORDER - Заказ; - СМАРТ: [название смарт-процесса] - для поиска визитов в смарт-процессах (список формируется автоматически на основе настроек вашего портала, формат: TYPE_ID:OWNER_TYPE_ID). Примеры: - CONTACT - искать визиты в контактах; - COMPANY - искать визиты в компаниях; - DEAL - искать визиты в сделках; - СМАРТ: Заявки - искать визиты в смарт-процессе "Заявки". Важно: Этот параметр используется только если не указан "ID визитов". Если указан "ID визитов", то этот параметр игнорируется. Для работы этого параметра также рекомендуется указать "ID сущности".
ID сущности	В данном поле указывается идентификатор сущности CRM, в которой будет осуществлён поиск визитов. Это необязательный параметр, используется только если не указан "ID визитов". Примеры: - {=Document:ID} - искать визиты в текущей сущности из документа (контакт, компания, лид, сделка); - 123 - искать визиты в сущности с ID 123; - {=Variable:CONTACT_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Особенности работы: - Если указан ID сущности без указания ID визита, активити (робот) вернёт массив ID найденных визитов; - Если указан ID сущности и ID визита, ID сущности игнорируется (приоритет у ID визита); - Для работы этого параметра рекомендуется указать "Тип Сущности".
Статус визита	В данном поле можно указать статус визита для фильтрации результатов или для проверки условий при указании ID визита. Это необязательный параметр. Варианты выбора: - Не завершена (1) - визит не выполнен (COMPLETED = N); - Завершена (2) - визит выполнен (COMPLETED = Y). Примеры использования: - Не завершена (1) - найти только невыполненные визиты; - Завершена (2) - найти только выполненные визиты; - При указании ID визита - проверить, соответствует ли статус визита указанному значению. Когда использовать: - Для фильтрации визитов по статусу при поиске в сущности; - Для проверки статуса конкретного визита при указании ID визита; - Для анализа выполненных или невыполненных визитов.
Выбрать визиты от указанной даты	В данном поле можно указать дату и время, начиная с которой будет осуществлён поиск визитов. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - {=System:NowLocal} - искать визиты с текущей даты и времени; - ={{=dateadd({=System:Now}, "-7d")}} - искать визиты за последние 7 дней; - ={{=dateadd({=System:Now}, "-1m")}} - искать визиты за последний месяц; - 01.01.2025 00:00:00 - искать визиты с указанной даты; - {=Variable:START_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска визитов за определённый период; - Для анализа визитов за последние дни/месяцы; - Для фильтрации визитов по дате создания.
Выбрать визиты до указанной даты	В данном поле можно указать дату и время, до которой будет осуществлён поиск визитов. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - {=System:NowLocal} - искать визиты до текущей даты и времени; - ={{=dateadd({=System:Now}, "1d")}} - искать визиты до завтрашнего дня; - 31.12.2025 23:59:59 - искать визиты до указанной даты; - {=Variable:END_DATE} - использовать дату из переменной предыдущего активити (робота). Когда использовать: - Для поиска визитов за определённый период (в паре с параметром "Выбрать визиты от указанной даты"); - Для анализа визитов до определённой даты; - Для фильтрации визитов по дате окончания периода поиска.
Тема визита содержит	В данном поле можно указать текст, который должен содержаться в теме визита. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - Важное - найти визиты, тема которых содержит слово "Важное"; - Консультация - найти визиты, тема которых содержит слово "Консультация"; - {=Variable:SEARCH_TEXT} - использовать текст из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации визитов по теме; - Для поиска визитов с определёнными ключевыми словами в теме; - Для анализа визитов по тематике.
Содержание визита содержит	В данном поле можно указать текст, который должен содержаться в описании визита. Это необязательный параметр, используется как дополнительный фильтр при поиске визитов. Примеры: - Демонстрация - найти визиты, описание которых содержит слово "Демонстрация"; - Продукт - найти визиты, описание которых содержит слово "Продукт"; - {=Variable:SEARCH_TEXT} - использовать текст из переменной предыдущего активити (робота). Когда использовать: - Для фильтрации визитов по содержанию; - Для поиска визитов с определёнными ключевыми словами в описании; - Для анализа визитов по содержанию.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Проверка статуса визита по ID	Параметры: ID визитов - {=Variable:VISIT_ID}, Статус визита - Завершена (2). Активити (робот) проверит, является ли визит выполненным. Результат будет возвращён в параметре math_search_results (Y или N).
Поиск всех визитов контакта	Параметры: Тип Сущности - CONTACT, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты контакта.
Поиск выполненных визитов сделки	Параметры: Тип Сущности - DEAL, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - Завершена (2), Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все выполненные визиты сделки.
Поиск визитов за последний месяц	Параметры: Тип Сущности - CONTACT, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - ={{=dateadd({=System:Now}, "-1m")}}, Выбрать визиты до указанной даты - {=System:NowLocal}, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты контакта за последний месяц.
Поиск визитов по теме	Параметры: Тип Сущности - COMPANY, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - Консультация, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты компании, тема которых содержит слово "Консультация".
Поиск невыполненных визитов за период	Параметры: Тип Сущности - DEAL, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - Не завершена (1), Выбрать визиты от указанной даты - ={{=dateadd({=System:Now}, "-7d")}}, Выбрать визиты до указанной даты - {=System:NowLocal}, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все невыполненные визиты сделки за последние 7 дней.
Поиск визитов через итератор	Параметры: Тип Сущности - CONTACT, ID сущности - {=Iterator:Value}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Для каждого ID контакта из итератора активити (робот) найдёт все визиты этого контакта.
Поиск визитов смарт-процесса	Параметры: Тип Сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - не указывается. Активити (робот) найдёт все визиты, привязанные к указанному элементу смарт-процесса "Заявки".
Поиск визитов по содержанию	Параметры: Тип Сущности - CONTACT, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - не указывается, Выбрать визиты от указанной даты - не указывается, Выбрать визиты до указанной даты - не указывается, Тема визита содержит - не указывается, Содержание визита содержит - Демонстрация. Активити (робот) найдёт все визиты контакта, описание которых содержит слово "Демонстрация".
Комплексный поиск визитов	Параметры: Тип Сущности - DEAL, ID сущности - {=Document:ID}, ID визитов - не указывается, Статус визита - Завершена (2), Выбрать визиты от указанной даты - ={{=dateadd({=System:Now}, "-30d")}}, Выбрать визиты до указанной даты - {=System:NowLocal}, Тема визита содержит - Важное, Содержание визита содержит - не указывается. Активити (робот) найдёт все выполненные визиты сделки за последние 30 дней, тема которых содержит слово "Важное".

Парсинг содержимого дела

Активити (робот) "Парсинг содержимого дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Извлечение конкретных данных из темы или описания дела;
• Парсинг номеров документов, сумм, дат и других данных из текста дела;
• Извлечение слов до или после указанного слова;
• Извлечение содержимого между двумя словами;
• Поиск и извлечение чисел из текста дела;
  
• Автоматическое извлечение данных для заполнения полей сущностей CRM;
• Парсинг данных из писем, звонков и других дел;
• Обработка структурированных данных в тексте дела;
• Извлечение информации для аналитики и отчётности;
• Автоматизация обработки данных из внешних источников.

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, содержимое которого нужно распарсить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - распарсить дело с ID из переменной предыдущего активити (робота); - 123 - распарсить дело с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - распарсить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - распарсить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует, активити (робот) завершится с ошибкой. Всегда проверяйте существование дела перед парсингом.
Парсинг темы дела	В данном поле указываются правила парсинга для темы (заголовка) дела. Это необязательный параметр, поддерживается множественный выбор (до 10 правил). Каждое правило имеет формат: "ТИП_ПАРСИНГА##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2". Типы парсинга: - 1##РАЗДЕЛИТЕЛЬ - получить слово до указанного разделителя (предыдущее слово); - 2##РАЗДЕЛИТЕЛЬ - получить слово после указанного разделителя (следующее слово); - 3##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2 - получить содержимое между двумя разделителями; - 4##КЛЮЧЕВОЕ_СЛОВО - найти и извлечь число из слова, содержащего ключевое слово. Примеры: - 1##Сделка - получить слово перед словом "Сделка" (например, из "Новая Сделка 123" получится "Новая"); - 2##№ - получить слово после символа "№" (например, из "Сделка №123" получится "123"); - 3##от##руб - получить содержимое между словами "от" и "руб" (например, из "Сумма от 10000 руб" получится "10000"); - 4##сумма - найти и извлечь число из слова, содержащего "сумма" (например, из "сумма12345" получится "12345"). Когда использовать: - Для извлечения данных из структурированных тем дел; - Для парсинга номеров, сумм и других данных из заголовка дела; - Для извлечения ключевой информации из темы дела.
Парсинг описания дела	В данном поле указываются правила парсинга для описания (содержания) дела. Это необязательный параметр, поддерживается множественный выбор (до 10 правил). Каждое правило имеет формат: "ТИП_ПАРСИНГА##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2". Типы парсинга: - 1##РАЗДЕЛИТЕЛЬ - получить слово до указанного разделителя (предыдущее слово); - 2##РАЗДЕЛИТЕЛЬ - получить слово после указанного разделителя (следующее слово); - 3##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2 - получить содержимое между двумя разделителями; - 4##КЛЮЧЕВОЕ_СЛОВО - найти и извлечь число из слова, содержащего ключевое слово. Примеры: - 1##Сумма - получить слово перед словом "Сумма" (например, из "Общая Сумма 50000" получится "Общая"); - 2##: - получить слово после двоеточия (например, из "Номер: 12345" получится "12345"); - 3##от##до - получить содержимое между словами "от" и "до" (например, из "Период от 01.01.2025 до 31.01.2025" получится "01.01.2025"); - 4##цена - найти и извлечь число из слова, содержащего "цена" (например, из "цена1000" получится "1000"). Когда использовать: - Для извлечения данных из структурированных описаний дел; - Для парсинга данных из писем, звонков и других дел; - Для извлечения информации из текста дела для дальнейшей обработки.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Извлечение номера сделки из темы дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (получить слово после "№"), Парсинг описания дела - не указывается. Если тема дела "Сделка №12345", активити (робот) извлечёт "12345" в параметр found_result_1.
Извлечение суммы из описания дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 3##Сумма:##руб (получить содержимое между "Сумма:" и "руб"). Если описание "Общая Сумма: 50000 руб", активити (робот) извлечёт "50000" в параметр found_result_1.
Извлечение нескольких данных из темы	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№, 2##от (два правила: получить слово после "№" и после "от"), Парсинг описания дела - не указывается. Если тема "Сделка №123 от 01.01.2025", активити (робот) извлечёт "123" в found_result_1 и "01.01.2025" в found_result_2.
Извлечение числа из слова с ключевым словом	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 4##сумма (найти число в слове, содержащем "сумма"), Парсинг описания дела - не указывается. Если тема содержит "сумма12345" или "сумма_12345", активити (робот) извлечёт "12345" в параметр found_result_1.
Извлечение данных между разделителями	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 3##от##до (получить содержимое между "от" и "до"). Если описание "Период от 01.01.2025 до 31.01.2025", активити (робот) извлечёт "01.01.2025" в параметр found_result_1.
Извлечение слова до указанного разделителя	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 1##Сделка (получить слово перед "Сделка"), Парсинг описания дела - не указывается. Если тема "Новая Сделка 123", активити (робот) извлечёт "Новая" в параметр found_result_1.
Комплексный парсинг темы и описания	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (получить номер после "№"), Парсинг описания дела - 3##Сумма:##руб, 2##Дата: (получить сумму и дату из описания). Активити (робот) извлечёт номер в found_result_1, сумму в found_result_1 (из описания), дату в found_result_2 (из описания).
Парсинг через итератор	Параметры: ID дела - {=Iterator:Value}, Парсинг темы дела - 2##№, Парсинг описания дела - 3##Сумма:##руб. Для каждого дела из итератора активити (робот) извлечёт номер и сумму.
Извлечение данных для заполнения полей	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (номер сделки), Парсинг описания дела - 3##Сумма:##руб (сумма сделки). Используйте найденные значения для заполнения полей сущности CRM через активити (робот) "Изменение дела" или другие активити.
Парсинг структурированных данных	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 2##Номер:, 2##Телефон:, 2##Email: (извлечь номер, телефон и email из структурированного описания). Активити (робот) извлечёт все указанные данные в отдельные параметры.

Слежение за делом

Активити (робот) "Слежение за делом" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое отслеживание создания дел, привязанных к сущности CRM;
• Автоматическое отслеживание обновления дел, привязанных к сущности CRM;
• Реагирование на события создания или изменения дел в бизнес-процессах;
• Фильтрация отслеживаемых дел по типу (звонок, письмо, встреча и т.д.);
• Фильтрация отслеживаемых дел по направлению (входящие/исходящие);
• Автоматизация процессов при создании или изменении дел;
• Отслеживание дел в смарт-процессах;
• Мониторинг активности по сущностям CRM;
• Автоматическое выполнение действий при изменении дел;
• Интеграция с внешними системами на основе событий дел.

Название поля	Описание и примеры использования
Тип CRM сущности	В данном поле указывается тип сущности CRM, за делами которой нужно следить. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для отслеживания дел, привязанных к лидам; - Сделка (D) - для отслеживания дел, привязанных к сделкам; - Контакт (C) - для отслеживания дел, привязанных к контактам; - Компания (CO) - для отслеживания дел, привязанных к компаниям; - Предложение (Q) - для отслеживания дел, привязанных к предложениям; - Заказ (O) - для отслеживания дел, привязанных к заказам; - Счёт (SI) - для отслеживания дел, привязанных к счетам; - СМАРТ: [название смарт-процесса] - для отслеживания дел, привязанных к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - отслеживать дела, привязанные к сделкам; - Контакт (C) - отслеживать дела, привязанные к контактам; - СМАРТ: Заявки - отслеживать дела, привязанные к смарт-процессу "Заявки". Важно: Для смарт-процессов используется формат TYPE_ID:OWNER_TYPE_ID (например, 1:135), где TYPE_ID - тип дела, OWNER_TYPE_ID - ID типа сущности смарт-процесса.
ID CRM сущности	В данном поле указывается идентификатор сущности CRM, за делами которой нужно следить. Это обязательный параметр. Примеры: - {=Document:ID} - следить за делами текущей сущности из документа (сделка, лид, контакт, компания); - 123 - следить за делами сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
Тип дела	В данном поле указываются типы дел, за которыми нужно следить. Это обязательный параметр, поддерживается множественный выбор. Можно выбрать несколько типов дел одновременно. Варианты выбора: - Универсальное (CRM_TODO) - универсальные дела; - Встреча (CRM_MEETING) - дела типа "Встреча"; - Звонок (VOXIMPLANT_CALL) - дела типа "Звонок"; - Письмо (CRM_EMAIL) - дела типа "Письмо"; - Задачи (TASKS) - задачи (старые дела для обратной совместимости); - Задача (новая) (CRM_TASKS_TASK) - задачи в новой реализации; - Чат (IMOPENLINES_SESSION) - дела типа "Чат"; - Обзвон (CALL_LIST) - дела типа "Обзвон"; - SMS (CRM_SMS) - дела типа "SMS"; - CRM форма (CRM_WEBFORM) - дела типа "CRM форма"; - Визит (VISIT_TRACKER) - дела типа "Визит"; - Слоты (CRM_CALENDAR_SHARING) - дела типа "Слоты"; - Доставка (CRM_DELIVERY) - дела типа "Доставка"; - Документ подписания (CRM_SIGN_DOCUMENT) - дела типа "Документ подписания"; - Сообщение в WhatsApp через ЕЦУ (CRM_NOTIFICATION) - дела типа "Сообщение в WhatsApp"; - Оплата (CRM_PAYMENT) - дела типа "Оплата"; - Дело бизнес-процесса (CRM_BIZPROC_WORKFLOW) - дела типа "Дело бизнес-процесса"; - И другие типы дел. Примеры использования: - Звонок - отслеживать только дела типа "Звонок"; - Письмо - отслеживать только дела типа "Письмо"; - Звонок, Письмо, Встреча - отслеживать несколько типов дел одновременно (множественный выбор). Когда использовать: - Для фильтрации отслеживаемых дел по типу; - Для отслеживания только определённых типов дел; - Для настройки гибкого мониторинга различных типов активности.
Направление дела	В данном поле указывается направление дел, за которыми нужно следить: входящие или исходящие. Это необязательный параметр, поддерживается множественный выбор. Используется для фильтрации событий по направлению дел. Варианты выбора: - Входящее (1) - отслеживать только входящие дела (полученные от клиентов или партнёров); - Исходящее (2) - отслеживать только исходящие дела (отправленные клиентам или партнёрам). Примеры использования: - Входящее (1) - отслеживать только входящие дела; - Исходящее (2) - отслеживать только исходящие дела; - Входящее, Исходящее - отслеживать дела обоих направлений (множественный выбор). Когда использовать: - Для фильтрации отслеживаемых дел по направлению; - Для отслеживания только входящей или только исходящей активности; - Для настройки различных процессов для разных направлений дел.
На какое событие реагировать	В данном поле указываются события, на которые нужно реагировать. Это обязательный параметр, поддерживается множественный выбор. Можно выбрать одно или оба события одновременно. Варианты выбора: - Создание дела (onCrmActivityAdd) - реагировать на создание нового дела; - Обновление дела (onCrmActivityUpdate) - реагировать на обновление существующего дела. Примеры использования: - Создание дела - реагировать только на создание новых дел; - Обновление дела - реагировать только на обновление существующих дел; - Создание дела, Обновление дела - реагировать на оба события (множественный выбор). Когда использовать: - Для отслеживания только создания новых дел; - Для отслеживания только изменений существующих дел; - Для отслеживания всех изменений дел (создание и обновление).
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Отслеживание создания всех дел по сделке	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание всех дел, привязанных к указанной сделке.
Отслеживание только звонков контакта	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Document:ID}, Тип дела - Звонок (VOXIMPLANT_CALL), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать создание и обновление только звонков, привязанных к указанному контакту.
Отслеживание входящих писем сделки	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - Письмо (CRM_EMAIL), Направление дела - Входящее (1), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание только входящих писем, привязанных к указанной сделке.
Отслеживание обновления встреч	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Document:ID}, Тип дела - Встреча (CRM_MEETING), Направление дела - не указывается (все направления), На какое событие реагировать - Обновление дела. Активити (робот) будет отслеживать обновление встреч, привязанных к указанному контакту.
Отслеживание дел в смарт-процессе	Параметры: Тип CRM сущности - СМАРТ: Заявки, ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание всех дел, привязанных к указанному элементу смарт-процесса.
Отслеживание нескольких типов дел	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - Звонок (VOXIMPLANT_CALL), Письмо (CRM_EMAIL), Встреча (CRM_MEETING) (множественный выбор), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Активити (робот) будет отслеживать создание звонков, писем и встреч, привязанных к указанной сделке.
Отслеживание исходящих дел	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - Исходящее (2), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать создание и обновление только исходящих дел, привязанных к указанному контакту.
Отслеживание всех изменений дел	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать все изменения дел (создание и обновление), привязанных к указанной сделке.
Отслеживание через итератор	Параметры: Тип CRM сущности - Контакт (C), ID CRM сущности - {=Iterator:Value}, Тип дела - не указывается (все типы), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела. Для каждого контакта из итератора активити (робот) настроит отслеживание создания дел.
Отслеживание только задач	Параметры: Тип CRM сущности - Сделка (D), ID CRM сущности - {=Document:ID}, Тип дела - Задача (новая) (CRM_TASKS_TASK), Направление дела - не указывается (все направления), На какое событие реагировать - Создание дела, Обновление дела. Активити (робот) будет отслеживать создание и обновление только задач, привязанных к указанной сделке.

Запланировать звонок

Активити (робот) "Запланировать звонок" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое планирование звонков клиентам;
• Создание запланированных звонков при изменении статуса сделки или лида;
• Планирование звонков на основе данных из внешних систем;
• Автоматическое создание звонков при поступлении заявок;
• Планирование звонков с автоматическим определением номера телефона;
• Создание звонков, привязанных к сделке с автоматическим определением контакта или компании;
• Автоматизация планирования звонков для менеджеров;
• Создание звонков с указанием даты и времени;
• Планирование звонков с приоритетом;
• Автоматическое создание звонков при выполнении определённых условий.

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязан создаваемый звонок. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (1) - для привязки звонка к лиду; - Контакт (3) - для привязки звонка к контакту; - Компания (4) - для привязки звонка к компании. Примеры использования: - Лид (1) - для создания звонка, привязанного к лиду; - Контакт (3) - для создания звонка, привязанного к контакту; - Компания (4) - для создания звонка, привязанного к компании. Важно: Если указан параметр "ID сделки", то параметр "Тип сущности" используется только для определения типа сущности, из которой будет взят номер телефона (контакт или компания сделки).
ID Сущности	В данном поле указывается числовой идентификатор (ID) сущности, к которой будет привязан создаваемый звонок. Это обязательный параметр, используется только если не указан параметр "ID сделки". Примеры: - {=Document:ID} - привязать звонок к текущей сущности из документа (лид, контакт, компания); - 123 - привязать звонок к сущности с ID 123; - {=Variable:LEAD_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
ID сделки	В данном поле можно указать идентификатор сделки, к которой будет привязан создаваемый звонок. Это необязательный параметр. Если указан, то звонок будет привязан к сделке, а номер телефона будет взят из контакта или компании, привязанных к сделке. Примеры: - {=Document:ID} - привязать звонок к текущей сделке из документа; - 123 - привязать звонок к сделке с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска. Особенности работы: - Если указан ID сделки, звонок будет привязан к сделке, а не к указанной сущности; - Номер телефона будет автоматически взят из контакта или компании, привязанных к сделке (в зависимости от типа сущности); - Если у сделки нет привязанного контакта или компании, активити (робот) завершится с ошибкой. Важно: Если указан ID сделки, то параметр "ID Сущности" игнорируется. Номер телефона будет взят из контакта или компании сделки в зависимости от типа сущности. Если у сделки нет привязанного контакта (для типа "Контакт") или компании (для типа "Компания"), активити (робот) завершится с ошибкой.
Телефон	В данном поле можно указать номер телефона для звонка. Это необязательный параметр. Если не указан, номер телефона будет автоматически взят из сущности (лид, контакт, компания) или из контакта/компании сделки. Примеры: - +79161234567 - указать номер телефона напрямую; - 89161234567 - указать номер без префикса; - {=Document:PHONE} - использовать номер телефона из текущей сущности; - {=Variable:PHONE_NUMBER} - использовать номер из переменной предыдущего активити (робота). Особенности работы: - Если номер телефона указан, он будет использован напрямую; - Если номер телефона не указан, активити (робот) автоматически возьмёт номер из сущности: * Для лида - из поля PHONE лида; * Для контакта - из поля PHONE контакта; * Для компании - из поля PHONE компании; * Для сделки - из поля PHONE контакта или компании сделки (в зависимости от типа сущности). Важно: Если номер телефона не указан и не найден в сущности, активити (робот) завершится с ошибкой "Отсутствует номер телефона".
Тема	В данном поле указывается тема (заголовок) звонка. Это обязательный параметр. Примеры: - Звонок клиенту по сделке #{=Document:ID}; - Консультация по продукту; - Напоминание о встрече; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к теме из переменной. Рекомендации: - Используйте информативные темы, которые помогут быстро понять суть звонка; - Можно включать переменные и поля из текущей сущности для персонализации.
Описание	В данном поле указывается описание и содержание звонка. Это обязательный параметр. Примеры: - Необходимо обсудить условия сделки и ответить на вопросы клиента.; - Провести консультацию по продукту. Клиент заинтересован в функциях X и Y.; - Напомнить о предстоящей встрече и уточнить детали.; - ={{={=Variable:DESCRIPTION} & "[br]Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных с форматированием. Рекомендации: - Используйте подробные описания для лучшего понимания цели звонка; - Можно включать переменные и поля из текущей сущности для персонализации.
Ответственный	В данном поле указывается сотрудник, ответственный за выполнение звонка. Это обязательный параметр. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственным ответственного из текущей сущности; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Рекомендации: - Используйте ответственного из текущей сущности для автоматического назначения; - Можно назначать конкретного сотрудника для специализированных звонков.
Приоритет	В данном поле можно указать приоритет звонка. Это необязательный параметр (варианты: да/нет). Варианты выбора: - Нет (N) - обычный приоритет; - Да (Y) - высокий приоритет (важный звонок). Примеры использования: - Нет (N) - для обычных звонков; - Да (Y) - для важных звонков, требующих срочного выполнения. Рекомендации: - Используйте высокий приоритет только для действительно важных звонков; - Высокоприоритетные звонки выделяются в интерфейсе CRM.
Дата начала	В данном поле можно указать дату и время начала звонка. Это необязательный параметр. Если не указано, дата начала не будет установлена. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "1d")}} - установить дату начала через 1 день от текущего момента; - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}} - установить дату начала через 2 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:BEGINDATE}, "1h")}} - установить дату начала через 1 час от даты начала сделки; - 15.01.2025 10:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта времени начала; - Учитывайте рабочие дни и часы при планировании звонков.
Дата завершения	В данном поле можно указать дату и время завершения звонка. Это необязательный параметр. Если не указано, дата завершения не будет установлена. Примеры: - ={{=dateadd({=System:Now}, "30m")}} - установить дату завершения через 30 минут от текущего момента (типичная длительность звонка); - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}} - установить дату завершения через 1 рабочий день с учётом рабочего времени ответственного; - ={{=dateadd({=Variable:DATE_START}, "1h")}} - установить дату завершения через 1 час от даты начала (из переменной); - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить дату завершения на 1 день раньше даты закрытия сделки; - 15.01.2025 10:30:00 - указать конкретную дату и время завершения. Рекомендации: - Дата завершения должна быть позже даты начала; - Используйте функции работы с датами для автоматического расчёта времени завершения; - Типичная длительность звонка составляет 15-30 минут.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Планирование звонка лиду	Параметры: Тип сущности - Лид (1), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается (будет взят из лида), Тема - "Звонок по заявке #{=Document:ID}", Описание - "Необходимо связаться с клиентом для уточнения деталей заявки", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "1d 30m")}}.
Планирование звонка контакту с указанием номера	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - +79161234567, Тема - "Консультация по продукту", Описание - "Провести консультацию по продукту и ответить на вопросы клиента", Ответственный - {=User:ID}, Приоритет - Да (Y), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.
Планирование звонка по сделке с автоматическим определением контакта	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:CONTACT_ID}, ID сделки - {=Document:ID}, Телефон - не указывается (будет взят из контакта сделки), Тема - "Звонок по сделке #{=Document:ID}", Описание - "Обсудить условия сделки и ответить на вопросы клиента", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование звонка компании	Параметры: Тип сущности - Компания (4), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается (будет взят из компании), Тема - "Звонок в компанию {=Document:TITLE}", Описание - "Связаться с компанией для обсуждения сотрудничества", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Да (Y), Дата начала - ={{=dateadd({=System:Now}, "2d")}}, Дата завершения - ={{=dateadd({=System:Now}, "2d 30m")}}.
Планирование звонка по сделке с автоматическим определением компании	Параметры: Тип сущности - Компания (4), ID Сущности - {=Document:COMPANY_ID}, ID сделки - {=Document:ID}, Телефон - не указывается (будет взят из компании сделки), Тема - "Звонок по сделке #{=Document:ID}", Описание - "Обсудить условия сделки с представителем компании", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование срочного звонка	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается, Тема - "Срочный звонок клиенту", Описание - "Необходимо срочно связаться с клиентом", Ответственный - {=User:ID}, Приоритет - Да (Y), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.
Планирование звонка через итератор	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Iterator:Value}, ID сделки - не указывается, Телефон - не указывается, Тема - "Звонок контакту #{=Iterator:Value}", Описание - "Связаться с контактом для обсуждения", Ответственный - {=User:ID}, Приоритет - Нет (N), Дата начала - ={{=dateadd({=System:Now}, "1d")}}, Дата завершения - ={{=dateadd({=System:Now}, "1d 30m")}}. Для каждого контакта из итератора будет создан запланированный звонок.
Планирование звонка с указанием конкретного времени	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - не указывается, Тема - "Запланированный звонок", Описание - "Звонок запланирован на конкретное время", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Нет (N), Дата начала - 15.01.2025 10:00:00, Дата завершения - 15.01.2025 10:30:00.
Планирование звонка при изменении статуса сделки	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:CONTACT_ID}, ID сделки - {=Document:ID}, Телефон - не указывается, Тема - "Звонок по сделке в статусе '{=Document:STAGE_ID}'", Описание - "Сделка переведена в новый статус. Необходимо связаться с клиентом", Ответственный - {=Document:ASSIGNED_BY_ID}, Приоритет - Да (Y), Дата начала - ={{=workdateadd({=System:Now}, "1d", {=Document:ASSIGNED_BY_ID})}}, Дата завершения - ={{=workdateadd({=System:Now}, "1d 30m", {=Document:ASSIGNED_BY_ID})}}.
Планирование звонка с номером из переменной	Параметры: Тип сущности - Контакт (3), ID Сущности - {=Document:ID}, ID сделки - не указывается, Телефон - {=Variable:PHONE_NUMBER}, Тема - "Звонок на указанный номер", Описание - "Связаться с клиентом по указанному номеру телефона", Ответственный - {=User:ID}, Приоритет - Нет (N), Дата начала - {=System:NowLocal}, Дата завершения - ={{=dateadd({=System:Now}, "30m")}}.

Универсальные дела

Добавление дела

Активити (робот) "Добавление дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое создание универсальных дел при изменении статуса сделки или лида;
• Создание напоминаний и задач для ответственных сотрудников;
• Автоматизация планирования дел на основе данных из других сущностей CRM;
• Создание дел с напоминаниями о важных событиях и дедлайнах;
• Планирование дел с привязкой к сделкам, контактам, компаниям или смарт-процессам;
• Автоматическое создание дел для контроля выполнения обязательств;
• Создание дел с цветовой маркировкой для визуального разделения;
• Автоматизация создания дел при интеграции с внешними системами;
• Создание дочерних дел, связанных с родительским делом в таймлайне;
• Планирование регулярных дел и напоминаний с настройкой времени уведомлений.

Название поля	Описание и примеры использования
Тип сущности	В данном поле указывается тип сущности, к которой будет привязано создаваемое дело. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для привязки дела к лиду; - Сделка (D) - для привязки дела к сделке; - Контакт (C) - для привязки дела к контакту; - Компания (CO) - для привязки дела к компании; - Предложение (Q) - для привязки дела к предложению; - Заказ (O) - для привязки дела к заказу; - Счёт (SI) - для привязки дела к счету; - СМАРТ: [название смарт-процесса] - для привязки дела к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - создать дело, привязанное к сделке; - Контакт (C) - создать дело, привязанное к контакту; - СМАРТ: Заявки - создать дело, привязанное к смарт-процессу "Заявки". Когда использовать: - Для создания дел, связанных с конкретной сущностью CRM; - Для планирования задач по работе с клиентами и сделками; - Для автоматизации создания дел при работе со смарт-процессами.
ID сущности	В данном поле указывается идентификатор сущности CRM, к которой будет привязано создаваемое дело. Это обязательный параметр. Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой.
Срок выполнения	В данном поле указывается дата и время, до которого должно быть выполнено дело. Это обязательный параметр. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "3d")}} - установить срок выполнения через 3 дня от текущего момента; - ={{=workdateadd({=System:Now}, "5d", {=Document:ASSIGNED_BY_ID})}} - установить срок выполнения через 5 рабочих дней с учётом рабочего времени ответственного; - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}} - установить срок выполнения на 1 день раньше даты закрытия сделки; - 20.01.2025 18:00:00 - указать конкретную дату и время. Рекомендации: - Используйте функции работы с датами для автоматического расчёта дедлайнов; - Учитывайте рабочие дни и часы при планировании дел; - Срок выполнения используется для отображения дела в календаре и для напоминаний.
Заголовок дела	В данном поле указывается текстовый заголовок создаваемого дела. Это необязательный параметр. Примеры: - Позвонить клиенту; - Подготовить коммерческое предложение для сделки #{=Document:ID}; - Встреча с {=Document:COMPANY_TITLE} - {=Variable:MEETING_DATE}; - Напоминание: оплата по сделке {=Document:TITLE}; - ={{={=Variable:SUBJECT} & " - Дополнительная информация"}} - добавить информацию к заголовку из переменной. Рекомендации: - Используйте информативные заголовки, которые помогут быстро понять суть дела; - Можно включать переменные и поля из текущей сущности для персонализации; - Если заголовок не указан, дело будет создано без заголовка.
Описание дела	В данном поле указывается подробное описание создаваемого дела. Это необязательный параметр. Примеры: - Необходимо связаться с клиентом для уточнения деталей сделки; - Проверить документы по сделке #{=Document:ID}. Сумма: {=Document:OPPORTUNITY} руб.; - Подготовить договор для компании {=Document:COMPANY_TITLE}. Контактное лицо: {=Document:CONTACT_NAME}; - ={{={=Variable:DESCRIPTION} & " Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - объединить несколько переменных; - Связаться с клиентом по телефону {=Document:PHONE} для подтверждения встречи. Когда использовать: - Для добавления подробной информации о задаче; - Для указания инструкций по выполнению дела; - Для добавления контекстной информации из других полей сущности.
Ответственный	В данном поле указывается сотрудник, который должен выполнить дело. Это необязательный параметр. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственным сотрудника из текущей сущности; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для назначения конкретного сотрудника на выполнение задачи; - Для автоматического назначения ответственного на основе данных сущности; - Если ответственный не указан, дело будет создано без назначения.
Напоминания (минуты до дедлайна)	В данном поле указывается время до дедлайна (в минутах), когда нужно отправить напоминание о предстоящем деле. Это необязательный параметр. Можно указать несколько значений через запятую для множественных напоминаний. Примеры: - 60 - напомнить за 60 минут до дедлайна (1 час); - 1440 - напомнить за 1440 минут до дедлайна (1 день); - 5, 30, 60 - напомнить за 5 минут, за 30 минут и за 1 час до дедлайна; - {=Variable:REMINDER_MINUTES} - использовать значение из переменной предыдущего активити (робота). Особенности работы: - Значения указываются в минутах до дедлайна (срока выполнения); - Можно указать несколько значений через запятую для множественных напоминаний; - Напоминания отправляются автоматически системой Битрикс24; - Если напоминания не указаны, уведомления не будут отправлены. Когда использовать: - Для настройки автоматических напоминаний о предстоящих делах; - Для множественных напоминаний (например, за день и за час до дедлайна); - Для контроля выполнения важных задач.
Цвет дела	В данном поле указывается цвет для визуальной маркировки дела в календаре и списке дел. Это необязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Жёлтый (0) - жёлтый цвет; - Синий (1) - синий цвет; - Бирюзовый (2) - бирюзовый цвет; - Оранжевый (3) - оранжевый цвет; - Зелёный (4) - зелёный цвет; - Фиолетовый (5) - фиолетовый цвет; - Серый (6) - серый цвет; - Красный (7) - красный цвет. Примеры использования: - Красный - для срочных и важных дел; - Зелёный - для выполненных или успешных дел; - Жёлтый - для стандартных дел; - Синий - для дел, требующих внимания. Когда использовать: - Для визуального разделения дел по категориям или приоритетам; - Для быстрой идентификации типа дел в календаре; - Если цвет не указан, дело будет создано без цветовой маркировки.
Идентификатор дела в таймлайне, с которым можно связать создаваемое дело	В данном поле указывается ID родительского дела в таймлайне, с которым нужно связать создаваемое дело. Это необязательный параметр. Если указан, создаваемое дело станет дочерним по отношению к указанному родительскому делу. Примеры: - {=Variable:PARENT_ACTIVITY_ID} - связать дело с родительским делом из переменной предыдущего активити (робота); - 12345 - связать дело с родительским делом с ID 12345; - {=A1988_22222_92566_99999:new_id_todo} - использовать ID дела из результата активити (робота) "Добавление дела"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел. Особенности работы: - Дочернее дело отображается в таймлайне под родительским делом; - Дочерние дела помогают структурировать работу и разбивать большие задачи на подзадачи; - Если родительское дело не указано, дело будет создано как самостоятельное. Когда использовать: - Для создания подзадач в рамках большого проекта; - Для структурирования работы по этапам; - Для организации дел в иерархическую структуру.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Создание простого дела с дедлайном	Параметры: Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "3d")}}, Заголовок дела - Позвонить клиенту, Описание дела - Связаться с клиентом для уточнения деталей сделки. Активити (робот) создаст дело с дедлайном через 3 дня.
Создание дела с напоминаниями	Параметры: Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "1d")}}, Заголовок дела - Встреча с клиентом, Напоминания (минуты до дедлайна) - 1440, 60. Активити (робот) создаст дело с напоминаниями за день и за час до дедлайна.
Создание срочного дела с цветовой маркировкой	Параметры: Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "2h")}}, Заголовок дела - Срочно: подготовить документы, Цвет дела - Красный (7). Активити (робот) создаст срочное дело с красной маркировкой.
Создание дела с назначением ответственного	Параметры: Тип сущности - Лид (L), ID сущности - {=Document:ID}, Срок выполнения - ={{=workdateadd({=System:Now}, "2d", {=Document:ASSIGNED_BY_ID})}}, Ответственный - {=Document:ASSIGNED_BY_ID}, Заголовок дела - Обработать лид. Активити (робот) создаст дело с назначением ответственного из сущности.
Создание дочернего дела	Параметры: Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "5d")}}, Заголовок дела - Подзадача: подготовить договор, Идентификатор дела в таймлайне - {=Variable:PARENT_ACTIVITY_ID}. Активити (робот) создаст дочернее дело, связанное с родительским.
Создание дела в смарт-процессе	Параметры: Тип сущности - СМАРТ: Заявки, ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "1d")}}, Заголовок дела - Обработать заявку. Активити (робот) создаст дело, привязанное к смарт-процессу.
Создание дела с персонализированным заголовком	Параметры: Тип сущности - Компания (CO), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "7d")}}, Заголовок дела - Встреча с {=Document:TITLE}, Описание дела - Обсудить условия сотрудничества с компанией {=Document:TITLE}. Активити (робот) создаст дело с заголовком, содержащим название компании.
Создание дела с множественными напоминаниями	Параметры: Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "3d")}}, Заголовок дела - Важное дело, Напоминания (минуты до дедлайна) - 4320, 1440, 60. Активити (робот) создаст дело с напоминаниями за 3 дня, за день и за час до дедлайна.
Создание дела с автоматическим расчётом дедлайна	Параметры: Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}}, Заголовок дела - Подготовка к закрытию сделки. Активити (робот) создаст дело с дедлайном за день до закрытия сделки.
Создание дела через итератор	Параметры: Тип сущности - Контакт (C), ID сущности - {=Iterator:Value}, Срок выполнения - ={{=dateadd({=System:Now}, "1d")}}, Заголовок дела - Связаться с контактом. Для каждого контакта из итератора будет создано отдельное дело.

Изменение универсального дела

Активити (робот) "Изменение универсального дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Обновление данных существующего универсального дела;
• Изменение срока выполнения дела при изменении условий;
• Обновление заголовка и описания дела на основе новых данных;
• Изменение ответственного за дело при перераспределении задач;
• Добавление или изменение напоминаний о предстоящем деле;
• Изменение цветовой маркировки дела для визуального разделения;
• Обновление связи с родительским делом в таймлайне;
• Автоматическое обновление дел при изменении статуса сделки или лида;
• Массовое обновление дел по определённым критериям;
• Автоматизация обновления дел при интеграции с внешними системами.

Название поля	Описание и примеры использования
ID дела для обновления	В данном поле указывается идентификатор дела, которое нужно обновить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - обновить дело с ID из переменной предыдущего активити (робота); - 12345 - обновить дело с ID 12345; - {=A1988_22222_92566_99999:new_id_todo} - использовать ID дела из результата активити (робота) "Добавление дела"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - обновить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - обновить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Добавление дела" (параметр new_id_todo); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует, активити (робот) завершится с ошибкой. Всегда проверяйте существование дела перед обновлением.
Тип сущности	В данном поле указывается новый тип сущности, к которой будет привязано дело. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Лид (L) - для привязки дела к лиду; - Сделка (D) - для привязки дела к сделке; - Контакт (C) - для привязки дела к контакту; - Компания (CO) - для привязки дела к компании; - Предложение (Q) - для привязки дела к предложению; - Заказ (O) - для привязки дела к заказу; - Счёт (SI) - для привязки дела к счету; - СМАРТ: [название смарт-процесса] - для привязки дела к смарт-процессам (список формируется автоматически на основе настроек вашего портала). Примеры: - Сделка (D) - привязать дело к сделке; - Контакт (C) - привязать дело к контакту; - СМАРТ: Заявки - привязать дело к смарт-процессу "Заявки". Когда использовать: - Для изменения привязки дела к другой сущности; - Для переноса дела при изменении типа сущности в бизнес-процессе; - Если тип сущности не нужно менять, укажите текущий тип сущности дела.
ID сущности	В данном поле указывается новый идентификатор сущности CRM, к которой будет привязано дело. Это обязательный параметр. Примеры: - {=Document:ID} - привязать дело к текущей сущности из документа (сделка, лид, контакт, компания); - 123 - привязать дело к сущности с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_results} - использовать ID из результата поиска (первый элемент массива); - {=Iterator:Value} - использовать ID для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID соответствует выбранному типу сущности. Если ID не существует или не соответствует типу, активити (робот) завершится с ошибкой. Если ID сущности не нужно менять, укажите текущий ID сущности дела.
Срок выполнения	В данном поле указывается новый срок выполнения дела (дата и время, до которого должно быть выполнено дело). Это обязательный параметр. Примеры: - {=System:NowLocal} - установить текущую дату и время; - ={{=dateadd({=System:Now}, "5d")}} - установить срок выполнения через 5 дней от текущего момента; - ={{=workdateadd({=System:Now}, "3d", {=Document:ASSIGNED_BY_ID})}} - установить срок выполнения через 3 рабочих дня с учётом рабочего времени ответственного; - ={{=dateadd({=Document:CLOSEDATE}, "1d")}} - установить срок выполнения на 1 день позже даты закрытия сделки; - 25.01.2025 18:00:00 - указать конкретную дату и время. Когда использовать: - Для продления срока выполнения дела; - Для изменения дедлайна на основе новых данных; - Для автоматического обновления срока при изменении условий в бизнес-процессе.
Заголовок дела	В данном поле указывается новый заголовок дела. Это необязательный параметр. Если не указан, заголовок останется без изменений. Примеры: - Позвонить клиенту - обновить заголовок на новый текст; - Подготовить коммерческое предложение для сделки #{=Document:ID} - обновить заголовок с использованием переменных; - ={{={=Variable:OLD_TITLE} & " - Обновлено"}} - добавить информацию к существующему заголовку; - Встреча с {=Document:COMPANY_TITLE} - обновить заголовок на основе данных сущности. Когда использовать: - Для обновления заголовка на основе новых данных; - Для добавления дополнительной информации к существующему заголовку; - Если заголовок не нужно менять, оставьте поле пустым.
Описание дела	В данном поле указывается новое описание дела. Это необязательный параметр. Если не указано, описание останется без изменений. Примеры: - Необходимо связаться с клиентом для уточнения деталей сделки - обновить описание на новый текст; - Проверить документы по сделке #{=Document:ID}. Сумма: {=Document:OPPORTUNITY} руб. - обновить описание с использованием переменных; - ={{={=Variable:OLD_DESCRIPTION} & " Дополнительная информация: " & {=Variable:ADDITIONAL_INFO}}}} - добавить информацию к существующему описанию; - Подготовить договор для компании {=Document:COMPANY_TITLE} - обновить описание на основе данных сущности. Когда использовать: - Для обновления описания на основе новых данных; - Для добавления дополнительной информации к существующему описанию; - Если описание не нужно менять, оставьте поле пустым.
Ответственный	В данном поле указывается новый ответственный за дело. Это необязательный параметр. Если не указан, ответственный останется без изменений. Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственным сотрудника из текущей сущности; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Когда использовать: - Для перераспределения задач между сотрудниками; - Для автоматического назначения ответственного на основе данных сущности; - Если ответственного не нужно менять, оставьте поле пустым.
Напоминания (минуты до дедлайна)	В данном поле указывается новое время до дедлайна (в минутах), когда нужно отправить напоминание о предстоящем деле. Это необязательный параметр. Можно указать несколько значений через запятую для множественных напоминаний. Если не указано, напоминания останутся без изменений. Примеры: - 60 - установить напоминание за 60 минут до дедлайна (1 час); - 1440 - установить напоминание за 1440 минут до дедлайна (1 день); - 5, 30, 60 - установить напоминания за 5 минут, за 30 минут и за 1 час до дедлайна; - {=Variable:REMINDER_MINUTES} - использовать значение из переменной предыдущего активити (робота). Особенности работы: - Значения указываются в минутах до срока выполнения дела; - Можно указать несколько значений через запятую для множественных напоминаний; - Новые напоминания заменят существующие напоминания дела; - Если напоминания не указаны, существующие напоминания останутся без изменений. Когда использовать: - Для добавления или изменения напоминаний о предстоящем деле; - Для настройки множественных напоминаний; - Если напоминания не нужно менять, оставьте поле пустым.
Цвет дела	В данном поле указывается новый цвет для визуальной маркировки дела в календаре и списке дел. Это необязательный параметр. Выбирается из выпадающего списка. Если не указан, цвет останется без изменений. Варианты выбора: - Жёлтый (0) - жёлтый цвет; - Синий (1) - синий цвет; - Бирюзовый (2) - бирюзовый цвет; - Оранжевый (3) - оранжевый цвет; - Зелёный (4) - зелёный цвет; - Фиолетовый (5) - фиолетовый цвет; - Серый (6) - серый цвет; - Красный (7) - красный цвет. Примеры использования: - Красный - для срочных и важных дел; - Зелёный - для выполненных или успешных дел; - Жёлтый - для стандартных дел; - Синий - для дел, требующих внимания. Когда использовать: - Для изменения цветовой маркировки дела при изменении приоритета; - Для визуального разделения дел по категориям; - Если цвет не нужно менять, оставьте поле пустым.
Идентификатор дела в таймлайне, с которым можно связать создаваемое дело	В данном поле указывается новый ID родительского дела в таймлайне, с которым нужно связать дело. Это необязательный параметр. Если не указан, связь с родительским делом останется без изменений. Примеры: - {=Variable:PARENT_ACTIVITY_ID} - связать дело с новым родительским делом из переменной; - 12345 - связать дело с родительским делом с ID 12345; - {=A1988_22222_92566_99999:new_id_todo} - использовать ID дела из результата активити (робота) "Добавление дела"; - Если нужно убрать связь с родительским делом, укажите пустое значение или 0. Особенности работы: - Дочернее дело отображается в таймлайне под родительским делом; - Изменение связи с родительским делом позволяет переструктурировать иерархию дел; - Если родительское дело не указано, существующая связь останется без изменений. Когда использовать: - Для изменения связи с родительским делом; - Для переструктурирования иерархии дел; - Если связь с родительским делом не нужно менять, оставьте поле пустым.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Продление срока выполнения дела	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "7d")}}. Активити (робот) продлит срок выполнения дела на 7 дней.
Изменение ответственного за дело	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "3d")}}, Ответственный - {=Document:ASSIGNED_BY_ID}. Активити (робот) изменит ответственного на сотрудника из текущей сущности.
Добавление напоминаний к существующему делу	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "2d")}}, Напоминания (минуты до дедлайна) - 1440, 60. Активити (робот) добавит напоминания за день и за час до дедлайна.
Изменение цветовой маркировки дела	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Лид (L), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "1d")}}, Цвет дела - Красный (7). Активити (робот) изменит цвет дела на красный для визуального выделения.
Обновление заголовка и описания дела	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Компания (CO), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "5d")}}, Заголовок дела - Встреча с {=Document:TITLE}, Описание дела - Обсудить условия сотрудничества. Активити (робот) обновит заголовок и описание дела.
Изменение привязки дела к другой сущности	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Variable:NEW_DEAL_ID}, Срок выполнения - ={{=dateadd({=System:Now}, "3d")}}. Активити (робот) перенесёт дело к другой сделке.
Изменение связи с родительским делом	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "4d")}}, Идентификатор дела в таймлайне - {=Variable:NEW_PARENT_ID}. Активити (робот) изменит связь с родительским делом.
Массовое обновление дел через итератор	Параметры: ID дела для обновления - {=Iterator:Value}, Тип сущности - Контакт (C), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "2d")}}, Цвет дела - Зелёный (4). Для каждого дела из итератора будет изменён срок выполнения и цвет.
Автоматическое обновление срока при изменении условий	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=Document:CLOSEDATE}, "-1d")}}. Активити (робот) обновит срок выполнения на основе даты закрытия сделки.
Полное обновление дела со всеми параметрами	Параметры: ID дела для обновления - {=Variable:ACTIVITY_ID}, Тип сущности - Сделка (D), ID сущности - {=Document:ID}, Срок выполнения - ={{=dateadd({=System:Now}, "5d")}}, Заголовок дела - Обновлённое дело, Описание дела - Новое описание, Ответственный - {=User:ID}, Напоминания (минуты до дедлайна) - 1440, 60, Цвет дела - Синий (1). Активити (робот) обновит все указанные параметры дела.

Задачи

Задачи

Слежение за статусом задачи

Данное активити позволяет отслеживать статус в указанной Вами задаче.

ID задачи (условие): в данном поле указывается ID задачи, за статусом которой требуется вести наблюдение.

Статус задачи: в данном поле выбирается из выпадающего списка статус задачи.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление задачи

Данное активити позволяет удалить задачу, согласно выбранным Вами параметрам.

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Владелец (условие): указывается автор задачи из выпадающего списка.

Статус задачи, ID (условие): в данном поле указывается номер статуса задачи.

Номер   статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Завершение задач

Данное активити позволяет автоматически закрывать неактуальные задачи, при условии знания их ID
   Логика активити подразумевает, что если не указаны данные, необходимые для выбора конкретной задачи, то будут закрываться все задачи, которые находятся в статусах 1,2,3,4 (о значениях статусов смотрите в описании активити "Получить текущий статус и мета - статус задачи") в той сущности, где запущен данный бизнес-процесс (Лид, Сделка, Контакт, Компания). 

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Постановщик (условие) - позволяет отобрать все задачи в которых постановщиком будет выбранный сотрудник. Выбор происходит из выпадающего списка.

Ответственный (условие) - позволяет отобрать все задачи в которых ответственным будет выбранный сотрудник. Выбор происходит из выпадающего списка.

Закрывать все задачи указанной сущности: варианты да/нет.
Данное поле позволяет выбрать, нужно ли автоматически закрыть все задачи для указанной сущности или нет. Т.е если указана сущность, то все ее задачи будут или не будут закрыты.
Так же, если указать да/нет в данном поле, но не указать сущность, то активити выдаст ошибку.

Тип сущности: в данном поле из выпадающего списка выбирается тип сущности, задачи которой будут закрыты.

ID сущности: в данном поле указывается ID сущности, либо переменная, указывающая на этот ID.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания (Время ожидания ответа от приложения): это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получить статус и мета-статус задачи

Данное активити позволяет получить статус задачи для того, чтобы понять что с ней происходит. Исходя из нашей логики, получив статус, можно далее реагировать как необходимо. Результатом работы данного активити будет число, которое обозначает конкретный статус задачи.
Результат работы активити можно вывести в ленту с помощью активити "Cоздание сообщения в ленту сущностей CRM"

Номер  статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Номер   статуса	Расшифровка мета - статуса задачи
-1	Просроченная задача
-2	Непросмотренная задача
-3	Почти просрочена (осталось менее 24х часов до даты крайнего срока)

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.   

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, Вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Создание задачи

Активити (робот) "Создание задачи" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое создание задач при наступлении определённых событий в CRM;
• Создание задач с привязкой к сущностям (сделки, лиды, контакты, компании);
• Формирование задач с чек-листами для контроля выполнения;
• Создание связанных и зависимых задач для управления проектами;
• Автоматическое назначение ответственных и наблюдателей;
• Установка сроков и приоритетов задач на основе данных бизнес-процесса;
• Создание задач в рабочих группах и проектах.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Остановить процесс во время выполнения задачи	Позволяет остановить бизнес-процесс до выполнения задачи. После выполнения задачи БП продолжит работу. Варианты: Да, Нет.
Название задачи	Название задачи в дизайнере БП. Рекомендуется использовать модель именования: Задача №1, Задача №2. Название должно заполняться латиницей и без пробелов (для системного идентификатора).
Постановщик	ID сотрудника, который будет принимать задачу. Получает уведомления по каждому изменению. Пример: {=User:ID}, [1], user_1
Ответственный	ID сотрудника, который должен выполнить задачу и отчитаться о проделанной работе. Пример: {=Document:ASSIGNED_BY_ID}
Соисполнители	ID сотрудников, участвующих в работе. Получают уведомления, но не участвуют в отчетах. Пример: несколько ID через запятую или массив.
Наблюдатели	ID сотрудников, наблюдающих за изменениями в задаче. Получают уведомления. Пример: несколько ID через запятую или массив.
Дата начала	Дата начала задачи. Поддерживается выбор формата даты. Пример: {{=dateadd({=System:Now}, "1d")}}
Дата окончания	Дата окончания задачи. Пример: {{=dateadd({=System:Now}, "7d")}}
Крайний срок	Крайний срок по задаче. По этой дате система считает просрочку. ВАЖНО! Изменение крайнего срока ведёт к смещению сроков зависимых задач на диаграмме Ганта.
Описание задачи	Описание того, что необходимо сделать в рамках задачи. Указывайте подробное описание.
Важность	Приоритетность задачи. Задачи с высоким приоритетом отмечаются маркером (огонёк). Значения: 1 (обычная), 2 (важная).
Задача в проекте (группе)	ID группы (проекта) для привязки задачи. Удобно для разделения задач в отчетах.
Разрешить ответственному менять крайний срок	Позволяет ответственному передвигать сроки выполнения задачи. Варианты: Да, Нет.
Включить учет времени по задаче	Включает функцию замера времени в задаче. Варианты: Да, Нет.
Принять работу после завершения задачи	Требует от постановщика принять задачу после завершения. Отображается "Ожидает контроля". Варианты: Да, Нет.
Включить задачу в отчет по эффективности	Добавляет задачу в отчет по эффективности менеджера. Варианты: Да, Нет.
Привязать задачу к текущей сущности (CRM)	Привязывает задачу к сущности из которой запускается БП. Типы: Лид, Контакт, Компания, Сделка.
Привязать задачу к нескольким сущностям	Позволяет привязать задачу к нескольким CRM-сущностям. Формат: тип_ID (L_123, D_456, C_789, CO_101, SI_102, Q_103, T84_1234). Обозначения: L_ - Лид, D_ - Сделка, C_ - Контакт, CO_ - Компания, SI_ - Счёт, Q_ - Предложение.
Коды смарт-процессов	Позволяет выбрать символьный код СП. Для каждого СП код уникален. При добавлении нового СП активити нужно переустановить.
Теги	Теги для маркировки задач и удобного поиска.
Пункт чек-листа	Создание пунктов чек-листа в задаче. Можно создать несколько полей. Чем больше пунктов, тем дольше выполняется БП.
Идентификатор родительской задачи	ID родительской задачи для создания вложенных задач.
Плановые трудозатраты (в секундах)	Запланированное время на выполнение в секундах. Пример: для 2 часов укажите 7200 (2*60*60).
Планируемая длительность	Автоматический расчёт сроков. Указывается число, единица в следующем поле. Единицы: days, hours, minutes.
Идентификатор задачи для зависимости	ID задачи для создания зависимости. Формат: id#тип. Пример: 123456#1, 985#2, 737#1
Прикрепить файл к задаче	ID файла с диска Б24 для прикрепления к задаче.
Крайний срок в рабочее время	Автоматически переносит сроки на рабочие дни (например, с воскресенья на понедельник).

Типы зависимостей между задачами:

Индекс	Описание
1	Когда начнётся указанная - начнётся создаваемая
2	Когда начнётся указанная - закончится создаваемая
3	Когда закончится указанная - начнётся создаваемая
4	Когда закончится указанная - закончится создаваемая
11	Когда начнётся создаваемая - начнётся указанная
12	Когда начнётся создаваемая - закончится указанная
13	Когда закончится создаваемая - начнётся указанная
14	Когда закончится создаваемая - закончится указанная

Примеры использования:

№	Сценарий	Название	Ответственный	Крайний срок
1	Задача при создании сделки	Обработка сделки №{=Document:ID}	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "3d")}}
2	Задача для менеджера	Связаться с клиентом	user_25	{{=dateadd({=System:Now}, "1d")}}
3	Задача с высоким приоритетом	Срочная задача	{=User:ID}	{=System:Now}
4	Задача в проекте	Задача проекта	{=Variable:RESPONSIBLE_ID}	{{=dateadd({=System:Now}, "7d")}}
5	Подзадача	Подзадача	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "2d")}}
6	Задача с привязкой к сделке	Контроль сделки	user_1	{{=dateadd({=System:Now}, "5d")}}
7	Задача с чек-листом	Задача с контролем	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "3d")}}
8	Задача с соисполнителями	Командная задача	user_10	{{=dateadd({=System:Now}, "7d")}}
9	Задача с зависимостью	Зависимая задача	{=Document:ASSIGNED_BY_ID}	{{=dateadd({=System:Now}, "10d")}}
10	Задача с файлом	Задача с документами	{=User:ID}	{{=dateadd({=System:Now}, "5d")}}

Возвращаемые параметры для данного активити:

• ID задачи (task_id) - числовой идентификатор созданной задачи;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Поиск задачи (v.2)

Данное активити даёт возможность найти задачи, согласно указанных параметров.
Результатом работы является получение ID задачи в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Название	Описание
ID задачи:	В данном пункте указывается ID задачи, которую Вам необходимо найти.
Название задачи:	В данном пункте указывается название задачи, которую необходимо найти.
Истинный статус задачи:	В данном поле выбирается один из вариантов истинного статуса задачи: новая задача,  принята ответственным, выполняется, условно завершена, выполнена, отложена. При поиске задач, нельзя искать по 2 типам статусов одновременно, это приведет к тому, что активити попросту ничего не найдет. Т.е одновременный поиск с фильтрами "Истинный статус" и "Мета статус" - невозможен.
Мета - статус задачи:	В данном поле устанавливается мета - статус искомой задачи: задача почти просрочена, не просмотренная задача, просроченная задача. При поиске задач, нельзя искать по 2 типам статусов одновременно, это приведет к тому, что активити попросту ничего не найдет. Т.е одновременный поиск с фильтрами "Истинный статус" и "Мета статус" - невозможен.
Дата начала:	В данном пункте указывается дата начала выполнения задачи.
Дата окончания:	В данном пункте указывается дата завершения задачи.
Крайний срок:	В данном пункте указывается дата крайнего срока задачи.
ID задачи	В данном пункте указывается ID задач
Привязать к текущей сущности	В данном пункте указывается привязана ли задача к текущей сущности или нет.
ID ответственного:	В данном пункте указывается ID ответственного.
ID постановщика:	В данном пункте указывается ID постановщика, которую Вам необходимо найти.
ID соисполнителей:	В данном пункте указывается ID соисполнителей, которых Вам нужно найти.
ID наблюдателей:	В данном пункте указывается ID наблюдателей, которых Вам нужно найти.
ID родительской задачи:	В данном пункте указывается ID родительской задачи, которую Вам необходимо найти.
ID рабочей группы:	В данном пункте указывается ID рабочей группы, которую Вам необходимо найти.
Плановые трудозатраты (в секундах):	В данном поле указывается плановые трудозатраты на выполнение задачи в виде времени, указывается значение в секундах.
Планируемая длительность в часах или днях:	В данном пункте указывается планируемая длительность задачи в часах или днях.
ID сайта:	В данном пункте указывается ID сайта, который Вам нужно найти.
Дата и время исполнения только в рабочее время:	В данном пункте указывается дата и время исполнения задачи, только в рабочее время.
Стадия:	В данном пункте указывается стадия, в которой находится задача.
Изменил:	В данном поле указывается ID пользователя, который внес какие-либо изменения в задаче.
Дата изменения:	В данном поле указывается дата последнего изменения в задаче.
Изменил статус:	В данном поле указывается ID сотрудника, изменившего статус.
Дата изменения статуса:	В данном поле указывается дата изменения статуса задачи.
Закрыл задачу:	В данном полу указывается ID сотрудника, закрывшего задачу.
Затраченное время из истории изменений:	В данном поле указывается затраченное время из истории изменений задачи.
Дата последнего просмотра:	В данном поле указывается дата последнего просмотра искомой задачи.
Индекс сортировки:	В данном поле указывается индекс сортировки задачи в виде цифры. Данный индекс можно найти в параметрах задачи.
Затрачено (фактически):	В данном поле указывается время, фактически затраченное на выполнение задачи.

Номер  статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Номер   статуса	Расшифровка мета - статуса задачи
-1	Просроченная задача
-2	Непросмотренная задача
-3	Почти просрочена (осталось менее 24х часов до даты крайнего срока)

Поиск по привязке к сущностям CRM: в поле указывается CRM сущность, к которой привязана искомая задача или задачи.
Поле заполняется в определенном формате.
Пример: L_12345
L_ - обозначение лида.
12345 - ID этого лида.

Обозначения сущностей CRM:
L_ - Лид
D_ - Сделка
C_ - Контакт
CO_ - Компания
SI_ - Счёт
Q_ - Предложение
Символьный код СП из поля ниже_ID элемента СП - Смарт-процесс
Пример заполнения поля: T84_1234. 

Коды смарт-процессов: позволяет посмотреть и выбрать значение символьного кода для СП.
Для каждого СП этот код уникален.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получить все данные по задаче

Активити (робот) "Получить все данные по задаче" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение всех данных задачи по её ID для использования в бизнес-процессе;
• Извлечение информации о задаче для формирования отчётов;
• Получение статуса и мета-данных задачи;
• Автоматическая проверка параметров задачи (сроки, ответственные, соисполнители);
• Получение данных для условного ветвления в бизнес-процессе;
• Синхронизация данных задачи с другими системами;
• Получение результатов из дополнительных результатов выбранной задачи.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID задачи (условие)	Обязательный параметр. В данном поле указывается ID задачи, данные которой необходимо получить. Примеры: - {=Variable:TASK_ID} - ID задачи из переменной; - 123456 - конкретный ID задачи; - {=A1988_22222_92566_99999:task_id} - ID из результата предыдущего активити.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП. Используйте только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию с очередями запросов. Если время истекло и результат не получен, бизнес-процесс продолжит работу по заложенной логике.

Примеры использования:

№	Сценарий	ID задачи	Описание
1	Получить данные созданной задачи	{=A1988_22222_92566_99999:task_id}	Используется после активити создания задачи
2	Получить данные из переменной	{=Variable:TASK_ID}	ID задачи хранится в переменной БП
3	Получить данные конкретной задачи	123456	Указывается конкретный ID
4	Проверить статус задачи	{=Variable:TASK_ID}	Для условного ветвления
5	Получить ответственного	{=Variable:TASK_ID}	Для назначения в другие сущности
6	Получить сроки задачи	{=Variable:TASK_ID}	Для расчёта дедлайнов
7	Получить соисполнителей	{=Variable:TASK_ID}	Для уведомлений или назначений
8	Получить данные для отчёта	{=Variable:TASK_ID}	Для формирования отчётности
9	Проверить привязку к CRM	{=Variable:TASK_ID}	Для связи с сущностями CRM
10	Получить данные в итераторе	{=Iterator:Value}	Для обработки списка задач

Возвращаемые параметры для данного активити:

• Статусы - статус и мета-статус задачи;
• Массивы - соисполнители, наблюдатели, теги, файлы;
• Все параметры по задаче, включая:
  - ID задачи;
  - Название и описание;
  - Постановщик и ответственный;
  - Соисполнители и наблюдатели;
  - Даты начала, окончания, крайний срок;
  - Приоритет;
  - Статус и мета-статус;
  - Привязка к группе/проекту;
  - Привязка к CRM-сущностям;
  - Родительская задача;
  - Затраченное время;
  - и другие поля.

Слежение за изменением в задаче

Данное активити позволяет отслеживать изменения в указанной Вами задаче.

ID задачи (условие):  в данном поле указывается ID задачи, за изменениями в которой требуется вести наблюдение.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Изменение задачи

Активити (робот) "Изменение задачи" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое изменение параметров задачи (название, описание, сроки, приоритет);
• Переназначение ответственного или добавление соисполнителей;
• Изменение сроков выполнения задачи на основе событий в CRM;
• Привязка задачи к сущностям CRM (сделки, лиды, контакты, компании);
• Обновление статуса и приоритета задачи автоматически;
• Добавление тегов и файлов к существующим задачам;
• Управление зависимостями между задачами;
• Привязка задачи к рабочим группам и проектам.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID задачи	Обязательный параметр. ID задачи, которую необходимо изменить. Примеры: - {=Variable:TASK_ID} - из переменной; - 123456 - конкретный ID задачи.
Название задачи	Поле позволяет указать новое название задачи. Примеры: - {=Variable:TASK_TITLE}; - Задача №{=Document:ID}. Рекомендуем использовать модель именования: Задача №1, Задача №2 и т.д.
Описание задачи	В этом поле указывается что необходимо сделать в рамках задачи. Пример: {=Variable:TASK_DESCRIPTION} Рекомендуем заполнять описание максимально подробно.
Дата начала	Дата начала задачи. Есть возможность выбора формата даты. Примеры: - {=Variable:START_DATE}; - {{=dateadd({=System:Now}, "1d")}} - завтра.
Дата завершения	Дата окончания задачи. Примеры: - {=Variable:END_DATE}; - {{=dateadd({=System:Now}, "7d")}} - через 7 дней.
Крайний срок	Крайний срок задачи. Пример: {{=dateadd({=System:Now}, "5d")}} ВАЖНО! Изменение крайнего срока ведёт к смещению сроков зависимых задач на диаграмме Ганта.
Приоритет	Позволяет установить приоритетность задачи. Значения: - 1 - обычная; - 2 - важная (отмечается огоньком).
Идентификатор ответственного	ID сотрудника, который должен выполнить задачу. Форматы: {=Document:ASSIGNED_BY_ID}, [1], user_1.
Идентификатор постановщика	ID сотрудника, который будет принимать задачу. Форматы: {=User:ID}, [1], user_1. ВАЖНО! Постановщик получает уведомления по каждому изменению задачи.
Соисполнители	ID сотрудников, участвующих в работе. Можно указать несколько ID через запятую или массив. Пример: {=Variable:ACCOMPLICES}
Наблюдатели	ID сотрудников, наблюдающих за задачей. Получают уведомления об изменениях. Пример: {=Variable:AUDITORS}
Теги	Теги задач для фильтрации и поиска. Можно указать несколько как массив. Пример: {=Variable:TAGS} Теги - идентификаторы для уточнения категории, описания, поиска данных.
Флаг "Разрешить ответственному менять крайний срок"	Позволяет ответственному передвигать сроки выполнения. Варианты: да/нет.
Флаг "Привязать к текущей сущности CRM"	Привязка задачи к сущности из которой запускается БП. Варианты: да/нет.
Привязать задачу к нескольким сущностям	Позволяет привязать задачу к нескольким CRM-сущностям. Обозначения: - L_ - Лид; - D_ - Сделка; - C_ - Контакт; - CO_ - Компания; - SI_ - Счёт; - Q_ - Предложение; - T84_ - Смарт-процесс (символьный код). Пример: L_123, D_456, C_789
Коды смарт-процессов	Позволяет выбрать символьный код для СП. Для каждого СП код уникален. Если добавляете новый СП, нужно переустановить активити.
Флаг "Принять работу после завершения задачи"	Потребует от постановщика принять задачу после завершения. Отображается "Ожидает контроля".
Идентификатор родительской задачи	ID родительской задачи для создания вложенных задач. Пример: {=Variable:PARENT_TASK_ID}
Идентификатор рабочей группы	Привязка задачи к группе (проекту) для разделения в отчетах. Пример: {=Variable:GROUP_ID}
Плановые трудозатраты (в секундах)	Запланированное время на выполнение. Указывается в секундах. Пример: для 2 часов укажите 7200 (2*60*60).
Идентификатор задачи для зависимости	ID задачи для привязки зависимости. Формат: id#тип. Пример: 123456#1, 985#2, 737#1 Типы зависимостей: - 1 - Когда начнётся указанная - начнётся эта; - 2 - Когда начнётся указанная - закончится эта; - 3 - Когда закончится указанная - начнётся эта; - 4 - Когда закончится указанная - закончится эта; - 11-14 - обратные зависимости. Изменить привязку можно только после ручного удаления связи.
Статус задачи	Позволяет выбрать из списка новый статус задачи. Статусы: - Задача выполняется (пользователь нажал начать выполнение); - Условно завершена (пользователь закрыл задачу и ждет согласования от постановщика); - Задача выполнена (пользователь завершил выполнение задачи); - Задача отложена (пользователь нажал отложить); - Закрывает задачу требующую контроля; - Задачу не принял контроллер Возобновить после завершения; REST Api Б24 запрещает переводить задачу в статус "Задача выполняется (пользователь нажал начать выполнение)". При попытке перевести задачу в этот статус вы будете получать ошибку "error_api: tasks.task.start"
Прикрепить файл к задаче	ID файлов с облачного диска. Можно указать несколько через запятую. Пример: {=Variable:FILE_IDS} или 123, 456, 789
Крайний срок в рабочее время	Автоматически увеличивает сроки в рамках рабочих дней. Воскресенье - на понедельник.

Примеры использования:

№	Сценарий	Параметр	Значение
1	Изменить название	Название задачи	Новое название задачи
2	Сменить ответственного	Идентификатор ответственного	user_25
3	Продлить срок на 7 дней	Крайний срок	{{=dateadd({=System:Now}, "7d")}}
4	Установить высокий приоритет	Приоритет	2
5	Добавить соисполнителей	Соисполнители	user_10, user_15, user_20
6	Привязать к сделке	Привязать к сущностям	D_{=Document:ID}
7	Добавить теги	Теги	срочно, важно
8	Привязать к группе	Идентификатор рабочей группы	{=Variable:GROUP_ID}
9	Установить трудозатраты 4 часа	Плановые трудозатраты	14400
10	Обновить описание	Описание задачи	Обновлено: {=System:Date}

Возвращаемые параметры для данного активити:

• ID изменённой задачи (task_id) - числовой идентификатор изменённой задачи;
• Успех операции (success) - результат выполнения (Y/N);
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Перенос затраченного времени в задаче

Данное активити позволяет переносить информацию о затраченном времени из одной задачи в другую.
Перенос осуществляется путем указания ID-задачи из которой нужно перенести время и ID-задачи в которую необходимо перенести время.

Взять ID гл. задачи из родительской задачи: варианты "да" или "нет". Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.
Данный пункт используется, когда у Вас связаны между собой 2 задачи, одна из этих задач "родительская" (главная), вторая "дочерняя". Сам процесс запускается из "дочерней" задачи, но при этом видит ID "родительской" (главной) задачи.

Продублировать затраченное время в комментарий к главной задаче: варианты да/нет. Позволяет выбрать, нужно ли дублировать затраченное  время в комментарии  к главной задаче или нет.

ID главной задачи: указывается ID главной задачи.

ID задачи из которой будет взято затраченное время: указывается ID задачи из которой будут взяты данные о затраченном времени.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Чек-лист

Проверка чек-листа к задаче

Данное активити проверяет чек-лист в задаче, ID которого Вы указали, и возвращает в БП значение «ложь» или «правда», что означает статус «не выполнено» или «выполнено»

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Сценарий работы робота

Информация о чек-листе в задаче

Активити предоставляет информацию о чек-листа в задаче, ID которой Вы указали.

ID задачи (условие): указывается идентификатор задачи из которой необходимо получить данные чек-листа.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Добавить чек-лист к задаче

Данное активити позволяет добавить пункты чек-листа в задачи, соответствующие указанному ID.

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Пункт чек-листа - в данном поле пишется важный момент, который должен выполнить ответственный за выполнение задачи. 

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Изменение пункта чек-листа в задаче

Активити позволяет изменить пункты чек-листов указанной задачи.

ID задачи: указывается ID задачи, в которой нужно изменить пункт чек-листа.

ID пункта чек-листа: указывается идентификатор пункта чек-листа.
ID родительского пункта чек-листа: идентификатор чек-листа к которому привязан изменяемый пункт чек-листа.

Текст пункта чек-листа: указывается содержание пункта чек-листа.

Признак выполнения пункта чек-листа: варианты да/нет.
Позволяет указать, выполнен или нет пункт чек-листа.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Удаление пункта чек-листа в задаче

Активити позволяет удалить пункты чек-листа из указанной задачи.

ID задачи (условие): указывается идентификатор задачи из которой необходимо удалить пункты чек-листа.

ID пункта чек-листа: указывается идентификатор удаляемого пункта чек-листа.
Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Комментарии в задачах

Создать комментарии в задаче

Активити (робот) "Создать комментарий в задаче" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое добавление комментариев к задачам при наступлении определённых событий;
• Информирование участников задачи о статусе выполнения работ;
• Логирование действий бизнес-процесса в комментариях задачи;
• Автоматическое уведомление о важных изменениях в связанных сущностях CRM;
• Добавление итогов или результатов работы других активити в комментарии;
• Формирование истории обработки задачи для последующего анализа;
• Автоматические напоминания ответственным сотрудникам.

Сценарий работы робота




Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID задачи	Обязательное поле. В данном поле указывается идентификатор задачи, в которой будет создан комментарий. Примеры: - 123456 - создать комментарий в задаче с ID 123456; - {=Variable:TASK_ID} - использовать ID задачи из переменной; - {=A1988_22222_92566_99999:task_id} - использовать ID из результата предыдущего активити (робота); - {=Document:ID} - использовать ID текущего документа (если БП запущен из задачи).
ID пользователя	В данном поле указывается идентификатор пользователя, от имени которого будет создан комментарий. Примеры: - 1 - создать комментарий от пользователя с ID 1; - user_25 - создать комментарий от пользователя с ID 25; - {=Document:ASSIGNED_BY_ID} - от имени ответственного текущей сущности; - {=User:ID} - от имени текущего пользователя.
Текст сообщения	В данном поле указывается текст комментария. Поддерживается BB-код для форматирования. Примеры: - Задача выполнена успешно - простой текстовый комментарий; - Статус сделки изменён на: {=Variable:STAGE_NAME} - с подстановкой переменной; - [B]Важно![/B] Требуется проверка данных - с форматированием BB-кодом; - Результат обработки: {=A1988_22222_92566_99999:result} - с результатом другого активити.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении указанного времени, то активити завершается.

Примеры использования:

№	Сценарий	ID задачи	ID пользователя	Текст сообщения
1	Уведомление о создании сделки	{=Variable:TASK_ID}	1	Создана новая сделка №{=Document:ID}
2	Логирование статуса	123456	{=Document:ASSIGNED_BY_ID}	Статус изменён на: {=Variable:STATUS}
3	Напоминание ответственному	{=Variable:TASK_ID}	user_1	[B]Напоминание![/B] Срок задачи истекает завтра
4	Отчёт о выполнении	{=A1988_22222_92566_99999:task_id}	{=User:ID}	Обработано записей: {=Variable:COUNT}
5	Информация о клиенте	{=Variable:TASK_ID}	1	Клиент: {=Variable:CLIENT_NAME}, тел: {=Variable:PHONE}
6	Результат проверки	{=Variable:TASK_ID}	{=Document:CREATED_BY}	Проверка завершена. Результат: {=Variable:CHECK_RESULT}
7	Уведомление об ошибке	{=Variable:TASK_ID}	1	[COLOR=red]Ошибка![/COLOR] {=Variable:ERROR_MESSAGE}
8	Информация о платеже	{=Variable:TASK_ID}	{=Document:ASSIGNED_BY_ID}	Получен платёж на сумму: {=Variable:AMOUNT} руб.
9	Результат интеграции	{=Variable:TASK_ID}	user_1	Данные синхронизированы с внешней системой. ID: {=Variable:EXT_ID}
10	Итоги дня	{=Variable:TASK_ID}	1	Итоги за {=System:Date}: обработано {=Variable:COUNT} заявок

Возвращаемые параметры для данного активити:

• ID нового комментария (comment_id) - числовой идентификатор созданного комментария;
• Успех операции (success) - результат выполнения операции (Y/N);
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Получить данные по комментарию в задаче

Активити позволяет получить данные о комментарии в задаче.


ID комментария:  в этом поле нужно указать идентификатор комментария, данные о котором вы хотите получить.

ID задачи:  в этом поле указывается идентификатор задачи, в которой находится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск комментариев в задаче

Активити позволяет получить id комментариев в указанной задаче.


ID задачи: в этом поле указывается идентификатор задачи, в которой будет производиться поиск комментариев.

ID пользователя: в этом поле указывается идентификатор пользователя, по которому будет произведен поиск комментариев в задаче.

Имя пользователя: в этом поле указывается имя пользователя, по которому будет произведен поиск комментариев в задаче.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Особенно это важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменить комментарий к задаче

Активити позволяет изменить указанный комментарий в указанной задаче, сделанный указанным пользователем


ID задачи:  в этом поле указывается идентификатор задачи, в которой находится комментарий.

ID комментария:  в этом поле указывается идентификатор комментария.
Идентификатор комментария можно получить с помощью активити "Создать комментарий" (если вы его создавали этим активити).

ID пользователя: в этом поле указывается идентификатор пользователя от имени которого был создан комментарий.

Текст сообщения: в этом поле указывается текст комментария.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Перенос комментариев в другую задачу

Данное активити позволяет переносить комментарии из одной задачи в другую. Это можно сделать задав ID задачи из которой будет произведен перенос и ID задачи в которую будет осуществлен перенос комментариев.

Сценарий работы активити бизнес-процесса

Взять ID гл. задачи из родительской задачи: варианты: да/нет. Позволяет получить автоматически ID главной задачи из подзадач для пункта "ID главной задачи".

ID главной задачи: в данном поле указывается ID задачи в которую будет перенесены комментарии.

ID задачи из которой будут взяты комментарии: в данном поле указывается ID задачи из которой будут взяты комментарии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Интеграции

SENLER - Добавление в группу подписки VK сообщества

Данное активити позволяет добавить подписчика VK в базу данных сервиса Senler.
Senler, это сервис, который позволяет отправлять рассылки через социальную сеть VK, и наше активити работает только с уже импортированными из базы подписчиками. 

Ключ из Callback API: в данное поле вставляется специальный секретный ключ.
Для получения ключа перейдите в следующие пункты меню настроек в личном кабинете Senler: Настройки -> Подключение ->  Ручная настройка (в п. Подключение) -> Секретный ключ. 
Скопируйте ключ (для того, чтобы это сделать, нужно сделать ключ видимым с помощью иконки "Показать ключ" в конце строки с ключем). 

Тип сущности: в этом поле указывается тип сущности с которой будет происходить работа активити.

ID сущности: в этом поле указывается ID сущности, с которой будет происходить работа.

Идентификатор пользователя ВКонтакте: в данном поле указывается ID пользователя в VK (id12345678), в формате 12345678. 
Если ID не указан, то он будет сам подгружаться из сущности.

Числовой идентификатор сообщества ВКонтакте: в данном поле указывается ID группы в VK. 
ID группы можно получить несколькими способами:
1. Скопировать ID группы из адресной строки браузера.
2. В личном кабинете senler, во  вкладке  "Мои сообщества", есть список сообществ, под каждым из сообществ есть перечень данных об этом сообществе, среди этих данных есть ID этого сообщества.
Пример: @club123456789, где 123456789 -  ID сообщества.
3. Если ID сообщества буквенный, а для активити нужно только числовой вариант, то нужно воспользоваться специальным сервисом по получению ID сообщества, таких сервисов довольно много, и их довольно легко найти воспользовавшись поиском в google.
Идентификатор группы подписчиков (0 - без группы): в данном поле указывается ID группы подписчиков (цифрами, без доп знаков)
Сам идентификатор выглядит так:#123456. 
Для его получения личном кабинете Senler нужно: 
1. Выбрать интересующую Вас группу в VK.
2. Перейти во вкладку "Группы подписчиков".
3. Найти нужную группу подписчиков и в правом верхнем углу этой группы будет указан ID этой группы в формате #123456 

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

SENLER - Удаление из группы подписки VK сообщества

Данное активити позволяет удалить подписчика из группы подписки VK сообщества.
Senler, это сервис, который позволяет отправлять рассылки через социальную сеть VK, и наше активити работает только с уже импортированными из базы подписчиками. 

Ключ из Callback API: в данное поле вставляется специальный секретный ключ.
Для получения ключа перейдите в следующие пункты меню настроек в личном кабинете Senler: Настройки -> Подключение ->  Ручная настройка (в п. Подключение) -> Секретный ключ. 
Скопируйте ключ (для того, чтобы это сделать, нужно сделать ключ видимым с помощью иконки "Показать ключ" в конце строки с ключем). 

Тип сущности: в этом поле указывается тип сущности с которой будет происходить работа активити.

ID сущности: в этом поле указывается ID сущности, с которой будет происходить работа.

Идентификатор пользователя ВКонтакте: в данном поле указывается ID пользователя в VK, в формате id12345678. 
Если ID не указан, то он будет сам подгружаться из сущности.

Числовой идентификатор сообщества ВКонтакте: в данном поле указывается ID группы в VK. 
ID группы можно получить несколькими способами:
1. Скопировать ID группы из адресной строки браузера.
2. В личном кабинете senler, во  вкладке  "Мои сообщества", есть список сообществ, под каждым из сообществ есть перечень данных об этом сообществе, среди этих данных есть ID этого сообщества.
Пример: @club123456789, где 123456789 -  ID сообщества.
3. Если ID сообщества буквенный, а для активити нужно только числовой вариант, то нужно воспользоваться специальным сервисом по получению ID сообщества, таких сервисов довольно много, и их довольно легко найти воспользовавшись поиском в google.
Идентификатор группы подписчиков (0 - без группы): в данном поле указывается ID группы подписчиков (цифрами, без доп знаков)
Сам идентификатор выглядит так:#123456. 
Для его получения личном кабинете Senler нужно: 
1. Выбрать интересующую Вас группу в VK.
2. Перейти во вкладку "Группы подписчиков".
3. Найти нужную группу подписчиков и в правом верхнем углу этой группы будет указан ID этой группы в формате #123456 

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Комментарии (таймлайн)

Поиск комментариев из таймлайн сущности CRM

Данное активити позволяет получить список всех комментариев для определенной CRM сущности, указав для фильтра параметры этой сущности.
Результатом работы активити, будет получение списка комментариев из определенной CRM сущности в виде массива для итератора, строки, а так же количества найденных элементов (комментариев), которые соответствуют условиям поиска.

ID сущности: в данном поле указывается ID сущности к которой привязаны записи в тайм лайне.

Тип сущности: в данном поле из выпадающего списка нужно выбрать тип сущности, к которой привязаны записи в тайм лайне.
Активити работает со следующими типами сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

Автор:в данном поле указывается автор искомых сообщений, в виде его ID, при этом ID должен быть указан без скобок или каких-либо лишних данных.

Текст комментария: в данном поле указывается текст комментария.

Делать отладочные сообщения в журнале БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получение всех коментариев из таймлайн сущности CRM

Данное активити позволяет поучить список ID всех комментариев выбранной CRM сущности.

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности, к которой привязан комментарий.

Тип сущности: в данном поле, из выпадающего списка нужно выбрать тип сущности, к которой привязан комментарий.
Активити работает со следующими типами сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Удаление коментария из таймлайна

Данное активити позволяет удалить комментарий из тайм лайна.

Сценарий работы активити бизнес-процесса

ID комментария: в данном поле указывается ID комментария, который нужно удалить.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Список привязок к записи в таймлайне

Данное активити позволяет получить список привязок к записи в тайм лайне.

Сценарий работы активити бизнес-процесса

ID записи в тайм лайне: в данном полу указывается ID записи в тайм лайне CRM сущности.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Изменение коментария из таймлайна

Данное активити позволяет изменить комментарий в тайм лайне сущности.

Сценарий работы активити бизнес-процесса

ID комментария: в данном поле указывается ID изменяемого комментария.
Текст комментария: в данном поле указывается новый текст для изменяемого комментария

ВАЖНО! 
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести изменение более 1000 сущностей, то нужно встраивать в БП счетчик, и после 1000 изменений делать паузу на 15 минут, если этого не сделать, то это приведет к тормозам в обработке на стороне Б24 и остальные сущности могут не отработаться.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Создание комментария в тайм лайн сущности CRM

Данное активити позволяет отправлять текст сообщения, выбранному типу сущности с указанным ID сущности.
Так же данное активити позволяет выводить результат работы других активити в ленту, при условии правильной настройки.

Тип сущности: в данном поле указывается тип сущности к которой будет привязан бизнес-процессу данного дела. Выбирается из выпадающего списка.

Активити работает со следующими типами сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

ID Сущности: в данном пункте указывается ID сущности, которую необходимо изменить.

Заголовок сообщения: в данной графе указывается текстовый заголовок сообщения.

Текст сообщения: в данной графе указывается текст сообщения.
Так же в данном поле можно вывести возвращаемые параметры из предшествующих активити.
Для этого нужно нажать кнопку "...", а далее выбрать пункт "Дополнительные результаты", после чего выбрать результаты, который необходимо вывести.

Добавить видео в сообщение: в данном поле необходимо указать код видео Youtube.
Пример:
Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g .

Размер видео: в данном поле из выпадающего списка можно выбрать разрешение прикрепляемого в сообщение видео.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Получение данных о коментарии из таймлайн сущности CRM

Данное активити позволяет получить данные о комментарии, прикрепленном к сущности CRM.

Сценарий работы активити бизнес-процесса

ID комментария в тайм лайне: в данном поле указывается ID комментария, данные которого Вам нужно получить. Получить эти данные вы можете из возвращаемых параметров другого активити.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Установка-снятие привязки коментария с сущности crm

Данное активити позволяет установить или снять привязку комментария с сущности CRM .

Сценарий работы активити бизнес-процесса

Операция с привязкой: в данном полу указывается тип операции привязки: снять привязку или установить привязку.

ID комментария в тайм лайне: в данном поле указывается ID комментария в тайм лайне.

ID сущности: в данном поле указывается ID сущности, к которой привязаны комментарии.

Тип сущности: в данном поле указывается тип сущности, к которой привязан комментарий.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Закрепить запись в таймлайне

Активити (робот) «Закрепить запись в таймлайне» предназначено для использования в роботах и может быть полезно в следующих сценариях: выделение важного комментария или лог-записи в карточке сделки, закрепление итогов переговоров для менеджера, фиксация контрольной точки перед этапом согласования, приоритизация записи при большом потоке событий в таймлайне.


Типичная цепочка:

1. Получение ID записи из списка комментариев или лог-записей по фильтру;
2. Закрепление;
3. Уведомление ответственного при "Успешное закрепление" = Y.

Название поля	Описание и примеры использования
ID записи таймлайна	Числовой идентификатор записи в таймлайне. Его можно получить из активити со списком комментариев или лог-записей по сущности. Пример: {=Variable:TIMELINE_ID}
Тип объекта CRM (ownerTypeId)	Числовой код типа объекта CRM, к которому привязана запись (например 2 для сделки, 1 для лида). Подставьте значение, соответствующее карточке сущности. Пример: {=Variable:ENTITY_TYPE_ID}
ID элемента CRM (ownerId)	Идентификатор элемента CRM, в карточке которого отображается таймлайн. Пример: {=Document:ID}

Описание примера	Решение
Закрепить комментарий после модерации	ID = {=Variable:COMMENT_TL_ID}, "Тип объекта CRM" = 2, "ID элемента CRM" = {=Document:ID} для сделки.
Закрепить запись в таймлайне лида	"Тип объекта CRM" = 1, "ID элемента CRM" = {=Document:ID}, ID = {=Variable:ITEM_ID}.
Цепочка после поиска комментария	ID из первого результата списка по фильтру, ID элемента CRM и Тип объекта CRM из полей документа сделки.
Закрепление итогового лог-сообщения	ID лог-записи из переменной {=Variable:LOG_ID}, "Тип объекта CRM" и "ID элемента CRM" совпадают с карточкой контакта.
Условное закрепление по важности	Условие: Variable:HIGH = Y, затем параметры из полей документа и переменной с ID записи.
Отложенное закрепление после паузы	После задержки процесса подставьте сохранённый ID записи из переменной {=Variable:PIN_QUEUE_ID}.
Обработка ошибки лимита	Если "Успех закрепления" = N, проверьте "Сообщение об ошибках" и при необходимости сначала открепите другую запись активити «Открепить запись в таймлайне».
Смарт-процесс	Тип объекта CRM = entityTypeId из настроек типа, ID элемента CRM = ID элемента смарт-процесса, ID записи из списка по entityTypeId.
Компания и контакт	Для компании Тип объекта CRM = 4, ID элемента CRM = {=Document:ID} в карточке компании; ID записи из списка по entity.
Логирование в переменную процесса	После шага сохраните значение "Успешное закрепление" и фрагмент "Сообщение об ошибках" в пользовательские поля сделки для аудита.

Открепить запись в таймлайне

Активити (робот) «Открепить запись в таймлайне» предназначено для использования в роботах и может быть полезно в следующих сценариях: снятие избранного после устаревания комментария, освобождение слота закрепления перед добавлением новой записи, отмена выделения вручную запущенным процессом, очистка карточки при смене сценария сопровождения сделки.

- Возвращаются признак успеха и служебное сообщение.

Рекомендуемая цепочка: при отмене сценария или по таймеру снять закрепление, затем при необходимости закрепить новую запись другим роботом.

Название поля	Описание и примеры использования
ID записи таймлайна	Идентификатор записи, которую нужно убрать из закреплённых. Должен совпадать с той записью, что ранее была закреплена. Пример: {=Variable:TIMELINE_ID}
Тип объекта CRM (ownerTypeId)	Тип объекта карточки, в которой отображается таймлайн. Пример: {=Variable:ENTITY_TYPE_ID}
ID элемента CRM (ownerId)	Идентификатор элемента CRM, привязанного к записи. Пример: {=Document:ID}

Описание примера	Решение
Снять закрепление при закрытии сделки	ID = {=Variable:PINNED_ID}, Тип объекта CRM = 2, ID элемента CRM = {=Document:ID}.
Освободить слот перед новым закреплением	Сначала открепите старую запись с теми же "Тип объекта CRM" и "ID элемента CRM", затем вызовите робот закрепления для новой.
Открепление по истечении срока	Через день после дедлайна процесса передайте ID из переменной {=Variable:OLD_PIN_ID}.
Лид и смена сценария	Тип объекта CRM = 1, ID элемента CRM = {=Document:ID}, ID записи из переменной {=Variable:TL_NOTE_ID}.
Отложенное снятие после уведомления	После отправки письма клиенту открепите служебную запись с ID из результата предыдущего шага.
Откат ошибочного закрепления	Те же параметры, что были переданы в робот закрепления при тестовом запуске процесса.
Контроль по флагу	Условие: Variable:UNPIN = Y, затем ID = {=Variable:ITEM_ID}, ID элемента CRM = {=Document:ID}.
Компания и контакт	Для контакта Тип объекта CRM = 3, ID элемента CRM = {=Document:ID} в карточке контакта.
Обработка unpin_ok = N	Читайте "Сообщение об ошибках": при NOT_FOUND проверьте, что запись не удалена и ID актуален.
Журнал изменений в карточке	Запишите в пользовательское поле факт открепления и {=User:ID} инициатора робота.

Компании

Умный поиск компаний по реквизитам

Данное активити позволяет получить список ID компаний у которых заполнены или не заполнены реквизиты.

Заполнены реквизиты: в данном поле указывается заполнены реквизиты или нет.

ИНН, КПП, ОГРН, ОГРНИП, КБЕ, ИИН: в данных полях указываются реквизиты, по которым будет осуществлен поиск компании.
Для поиска любого значения, укажите в поле "##"

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Получение данных по сущности: Компания

Активити (робот) "Получение данных по сущности: Компания" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение всех данных компании по её ID для использования в бизнес-процессе;
• Извлечение информации о компании для формирования документов или отчётов;
• Получение данных компании для передачи во внешние системы;
• Автоматическая проверка и валидация данных компании;
• Формирование персонализированных коммерческих предложений;
• Синхронизация данных компании между сущностями CRM;
• Подготовка данных для массовых рассылок и уведомлений.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID сущности	Обязательный параметр. В данном поле указывается ID компании, данные которой требуется получить. Примеры: - {=Document:ID} - ID текущей компании из документа; - 123 - конкретный ID компании; - {=Variable:COMPANY_ID} - ID компании из переменной; - {=Document:COMPANY_ID} - ID компании из связанной сущности (сделки, контакта); - {=A1988_22222_92566_99999:search_results} - ID из результата поиска.
Для печати	Варианты: да/нет. Данное поле позволяет включить вывод данных в удобном для печати текстовом виде.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Примеры использования:

№	Сценарий	ID сущности	Для печати
1	Получить данные текущей компании	{=Document:ID}	Нет
2	Получить данные компании из сделки	{=Document:COMPANY_ID}	Нет
3	Получить данные для документа	{=Variable:COMPANY_ID}	Да
4	Получить данные из результата поиска	{=A1988_22222_92566_99999:search_results}	Нет
5	Получить данные в итераторе	{=Iterator:Value}	Нет
6	Получить данные конкретной компании	12345	Нет
7	Формирование коммерческого предложения	{=Document:COMPANY_ID}	Да
8	Проверка реквизитов	{=Variable:COMPANY_ID}	Нет
9	Синхронизация с 1С	{=Variable:COMPANY_ID}	Нет
10	Получить данные из контакта	{=Document:COMPANY_ID}	Нет

Возвращаемые параметры для данного активити:

• Все параметры из сущности "Компания" - все стандартные и пользовательские поля компании, включая:
  - ID компании;
  - Название компании;
  - Телефоны, Email, Сайты;
  - Тип компании;
  - Отрасль;
  - Ответственный;
  - Источник;
  - Комментарии;
  - Адресные поля;
  - UTM-метки;
  - Пользовательские поля (UF_*);
  - и другие поля.
• Сообщение об ошибке - текст ошибки при неуспешном выполнении.

Удаление компании

Данное активити позволяет удалить сущность "Компания", указав её ID.

ID компании: в данном поле нужно указать ID удаляемой компании.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Компаний с реквизитами и без них

Данное активити позволяет получить список ID компаний у которых заполнены или не заполнены реквизиты.
Результатом работы является получение списка ID компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Заполнены реквизиты у компании: в данном поле указывается заполнены реквизиты компании или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск компаний по адресу

Данное активити позволяет выполнить поиск компаний по данным в адресном реквизите.
Результатом работы является получение списка ID, найденных компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Тип адреса: в данном поле указывается тип адреса, который указан в сущности компания: фактический адрес, адрес регистрации, юр. Адрес, адрес бенефициара.
Улица, дом, корпус, строение: в данном поле указывается адрес дома, корпуса, строения, указанный в адресных данных компании.

Квартира / офис: в данном поле указывается квартира или офис, которые указанны в адресных данных компании.

Город: в данном поле указывается город, в котором расположена компания.

Почтовый индекс: в данном поле указывается почтовый индекс, в котором расположена компания.

Район: в данном поле указывается район, в котором расположена компания.

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

Страна: в данном поле указывается страна, в котором расположена и зарегистрирована компания.

Код страны: в данном поле указывается код страны, в которой расположена компания.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменение компании

Активити (робот) "Изменение компании" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое обновление данных компании на основе информации из других систем;
• Изменение ответственного за компанию по определённым условиям;
• Обновление контактной информации (телефоны, email, адрес);
• Изменение типа компании или сферы деятельности;
• Обновление реквизитов и финансовой информации;
• Синхронизация данных компании с внешними системами (1С, ERP);
• Обновление UTM-меток и рекламных данных.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID компании	Обязательный параметр. ID компании, данные о которой необходимо изменить. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - {=Document:ID} - ID текущей компании; - 123 - конкретный ID компании; - {=Variable:COMPANY_ID} - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в компании. Варианты: почта, телефон, почта и телефон, не очищать.
Название компании	Новое название компании.
Тип компании	Тип к которому принадлежит компания. Значения берутся из справочника CRM.
Фактический адрес	Фактический адрес расположения компании.
Адрес (стр. 2)	Квартира/офис компании.
Город	Город, в котором находится компания.
Почтовый индекс	Почтовый индекс компании.
Район	Район, в котором находится компания.
Область	Область, в которой находится компания.
Страна	Страна, в которой находится компания.
Код страны	Код страны, в которой находится компания.
Юридический адрес	Юридический адрес компании (адрес регистрации, например в налоговой).
Банковские реквизиты	Банковские реквизиты компании.
Сфера деятельности	Сфера деятельности компании. Выбирается из выпадающего списка.
Валюта	Валюта для расчётов с данной компанией.
Годовой оборот	Годовой оборот компании.
Комментарии	Комментарии к компании.
Ответственный	ID ответственного за компанию. Формат: user_ID (например, user_1).
Контакт	ID контакта, связанного с компанией.
UTM-метки	Рекламная система, тип трафика, обозначение рекламной кампании, содержание кампании, условие поиска.
Телефон	Телефон компании. Активити добавляет, не удаляет существующие.
E-MAIL	Email компании. Активити добавляет, не удаляет существующие.
Сайт	Сайт компании. Активити добавляет, не удаляет существующие.

Примеры использования:

№	Сценарий	ID Компании	Изменяемое поле	Значение
1	Изменить ответственного	{=Document:ID}	Ответственный	user_25
2	Обновить название	{=Variable:COMPANY_ID}	Название компании	ООО "Новое название"
3	Изменить тип компании	{=Document:ID}	Тип компании	CLIENT
4	Добавить телефон	{=Document:ID}	Телефон	+79001234567
5	Обновить адрес	{=Variable:COMPANY_ID}	Фактический адрес	ул. Ленина, д. 1
6	Изменить сферу деятельности	{=Document:ID}	Сфера деятельности	IT
7	Очистить телефоны	{=Document:ID}	Очистить	Телефон
8	Добавить комментарий	{=Document:ID}	Комментарии	Обновлено: {=System:Date}
9	Изменить валюту	{=Document:ID}	Валюта	RUB
10	Добавить email	{=Document:ID}	E-MAIL	{=Variable:EMAIL}

Возвращаемые параметры для данного активити:

• ID компании (company_id) - числовой идентификатор изменённой компании;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Поиск Компаний (v.2)

Активити (робот) "Поиск Компаний (v.2)" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск компаний по различным полям (название, тип, отрасль, ответственный и т.д.);
• Фильтрация компаний по множеству критериев одновременно;
• Поиск компаний по частичному совпадению названия;
• Поиск компаний за определённый период (по дате создания или изменения);
• Поиск компаний по пользовательским полям;
• Проверка наличия компании перед созданием дубликата;
• Получение списка ID компаний для массовых операций.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Название компании	Поиск по названию компании. Поддерживается частичное совпадение. Примеры: - ООО "Ромашка" - точное совпадение; - ={%Ромашка%} - частичное совпадение (содержит "Ромашка"); - ={%ООО%} - все компании, содержащие "ООО".
Тип компании	Поиск по типу компании. Указывается символьный код типа из справочника CRM. Примеры: - CLIENT - клиенты; - SUPPLIER - поставщики; - PARTNER - партнёры.
Ответственный	Поиск по ответственному за компанию. Примеры: - {=Document:ASSIGNED_BY_ID} - ответственный из текущего документа; - user_25 - конкретный пользователь; - {=User:ID} - текущий пользователь.
Сфера деятельности	Поиск по сфере деятельности компании. Указывается символьный код.
Дата создания	Поиск по дате создания компании. Поддерживаются операторы сравнения. Примеры: - >={{=dateadd({=System:Now}, "-30d")}} - созданные за последние 30 дней; - <={{=dateadd({=System:Now}, "-1d")}} - созданные до вчерашнего дня.
Пользовательские поля	Активити (робот) автоматически создаёт параметры для всех пользовательских полей (UF_*) вашего портала.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Используйте только по необходимости из-за большого расхода запросов.
Запускать от имени	Сотрудник, с правами которого выполняется активити. Рекомендуется выбирать администратора.

Операторы сравнения для поиска:

Оператор	Описание	Пример
=	Точное совпадение	={123}
!	Не равно	={!123}
>=	Больше или равно	>={100}
<=	Меньше или равно	<={100}
>	Больше	>{100}
<	Меньше	<{100}
%	Содержит (для строк)	={%текст%}
!%	Не содержит (для строк)	={!%текст%}

Примеры использования:

№	Сценарий	Параметры поиска
1	Поиск по названию	Название: ={%Ромашка%}
2	Поиск по типу	Тип: CLIENT
3	Поиск по ответственному	Ответственный: {=Document:ASSIGNED_BY_ID}
4	Поиск за последний месяц	Дата создания: >={{=dateadd({=System:Now}, "-30d")}}
5	Поиск по отрасли	Сфера деятельности: IT
6	Поиск по нескольким критериям	Тип: CLIENT, Ответственный: user_1
7	Проверка дубликата	Название: ={ООО "Точное название"}
8	Поиск по пользовательскому полю	UF_CRM_*: {=Variable:VALUE}
9	Поиск активных компаний	Статус: ACTIVE
10	Поиск по городу	Город: Москва

Возвращаемые параметры для данного активити:

• Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных компаний;
• Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска через запятую;
• Первый результат поиска (search_result_first_string) - строка с первым результатом;
• Последний результат поиска (search_result_last_string) - строка с последним результатом;
• Количество найденных элементов (count_search) - числовое значение;
• Соответствует условиям (math_search_results) - Y (найдены) или N (не найдены);
• Логи ошибок (s_error_logs) - описание ошибки или сообщение об успехе.

Поиск Компании по ИНН КПП

Данное активити позволяет получить список ID компании по ИНН КПП.
Результатом работы является получение списка ID компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

ИНН:  в данном поле указываются реквизиты компаний, которые нужно найти.
Для поиска любого значения ИНН введите "##", если же нужна компания с конкретным ИНН, то нужно указать ИНН этой компании.
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Контакты

Получение данных по сущности: Контакт

Активити (робот) "Получение данных по сущности: Контакт" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение всех данных контакта по его ID для использования в бизнес-процессе;
• Извлечение информации о контакте для формирования документов или отчётов;
• Получение данных контакта для передачи во внешние системы;
• Автоматическая проверка и валидация данных контакта;
• Формирование персонализированных сообщений на основе данных контакта;
• Синхронизация данных контакта между сущностями CRM;
• Подготовка данных для массовых рассылок и уведомлений.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID сущности	Обязательный параметр. В данном поле указывается ID контакта, данные которого необходимо получить. Примеры: - {=Document:ID} - ID текущего контакта из документа; - 123 - конкретный ID контакта; - {=Variable:CONTACT_ID} - ID контакта из переменной; - {=A1988_22222_92566_99999:search_results} - ID из результата поиска.
Для печати	Варианты: да/нет. Данное поле позволяет включить вывод данных в удобном для печати текстовом виде.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Данная опция позволяет ограничить срок ожидания ответа. Технические особенности платформы Битрикс24 иногда создают ситуацию с очередями запросов, что может помешать работе активити.

Примеры использования:

№	Сценарий	ID сущности	Для печати
1	Получить данные текущего контакта	{=Document:ID}	Нет
2	Получить данные для отчёта	{=Variable:CONTACT_ID}	Да
3	Получить данные из результата поиска	{=A1988_22222_92566_99999:search_results}	Нет
4	Получить данные из сделки	{=Document:CONTACT_ID}	Нет
5	Получить данные в итераторе	{=Iterator:Value}	Нет
6	Получить данные конкретного контакта	12345	Нет
7	Формирование документа	{=Variable:CONTACT_ID}	Да
8	Проверка данных контакта	{=Document:CONTACT_ID}	Нет
9	Синхронизация с внешней системой	{=Variable:CONTACT_ID}	Нет
10	Формирование персонализированного сообщения	{=Document:CONTACT_ID}	Нет

Возвращаемые параметры для данного активити:

• Все данные из сущности контакт - все стандартные и пользовательские поля контакта, включая:
  - ID контакта;
  - Имя, Фамилия, Отчество;
  - Телефоны, Email, Сайты;
  - Компания (ID связанной компании);
  - Ответственный;
  - Должность;
  - Источник;
  - Комментарии;
  - UTM-метки;
  - Пользовательские поля (UF_*);
  - и другие поля.
• Сообщение об ошибке - текст ошибки при неуспешном выполнении.

Удаление контакта

Данное активити позволяет удалить сущность "Контакт", указав её ID.

ID контакта: в данном поле нужно указать ID удаляемого контакта.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Контактов с реквизитами и без

Данное активити позволяет получить список ID контактов по наличию или отсутствию у них реквизитов.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Заполнены реквизиты у контакта: в данном поле указывается заполнены реквизиты контакта или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск контактов по адресу

Данное активити позволяет выполнить поиск контактов по данным в адресном реквизите.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Тип адреса: в данном поле указывается тип адреса реквизитов, который указан в искомом контакте: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.
Улица, дом, корпус, строение: в данном поле указываются адресные данные контакта, такие как улица, дом, корпус, строение, которые указан в адресном реквизите.

Квартира / офис: в данном поле указывается номер квартиры или офиса, который указан в адресном реквизите.

Город: в данном поле указывается город, где проживает или находится данный контакт, который указан в адресном реквизите.

Почтовый индекс: в данном поле указывается почтовый индекс, который указан в адресном реквизите.

Район: в данном поле указывается район расположения контакта, который указан в адресном реквизите.

Область: в данном поле указывается область, которая указана в адресном реквизите.

Страна: в данном поле указывается страна, которая указана в адресном реквизите.

Код страны:  в данном поле указывается код страны, который указан в адресном реквизите.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменение Контакта

Активити (робот) "Изменение Контакта" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое обновление данных контакта на основе информации из других систем;
• Изменение ответственного за контакт по определённым условиям;
• Обновление контактной информации (телефоны, email, адрес);
• Привязка контакта к компании или нескольким компаниям;
• Изменение типа контакта или источника;
• Обновление UTM-меток и рекламных данных;
• Синхронизация данных контакта с внешними системами.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID Контакта	Обязательный параметр. ID контакта, которого необходимо изменить. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - {=Document:ID} - ID текущего контакта; - 123 - конкретный ID контакта; - {=Variable:CONTACT_ID} - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в контакте. Варианты: почта, телефон, почта и телефон, не очищать.
Обращение	Обращение к клиенту (мистер, товарищ, госпожа и т.д.).
Имя	Новое значение имени контакта.
Фамилия	Новое значение фамилии контакта.
Отчество	Новое значение отчества контакта.
Дата рождения	Новое значение даты рождения контакта.
Тип контакта	Изменение типа контакта. Значения берутся из справочника CRM.
Источник	Изменение источника контакта. Значения берутся из справочника CRM.
Описание	Тип источника, из которого контакт попал в CRM.
Должность	Изменение должности контакта.
Адресные поля	Адрес, город, почтовый индекс, район, область, страна (устаревшие поля, сейчас используются реквизиты).
Комментарий	Изменение комментария контакта.
Доступен для всех	Варианты: да/нет. Доступен ли контакт для всех сотрудников.
Ответственный	Изменение ответственного за контакт. Указывается ID пользователя.
Компания	Изменение компании, которая относится к контакту. Указывается ID компании.
Компании	Изменение нескольких компаний для контакта (когда один контакт привязан к множеству компаний).
UTM-метки	Рекламная система, тип трафика, обозначение рекламной кампании, содержание кампании, условие поиска.
Телефон	Добавление телефонов. Активити только добавляет, не удаляет существующие.
EMAIL	Добавление адресов электронной почты. Активити только добавляет, не удаляет существующие.
Сайт	Добавление адресов сайтов. Активити только добавляет, не удаляет существующие.
Мессенджеры	Добавление адресов интернет-мессенджеров.

Примеры использования:

№	Сценарий	ID Контакта	Изменяемое поле	Значение
1	Изменить ответственного	{=Document:ID}	Ответственный	user_25
2	Обновить должность	{=Variable:CONTACT_ID}	Должность	Директор
3	Привязать к компании	{=Document:ID}	Компания	{=Variable:COMPANY_ID}
4	Добавить телефон	{=Document:ID}	Телефон	+79001234567
5	Изменить тип контакта	{=Document:ID}	Тип контакта	CLIENT
6	Обновить ФИО	{=Variable:CONTACT_ID}	Имя, Фамилия	Иван, Петров
7	Очистить телефоны	{=Document:ID}	Очистить	Телефон
8	Добавить комментарий	{=Document:ID}	Комментарий	Обновлено: {=System:Date}
9	Изменить источник	{=Document:ID}	Источник	WEB
10	Добавить email	{=Document:ID}	EMAIL	{=Variable:EMAIL}

Возвращаемые параметры для данного активити:

• ID контакта (contact_id) - числовой идентификатор изменённого контакта;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Поиск Контактов по ИНН КПП

Данное активити позволяет получить список ID контактов по ИНН КПП.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

ИНН: в данном поле указываются реквизиты контактов, которые нужно найти.
Для поиска любого значения ИНН введите "##", если же нужен контакт с конкретным ИНН, то нужно указать ИНН этого контакта.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Контакта (v.2)

Активити (робот) "Поиск контактов v2" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск контактов по ФИО, должности, адресу и другим полям;
• Поиск контактов по телефону или email с использованием механизма поиска дубликатов;
• Фильтрация контактов для создания отчётов и аналитики;
• Автоматический поиск связанных контактов при работе со сделками и лидами;
• Поиск дубликатов контактов для очистки базы данных;
• Поиск контактов по UTM-меткам для анализа эффективности маркетинга;
• Поиск контактов по дате создания или изменения для контроля актуальности данных;
• Поиск контактов по пользовательским полям для сложной фильтрации;
• Массовые операции над группой контактов (изменение полей, назначение ответственного);
• Интеграция с внешними системами через поиск по внешним идентификаторам.

Название поля	Описание и примеры использования
Сообщение об ошибке	В данном поле указывается, будет ли выводиться сообщение об ошибке в журнал БП или нет. Варианты: да/нет.
ID	В данном поле указывается числовой идентификатор искомого контакта. Примеры: - ={123} - найти контакт с ID равным 123; - ={!123} - найти все контакты, кроме контакта с ID 123; - {=Document:CONTACT_ID} - использовать ID контакта из текущего документа.
Имя	В данном поле указывается имя искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%Иван} - найти контакты, имя которых содержит "Иван"; - ={Иван} - найти контакты с точным именем "Иван"; - ={!%Тест} - найти контакты, имя которых не содержит "Тест".
Отчество	В данном поле указывается отчество искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%Иванович} - найти контакты с отчеством, содержащим "Иванович"; - ={Петрович} - найти контакты с точным отчеством "Петрович".
Фамилия	В данном поле указывается фамилия искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%Петров} - найти контакты с фамилией, содержащей "Петров"; - ={Иванов} - найти контакты с точной фамилией "Иванов"; - {=Document:LAST_NAME} - использовать фамилию из текущего документа.
Описание	В данном поле указывается текст описания искомого контакта. Поддерживает поиск по частичному совпадению. Примеры: - ={%VIP} - найти контакты, описание которых содержит "VIP"; - ={!%тест} - найти контакты, описание которых не содержит "тест".
Должность	В данном поле указывается должность искомого контакта. Примеры: - ={%директор} - найти контакты с должностью, содержащей "директор"; - ={Менеджер} - найти контакты с точной должностью "Менеджер".
Адрес	В данном поле указывается фактический адрес контакта (устаревшее поле, сейчас используются реквизиты). Примеры: - ={%Москва} - найти контакты с адресом, содержащим "Москва".
Адрес (стр. 2)	В данном поле указывается адрес квартиры или офиса контакта (устаревшее поле, сейчас используются реквизиты).
Город	В данном поле указывается город расположения контакта (устаревшее поле, сейчас используются реквизиты). Примеры: - ={Санкт-Петербург} - найти контакты из Санкт-Петербурга.
Почтовый индекс	В данном поле указывается почтовый индекс контакта (устаревшее поле, сейчас используются реквизиты).
Район	В данном поле указывается район контакта.
Область	В данном поле указывается область контакта.
Страна	В данном поле указывается страна контакта. Примеры: - ={Россия} - найти контакты из России.
Код страны	В данном поле указывается код страны контакта. Примеры: - ={RU} - найти контакты с кодом страны RU.
Комментарий	В данном поле указывается текст комментария к контакту. Поддерживает поиск по частичному совпадению. Примеры: - ={%важно} - найти контакты, комментарий которых содержит "важно".
Дата создания	В данном поле указывается дата создания контакта. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={=>01.01.2025 00:00:00} - найти контакты, созданные после 1 января 2025 года; - ={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}} - найти контакты, созданные в 2025 году.
Дата изменения	В данном поле указывается дата последнего изменения контакта. Примеры: - ={=>01.03.2025 00:00:00} - найти контакты, изменённые после 1 марта 2025 года.
Внешний источник	В данном поле указывается идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Идентификатор элемента внешнего источника	В данном поле указывается внешний ключ, используемый для операций обмена. Идентификатор объекта внешней информационной базы.
Версия оригинала	В данном поле указывается версия внешнего ключа, используемого для операций обмена.
Рекламная система (UTM_SOURCE)	В данном поле указывается UTM SOURCE из UTM-метки. Примеры: - ={%google} - найти контакты из рекламной системы Google; - ={%yandex} - найти контакты из рекламной системы Yandex.
Тип трафика (UTM_MEDIUM)	В данном поле указывается UTM MEDIUM из UTM-метки. Примеры: - ={%cpc} - найти контакты с типом трафика "cost per click"; - ={%organic} - найти контакты с органическим трафиком.
Обозначение рекламной кампании (UTM_CAMPAIGN)	В данном поле указывается UTM CAMPAIGN из UTM-метки. Примеры: - ={%летняя} - найти контакты из кампании "летняя распродажа".
Содержание кампании (UTM_CONTENT)	В данном поле указывается UTM CONTENT из UTM-метки.
Условие поиска кампании (UTM_TERM)	В данном поле указывается UTM TERM из UTM-метки (обычно ключевое слово).
Телефон	В данном поле указывается номер телефона для поиска контакта. Поиск осуществляется через механизм поиска дубликатов (crm.duplicate.findbycomm). Примеры: - +79001234567 - найти контакт с указанным телефоном; - {=Document:PHONE} - использовать телефон из текущего документа.
E-mail	В данном поле указывается email для поиска контакта. Поиск осуществляется через механизм поиска дубликатов (crm.duplicate.findbycomm). Примеры: - test@example.com - найти контакт с указанным email; - {=Document:EMAIL} - использовать email из текущего документа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Поиск контакта по телефону +79001234567	Параметры: Телефон - +79001234567. Активити (робот) найдёт контакт с указанным номером телефона через механизм поиска дубликатов. Результат будет возвращён в параметре search_results_array.
Поиск контакта по email из текущей сделки	Параметры: E-mail - {=Document:EMAIL}. Активити (робот) найдёт контакт с email из текущего документа.
Поиск контактов с фамилией, содержащей "Иванов"	Параметры: Фамилия - ={%Иванов}. Активити (робот) найдёт все контакты, фамилия которых содержит "Иванов" (Иванов, Иванова, Ивановский и т.д.).
Поиск контактов из Москвы с должностью директор	Параметры: Город - ={Москва}, Должность - ={%директор}. Активити (робот) найдёт все контакты из Москвы, должность которых содержит слово "директор".
Поиск контактов, созданных за последний месяц	Параметры: Дата создания - ={=>{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все контакты, созданные за последний месяц.
Поиск контактов из рекламной кампании Google	Параметры: Рекламная система (UTM_SOURCE) - ={%google}. Активити (робот) найдёт все контакты, пришедшие из рекламной системы Google.
Поиск контактов по точному ФИО: Иванов Иван Иванович	Параметры: Фамилия - ={Иванов}, Имя - ={Иван}, Отчество - ={Иванович}. Активити (робот) найдёт контакт с точным совпадением ФИО.
Поиск контактов, кроме тестовых	Параметры: Имя - ={!%тест}, Описание - ={!%тест}. Активити (робот) найдёт все контакты, имя и описание которых не содержат слово "тест".
Поиск контактов по внешнему идентификатору из 1С	Параметры: Идентификатор элемента внешнего источника - ={1C_12345}. Активити (робот) найдёт контакт с указанным внешним идентификатором для синхронизации с 1С.
Поиск контактов, изменённых в определённый период	Параметры: Дата изменения - ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}. Активити (робот) найдёт все контакты, изменённые в январе 2025 года.

Лиды

Поиск Лида (v.2)

Активити (робот) "Поиск лида v2" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск лидов по ФИО, названию компании, должности и другим полям;
• Поиск лидов по телефону или email с использованием механизма поиска дубликатов;
• Фильтрация лидов для создания отчётов и аналитики;
• Поиск дубликатов лидов для очистки базы данных;
• Поиск лидов по источникам для анализа эффективности каналов привлечения;
• Поиск лидов по статусам для автоматизации воронки продаж;
• Массовые операции над группой лидов (изменение статуса, назначение ответственного);
• Поиск лидов по дате создания для контроля актуальности;
• Поиск лидов по пользовательским полям для сложной фильтрации;
• Интеграция с внешними системами через поиск по внешним идентификаторам.

Название поля	Описание и примеры использования
ID	В данном поле указывается числовой идентификатор искомого лида. Примеры: - ={123} - найти лид с ID равным 123; - {=Document:ID} - использовать ID из текущего документа; - ={!123} - найти все лиды, кроме лида с ID 123.
Название лида	В данном поле указывается название искомого лида. Поддерживает поиск по частичному совпадению. Примеры: - ={%заявка} - найти лиды, название которых содержит "заявка"; - ={Заявка с сайта} - найти лид с точным названием; - ={!%тест} - найти лиды, название которых не содержит "тест".
Обращение	В данном поле указывается обращение, которое содержится в искомом лиде. Примеры: - ={Господин} - найти лиды с обращением "Господин".
Имя	В данном поле указывается имя, указанное в искомом лиде. Поддерживает поиск по частичному совпадению. Примеры: - ={%Иван} - найти лиды с именем, содержащим "Иван"; - ={Иван} - найти лиды с точным именем "Иван".
Отчество	В данном поле указывается отчество, указанное в искомом лиде. Примеры: - ={%Иванович} - найти лиды с отчеством, содержащим "Иванович".
Фамилия	В данном поле указывается фамилия, указанная в искомом лиде. Примеры: - ={%Петров} - найти лиды с фамилией, содержащей "Петров"; - {=Document:LAST_NAME} - использовать фамилию из текущего документа.
Название компании	В данном поле указывается название компании, которое указано в поле лида "Название компании". Примеры: - ={%ООО} - найти лиды с названием компании, содержащим "ООО"; - ={ООО Рога и копыта} - найти лид с точным названием компании.
Источник	В данном поле можно выбрать источники искомого лида. Выбрать можно несколько штук, зажав Ctrl и кликая по нужным источникам. Примеры: - WEB - найти лиды из источника "Веб-сайт"; - CALL - найти лиды из источника "Звонок".
Дополнительно об источнике	В данном поле указываются дополнительные сведения об источнике лида. Примеры: - ={%реклама} - найти лиды с дополнительной информацией об источнике, содержащей "реклама".
Статус	В данном поле можно выбрать несколько статусов для искомого лида. Выбрать можно несколько штук, зажав Ctrl и кликая по нужным статусам. Примеры: - Новый - найти новые лиды; - В работе - найти лиды в работе.
Дополнительно о статусе	В данном поле указываются дополнительные сведения о статусе лида.
Состояние статуса	В данном поле указывается состояние статуса искомого лида. Примеры: - ={P} - найти лиды в работе (Process); - ={S} - найти успешно конвертированные лиды (Success); - ={F} - найти проваленные лиды (Failed).
Должность	В данном поле указывается должность, которая указана в поле лида "Должность". Примеры: - ={%директор} - найти лиды с должностью, содержащей "директор".
Адрес	В данном поле указывается значение "фактического адреса", заполненное в искомом лиде. Примеры: - ={%Москва} - найти лиды с адресом, содержащим "Москва".
Адрес (стр. 2)	В данном поле указывается значение "квартира/офис фактического адреса", заполненное в искомом лиде.
Город	В данном поле указывается город, который указан в поле лида "Город". Примеры: - ={Санкт-Петербург} - найти лиды из Санкт-Петербурга.
Телефон	В данном поле указывается телефон, который был указан в лиде в соответствующем поле. Поиск осуществляется через механизм поиска дубликатов. Примеры: - +79001234567 - найти лид с указанным телефоном; - {=Document:PHONE} - использовать телефон из текущего документа.
E-mail	В данном поле указывается email, который был указан в лиде в соответствующем поле. Поиск осуществляется через механизм поиска дубликатов. Примеры: - test@example.com - найти лид с указанным email; - {=Document:EMAIL} - использовать email из текущего документа.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Описание примера	Решение
Поиск лида по телефону +79001234567	Параметры: Телефон - +79001234567. Активити (робот) найдёт лид с указанным номером телефона через механизм поиска дубликатов.
Поиск лида по email из текущей сделки	Параметры: E-mail - {=Document:EMAIL}. Активити (робот) найдёт лид с email из текущего документа.
Поиск лидов с фамилией, содержащей "Иванов"	Параметры: Фамилия - ={%Иванов}. Активити (робот) найдёт все лиды, фамилия которых содержит "Иванов".
Поиск лидов из источника "Веб-сайт"	Параметры: Источник - WEB. Активити (робот) найдёт все лиды, пришедшие через веб-сайт.
Поиск новых лидов	Параметры: Статус - Новый. Активити (робот) найдёт все лиды в статусе "Новый".
Поиск лидов в работе	Параметры: Состояние статуса - ={P}. Активити (робот) найдёт все лиды со статусом "В работе" (Process).
Поиск лидов из компании, содержащей "ООО"	Параметры: Название компании - ={%ООО}. Активити (робот) найдёт все лиды, у которых название компании содержит "ООО".
Поиск лидов с должностью "директор"	Параметры: Должность - ={%директор}. Активити (робот) найдёт все лиды, должность которых содержит "директор".
Поиск лидов из Москвы	Параметры: Город - ={Москва}. Активити (робот) найдёт все лиды из Москвы.
Поиск проваленных лидов	Параметры: Состояние статуса - ={F}. Активити (робот) найдёт все проваленные лиды (Failed).

Создание лида с товарами

Данное активити позволяет создавать лид, к которому перекреплены товарные позиции.

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
TITLE (Название Лида):	В данном поле можно указать значение названия Лида.
HONORIFIC(обращение):	Обращение к клиенту (мистер, товарищ, госпожа и т.д.)
NAME (Имя контакта):	В данном поле можно указать значение имени Контакта.
SECOND_NAME (Фамилия контакта):	В данном поле можно указать значение фамилии Контакта.
LAST_NAME (отчество контакта):	В данном поле можно указать значение отчества Контакта.
BIRTHDATE (Дата рождения):	В данном поле можно указать значение даты рождения Контакта.
COMPANY_TITLE (Название компании):	В данном поле можно указать название компании.
SOURCE_ID (Источник Лида):	В данном поле можно указать источник Лида. Значения берутся из одноимённого справочника CRM.

SOURCE_DESCRIPTION (описание источника):    в данном пункте указывается тип источника из которого лид попал в CRM. 

Название	Описание
STATUS_ID(обозначение статуса):	В данном пункте вводится код статуса, который можно получить из специальной таблицы.
STATUS_DESCRIPTION(описание статуса):	В данном пункте указывается тип источника статуса из которого лид попал в CRM.
STATUS_SEMANTIC_ID:	На текущий момент данное поле не используется. Оно будет необходимо для сквозной аналитики от Битрикс24.
POST (должность контакта):	В данном поле можно указать должность Контакта.
ADDRESS (Фактический адрес):	В данном поле можно указать фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_2 (квартира\офис фактического адреса):	В данном поле можно указать адрес квартиры или офиса Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_CITY (Город фактического адреса):	В данном поле можно указать город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_POSTAL_CODE (Почтовый индекс фактического адреса):	В данном поле можно указать почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_REGION (Район фактического адреса):	В данном поле можно указать район Контакта (устаревшее поле, сейчас используются реквизиты).
ASSIGNED_BY_ID (Ответственный за компанию):	В данном поле можно указать ответственного за компанию. Следует помнить, что поле должно принимать формат
ADDRESS_PROVINCE (Область фактического адреса):	В данном поле можно указать область Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_COUNTRY (Страна фактического адреса):	В данном поле можно указать страну Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_COUNTRY_CODE (Код страны фактического адреса):	В данном поле можно указать код страны Контакта (устаревшее поле, сейчас используются реквизиты).
CURRENCY_ID (Валюта расчетов):	В данном поле можно указать валюту расчётов Лида. Значения берутся из одноимённого справочника CRM.
OPPORTUNITY (Предполагаемая сумма):	В данном поле можно указать предполагаемую сумму по Лиду. Данное поле заполняется автоматически из товарного раздела и не следует его менять если у Вас заполнены в Лиде товары с ценами.
COMMENTS (Комментарий):	В данном поле можно указать комментарий компании.
ASSIGNED_BY_ID (Ответственный за компанию):	В данном поле можно указать ответственного за компанию. Следует помнить, что поле должно принимать формат - user_ID (например user_1).
ORIGINATOR_ID (Идентификатор внешней информационной базы):	Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
ORIGIN_ID (Внешний ключ, используется для операций обмена):	Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С, для того, чтобы сопоставить компанию в разных системах.
UTM_SOURCE (метка источника):	В данном поле можно указать метку источника рекламной кампании.
UTM_MEDIUM (метка типа кампании):	В данном поле можно указать метку источника рекламной кампании.
UTM_CAMPAIGN (метка названия кампании):	В данном поле можно указать метку названия рекламной кампании.
UTM_CONTENT (метка контейнера кампании):	В данном поле можно указать метку дополнительного контейнера рекламной кампании.
UTM_TERM (метка ключевого слова кампании):	В данном поле можно указать метку ключевого слова рекламной кампании.
PHONE (Телефон):	В данном поле можно добавить разные номера телефонов. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
EMAIL (адрес электронно почты):	В данном поле можно добавить разные адреса электронной почты. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
WEB (адрес сайта):	В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
IM (интернет мессенджеры):	В данном поле можно добавить разные адреса интернет - мессенджеров компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.

Товары (ID##количество##ед. измерения##цена): один из самых главных пунктов данного активити. В данный пункт заполняются товарные позиции, которые будут прикреплены к лиду.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Изменение Лида

Активити (робот) "Изменение Лида" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое обновление данных лида на основе информации из других систем;
• Изменение статуса лида при прохождении этапов воронки;
• Обновление контактной информации (телефоны, email);
• Изменение ответственного за лид по определённым условиям;
• Обновление суммы и валюты расчётов;
• Работа с НДС и скидками на товары в лиде;
• Синхронизация данных лида с внешними системами.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID лида	Обязательный параметр. ID лида, который Вы будете редактировать. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - {=Document:ID} - ID текущего лида; - 123 - конкретный ID лида; - {=Variable:LEAD_ID} - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в лиде. Варианты: почта, телефон, почта и телефон, не очищать.
Ставка НДС	Ставка налога в лиде. Работает только если настроено поле "Способ начисления НДС".
Способ начисления НДС	Как будет начисляться НДС: сверху или уже включен в стоимость.
Тип скидки	Тип скидки. Варианты: сумма или процент.
Размер скидки	Размер предоставляемой скидки.
Название Лида	Новое название лида.
Обращение	Обращение к клиенту (мистер, товарищ, госпожа и т.д.).
Имя	Новое значение имени контакта в лиде.
Фамилия	Новое значение фамилии контакта в лиде.
Отчество	Новое значение отчества контакта в лиде.
Дата рождения	Новое значение даты рождения.
Название компании	Название компании в лиде.
Источник	Источник лида. Значения берутся из справочника CRM.
Дополнительно об источнике	Тип источника, из которого лид попал в CRM.
Статус	Код статуса лида. Можно получить из специальной таблицы статусов.
Должность	Должность контакта в лиде.
Адресные поля	Адрес, город, почтовый индекс, район, область, страна (устаревшие поля, сейчас используются реквизиты).
Валюта расчетов	Валюта расчётов лида. Значения берутся из справочника CRM.
Сумма	Предполагаемая сумма по лиду. Данное поле заполняется автоматически из товарного раздела. Не меняйте его, если в лиде заполнены товары с ценами.
Комментарий	Комментарий к лиду.
Ответственный	ID ответственного. Формат: user_ID (например, user_1).
Компания	ID компании, привязанной к лиду.
Контакт	ID контакта, привязанного к лиду.
Телефон	Телефоны. Активити добавляет, не удаляет существующие.
EMAIL	Адреса email. Активити добавляет, не удаляет существующие.
Сайт	Сайты. Активити добавляет, не удаляет существующие.
Мессенджер	Адреса интернет-мессенджеров. Активити добавляет, не удаляет существующие.

Примеры использования:

№	Сценарий	ID Лида	Изменяемое поле	Значение
1	Изменить статус	{=Document:ID}	Статус	IN_PROCESS
2	Изменить ответственного	{=Variable:LEAD_ID}	Ответственный	user_25
3	Обновить название	{=Document:ID}	Название Лида	Новый лид от {=System:Date}
4	Добавить телефон	{=Document:ID}	Телефон	+79001234567
5	Изменить источник	{=Document:ID}	Источник	WEB
6	Обновить сумму	{=Document:ID}	Сумма	{=Variable:AMOUNT}
7	Очистить телефоны	{=Document:ID}	Очистить	Телефон
8	Добавить комментарий	{=Document:ID}	Комментарий	Обработано: {=System:Date}
9	Изменить валюту	{=Document:ID}	Валюта расчетов	RUB
10	Установить скидку	{=Document:ID}	Размер скидки	10

Возвращаемые параметры для данного активити:

• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Получение данных по сущности: Лид

Активити (робот) "Получение данных по сущности: Лид" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение всех данных лида по его ID для использования в бизнес-процессе;
• Извлечение информации о лиде для квалификации и распределения;
• Получение данных лида для формирования документов или отчётов;
• Автоматическая проверка и валидация данных лида;
• Формирование персонализированных сообщений на основе данных лида;
• Подготовка данных для конвертации лида в сделку, контакт, компанию;
• Синхронизация данных лида с внешними системами.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID сущности	Обязательный параметр. В данном поле указывается ID лида, данные которого необходимо получить. Примеры: - {=Document:ID} - ID текущего лида из документа; - 123 - конкретный ID лида; - {=Variable:LEAD_ID} - ID лида из переменной; - {=A1988_22222_92566_99999:search_results} - ID из результата поиска.
Для печати	Вывод данных в пригодном для печати текстовом виде. Варианты: да/нет.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Данная опция позволяет ограничить срок ожидания ответа. Технические особенности платформы Битрикс24 иногда создают ситуацию с очередями запросов.

Примеры использования:

№	Сценарий	ID сущности	Для печати
1	Получить данные текущего лида	{=Document:ID}	Нет
2	Получить данные для отчёта	{=Variable:LEAD_ID}	Да
3	Получить данные из результата поиска	{=A1988_22222_92566_99999:search_results}	Нет
4	Получить данные в итераторе	{=Iterator:Value}	Нет
5	Получить данные конкретного лида	12345	Нет
6	Квалификация лида	{=Document:ID}	Нет
7	Подготовка к конвертации	{=Variable:LEAD_ID}	Нет
8	Формирование письма	{=Document:ID}	Нет
9	Синхронизация с CRM	{=Variable:LEAD_ID}	Нет
10	Проверка источника	{=Document:ID}	Нет

Возвращаемые параметры для данного активити:

• Сообщение об ошибке - текст ошибки при неуспешном выполнении;
• Все данные полей по сущности Лид - все стандартные и пользовательские поля лида, включая:
  - ID лида;
  - Название лида;
  - Имя, Фамилия, Отчество;
  - Телефоны, Email;
  - Статус лида;
  - Источник;
  - Ответственный;
  - Сумма и валюта;
  - Комментарии;
  - UTM-метки;
  - Товарные позиции (если есть);
  - Пользовательские поля (UF_*);
  - и другие поля.

Удаление лида

Данное активити позволяет удалить сущность лид, указав её ID.



ID лида: в данном поле нужно указать ID удаляемого лида.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

ТЕСТ

ТЕСТ 1

ТЕСТ2

Подразделения

Поиск подразделений

Активити (робот) «Поиск подразделений» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда нужно найти подразделения компании по одному или нескольким критериям (идентификатор, название, родитель, руководитель) и получить список их ID для дальнейших шагов бизнес-процесса.

Результат формируется запросом к REST-методу department.get.
Названия полей в форме активити подставляются из справочника полей подразделений портала.
При большом числе совпадений ответ может приходить порциями; активити собирает все найденные записи и извлекает из них поле ID.

- Активити передаёт непустые значения в метод поиска и обрабатывает структуру ответа, в том числе когда записей больше пятидесяти;
- При успехе возвращаются массив ID, строка через запятую, первый и последний ID в выборке;
- Если фильтр пуст, подразделения не найдены или список ID пуст, активити завершится с ошибкой или признаком неуспеха в зависимости от ситуации.


Типичная цепочка: задать условие поиска, получить массив числовых ID подразделений или те же ID в одной строке через запятую (строка), проверить параметр "успешного выполнения задачи" и количество найденных элементов.
Затем передать найденные ID в другие роботы или переменные процесса.

Название поля	Описание и примеры использования
ID	Числовой идентификатор подразделения для точного поиска. Пример: 42 Поле необязательное, но вместе с остальными должно участвовать в заполнении хотя бы одного критерия фильтра.
Название	Строка для поиска по наименованию подразделения (как настроено в полях портала). Пример: Отдел продаж
Родитель	Идентификатор вышестоящего подразделения в иерархии. Пример: 10
Руководитель	Пользователь-руководитель (поле типа пользователь в форме робота). Указывается как сотрудник из структуры портала. Пример: выбор пользователя из списка в конструкторе бизнес-процесса.

Описание примера	Решение
Найти подразделение по точному ID	ID = 15, остальные поля пустые. Используйте параметр "Результат поиска (массив для итератора)" для одной записи или проверьте количество найденных ID.
Фильтр по родительскому отделу	Родитель = 3, Название пустое. Дочерние подразделения попадут в массив числовых ID.
Поиск по названию филиала	Название = Москва, остальные поля по необходимости. Сверьте количество найденных ID с ожидаемым числом отделов.
Все отделы, где руководитель — конкретный сотрудник	Руководитель = выбранный пользователь, ID и Название не заданы. Результат — список ID из массива числовых ID подразделений.
Передать первый найденный ID в переменную	После шага возьмите набор найденных ID из параметра "Результат поиска (строка)" для подстановки в поле следующего действия.
Сравнить с отделом из сделки	ID = {=Document:UF_DEPARTMENT} при условии, что в поле сделки хранится один числовой ID подразделения.
Строка ID для внешней системы	Используйте найденные ID из параметра "Результат поиска (строка)" как единую строку с перечислением через запятую для вебхука.
Остановить сценарий, если ничего не найдено	Настройте ветку ошибки после активити или проверку параметра "Успех выполнения операции" = N в условии.
Комбинация: родитель и часть названия	Родитель = 7, Название = Логистика. Уточняет выборку внутри ветки оргструктуры.
Последний ID в отсортированном списке результатов	После успешного поиска используйте параметр "Последний результат поиска", если порядок в ответе соответствует логике выборки портала.

Получить сведения о выбранном подразделении

Активити (робот) «Получить сведения о выбранном подразделении для чатов» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда нужно по одному подразделению оргструктуры получить краткое название, полное название и список идентификаторов руководителей для уведомлений, задач или записи в поля сущности.

Результат формируется запросом к REST-методу im.department.get.
В поле ID подразделения допускается только одно числовое значение без перечисления через запятую.
Расширенный набор данных пользователей в запрос не передаётся (режим как у других роботов подразделений).


Типичная цепочка: получить из переменной или поля документа один ID отдела, вызвать активити, записать значение параметров "Название" в комментарий, "ID руководителя"  — в задачу или согласование.

Название поля	Описание и примеры использования
ID подразделения	Один числовой идентификатор подразделения. Строка «5» или «12» допустима; перечисление «3,7» недопустимо. Пример: 8

Описание примера	Решение
Подставить название отдела в тему задачи	ID подразделения = {=Variable:DEPT_ID}. В следующем шаге используйте возвращаемый параметр "Название" в тексте «Копия {=Variable:TITLE}».
Записать полный путь отдела в комментарий	ID подразделения = 14. В комментарий выведите параметр "Полное название" из результата активити.
Назначить задачу руководителю отдела	Возьмите первый элемент из "ID руководителя" или используйте множественное поле в шаге, где допускается несколько ответственных.
Сверить отдел сделки с карточкой оргструктуры	ID подразделения = {=Document:UF_DEPARTMENT} при условии, что в поле один числовой ID. Сравните параметр "Название" с ожидаемым текстом во вложенном условии.
Передать ID руководителей в переменную процесса	Сохраните параметр "ID руководителя" в множественную переменную типа пользователь или число для последующей рассылки.
Проверка непустого названия перед записью в поле CRM	После шага проверьте, что параметр "Название" не пустой; иначе не перезаписывайте поле сделки или запросите ID у оператора.
Ошибка запроса и альтернативная ветка	При сбое запроса служебное поле параметра "Сообщение об ошибке" содержит префикс ошибки и текст; настройте условие по пустыми параметрами  "Название" и "Полное название" при необходимости.
Фиксация названия в лиде	ID подразделения из переменной {=Variable:SELECTED_DEPT}. Запишите параметр "Название" в пользовательское поле лида текстом.
Один ответственный из списка руководителей	Если в "ID руководителя" несколько значений, используйте первое значение во вложенном выражении или отдельном роботе выбора.
Проверка перед вложенным роботом по отделам	Сначала убедитесь, что {=Variable:DEPT_ID} не пустой и не содержит запятую; затем передайте его в поле ID подразделения.

Получить руководителей выбранного подразделения

Активити (робот) «Получить руководителей выбранного подразделения» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда нужно по одному или нескольким подразделениям получить список руководителей (пользователей) и передать их идентификаторы в согласования, задачи или уведомления.

Результат формируется запросом к REST-методу im.department.managers.get.
В запросе подробные карточки пользователей не запрашиваются: активити собирает только идентификаторы руководителей.
Список ID в результате уникален, отсортирован по возрастанию числового значения.


Типичная цепочка: указать ID отделов из оргструктуры, получить значения параметра "Результат поиска (массив для итератора)" или "Результат поиска (строка)", проверить параметр "Успех выполнения операции", затем назначить согласование или задачу руководителям.

Название поля	Описание и примеры использования
ID подразделений	Один или несколько идентификаторов подразделений через запятую. Пробелы вокруг запятой допускаются. Пример: 2,9 Поле должно быть заполнено, иначе активити завершится с ошибкой «Не указаны ID подразделений».
Формат получения данных	Определяет вид значений в результатах. Число (1,2,3) — в массиве и строке возвращаются числовые ID пользователей. Пользователь (user_1,user_2,user_3) — те же ID в виде строк с префиксом user_, удобно для роботов, где ожидается формат пользователя.

Описание примера	Решение
Один отдел: согласование с руководителем	ID подразделений = 6, Формат получения данных = Пользователь (user_1,user_2,user_3). Подставьте search_result_first_string в шаг согласования.
Несколько отделов: объединённый список руководителей	ID подразделений = 4,5,11, Формат получения данных = Число (1,2,3). Один человек не дублируется, если числится в нескольких выбранных отделах.
Массовая задача всем руководителям из выборки	Формат получения данных = Число (1,2,3). Используйте параметр "Результат поиска (массив для итератора)" как источник для итератора или множественного назначения.
Строка ID для интеграции	Формат получения данных = Число (1,2,3). Передайте параметр "Результат поиска (строка)" во внешний вебхук.
Сравнить с ответственным по сделке	Формат получения данных = Число (1,2,3). Проверьте вхождение {=Document:ASSIGNED_BY_ID} в параметре "Результат поиска (массив для итератора)".
Остановка при отсутствии руководителей	После шага проверьте параметры "Успех выполнения операции" = Y и "Количество найденных элементов" больше нуля перед рассылкой.
Комментарий: сколько руководителей найдено	Запишите текст «Руководителей: » и значение параметра "Количество найденных элементов" в комментарий к задаче.
Последний ID в отсортированном списке	Формат получения данных = Число (1,2,3). Используйте параметр "Последний результат поиска" как наибольший ID в выборке.
ID отделов из переменной процесса	ID подразделений = {=Variable:DEPT_LIST} (строка с числами через запятую). Убедитесь, что переменная не пустая.
Формат user для уведомлений портала	Формат получения данных = Пользователь (user_1,user_2,user_3). Значения из параметра "" подходят для шагов с типом пользователь в формате user_ID.

Получить сотрудников выбранного подразделения

Активити (робот) «Получить сотрудников выбранного подразделения» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда нужно по одному или нескольким подразделениям компании получить список сотрудников (пользователей) и передать их идентификаторы в следующие шаги бизнес-процесса.

Результат формируется запросом к REST-методу im.department.employees.get.
В запросе подробные карточки пользователей из API не запрашиваются: активити собирает только идентификаторы сотрудников.
Список ID в результате уникален, отсортирован по возрастанию числового значения.


Типичная цепочка: указать ID отделов из оргструктуры, получить значения в параметрах  "Результат поиска (массив для итератора)" и Результат поиска (строка), проверить параметр "Успех выполнения операции", затем назначить задачи или рассылку по списку.

Название поля	Описание и примеры использования
ID подразделений	Один или несколько идентификаторов подразделений через запятую. Пробелы вокруг запятой допускаются. Пример: 3,7,12 Поле должно быть заполнено, иначе активити завершится с ошибкой «Не указаны ID подразделений».
Формат получения данных	Определяет вид значений в результатах. Число (1,2,3) — в массиве и строке возвращаются числовые ID пользователей. Пользователь (user_1,user_2,user_3) — те же ID в виде строк с префиксом user_, удобно для роботов, где ожидается формат пользователя.

Описание примера	Решение
Один отдел: все сотрудники для рассылки	ID подразделений = 5, Формат получения данных = Число (1,2,3). Используйте значения параметра "Результат поиска (строка)" или итератор по "Результат поиска (массив для итератора)".
Несколько отделов объединить в один список	ID подразделений = 3,7,12, Формат получения данных = Число (1,2,3). Дубликаты пользователей из разных отделов в результате не повторяются.
Назначить задачу первому по списку (минимальный ID)	Формат получения данных = Пользователь (user_1,user_2,user_3). Подставьте значения параметра "Результат поиска (строка)" в поле исполнителя следующего шага.
Связать с ответственным по сделке	Формат получения данных = Число (1,2,3). Сравните {=Document:ASSIGNED_BY_ID} с элементами параметра "Результат поиска (массив для итератора)" во вложенном условии.
Передать список во внешнюю систему	Формат получения данных = Число (1,2,3). Передайте значения параметра "Результат поиска (строка)" в вебхук как строку ID через запятую.
Ограничить сценарий при отсутствии людей	После шага проверьте значение параметра "Успех выполнения операции" = Y и "Количество найденных элементов" больше нуля. Иначе не запускайте массовые действия.
Запись в комментарий: сколько человек	Запишите текст «Сотрудников: » и значение параметра "Количество найденных элементов" в комментарий к задаче или сделке.
Формат user для уведомлений портала	Формат получения данных = Пользователь (user_1,user_2,user_3). Берите значения из параметра "Результат поиска (массив для итератора)" для шагов, где нужен формат user_ID.
Последний в отсортированном списке	Формат получения данных = Число (1,2,3). После сортировки по возрастанию "Последний результат поиска" соответствует наибольшему ID в выборке.
ID отдела из переменной процесса	ID подразделений = {=Variable:DEPT_IDS} (строка с ID через запятую, как в примере для поля). Убедитесь, что переменная не пустая до запуска робота.

Получить коллег пользователя, от которого выполнен запуск

Активити (робот) «Получить коллег пользователя от которого выполнен запуск» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда нужно получить список пользователей, которые считаются коллегами текущего пользователя в структуре компании Битрикс24, и передать их ID в следующие шаги бизнес-процесса.

Результат формируется запросом к REST-методу im.department.colleagues.list.
В запросе используется ограничение выборки до 50 записей за один вызов.
Пользователь, для которого запрашиваются коллеги, определяется контекстом запуска робота (от чьего имени выполняется действие), а не полями этой формы.


Типичная цепочка: получить список коллег, проверить значение параметров "Успех выполнения операции" и "Количество найденных элементов", затем передать значение параметра "Первый результат поиска" в уведомление или пройти по значениям параметра "Результат поиска (массив для итератора)" в итераторе.

Название поля	Описание и примеры использования
Формат получения данных	Определяет вид значений в результатах. Число (1,2,3) — в массиве и строке возвращаются числовые ID пользователей. Пользователь (user_1,user_2,user_3) — те же ID в виде строк с префиксом user_, удобно для подстановок в роботах, где ожидается формат пользователя.

Описание примера	Решение
Уведомить всех коллег одной строкой в задаче	Формат получения данных = Число (1,2,3). После шага возьмите значения параметра "Результат поиска (строка)" для отображения в комментарии или опишите перечисление в тексте задания «Копия {=Variable:TITLE}».
Отправить первому коллеге личное сообщение	Формат получения данных = Пользователь (user_1,user_2,user_3). Используйте значения параметра "Первый результат поиска" как получателя в следующем шаге (формат user_N).
Передать последнего в списке в другой робот	Формат получения данных = Число (1,2,3). Подставьте значения из параметра "Последний результат поиска" в переменную процесса и передайте в активити, где нужен один ID.
Обойти всех коллег в цикле	Формат получения данных = Число (1,2,3). В итераторе используйте множественное поле "Результат поиска (массив для итератора)" как источник ID для повторяющегося действия.
Проверить, есть ли коллеги, перед рассылкой	Добавьте условие после активити: "Успех выполнения операции" = Y и "Количество найденных элементов" больше нуля. Иначе не запускайте рассылку.
Сделка: сравнить коллег с ответственным	Формат получения данных = Число (1,2,3). Сравните ID элементов из параметра "Результат поиска (массив для итератора)" с полем {=Document:ASSIGNED_BY_ID} во вложенном условии процесса.
Запись в отчёт: сколько коллег найдено	Запишите в переменную текст вида «Найдено коллег: » и подставьте значения из параметра "Количество найденных элементов" как число.
Строка для внешней интеграции через запятую	Формат получения данных = Число (1,2,3). Передайте параметр "Результат поиска (строка)" в вызов вебхука или в поле API, где ожидается список ID через запятую.
Формат user для назначения исполнителей	Формат получения данных = Пользователь (user_1,user_2,user_3). Используйте значения из параметра "Результат поиска (массив для итератора)" в активити, где требуется формат user_ID.
Пустой результат и остановка сценария	Если коллег нет, активити завершится с ошибкой «Список пуст». Заложите альтернативную ветку процесса или предварительную проверку оргструктуры на портале.

Создать подразделение

Активити (робот) «Создать подразделение» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда новый отдел нужно завести из бизнес-процесса после согласования заявки, слияния компаний или автоматического развёртывания филиальной сети без ручного входа в раздел структуры компании на портале.

Результат формируется запросом к облачному API структуры компании.
Поля передаются в том виде, в каком их ожидает портал: обязательны название и привязка к родителю; сортировка и руководитель задаются по необходимости.
У пользователя, от имени которого выполняется запрос, должны быть права на изменение оргструктуры.


Типичная цепочка: условие или заявка запускает процесс, робот создаёт отдел, следующий шаг записывает полученный ID в поле сделки или передаёт его в задачу ответственному за оргструктуру.

Название поля	Описание и примеры использования
Название	Краткое имя нового отдела в дереве компании. Пример: Отдел сопровождения регионов
Родитель	Числовой ID родительского подразделения; для корня дерева на многих порталах указывают 0 согласно настройкам. Пример: 3
Сортировка	Необязательное целое число для порядка среди отделов одного уровня. Пример: 100
Руководитель	Пользователь, который станет руководителем отдела; можно оставить пустым. Пример: user_12

Описание примера	Решение
Создать отдел после одобрения заявки в смарт-процессе	Название = {=Variable:DEPT_TITLE}, Родитель = {=Variable:PARENT_DEPT_ID}, Руководитель = {=Variable:HEAD_USER}. Сохраните new_department_id в переменную процесса.
Филиал с фиксированным родителем	Название = Копия {=Variable:TITLE}, Родитель = 5, Сортировка = 500.
Команда проекта с руководителем из поля документа	Название = Проектная группа {=Document:ID}, Родитель = {=Variable:ROOT_DEPT}, Руководитель = {=Document:ASSIGNED_BY_ID}.
Отдел без руководителя на первом этапе	Название = Временный отдел, Родитель = 2. Поле Руководитель не заполняйте; назначьте руководителя отдельным шагом «Изменить подразделение».
Использовать порядок сортировки из переменной	Сортировка = {=Variable:SORT_ORDER}, Название = {=Variable:NAME}, Родитель = {=Variable:PARENT_ID}.
Запись ID в пользовательское поле лида	После шага передайте new_department_id в поле лида через «Изменить лид», если в карточке предусмотрено хранение ID отдела.
Разветвление по успешному созданию	Проверьте, что new_department_id больше нуля; иначе прочитайте s_error_logs и отправьте уведомление администратору.
Связка с поиском родителя	Сначала робот «Поиск подразделений» находит ID родителя, затем в этом активити Родитель = результат поиска первой строки.
Повтор при ошибке прав	Если в логе указано отказ в доступе, направьте процесс на согласование с HR и повторите шаг от имени администратора портала.
Логирование для аудита	Сохраняйте s_error_logs в комментарий заявки вместе с названием и {=System:Now} для последующей проверки.

Изменить подразделение

Активити (робот) «Изменить подразделение» предназначено для использования в роботах и может быть полезно в следующих сценариях: переименование отдела после реорганизации, перенос подразделения под другого родителя, смена руководителя по результату кадрового решения или корректировка порядка сортировки без ручного редактирования карточки в интерфейсе Битрикс24.

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


Обычно процесс сначала получает ID отдела из переменной или из робота поиска, затем подставляет новые значения из полей сущности или утверждённых констант сценария.

Название поля	Описание и примеры использования
ID подразделения	Числовой идентификатор изменяемого отдела. Пример: 14
Название	Новое имя; если оставить пустым, название не меняется. Пример: Отдел продаж B2B
Родитель	Новый ID родителя; укажите число для переноса ветки. Пример: 7
Сортировка	Новое значение порядка отображения среди соседей. Пример: 20
Руководитель	Пользователь-руководитель; заполните для назначения или смены. Пример: user_4

Описание примера	Решение
Только переименование	ID подразделения = {=Variable:DEPT_ID}, Название = {=Variable:NEW_NAME}. Остальные поля пустые.
Перенос под другой родительский отдел	ID подразделения = 9, Родитель = {=Variable:TARGET_PARENT_ID}.
Смена руководителя по итогам голосования	ID подразделения = {=Variable:DEPT_ID}, Руководитель = {=Variable:ELECTED_HEAD}.
Обновление сортировки после ревизии структуры	ID подразделения = {=Document:UF_DEPT_REF}, Сортировка = {=Variable:NEW_SORT}.
Комплексное обновление из одной формы	Заполните все поля значениями переменных процесса: Название, Родитель, Сортировка, Руководитель.
Проверка успеха перед уведомлением	Если значение параметра "Успешное обновление" = Y, отправьте чат-уведомление; если N — прочитайте данные из параметра "Сообщение об ошибке".
Связка со списком отделов	ID возьмите из первого элемента результата робота «Поиск подразделений» при фильтре по названию.
Отложенная смена названия	ID = {=Variable:DEPT_ID}, Название = Копия {=Variable:TITLE}. Используйте дату в тексте через шаблон переменной.
Исключение лишних изменений	Не передавайте поле Родитель, если перенос не требуется — так вы не затронете иерархию случайно.
Аудит изменений	Записывайте в таймлайн сущности строку из параметра "Сообщение об ошибке" и {=User:ID} исполнителя шага.

Удалить подразделение

Активити (робот) «Удалить подразделение» предназначено для использования в роботах и может быть полезно в следующих сценариях: ликвидация временного отдела после закрытия проекта, очистка тестовых записей оргструктуры, автоматическое удаление дубля после слияния команд при условии, что сотрудники и дочерние отделы уже перенесены вручную или другими шагами процесса.

Удаление необратимо на стороне портала: перед вызовом убедитесь, что у подразделения нет дочерних отделов и привязанных сотрудников, иначе API вернёт ошибку.
Требуются права на изменение структуры компании.


Рекомендуемая цепочка: сначала роботы переноса пользователей и дочерних отделов, затем удаление, затем уведомление ответственного HR.

Название поля	Описание и примеры использования
ID подразделения	Числовой идентификатор удаляемого отдела. Пример: 22

Описание примера	Решение
Удаление после успешного переноса людей	ID подразделения = {=Variable:OLD_DEPT_ID}. Перед шагом убедитесь, что список сотрудников пуст в карточке отдела.
Удаление тестового отдела по флагу	Условие: Variable:REMOVE_TEST = Y, затем ID = {=Variable:TEST_DEPT_ID}.
Отложенное удаление по таймеру	Через день после завершения проекта робот удаляет отдел с ID из поля документа.
Связка со списком	ID возьмите из результата робота «Поиск подразделений» при уникальном фильтре по названию (первый элемент массива ID).
Уведомление при ошибке	Если значение параметра "Успешное удаление" = N, отправьте сообщение в чат с текстом параметра "Сообщение об ошибке".
Запрет удаления без согласования	Оборачивайте шаг условием «согласовано» из предыдущего шага задания с руководителем.
Очистка после слияния	После переноса подчинённых в целевой отдел удалите пустой исходный ID.
Проверка перед удалением	Сначала робот списка с фильтром по родителю: если "Количество найденных элементов"= 0 для дочерних, разрешите удаление.
Логирование	Запишите в журнал сделки ID удалённого отдела и {=User:ID} инициатора.
Повтор при временной ошибке	При сетевой ошибке в логе настройте повтор шага через ожидание и повторный запуск вложенного процесса.

Прочее

Получение телефонов и email из сущности

Данное активити позволяет получить телефон или почты из сущности в формате строки.

Тип сущности: в этом поле из выпадающего списка выбирается тип сущности, из которой будут получены телефоны и e-mail.

ID Сущности: в этом поле указывается ID сущности из которой будут получать телефоны и e-mail.

Какой тип почты надо получить: значения нужно выбрать из выпадающего списка.
Доступно несколько вариантов:

• Почта
• Рабочая почта.
• Частная почта.
• Почта для рассылок.
• Другая.

Какой тип телефона надо получить: значения нужно выбрать из выпадающего списка.
Доступно несколько вариантов:

• Телефон
• Рабочий телефон
  
• Мобильный телефон
  
• Факс телефон
• Домашний телефон
  
• Пейджер телефон
  
• Телефон для рассылок
  
• Другой

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

Отправить PUSH уведомление

Данное активити позволяет отправить PUSH уведомление. 

Сценарий работы активити бизнес-процесса

Идентификаторы пользователей получателей push-уведомлений: в данном поле нужно указать пользователя, который получит PUSH-уведомление.
В данных пользователя должен быть указан номер мобильного телефона.

Произвольный текст: В данном поле указывается текст PUSH-уведомления.

Ссылка на изображение (аватар): в данном поле можно указать ссылку на изображение (аватар) отправителя.
Ссылка должна быть общедоступной, иначе аватар не будет добавлен.

Делать отладочные сообщения в журнал БП: вывод отладочных данных в журнале бизнес-процесса.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Генерация HTML(BBcode) таблицы

Данное активити генерирует HTML(BBcode) таблицу согласно указанным Вами параметрам.

Тип форматирования: в этом поле можно выбрать в каком формате таблицы будет осуществляться вывод, HTML или BBcode.

Основа заполнения: данное поле позволяет выбрать построчное (tr) или столбовое(td) заполнение строк. 

Построчное (tr): 

Столбовое (td):

Контент для таблицы: в данном поле записывается содержимое таблицы.
В каждом новом поле необходимо заполнить содержимое строки или столбца таким образом: строка1##строка2##строка3, в соответствии с основой заполнения.
Пример заполнения:
Построчное (tr): строка1##строка2##строка3
Столбовое (td): строка1##строка2##строка3
Т.е вне зависимости от выбранной основы заполнения, принцип заполнения одинаковый.
Если Вам нужно указать более трех строк/столбов (нет ограничения), то это тоже возможно, главное, чтобы последующее заполнение соответствовало тому, что вы указали изначально.
Пример:
Правильно:
Построчное (tr): строка1##строка2##строка3##строка4##строка5
                            строка1##строка2##строка3##строка4##строка5
Неправильно:
Построчное (tr):  строка1##строка2##строка3##строка4##строка5
                             строка1##строка2##строка3##строка4

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Постраничный вывод массива

Данное активити позволяет осуществить постраничный вывод массива при помощи бизнес-процесса.

Массив элементов: в данном поле вводится массив элементов для постраничного вывода, поле заполняется результатом работы предыдущего активити (возвращаемый параметр), либо вручную.

Количество элементов на странице: в данном поле указывается какое количество элементов будет отображено на странице при выводе.

Номер страницы для вывода: в данном поле указывается какую страницу выводить.

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Завершение по условиям

Данное активити завершается по указанным условиям.

Это активити подписывается на события и ждет, когда в сущности CRM (лид, контакт, компания, сделка) произойдут изменения, которые совпадут с условиями, указанными пользователем и по достижении этих условий завершает свою работу, давая тем самым запуститься следующему активити в цепочке БП.

Условия для завершения: в данном поле указываются условия для завершения активити.
Заполняются в следующем формате: код поля##условие (больше(>), меньше(<),равно(=)/неравно( ! ))##данные в поле.
Пример:
OPPORTUNITY##>##200
Условие означает: В поле OPPORTUNITY , сумма сделки больше 200.

Тип условия для всех параметров: в данном поле указывается один из вариантов  типа условий "и/или".
И - все поля должны совпасть (должны быть соблюдены).
Или - хотя бы одно из условий должно быть соблюдено.

Список событий: в этом поле выбирается вариант событий изменения сущности, на которые может реагировать активити.
Изменение лида/контакта/сделки/компании.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Парсинг текста в бизнес-процессах

Данное активити парсит (собирает данные) текст в БП согласно указанным параметрам.

Контент для парсинга: в данном пункте указывается текст, в котором БП будет искать данные согласно заданным ниже параметрам.

Параметры парсинга: в данном пункте настраивается параметр, отвечающий за поиск и выдачу  часть текста.

Для примера рассмотрим фразу: У лукоморья дуб зеленый.   
1##слово - вернет первое слово, расположенное до указанного искомого (обрабатывается вся строка, символы не возвращаются);
1##зеленый — вернёт в дополнительные параметры процесса слово дуб 

2##слово - вернет первое слово, расположенное после указанного искомого (обрабатывается вся строка, символы не возвращаются);
2##дуб — вернёт в дополнительные параметры процесса слово зелёный. 

3##символ/символы1##символ/символы2 - вернёт все символы или группы символов (включая пробел) в строке, расположенные меду указанными символом1 и символом2.
3##У##зе -  вернёт в дополнительные параметры процесса символ —  лукоморья дуб
Для команды 4 возьмем аббревиатуру счета с его номером: НФР-190188
4## - вернет все цифры в строке, без доп. символов.
Пример: Счет №21-сD1234 от 11.02.2020, вернет 21123411022020

5## - вернет ссылку из HTML-тега, который содержится в строке.
Пример: 5##Документ можно скачать перейдя по ссылке: https://test123.ru , вернет https://test123.ru. 
Учитывать регистр при парсинге: варианты да/нет.
Позволяет активировать либо деактивировать учет текстового регистра при парсинге (заглавная/строчная буква).
Пример: 
Звездное1небо5залито7звеЗдами
1. Учет регистра включен, параметр: 3##з##З 
Результат: "дное1небо5залито7зве".
2. Учет регистра выключен, параметр 3##з##З
Результат: "ве".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Сценарий работы робота

Выбор места расположения открытой линии

Данное активити позволяет изменить приоритет использования открытых линий в сущности, к которой они привязаны.

ID сущности: в этом поле указывается ID сущности.

Тип сущности: в этом поле указывается тип сущности, доступны варианты: лид, контакт, компания.

Укажите ID первой линии(не приоритетной): в этом поле указывается ID открытой линии, которая является менее приоритетной.

Укажите ID последней линии(приоритетной): в этом поле указывается приоритетная открытая линия (используется в активити для отправки сообщений через эту линию).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры данного активити:
- Соответствует условиям.
- Идентификатор пользователей ВКонтакте.
- Сообщение об ошибке.

Объединение массивов

Данное активити позволяет осуществить объединение массивов при помощи бизнес-процесса.

Тип операции: позволяет выбрать один из предложенных вариантов операции объединения "Сформировать результат из повторяющихся значений" или "Сформировать результат из уникальных значений".

• "Сформировать результат из повторяющихся значений"

- результатом работы активити является получение массива для итератора, который позволяет из нескольких массивов получить повторяющиеся значения, имеющиеся в этих массивах.

• "Сформировать результат из уникальных значений"

-  результатом работы активити является получение массива для итератора, которое позволяет из нескольких массивов получить уникальные значения каждого из массивов.

Массив для итератора 1-10: Количество полей в каждом пункте этого типа можно увеличивать. Каждый пункт является массивом для итератора. Данный массив может бы получен разными путями: из параметров БП или являться результатом работы активити (возвращаемый параметр).

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Разделение элементов массива

Данное активити позволяет разделять массив полученный, в активити "Поиск сущности" на отдельные элементы, для того, чтобы можно было запускать отдельные процессы для каждого элемента.

Массив который нужно разделить: множество, которое нужно добавить в данный пункт.
Под множеством понимается несколько однотипных элементов. 
Пример: 

Сообщение об ошибке: да/нет.
Позволяет выводить ошибки в журнал БП.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Получение значения элемента массива по ключу

Данное активити позволяет получить значение элемента массива по указанному вами ключу данного массива.

Массив для обработки: в данном поле указывается массив, значение из которого нужно получить.

Ключ массива: в данном поле указывается ключ, по которому нужно получить значение.
Данный ключ можно получить из самого массива, т.е ключ, это порядковый номер элемента в массиве(считается от 0, и если знак препинания отделен от слова, то считается за элемент).
Пример: 
Передается массив: Звездное небо, но холодная ночь.
Ключ: 3 
Получаемое значение по ключу: холодная.
Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получение id элемента массива по ключу

Данное активити позволяет получить id элемента массива по ключу (порядковому номеру) при помощи БП.

Сценарий работы активити бизнес-процесса

Порядковый номер элемента: в данном поле указывается порядковый номер элемента массива, который необходимо вывести.
Порядковые номера элементов начинают отсчитывать с нуля.

Пример: Задан массив элементов 100,57,62,83,145,217 и нам нужно получить ID элемента 83.
Согласно логике отсчета 1=100,2=57, 3=62, 4=83, 5=145, 6=217.
Соответственно указываем 4.

Массив элементов: в данном поле через запятую указывается массив элементов.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Удаление ожидающего события

Данное активити позволяет удалять/завершать ожидающие в очереди или повторяющиеся события (ожидание задачи или статус счета).
Это активити работает со следующими активити:

• Слежение за статусом задаче.
  
• Слежение за изменением в задаче.
  
• Слежение за статусом счета.

Тип сущности: в данном поле указывается тип сущности в которой находится событие (счет/задача)

ID сущности: в этом поле нужно указать ID сущности.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Преобразование из строки в массив и обратно

Данное активити может преобразовать данные (текст) из строки в массив и обратно.

Сценарий работы бизнес-процесса

Выберите операцию: в данном поле из выпадающего списка выбирается тип операции, которую будет выполнять активити:

• Из строки в массив.
• Из массива в строку.

Укажите массив:
ТОЛЬКО! Если выбрана операция из "из массива в строку" - в данном поле указывается массив для итератора, который нужно преобразовать.

ВАЖНО!
Максимальное количество элементов массива, доступных к преобразованию - 50

Укажите строку:
ТОЛЬКО! Если выбрана операция из "из строки в массив" - в данном поле указывается текст для преобразования.

Разделитель (объединитель): в данном поле указывается символ, либо несколько символов, которые участвуют в разделении или объединении.
По умолчанию в массивах получаемых в возвращаемых параметрах активити используется символ ";" (точка с запятой). Вы можете использовать любой другой разделитель, в т.ч и пробел, но в возвращаемых параметрах всегда приходит массив с делителем в виде точки с запятой.
Пример: 

• Строка: 1,2,3,4,5

Получиться массив
1
2
3
4
5
Разделителем будет в данном случае "," запятая.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Массив в виде строки.
- Массив в виде строки (массив для итератора).
- Результат: элемент массива 1-50.
- Сообщение об ошибке.

Удаление html тегов из тела письма

Данное активити позволяет удалить html теги из тела письма.

Сценарий работы бизнес-процесса

Тело письма: в поле добавляется текст, который нужно очистить от HTML - тегов.

Какие символы(слова) удалить: позволяет удалить символы, слова или текст, который был указан в поле (поле множественное).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры данного активити:
- Тело письма - результат.
- Сообщение об ошибке.

Поиск в массиве по фильтру

Данное активити ищет в массиве элементы которые отвечают условиям выбранного Вами фильтра.

Массив который нужно разделить: в это поле вставляется массив.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р
Запятая является делителем массива.

Условия: данном поле указывается условия для поиска: больше, меньше, больше чем, меньше чем и т.п
Пример заполнения:

• %картошка-250р
• %печения-55р
  
• %молотый кофе-600р
  

Формат выводов результатов (число):Варианты да/нет.
Позволяет выделить цифры из строки, если выбрано да.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р

• нет == картошка-250р,печения-55р,молотый кофе-600р
•  да == 250,55,600

Это поле необходимо использовать тогда, когда вам нужно выделить из текста определенный формат данных для дальнейшего использования.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Реквизиты

Изменение реквизита

Активити (робот) "Изменение реквизита" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Обновление данных существующего реквизита (ИНН, КПП, наименование, адрес и др.) после изменения в карточке контакта или компании;
• Синхронизация реквизитов с внешними системами (1С): подстановка актуальных полей по коду или ID реквизита;
• Исправление ошибочно введённых реквизитов по результатам проверки или после получения данных по ИНН;
• Изменение названия, активности или сортировки реквизита для отображения в карточке CRM;
• Массовое обновление реквизитов в цикле по списку ID реквизитов из поиска;
• Заполнение пустых полей реквизита данными из другого шага бизнес-процесса;
• Обновление контактных данных (телефон, e-mail, ФИО руководителя) в реквизите;
• Приведение реквизитов к единому формату после импорта или переноса данных;
• Обновление реквизита после смены юридического адреса или реорганизации компании;
• Установка или снятие активности реквизита в зависимости от условий процесса.

Название поля	Описание и примеры использования
ID реквизита	Обязательный параметр. Идентификатор реквизита, который нужно изменить. Примеры: - {=Variable:REQUISITE_ID} — ID из переменной (например, из результата активити «Добавление реквизита»); - {=A1988_22222_92566_99999:id_requisite} — ID реквизита из возвращаемого параметра активити (робота) «Добавление реквизита»; - {=Iterator:Value} — для массового обновления реквизитов в цикле по списку ID; - {=Document:ID} — если ID реквизита совпадает с полем документа.
Остальные поля реквизита	Набор полей для обновления (название, ИНН, КПП, полное и сокращённое наименование, ФИО руководителя, должность, адрес, телефон, e-mail, код, внешний код, активность, сортировка и др.) формируется при установке активити (робота) из crm.requisite.fields. Заполняйте только те поля, которые нужно изменить; пустые поля не передаются и не перезаписывают существующие значения. Поля «Тип пресета», «Тип сущности» и «ID сущности» в активити (роботе) не отображаются — привязка реквизита к контакту или компании не меняется.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора. При недостаточных правах активити (робот) может завершиться с ошибкой.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории, на каком шаге остановился процесс. Удобно при отладке.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса при включённом параметре «Устанавливать текст статуса».
Ожидать ответа	Параметр не управляется пользователем; определяет, нужно ли ожидать ответа от активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Ограничение времени ожидания ответа (в секундах, минутах, часах, днях). Рекомендуется не менее 5 минут и не более 1 часа. При истечении времени бизнес-процесс продолжит выполнение по заданной логике.

Описание примера	Решение
Обновить ИНН и наименование реквизита после проверки по ИНН	ID реквизита — {=Variable:REQUISITE_ID}. Заполните поля ИНН и полное наименование организации значениями из переменных (например, из результата запроса по ИНН). Остальные поля оставьте пустыми.
Изменить реквизит, только что созданный активити «Добавление реквизита»	ID реквизита — {=A1988_22222_92566_99999:id_requisite} (подставьте код вашего активити «Добавление реквизита»). В следующих полях укажите недостающие данные: телефон, e-mail, КПП и т.д.
Обновить контактные данные в реквизите компании	ID реквизита — {=Variable:REQUISITE_ID}. Заполните поля E-Mail, Телефон, Контактное лицо (и при необходимости ФИО первого руководителя, Должность первого руководителя).
Переименовать реквизит и изменить порядок отображения	ID реквизита — {=Variable:REQUISITE_ID}. В поле NAME (Название) укажите новое название, в поле «Сортировка» — число для порядка (например 200). Остальные поля не заполняйте.
Синхронизация с 1С: обновить код и внешний код реквизита	ID реквизита — из переменной, полученной при поиске реквизитов или из предыдущего шага. Заполните поле «Код» и «Внешний код» (или XML_ID) значениями из интеграции. При необходимости обновите ИНН, наименование.
Массовое обновление реквизитов по списку ID	В цикле по итератору: ID реквизита — {=Iterator:Value}. В остальных полях укажите общие данные для обновления (например, новое значение одного поля) или используйте переменные, зависящие от итератора.
Деактивировать реквизит по условию	ID реквизита — {=Variable:REQUISITE_ID}. В поле «Активен» выберите N (или 0). Используйте после условия «если реквизит устарел» или «если компания сменила реквизиты».
Заполнить пустые поля реквизита данными из карточки сделки	ID реквизита — из переменной (например, из поиска реквизитов компании сделки). Заполните поля из полей документа: например, телефон — {=Document:PHONE}, e-mail — {=Document:EMAIL}.
Обновить юридический адрес и ИФНС в реквизите	ID реквизита — {=Variable:REQUISITE_ID}. Заполните поля, соответствующие адресу и ИФНС (названия полей зависят от пресета и настроек портала). Остальные поля не указывайте.
Привести наименование и КПП к формату после импорта	ID реквизита — {=Iterator:Value} в цикле по списку ID реквизитов. В полях «Полное наименование организации», «Сокращённое наименование», КПП укажите значения из переменных, сформированных выражениями (например, с помощью функций trim, substr).

Добавление реквизита

Активити (робот) "Добавление реквизита" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Добавление главного (родительского) реквизита контакту или компании при создании или обновлении карточки;
• Автоматическое заполнение реквизитов после создания компании или контакта в бизнес-процессе;
• Подготовка данных для документов (счета, договоры, коммерческие предложения) с подстановкой ИНН, КПП, наименования и других полей;
• Интеграция с внешними системами (1С и др.): создание реквизитов с кодом и внешним кодом;
• Массовое добавление реквизитов для контактов или компаний через итератор;
• Заполнение реквизитов по шаблону (пресету) для ИП, юридических или физических лиц;
• Синхронизация реквизитов между CRM и учётными системами;
• Добавление реквизита компании при смене ответственного или стадии сделки;
• Создание реквизита с данными из полей лида или сделки при конвертации;
• Автоматизация ввода реквизитов после проверки по ИНН или при импорте.

Название поля	Описание и примеры использования
Тип пресета	Обязательный параметр. Указывается пресет (шаблон) реквизита. Пресеты настраиваются в CRM: Настройки CRM — Шаблоны реквизитов. В Битрикс24 есть готовые шаблоны для ИП, юридических и физических лиц; можно создавать свои. Список пресетов подставляется при установке активити (робота). Примеры: - Выберите пресет «Юридическое лицо» или «ИП» для российских реквизитов; - Пресет задаёт набор полей (ИНН, КПП, наименование, адрес и т.д.) для создаваемого реквизита.
Тип сущности	Обязательный параметр. Тип сущности CRM, к которой привязывается реквизит: 3 — Контакт, 4 — Компания. Примеры: - 3 или Контакт — реквизит будет привязан к контакту; - 4 или Компания — реквизит будет привязан к компании.
ENTITY_ID (ID сущности)	Обязательный параметр. Идентификатор контакта или компании, к которой добавляется реквизит. Примеры: - {=Document:ID} — ID компании или контакта из текущего документа; - {=Variable:COMPANY_ID} — ID из переменной предыдущего шага; - {=A1988_22222_92566_99999:company_id} — ID компании из результата активити (робота) «Получение данных по сущности: Компания»; - {=Iterator:Value} — для массового добавления реквизитов в цикле.
NAME (Название)	Обязательный параметр. Название создаваемого реквизита (отображается в карточке сущности). Примеры: - «Основные реквизиты»; - «Реквизиты для договора»; - {=Variable:REQUISITE_TITLE}.
Остальные поля реквизита	Набор полей (ИНН, КПП, полное и сокращённое наименование, ФИО руководителя, адрес, телефон, e-mail, код, внешний код, активность, сортировка и др.) формируется при установке активити (робота) из метода crm.requisite.fields. Перечень зависит от настроек портала и доступных шаблонов реквизитов. Заполняйте только нужные поля; для создания реквизита достаточно обязательных параметров и при необходимости основных данных (ИНН, наименование и т.д.).
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора. Если прав недостаточно, активити (робот) может завершиться с ошибкой.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории, на каком шаге остановился процесс. Удобно при отладке.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса при включённом параметре «Устанавливать текст статуса».
Ожидать ответа	Параметр не управляется пользователем; определяет, нужно ли ожидать ответа от активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Ограничение времени ожидания ответа (в секундах, минутах, часах, днях). Рекомендуется не менее 5 минут и не более 1 часа. При истечении времени бизнес-процесс продолжит выполнение по заданной логике.

Описание примера	Решение
Добавить основные реквизиты компании после создания компании	Тип пресета — «Юридическое лицо», Тип сущности — Компания (4), ENTITY_ID — {=Variable:NEW_COMPANY_ID}, Название — «Основные реквизиты». При необходимости заполните ИНН, КПП, полное наименование и другие поля. В возвращаемом параметре id_requisite получите ID созданного реквизита.
Создать реквизит контакту из поля документа	Тип пресета — «Физическое лицо», Тип сущности — Контакт (3), ENTITY_ID — {=Document:ID}, Название — «Реквизиты для договора». Активити (робот) создаст реквизит для контакта с ID из документа.
Добавить реквизиты с ИНН и наименованием для подготовки счёта	Тип пресета — «ИП» или «Юридическое лицо», Тип сущности — 4, ENTITY_ID — {=Document:COMPANY_ID}, Название — «Реквизиты», заполните поля ИНН, КПП, полное наименование организации. После сохранения реквизиты подставятся в документы CRM.
Массовое добавление реквизитов для списка компаний	В цикле по итератору: ENTITY_ID — {=Iterator:Value}, где Iterator передаёт ID компаний. Тип пресета и Тип сущности (4) задайте один раз; Название можно сформировать выражением, например «Реквизиты {=Iterator:Key}».
Создать реквизит с кодом для интеграции с 1С	Заполните Тип пресета, Тип сущности, ENTITY_ID, Название и поле «Код» (или «Внешний код») значением из внешней системы, например {=Variable:EXTERNAL_CODE}. Идентификатор внешней информационной базы при необходимости укажите в соответствующем поле.
Добавить реквизит компании, найденной по ИНН	После активити (робота) «Поиск Компании по ИНН КПП» или «Умный поиск компаний по реквизитам» возьмите ID компании из результата. Тип пресета — нужный шаблон, Тип сущности — 4, ENTITY_ID — {=A1988_22222_92566_99999:ID} (подставьте код вашего активити), Название — «Основные реквизиты».
Реквизит с данными руководителя и контактами	Выберите пресет для юрлица или ИП, укажите ENTITY_ID компании, заполните поля ФИО первого руководителя, Должность первого руководителя, E-Mail, Телефон. Название — «Контактные реквизиты».
Добавить реквизит после конвертации лида в сделку/компанию	В бизнес-процессе после создания компании из лида: ENTITY_ID — ID созданной компании из возвращаемого параметра соответствующего активити (робота), Тип сущности — 4, Тип пресета и Название — по задаче. Данные можно брать из полей лида через переменные.
Реквизит с указанием активности и сортировки	Параметры Тип пресета, Тип сущности, ENTITY_ID, Название — как обычно; поле «Активен» — Y или N; «Сортировка» — число для порядка отображения (например 100). Подходит для нескольких реквизитов у одной сущности.
Создать реквизит компании из карточки сделки	ENTITY_ID — {=Document:COMPANY_ID} (если документ — сделка и в нём есть привязка к компании). Тип пресета — «Юридическое лицо», Тип сущности — 4, Название — «Реквизиты для счёта». Используйте id_requisite в следующих шагах (например, для добавления банковских реквизитов).

Получение данных реквизита

Активити (робот) "Получение данных по сущности: реквизит" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение всех данных реквизита по ID для дальнейшей обработки в бизнес-процессе;
• Извлечение конкретных полей (ИНН, КПП, наименование, адрес, контакты) для подстановки в документы или письма;
• Проверка содержимого реквизита перед изменением, удалением или созданием связанного банковского реквизита;
• Получение данных реквизита после активити «Добавление реквизита» для проверки или передачи в следующие шаги;
• Извлечение реквизитов для формирования отчётов, выгрузок или интеграции с 1С;
• Проверка наличия реквизита и его полей по условию (например, заполнен ли ИНН);
• Получение данных реквизита компании или контакта для заполнения полей сделки, задачи или другого активити;
• Массовое получение данных реквизитов в цикле по списку ID из поиска или итератора;
• Копирование данных реквизита в переменные для использования в условиях или расчётах;
• Валидация и сравнение реквизитов (например, совпадение ИНН у компании и контрагента).

Название поля	Описание и примеры использования
Идентификатор реквизита	Обязательный параметр. ID реквизита, данные которого нужно получить. Примеры: - {=Variable:REQUISITE_ID} — ID из переменной предыдущего шага; - {=A1988_22222_92566_99999:id_requisite} — ID из возвращаемого параметра активити (робота) «Добавление реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — первый ID из результата активити (робота) «Поиск реквизитов»; - {=Iterator:Value} — для получения данных каждого реквизита в цикле по списку ID; - {=Document:ID} — если ID реквизита хранится в поле документа.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора. От прав зависит доступ к полям реквизита.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории, на каком шаге остановился процесс. Удобно при отладке.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса при включённом параметре «Устанавливать текст статуса».
Ожидать ответа	Параметр не управляется пользователем; определяет, нужно ли ожидать ответа от активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Ограничение времени ожидания ответа (в секундах, минутах, часах, днях). Рекомендуется не менее 5 минут и не более 1 часа. При истечении времени бизнес-процесс продолжит выполнение по заданной логике.

Описание примера	Решение
Получить данные реквизита после его создания	Идентификатор реквизита — {=A1988_22222_92566_99999:id_requisite} (код активити «Добавление реквизита»). Активити (робот) вернёт все поля созданного реквизита (ID, NAME, ИНН, КПП, наименование и др.) для использования в следующих шагах.
Извлечь ИНН и наименование для подстановки в счёт	Идентификатор реквизита — {=Variable:REQUISITE_ID}. В следующих активити (роботах) используйте возвращаемые параметры с кодами полей ИНН и полного наименования организации (названия полей соответствуют crm.requisite.fields).
Проверить, заполнен ли реквизит, перед отправкой документа	Идентификатор реквизита — {=Variable:REQUISITE_ID}. Получите данные реквизита, затем в условии проверьте нужное поле (например, ИНН или полное наименование). Если поле пустое — выполните ветку «Заполнить реквизит» или «Уведомить ответственного».
Получить данные первого реквизита из результата поиска	После активити (робота) «Поиск реквизитов» укажите идентификатор реквизита — {=A1988_22222_92566_99999:search_result_first_string}. Все поля найденного реквизита будут доступны в возвращаемых параметрах.
Массовое получение данных реквизитов в цикле	В цикле по итератору: идентификатор реквизита — {=Iterator:Value}. Для каждого ID реквизита активити (робот) вернёт полный набор полей. Используйте для выгрузки или обработки списка реквизитов.
Заполнить поля сделки или задачи данными из реквизита компании	Идентификатор реквизита — {=Variable:COMPANY_REQUISITE_ID}. Возьмите из возвращаемых параметров нужные поля (телефон, e-mail, адрес, наименование) и подставьте их в активити (робот) «Изменение сделки» или «Изменение задачи».
Сравнить ИНН реквизита компании и контрагента	Получите данные реквизита компании: идентификатор реквизита — {=Variable:REQUISITE_ID_1}. Сохраните значение поля ИНН в переменную. Получите данные реквизита контрагента (id_requisite — {=Variable:REQUISITE_ID_2}). В условии сравните два значения ИНН.
Получить контактные данные реквизита для письма	Идентификатор реквизита — {=Variable:REQUISITE_ID}. Используйте возвращаемые параметры E-Mail, Телефон, Контактное лицо (и при необходимости ФИО первого руководителя) в активити (роботе) отправки письма или уведомления.
Проверить наличие реквизита перед удалением	Идентификатор реквизита — {=Variable:REQUISITE_ID}. Выполните получение данных; если реквизит не найден, в журнал попадёт ошибка. При успехе используйте тот же ID в активити (роботе) «Удаление реквизита» или в условии по полям.
Выгрузка реквизитов для интеграции с 1С	В цикле по итератору передайте идентификатор реквизита — {=Iterator:Value}. Соберите возвращаемые параметры (ID, код, внешний код, ИНН, КПП, наименование и др.) в переменные или передайте в следующий шаг для отправки во внешнюю систему.

Поиск реквизитов

Активити (робот) "Поиск реквизитов" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск реквизитов компании или контакта по ИНН, наименованию, коду или другим полям для дальнейшей обработки;
• Проверка наличия реквизита с заданными данными перед созданием нового (избежание дубликатов);
• Поиск реквизитов по привязке к сущности (контакт или компания) и типу пресета для выбора нужного реквизита в карточке;
• Получение списка ID реквизитов для массового обновления, удаления или получения данных в цикле;
• Поиск реквизита компании сделки по ИНН или наименованию для подстановки в документы;
• Фильтрация реквизитов по активности, дате создания или пользовательским полям;
• Интеграция с 1С: поиск реквизита по внешнему коду или коду для синхронизации;
• Поиск реквизитов контакта для выбора основного реквизита или проверки заполненности;
• Получение первого или последнего реквизита из списка (по дате создания) для автоматического выбора;
• Поиск по нескольким критериям (ИНН + пресет, сущность + название) для точного определения реквизита.

Название поля	Описание и примеры использования
Тип пресета	Необязательный параметр. Поиск реквизитов только с указанным пресетом (шаблоном). Список пресетов формируется при установке активити (робота) из настроек портала (CRM — Шаблоны реквизитов). Примеры: - Выберите «Юридическое лицо» или «ИП» для поиска реквизитов определённого типа; - Оставьте пустым, чтобы не ограничивать поиск по пресету.
Тип сущности	Необязательный параметр. Ограничение по типу сущности: 3 — Контакт, 4 — Компания. Примеры: - 4 — искать только реквизиты компаний; - 3 — только реквизиты контактов.
ENTITY_ID (ID сущности)	Необязательный параметр. Поиск реквизитов, привязанных к указанному контакту или компании. Примеры: - {=Document:COMPANY_ID} — реквизиты компании из поля документа (сделки); - {=Variable:CONTACT_ID} — реквизиты контакта из переменной; - {=Document:ID} — реквизиты сущности с ID из документа.
Остальные поля для поиска	Набор полей (название, ИНН, КПП, полное и сокращённое наименование, код, внешний код, активность, даты, пользовательские поля и др.) формируется при установке активити (робота) из crm.requisite.fields. Заполняйте те поля, по которым нужно искать. Поддерживаются условия поиска (точное совпадение, вхождение подстроки и др. в зависимости от реализации). Пустые поля в фильтр не попадают. Примеры: - ИНН — поиск по ИНН (например, {=Variable:INN} или конкретное значение); - NAME — по названию реквизита; - Код, Внешний код — для поиска по интеграции с 1С.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора. От прав зависит доступ к реквизитам в CRM.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории, на каком шаге остановился процесс. Удобно при отладке.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса при включённом параметре «Устанавливать текст статуса».
Ожидать ответа	Параметр не управляется пользователем; определяет, нужно ли ожидать ответа от активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Ограничение времени ожидания ответа (в секундах, минутах, часах, днях). Рекомендуется не менее 5 минут и не более 1 часа. При истечении времени бизнес-процесс продолжит выполнение по заданной логике.

Описание примера	Решение
Найти реквизиты компании сделки	ENTITY_ID (ID сущности) — {=Document:COMPANY_ID}, Тип сущности — Компания (4). Остальные поля при необходимости (пресет, название). В результате получите значения в параметрах Результат поиска (массив для итератора) и "Первый результат поиска" для использования в «Получение данных по сущности: реквизит» или «Удаление реквизита».
Поиск реквизита по ИНН	Заполните поле ИНН — {=Variable:INN} или конкретное значение. При необходимости укажите ENTITY_ID — {=Variable:COMPANY_ID} и Тип сущности — 4. Используйте значения параметра "Первый результат поиска" как ID реквизита в следующих шагах.
Проверить, есть ли реквизит у контакта, перед созданием	ENTITY_ID — {=Document:ID}, Тип сущности — Контакт (3). Остальные поля пустые. Проверьте возвращаемый параметр "Успех выполнения операции": если Y и "Количество найденных элементов" больше 0 — реквизит уже есть; если N — можно создавать новый через «Добавление реквизита».
Получить первый реквизит компании по дате создания	ENTITY_ID — {=Variable:COMPANY_ID}, Тип сущности — 4. Результаты отсортированы по DATE_CREATE по возрастанию. Используйте значения параметра "Первый результат поиска" как ID самого раннего реквизита, "Последний результат поиска" — последнего.
Поиск по пресету и сущности	Тип пресета — «Юридическое лицо», ENTITY_ID — {=Document:COMPANY_ID}, Тип сущности — 4. Активити (робот) вернёт только реквизиты юрлица для указанной компании. Подставьте значение параметра "Первый результат поиска" в «Получение данных по сущности: реквизит» для извлечения полей.
Массовая обработка найденных реквизитов	Задайте критерии поиска (например, ENTITY_ID и ИНН). Передайте параметр "Результат поиска (массив для итератора)" в итератор. В цикле для каждого {=Iterator:Value} выполните «Получение данных по сущности: реквизит», «Изменение реквизита» или «Удаление реквизита».
Поиск реквизита по внешнему коду для синхронизации с 1С	Заполните поле «Внешний код» (или код) значением из 1С — {=Variable:EXTERNAL_CODE}. При необходимости добавьте ENTITY_ID. Используйте значение параметра "Первый результат поиска" как ID реквизита для обновления или получения данных.
Найти активные реквизиты компании	ENTITY_ID — {=Variable:COMPANY_ID}, Тип сущности — 4, поле «Активен» — Y (или 1). В результате будут только активные реквизиты. Параметр "Количество найденных элементов" покажет их количество.
Поиск по наименованию реквизита	NAME (Название) — «Основные реквизиты» или {=Variable:REQUISITE_NAME}. В сочетании с ENTITY_ID поиск сузится до реквизита с таким названием у указанной сущности.
Условие по результату поиска	Выполните поиск с нужными параметрами. В следующем шаге «Завершение по условиям» или условие: если значения параметров "Успех выполнения операции" = Y и "Количество найденных элементов" > 0 — ветка «Реквизит найден» (например, обновление); иначе — ветка «Реквизит не найден» (добавление нового).

Массив из параметра "Результат поиска (массив для итератора)" передавайте в итератор для обработки всех найденных реквизитов.


Результаты не найдены:
Если по заданным критериям реквизиты не найдены, активити (робот) завершится с ошибкой «Результатов не найдено», "Успех выполнения операции" = N.
Обрабатывайте эту ситуацию в условии (например, ветка «Создать реквизит»).

Порядок результатов:
Найденные реквизиты возвращаются в порядке возрастания даты создания (DATE_CREATE).
Первый в списке — самый старый, последний — самый новый (при одинаковых критериях).

Права доступа:
Сотрудник, указанный в поле «Запускать от имени», должен иметь права на просмотр реквизитов в CRM.
Рекомендуется использовать сотрудника с правами администратора.

Ограничение по количеству:
Метод crm.requisite.list может возвращать ограниченное количество записей за один запрос.
При большом числе реквизитов используйте дополнительные критерии (ENTITY_ID, пресет, ИНН и т.д.) для сужения выборки или обрабатывайте массив значений из параметра "Результат поиска (массив для итератора)" порциями.

Удаление реквизита

Активити (робот) "Удаление реквизита" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Удаление ошибочно созданного реквизита после проверки или отмены действия;
• Очистка дубликатов реквизитов: удаление лишних записей, оставшихся после объединения контактов или компаний;
• Удаление устаревшего реквизита при замене на новый (например, после смены юридического лица или реквизитов компании);
• Массовое удаление реквизитов по списку ID из результата поиска или итератора;
• Удаление тестовых реквизитов после переноса данных или отладки бизнес-процесса;
• Очистка реквизитов контакта или компании при закрытии или отмене сделки по условию;
• Синхронизация с внешней системой: удаление реквизитов, которых больше нет в 1С или учётной системе;
• Удаление реквизита перед повторным созданием с актуальными данными (сначала удалить, затем добавить);
• Очистка карточки при переводе контакта или компании в архив или неактивные;
• Удаление реквизита по запросу пользователя или по результату условия в процессе.

Название поля	Описание и примеры использования
ID реквизита	Обязательный параметр. Идентификатор реквизита, который нужно удалить. Примеры: - {=Variable:REQUISITE_ID} — ID из переменной предыдущего шага; - {=A1988_22222_92566_99999:id_requisite} — ID реквизита из возвращаемого параметра активити (робота) «Добавление реквизита» (например, для отката только что созданного реквизита); - {=A1988_22222_92566_99999:search_result_first_string} — первый ID из результата активити (робота) «Поиск реквизитов»; - {=Iterator:Value} — для массового удаления реквизитов в цикле по списку ID; - {=Document:ID} — если ID реквизита хранится в поле документа.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора. При недостаточных правах удаление может завершиться с ошибкой.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории, на каком шаге остановился процесс. Удобно при отладке.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса при включённом параметре «Устанавливать текст статуса».
Ожидать ответа	Параметр не управляется пользователем; определяет, нужно ли ожидать ответа от активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Ограничение времени ожидания ответа (в секундах, минутах, часах, днях). Рекомендуется не менее 5 минут и не более 1 часа. При истечении времени бизнес-процесс продолжит выполнение по заданной логике.

Описание примера	Решение
Удалить ошибочно созданный реквизит в той же цепочке процесса	ID реквизита — {=A1988_22222_92566_99999:id_requisite} (код активити «Добавление реквизита»). Используйте после условия «если проверка не прошла» или «если отмена» для отката только что созданного реквизита.
Удалить реквизит по результату поиска	После активити (робота) «Поиск реквизитов» укажите ID реквизита — {=A1988_22222_92566_99999:search_result_first_string} (или другой элемент массива результатов). Подходит для удаления одного из найденных реквизитов.
Массовое удаление реквизитов по списку ID	В цикле по итератору: ID реквизита — {=Iterator:Value}. Передайте в итератор массив ID реквизитов (например, из результата «Поиск реквизитов» или из переменной). Каждый реквизит будет удалён за один проход.
Удалить устаревший реквизит перед добавлением нового	ID реквизита — {=Variable:OLD_REQUISITE_ID}. Выполните активити (робот) «Удаление реквизита», затем активити (робот) «Добавление реквизита» с новыми данными. Переменная OLD_REQUISITE_ID может быть получена из поиска или из предыдущего шага.
Удалить реквизит при отмене сделки по условию	В ветке «Отмена» после условия по статусу сделки: ID реквизита — {=Variable:REQUISITE_ID}, где REQUISITE_ID сохранён при создании реквизита для этой сделки. Так можно убрать реквизит, созданный под отменённую сделку.
Синхронизация с 1С: удалить реквизиты, отсутствующие во внешней системе	Получите список ID реквизитов, которые нужно удалить (например, сравнением с выгрузкой из 1С). В цикле по итератору передайте ID реквизита — {=Iterator:Value}. Каждый реквизит из списка будет удалён.
Удалить дубликат реквизита после объединения компаний	ID реквизита — {=Variable:DUPLICATE_REQUISITE_ID}. Переменная может быть заполнена на предыдущем шаге при сравнении реквизитов объединённых компаний. Удаляется лишний реквизит, оставшийся после слияния.
Удалить тестовый реквизит после отладки	ID реквизита — константа или переменная с ID тестового реквизита (например, {=Variable:TEST_REQUISITE_ID}). Запускайте вручную или по условию «режим отладки выключен».
Очистка реквизитов при переводе компании в архив	Перед или после изменения статуса компании получите ID реквизитов компании (поиск или получение данных). В цикле выполните удаление с ID реквизита — {=Iterator:Value} для каждого ID.
Удалить реквизит по ID из поля документа	ID реквизита — {=Document:REQUISITE_ID} (если в документе есть поле с ID реквизита). Подходит для процессов, где реквизит привязан к сделке или задаче через пользовательское поле.

Реквизиты (адресные)

Удаление адресного реквизита

Активити (робот) "Удаление адресного реквизита" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Удаление ошибочно добавленного адреса;
• Очистка устаревшего адреса при замене на новый;
• Удаление адреса перед повторным добавлением с актуальными данными;
• Массовое удаление адресов по списку (тип + реквизит) в цикле;
• Синхронизация с 1С: удаление адресов, отсутствующих во внешней системе;
• Очистка тестовых адресов после отладки;
• Удаление адреса при смене реквизитов или закрытии сделки;
• Удаление дубликата адреса после объединения реквизитов;
• Удаление адреса по запросу пользователя или по условию;
• Очистка адресов при переводе реквизита в архив.

Название поля	Описание и примеры использования
Тип адреса	Обязательный параметр. Тип удаляемого адреса. Примеры: выбор из выпадающего списка. Должен соответствовать существующему адресу.
ID реквизита	Обязательный параметр. Идентификатор реквизита, к которому привязан удаляемый адрес. Примеры: - {=Variable:REQUISITE_ID}; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск реквизитов»; - {=Iterator:Value} — в цикле по списку ID реквизитов.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Удалить ошибочно добавленный адрес	Тип адреса — «Юридический», ID реквизита — {=A1988_22222_92566_99999:id_requisite} (если реквизит только что создан). Или ID реквизита из «Поиск реквизитов».
Удалить адрес перед добавлением нового	Тип адреса — «Юридический», ID реквизита — {=Variable:REQUISITE_ID}. Затем выполните «Добавление адресного реквизита» с новыми данными.
Удалить адрес по результату получения данных	Сначала «Получение данных по адресному реквизиту» — получите ID реквизита. Тип адреса и ID реквизита укажите те же. Или если в возвращаемых есть идентификация — используйте.
Массовое удаление адресов	Подготовьте пары (тип, ID реквизита). В цикле: ID реквизита — {=Iterator:Value}, Тип адреса — фиксированный или из переменной. Удаляйте адреса выбранного типа для каждого реквизита.
Синхронизация с 1С	Получите список реквизитов, у которых нужно удалить адрес (сравнение с 1С). Тип адреса — нужный, ID реквизита — {=Iterator:Value} для каждого. Удалите отсутствующие в 1С адреса.
Удалить тестовый адрес	Тип адреса — «Юридический», ID реквизита — {=Variable:TEST_REQUISITE_ID}. Запускайте по условию «режим отладки выключен» или вручную.
Удалить адрес при отмене сделки	В ветке «Отмена»: ID реквизита — {=Variable:REQUISITE_ID} (сохранён при создании), Тип адреса — «Юридический». Уберёт адрес, созданный под отменённую сделку.
Удалить дубликат после объединения	ID реквизита — {=Variable:DUPLICATE_REQUISITE_ID}, Тип адреса — нужный. Переменная из предыдущего шага при сравнении реквизитов.
Удалить адрес по условию	После проверки (например, адрес пустой или неверный): ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — «Почтовый». Удалите и добавьте заново с правильными данными.
Очистка при переводе в архив	Перед изменением статуса реквизита получите ID реквизитов. Для каждого: ID реквизита — {=Iterator:Value}, Тип адреса — «Юридический» (и при необходимости другие типы). Удалите адреса.

Добавление адресного реквизита

Активити (робот) "Добавление адресного реквизита" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Добавление адреса к реквизиту компании или контакта для документов (счета, договоры);
• Автоматическое заполнение юридического адреса после создания реквизита в бизнес-процессе;
• Добавление почтового адреса для доставки или корреспонденции;
• Заполнение адресных данных при интеграции с 1С или другими системами;
• Массовое добавление адресов для списка реквизитов через итератор;
• Добавление фактического адреса к реквизиту по шаблону;
• Синхронизация адресов между CRM и учётными системами;
• Добавление адреса реквизита при создании счёта или договора;
• Заполнение адреса из полей лида или сделки при конвертации;
• Автоматизация ввода адресов после проверки или при импорте.

Название поля	Описание и примеры использования
Тип адреса	Обязательный параметр. Указывается тип адреса (юридический, почтовый, фактический и т.д.). Список формируется при установке активити (робота) из настроек CRM. Примеры: - Выберите нужный тип из выпадающего списка; - Для каждого типа у реквизита может быть только один адрес.
ID реквизита	Обязательный параметр. Идентификатор реквизита, к которому добавляется адрес. Примеры: - {=Variable:REQUISITE_ID} — ID из переменной (например, из активити «Добавление реквизита»); - {=A1988_22222_92566_99999:id_requisite} — ID из результата активити «Добавление реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — первый ID из «Поиск реквизитов»; - {=Iterator:Value} — для массового добавления адресов в цикле.
Остальные поля адреса	Набор полей (страна, индекс, город, улица, дом, офис, адрес 1, адрес 2 и др.) формируется из crm.address.fields. Заполняйте только нужные поля. Перечень зависит от настроек портала. Примеры: - ADDRESS_1 — основной адрес ({=Variable:ADDRESS}); - ADDRESS_2 — дополнительная строка адреса; - CITY — город, REGION — регион (при наличии в полях).
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется выбирать сотрудника с правами администратора.
Устанавливать текст статуса	Позволяет включать установку статуса бизнес-процесса для отображения в истории.
Текст статуса	Текстовый статус, отображаемый в истории бизнес-процесса.
Ожидать ответа	Параметр не управляется пользователем.
Период ожидания	Время ожидания ответа от приложения. Рекомендуется не менее 5 минут и не более 1 часа.

Описание примера	Решение
Добавить юридический адрес после создания реквизита	Тип адреса — «Юридический», ID реквизита — {=A1988_22222_92566_99999:id_requisite}, ADDRESS_1 — {=Variable:LEGAL_ADDRESS}. В id_address получите ID созданного адреса.
Добавить почтовый адрес к реквизиту компании	Тип адреса — «Почтовый», ID реквизита — {=Variable:REQUISITE_ID}, заполните поля адреса из переменных. ID реквизита возьмите из «Поиск реквизитов» или «Добавление реквизита».
Создать адрес с данными из полей документа	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — нужный, ADDRESS_1 — {=Document:ADDRESS} (если адрес хранится в документе).
Массовое добавление адресов для реквизитов	В цикле по итератору: ID реквизита — {=Iterator:Value}. Итератор передаёт ID реквизитов. Тип адреса и поля адреса задайте один раз или из переменной.
Добавить адрес для подготовки счёта	После «Добавление реквизита»: ID реквизита — {=A1988_22222_92566_99999:id_requisite}, Тип адреса — «Юридический», заполните ADDRESS_1, CITY и др. из переменных. Адрес подставится в документы CRM.
Адрес реквизита из результата поиска	После «Поиск реквизитов»: ID реквизита — {=A1988_22222_92566_99999:search_result_first_string}, Тип адреса — «Почтовый». Добавьте адрес к первому найденному реквизиту.
Адрес с фиксированными данными	Тип адреса — «Фактический», ID реквизита — {=Variable:REQUISITE_ID}, ADDRESS_1 — «г. Москва, ул. Примерная, д. 1». Для шаблонных адресов.
Адрес при интеграции с 1С	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — «Юридический», ADDRESS_1 — {=Variable:ADDRESS_FROM_1C}. Данные из внешней системы.
Добавить адрес после конвертации лида	В бизнес-процессе после создания компании и реквизита: ID реквизита — из возвращаемого параметра «Добавление реквизита», заполните адрес из полей лида через переменные.
Адрес реквизита из карточки сделки	Сначала получите ID реквизита компании (поиск по ENTITY_ID — {=Document:COMPANY_ID}). ID реквизита — {=A1988_22222_92566_99999:search_result_first_string}, Тип адреса — нужный, ADDRESS_1 — {=Variable:DEAL_ADDRESS}.

Изменение адресного реквизита

Активити (робот) "Изменение адресного реквизита" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Обновление адреса реквизита при смене юридического адреса компании;
• Исправление ошибочно введённых адресных данных;
• Синхронизация адресов с 1С или другими учётными системами;
• Массовое обновление адресов по списку ID в цикле;
• Обновление почтового адреса для доставки;
• Замена устаревшего адреса на актуальный;
• Приведение адресов к единому формату;
• Обновление адреса при смене реквизитов компании;
• Исправление адреса после проверки по ИНН или другим полям;
• Автоматическое обновление адреса из внешнего источника данных.

Название поля	Описание и примеры использования
Тип адреса	Обязательный параметр. Тип адреса. В сочетании с ID реквизита идентифицирует адрес для обновления. Примеры: выбор из выпадающего списка, соответствующий существующему адресу.
ID реквизита	Идентификатор реквизита, к которому привязан адрес. Обязателен для идентификации вместе с типом адреса (если ID не указан). Примеры: - {=Variable:REQUISITE_ID}; - {=A1988_22222_92566_99999:id_requisite}.
Остальные поля адреса	Поля для обновления (ADDRESS_1, ADDRESS_2, CITY, COUNTRY_CODE и др.). Заполняйте только те поля, которые нужно изменить. Пустые поля не обновляются. Примеры: - ADDRESS_1 — {=Variable:NEW_ADDRESS}; - CITY — «Москва» или {=Document:CITY}.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота) для отладки и управления процессом.

Описание примера	Решение
Обновить юридический адрес после смены адреса компании	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — «Юридический», ADDRESS_1 — {=Variable:NEW_LEGAL_ADDRESS}. Только заполненные поля будут обновлены.
Исправить адрес, только что созданный	Тип адреса — тот же, что при добавлении, ID реквизита — {=A1988_22222_92566_99999:id_requisite} (ID реквизита из «Добавление реквизита»), ADDRESS_1 — исправленное значение. Адрес привязан к реквизиту; используйте ID реквизита.
Обновить адрес из результата получения данных	Тип адреса и ID реквизита — те же, что при получении. ADDRESS_1 — {=Variable:UPDATED_ADDRESS}. Адрес идентифицируется по TYPE_ID и ENTITY_ID.
Синхронизация адреса с 1С	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — нужный, ADDRESS_1 — {=Variable:ADDRESS_FROM_1C}. Данные подставляются из интеграции.
Массовое обновление адресов	Подготовьте пары (тип, ID реквизита). В цикле: ID реквизита — {=Iterator:Value}, Тип адреса — фиксированный или из переменной. Заполните ADDRESS_1 или другие поля. Каждый адрес обновится за проход.
Обновить только город	Тип адреса и ID реквизита — для идентификации, CITY — «Санкт-Петербург». Остальные поля пустые — обновится только город.
Привести адрес к формату	ID реквизита и Тип адреса — для идентификации, ADDRESS_1 — {=Variable:FORMATTED_ADDRESS}. Переменная с отформатированным адресом из предыдущего шага.
Обновить почтовый адрес для доставки	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — «Почтовый», ADDRESS_1, ADDRESS_2 — из полей заказа или переменных.
Обновить адрес при смене реквизитов	ID реквизита — {=Variable:NEW_REQUISITE_ID}, Тип адреса — «Юридический», ADDRESS_1 — из старого реквизита (полученного ранее). Или используйте ID адреса.
Исправление после проверки	В ветке «Адрес неверный» после условия: Тип адреса и ID реквизита — как при получении, ADDRESS_1 — {=Variable:CORRECTED_ADDRESS}.

Получение данных по адресному реквизиту

Активити (робот) "Получение данных по адресному реквизиту" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение данных адреса реквизита для подстановки в документы (счета, договоры);
• Извлечение адреса для доставки, почтовых отправлений;
• Проверка заполненности адреса перед формированием документа;
• Получение адреса после создания реквизита для проверки или передачи дальше;
• Копирование адреса в переменные для условий или расчётов;
• Сравнение адресов реквизита и контрагента;
• Выгрузка адресов для интеграции с 1С;
• Массовое получение данных адресов в цикле по списку реквизитов;
• Заполнение полей сделки или задачи данными адреса;
• Валидация адреса (проверка наличия города, индекса и т.д.).

Название поля	Описание и примеры использования
Тип адреса	Обязательный параметр. Тип адреса, данные которого нужно получить. Примеры: выбор из выпадающего списка (юридический, почтовый, фактический и т.д.).
ID реквизита	Обязательный параметр. Идентификатор реквизита, к которому привязан адрес. Примеры: - {=Variable:REQUISITE_ID} — из переменной; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск реквизитов»; - {=Iterator:Value} — в цикле по списку ID реквизитов.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Получить юридический адрес для счёта	Тип адреса — «Юридический», ID реквизита — {=Variable:REQUISITE_ID}. Используйте возвращаемые ADDRESS_1, ADDRESS_2, CITY в шаблоне счёта.
Извлечь адрес после создания реквизита	Тип адреса — «Юридический», ID реквизита — {=A1988_22222_92566_99999:id_requisite}. Проверьте корректность или передайте данные дальше.
Проверить, заполнен ли адрес	Тип адреса и ID реквизита — по задаче. В условии проверьте ADDRESS_1: если пусто — ветка «Заполнить адрес» или уведомление.
Получить адрес первого реквизита компании	После «Поиск реквизитов» по ENTITY_ID — {=Document:COMPANY_ID}: ID реквизита — {=A1988_22222_92566_99999:search_result_first_string}, Тип адреса — нужный.
Массовое получение адресов в цикле	В цикле по итератору (ID реквизитов): ID реквизита — {=Iterator:Value}, Тип адреса — «Юридический». Соберите ADDRESS_1 и др. для выгрузки.
Адрес для доставки	Тип адреса — «Почтовый» или «Фактический», ID реквизита — {=Variable:REQUISITE_ID}. Используйте возвращаемые поля в активити доставки или уведомления.
Сравнить адреса компании и контрагента	Получите адрес реквизита компании, сохраните ADDRESS_1 в переменную. Получите адрес контрагента — ID реквизита — {=Variable:CONTACT_REQUISITE_ID}. В условии сравните.
Выгрузка адресов для 1С	В цикле: ID реквизита — {=Iterator:Value}, Тип адреса — «Юридический». Соберите ID, ADDRESS_1, CITY, COUNTRY_CODE для передачи во внешнюю систему.
Заполнить поле сделки адресом	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — нужный. Передайте ADDRESS_1 или полный адрес в «Изменение сделки» через переменную.
Адрес для письма или уведомления	Тип адреса — «Почтовый», ID реквизита — {=Variable:REQUISITE_ID}. Подставьте ADDRESS_1, CITY в текст письма или шаблон уведомления.

Поиск адресов

Активити (робот) "Поиск адресов" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск адресов реквизита по типу (юридический, почтовый, фактический);
• Поиск адресов, привязанных к конкретному реквизиту (ENTITY_ID);
• Фильтрация адресов по городу, индексу, стране, строке адреса;
• Проверка наличия адреса перед созданием нового;
• Получение списка ID адресов для массового обновления или удаления;
• Поиск адреса по подстроке (ADDRESS_1, ADDRESS_2, CITY);
• Получение первого или последнего адреса из списка;
• Массовая обработка найденных адресов в цикле;
• Поиск адреса для подстановки в документы (счета, договоры);
• Условие по результату поиска (есть ли адрес у реквизита).

Название поля	Описание и примеры использования
Тип адреса	Необязательный параметр. Поиск адресов только указанного типа (юридический, почтовый, фактический и т.д.). Примеры: - Выберите «Юридический» для поиска юридических адресов; - Оставьте пустым, чтобы не ограничивать поиск по типу.
ID реквизита	Необязательный параметр. Поиск адресов, привязанных к указанному реквизиту. Примеры: - {=Variable:REQUISITE_ID}; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск реквизитов».
Остальные поля для поиска	Поля (ADDRESS_1, ADDRESS_2, CITY, POSTAL_CODE, REGION, COUNTRY_CODE и др.) формируются из crm.address.fields. Поддерживаются операторы сравнения (=, !, %, >, < и т.д.). Заполняйте поля, по которым искать. Пустые не попадают в фильтр. Примеры: - ADDRESS_1 — поиск по подстроке адреса (например, %Москва%); - CITY — по городу {=Variable:CITY}; - POSTAL_CODE — по индексу.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Найти адреса реквизита компании	ID реквизита — {=Variable:REQUISITE_ID}. Реквизит получите из «Поиск реквизитов» по ENTITY_ID — {=Document:COMPANY_ID}. В результате — search_results_array, search_result_first_string.
Поиск юридического адреса реквизита	Тип адреса — «Юридический», ID реквизита — {=Variable:REQUISITE_ID}. Используйте search_result_first_string в «Получение данных по адресному реквизиту» или «Изменение адресного реквизита».
Проверить, есть ли адрес, перед созданием	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — «Юридический». Проверьте math_search_results: Y и count_search > 0 — адрес уже есть; N — создавайте через «Добавление адресного реквизита».
Получить первый адрес по типу	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — «Почтовый». search_result_first_string — ID адреса для подстановки в документы.
Поиск по городу	ID реквизита — {=Variable:REQUISITE_ID}, CITY — «Москва» или {=Variable:CITY}. Вернёт адреса в указанном городе.
Массовая обработка найденных адресов	Задайте критерии (ID реквизита, Тип адреса и т.д.). Передайте search_results_array в итератор. В цикле для {=Iterator:Value} выполните «Получение данных», «Изменение» или «Удаление».
Поиск по подстроке адреса	ADDRESS_1 — «%ул. Ленина%» или {=Variable:STREET_PART}. Оператор % — поиск подстроки. Найдёт адреса, содержащие указанную строку.
Найти адрес для счёта на оплату	ID реквизита — {=Variable:REQUISITE_ID}, Тип адреса — «Юридический». search_result_first_string — ID адреса для «Получение данных по адресному реквизиту» и подстановки в шаблон счёта.
Поиск по индексу	POSTAL_CODE — {=Variable:INDEX} или «101000». Сузит поиск до адресов с указанным индексом.
Условие по результату поиска	Выполните поиск с нужными параметрами. В условии: если math_search_results = Y и count_search > 0 — ветка «Адрес найден»; иначе — «Добавить адрес».

Реквизиты (банковские)

Поиск банковских реквизитов

Активити (робот) "Поиск банковских реквизитов" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск банковских реквизитов реквизита по расчётному счёту, БИК, наименованию банка;
• Проверка наличия банковского реквизита перед созданием нового;
• Получение списка ID банковских реквизитов для массового обновления или удаления;
• Поиск банковских реквизитов по привязке к реквизиту (ENTITY_ID);
• Фильтрация по стране, дате создания и другим полям;
• Интеграция с 1С: поиск по коду или внешнему коду;
• Получение первого или последнего банковского реквизита из списка;
• Массовая обработка найденных банковских реквизитов в цикле;
• Поиск расчётного счёта для подстановки в счёт на оплату;
• Условие по результату поиска (есть ли банковские реквизиты у реквизита).

Название поля	Описание и примеры использования
ID реквизита	Необязательный параметр. Поиск банковских реквизитов, привязанных к указанному реквизиту. Примеры: - {=Variable:REQUISITE_ID}; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск реквизитов».
Страна	Необязательный параметр. Фильтр по стране банковских реквизитов. Примеры: выбор из выпадающего списка.
Остальные поля для поиска	Поля (RQ_ACC_NUM, RQ_BANK_NAME, RQ_BIC, RQ_CORR_ACC и др.) формируются из crm.requisite.bankdetail.fields. Заполняйте поля, по которым искать. Пустые не попадают в фильтр. Примеры: - RQ_ACC_NUM — поиск по расчётному счёту {=Variable:ACCOUNT}; - RQ_BIC — по БИК банка; - RQ_BANK_NAME — по наименованию банка.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Найти банковские реквизиты реквизита компании	ID реквизита — {=Variable:REQUISITE_ID}. Реквизит получите из «Поиск реквизитов» по ENTITY_ID — {=Document:COMPANY_ID}. В результате — search_results_array, search_result_first_string.
Поиск по расчётному счёту	RQ_ACC_NUM — {=Variable:ACCOUNT} или конкретное значение. При необходимости ID реквизита — {=Variable:REQUISITE_ID}. Используйте search_result_first_string в следующих шагах.
Проверить, есть ли банковский реквизит, перед созданием	ID реквизита — {=Variable:REQUISITE_ID}. Остальные поля пустые. Проверьте math_search_results: Y и count_search > 0 — уже есть; N — создавайте через «Добавление банковского реквизита».
Получить первый банковский реквизит по дате создания	ID реквизита — {=Variable:REQUISITE_ID}. search_result_first_string — самый ранний, search_result_last_string — самый новый. Для подстановки в счёт.
Поиск по БИК и реквизиту	ID реквизита — {=Variable:REQUISITE_ID}, RQ_BIC — {=Variable:BIC}. Вернёт банковские реквизиты с указанным БИК у реквизита.
Массовая обработка найденных	Задайте критерии (ID реквизита, RQ_ACC_NUM и т.д.). Передайте search_results_array в итератор. В цикле для {=Iterator:Value} выполните «Получение данных», «Изменение» или «Удаление».
Поиск по стране	Страна — «Россия», ID реквизита — {=Variable:REQUISITE_ID}. Только банковские реквизиты указанной страны. count_search покажет количество.
Найти расчётный счёт для счёта на оплату	ID реквизита — {=Variable:REQUISITE_ID}. Используйте search_result_first_string как ID банковского реквизита в «Получение данных по банковскому реквизиту» для извлечения полей счёта.
Интеграция с 1С	Заполните поле кода или внешнего кода значением из 1С — {=Variable:EXTERNAL_CODE}. Добавьте ID реквизита при необходимости. search_result_first_string — для обновления или получения.
Условие по результату поиска	Выполните поиск с нужными параметрами. В условии: если math_search_results = Y и count_search > 0 — ветка «Есть банковские реквизиты»; иначе — «Добавить банковский реквизит».

Получение данных по банковскому реквизиту

Активити (робот) "Получение данных по банковскому реквизиту" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение данных банковского реквизита по ID для подстановки в счёт на оплату;
• Извлечение расчётного счёта, БИК, наименования банка для документов;
• Проверка содержимого банковского реквизита перед изменением или удалением;
• Получение данных после «Добавление банковского реквизита» для проверки;
• Массовое получение данных банковских реквизитов в цикле;
• Заполнение полей сделки или счёта данными банковского реквизита;
• Выгрузка банковских реквизитов для интеграции с 1С;
• Проверка наличия и заполненности расчётного счёта;
• Копирование данных в переменные для условий;
• Сравнение банковских реквизитов контрагентов.

Название поля	Описание и примеры использования
ID банковских реквизитов	Обязательный параметр. Идентификатор банковского реквизита. Примеры: - {=Variable:BANKDETAIL_ID} — из переменной; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление банковского реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск банковских реквизитов»; - {=Iterator:Value} — в цикле по списку ID.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Получить данные для счёта на оплату	ID банковских реквизитов — {=Variable:BANKDETAIL_ID}. Используйте RQ_ACC_NUM, RQ_BANK_NAME, RQ_BIC, RQ_CORR_ACC в шаблоне счёта.
Извлечь данные после создания	ID банковских реквизитов — {=A1988_22222_92566_99999:id_requisite}. Проверьте корректность или передайте в следующие шаги.
Получить первый банковский реквизит из поиска	После «Поиск банковских реквизитов»: ID — {=A1988_22222_92566_99999:search_result_first_string}. Все поля в возвращаемых параметрах.
Массовое получение в цикле	В цикле: ID банковских реквизитов — {=Iterator:Value}. Для каждого ID — полный набор полей. Для выгрузки или обработки.
Проверить, заполнен ли расчётный счёт	ID — {=Variable:BANKDETAIL_ID}. В условии проверьте RQ_ACC_NUM: если пусто — ветка «Заполнить» или уведомление.
Заполнить поле сделки банковскими данными	ID — {=Variable:BANKDETAIL_ID}. Передайте RQ_ACC_NUM, RQ_BANK_NAME в «Изменение сделки» или переменные.
Выгрузка для 1С	В цикле: ID — {=Iterator:Value}. Соберите RQ_ACC_NUM, RQ_BIC, RQ_BANK_NAME, ENTITY_ID для передачи во внешнюю систему.
Сравнить расчётные счета	Получите данные первого: ID — {=Variable:BANKDETAIL_ID_1}, сохраните RQ_ACC_NUM. Второй: ID — {=Variable:BANKDETAIL_ID_2}. В условии сравните.
Данные для письма или уведомления	ID — {=Variable:BANKDETAIL_ID}. Подставьте RQ_ACC_NUM, RQ_BANK_NAME в текст письма или шаблон.
Проверить наличие перед удалением	ID — {=Variable:BANKDETAIL_ID}. Получите данные; при успехе используйте тот же ID в «Удаление банковского реквизита» или в условии по полям.

Удаление банковcкого реквизита

Активити (робот) "Удаление банковского реквизита" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Удаление ошибочно созданного банковского реквизита;
• Очистка устаревшего расчётного счёта при замене на новый;
• Удаление банковского реквизита перед повторным добавлением;
• Массовое удаление по списку ID в цикле;
• Синхронизация с 1С: удаление банковских реквизитов, отсутствующих во внешней системе;
• Удаление тестовых банковских реквизитов после отладки;
• Удаление дубликата после объединения реквизитов;
• Очистка банковских реквизитов при закрытии или отмене сделки;
• Удаление по запросу пользователя или по условию;
• Очистка при переводе реквизита в архив.

Название поля	Описание и примеры использования
ID банковских реквизитов	Обязательный параметр. Идентификатор удаляемого банковского реквизита. Примеры: - {=Variable:BANKDETAIL_ID}; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление банковского реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск банковских реквизитов»; - {=Iterator:Value} — в цикле по списку ID.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Удалить ошибочно созданный	ID банковских реквизитов — {=A1988_22222_92566_99999:id_requisite}. Используйте после условия «если проверка не прошла» для отката только что созданного.
Удалить по результату поиска	После «Поиск банковских реквизитов»: ID — {=A1988_22222_92566_99999:search_result_first_string}. Удалите первый из найденных.
Массовое удаление по списку ID	В цикле: ID — {=Iterator:Value}. Итератор передаёт массив ID из «Поиск банковских реквизитов» или переменной. Каждый будет удалён за проход.
Удалить перед добавлением нового	ID — {=Variable:OLD_BANKDETAIL_ID}. Затем «Добавление банковского реквизита» с новыми данными. OLD_BANKDETAIL_ID из поиска или предыдущего шага.
Удалить при отмене сделки	В ветке «Отмена»: ID — {=Variable:BANKDETAIL_ID}, сохранён при создании для сделки. Уберёт банковский реквизит под отменённую сделку.
Синхронизация с 1С	Получите список ID банковских реквизитов для удаления (сравнение с 1С). В цикле: ID — {=Iterator:Value}. Удалите отсутствующие в 1С.
Удалить дубликат	ID — {=Variable:DUPLICATE_BANKDETAIL_ID}. Переменная при сравнении банковских реквизитов объединённых реквизитов.
Удалить тестовый	ID — {=Variable:TEST_BANKDETAIL_ID}. Запускайте по условию «режим отладки выключен» или вручную.
Очистка при переводе в архив	Получите ID банковских реквизитов реквизита (поиск). В цикле: ID — {=Iterator:Value}. Удалите все банковские реквизиты.
Удалить по ID из поля документа	ID — {=Document:BANKDETAIL_ID} (если в документе есть поле с ID банковского реквизита). Для процессов с привязкой через пользовательское поле.

Изменение банковского реквизита

Активити (робот) "Изменение банковского реквизита" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Обновление расчётного счёта при смене банка или счёта компании;
• Исправление ошибочно введённых банковских данных;
• Синхронизация с 1С: обновление банковских реквизитов из внешней системы;
• Массовое обновление банковских реквизитов по списку ID;
• Обновление БИК, наименования банка, корреспондентского счёта;
• Замена устаревших банковских реквизитов на актуальные;
• Приведение банковских реквизитов к единому формату;
• Обновление после проверки по ИНН или другим полям;
• Исправление банковского реквизита, только что созданного;
• Автоматическое обновление из внешнего источника данных.

Название поля	Описание и примеры использования
ID банковских реквизитов	Обязательный параметр. Идентификатор банковского реквизита для изменения. Примеры: - {=Variable:BANKDETAIL_ID}; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление банковского реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск банковских реквизитов»; - {=Iterator:Value} — в цикле по списку ID.
Остальные поля	Поля для обновления (RQ_ACC_NUM, RQ_BANK_NAME, RQ_BIC, RQ_CORR_ACC и др.). Заполняйте только те, что нужно изменить. Пустые не обновляются. Примеры: - RQ_ACC_NUM — {=Variable:NEW_ACCOUNT}; - RQ_BANK_NAME — «Сбербанк» или {=Document:BANK_NAME}.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Обновить расчётный счёт	ID банковских реквизитов — {=Variable:BANKDETAIL_ID}, RQ_ACC_NUM — {=Variable:NEW_ACCOUNT}. Только заполненные поля обновятся.
Исправить только что созданный	ID — {=A1988_22222_92566_99999:id_requisite}, RQ_ACC_NUM — исправленное значение. В той же цепочке после «Добавление банковского реквизита».
Обновить наименование банка	ID — {=Variable:BANKDETAIL_ID}, RQ_BANK_NAME — «Новый банк» или {=Variable:BANK_NAME}. Остальные поля пустые.
Синхронизация с 1С	ID — {=Variable:BANKDETAIL_ID}, RQ_ACC_NUM — {=Variable:ACCOUNT_FROM_1C}, RQ_BIC — {=Variable:BIC_1C}. Данные из интеграции.
Массовое обновление	В цикле: ID — {=Iterator:Value}, RQ_ACC_NUM — {=Variable:NEW_ACCOUNT}. Каждый банковский реквизит обновится за проход.
Обновить БИК и корр. счёт	ID — {=Variable:BANKDETAIL_ID}, RQ_BIC — {=Variable:BIC}, RQ_CORR_ACC — {=Variable:CORR_ACC}. При смене банка.
Привести к формату	ID — {=Variable:BANKDETAIL_ID}, RQ_ACC_NUM — {=Variable:FORMATTED_ACCOUNT}. Переменная с отформатированным значением.
Обновить после проверки	В ветке «Данные неверны»: ID — {=Variable:BANKDETAIL_ID}, RQ_ACC_NUM — {=Variable:CORRECTED_ACCOUNT}. BANKDETAIL_ID из «Получение данных» или поиска.
Обновить из результата поиска	ID — {=A1988_22222_92566_99999:search_result_first_string}, RQ_BANK_NAME — «Актуальное наименование». Обновите первый найденный.
Обновить несколько полей	ID — {=Variable:BANKDETAIL_ID}, RQ_ACC_NUM — {=Variable:ACC}, RQ_BANK_NAME — {=Variable:BANK}, RQ_BIC — {=Variable:BIC}. Все указанные поля обновятся.

Добавление банковского реквизита

Активити (робот) "Добавление банковского реквизита" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Добавление расчётного счёта к реквизиту компании или контакта;
• Автоматическое заполнение банковских реквизитов после создания реквизита;
• Подготовка данных для счёта на оплату (БИК, ИНН банка, расчётный счёт);
• Интеграция с 1С: создание банковских реквизитов с кодом;
• Массовое добавление банковских реквизитов для списка реквизитов через итератор;
• Добавление нескольких счетов к одному реквизиту;
• Синхронизация банковских реквизитов между CRM и учётными системами;
• Заполнение банковских данных при создании счёта или договора;
• Добавление банковского реквизита после конвертации лида;
• Автоматизация ввода банковских реквизитов при импорте.

Название поля	Описание и примеры использования
ID реквизита	Обязательный параметр. Идентификатор реквизита, к которому добавляются банковские реквизиты. Примеры: - {=Variable:REQUISITE_ID} — из переменной; - {=A1988_22222_92566_99999:id_requisite} — из «Добавление реквизита»; - {=A1988_22222_92566_99999:search_result_first_string} — из «Поиск реквизитов»; - {=Iterator:Value} — в цикле по списку ID реквизитов.
Страна	Необязательный параметр. Страна банковских реквизитов. Список формируется из crm.requisite.preset.countries. Примеры: выбор из выпадающего списка.
Остальные поля банковских реквизитов	Набор полей (наименование банка, БИК, расчётный счёт, корреспондентский счёт, ИНН банка, КПП банка и др.) формируется из crm.requisite.bankdetail.fields. Заполняйте нужные поля. Перечень зависит от настроек портала и страны. Примеры: - RQ_ACC_NUM — расчётный счёт {=Variable:ACCOUNT}; - RQ_BANK_NAME — наименование банка; - RQ_BIC — БИК банка.
Запускать от имени	Сотрудник, от имени которого выполняется действие. Рекомендуется администратор.
Устанавливать текст статуса, Текст статуса, Ожидать ответа, Период ожидания	Стандартные параметры активити (робота).

Описание примера	Решение
Добавить расчётный счёт после создания реквизита	ID реквизита — {=A1988_22222_92566_99999:id_requisite}, RQ_ACC_NUM — {=Variable:ACCOUNT}, RQ_BANK_NAME — «Сбербанк», RQ_BIC — {=Variable:BIC}. В id_requisite получите ID созданных банковских реквизитов.
Банковские реквизиты для счёта на оплату	ID реквизита — {=Variable:REQUISITE_ID}, заполните RQ_ACC_NUM, RQ_BANK_NAME, RQ_BIC, RQ_CORR_ACC (корр. счёт при необходимости). Реквизит из «Поиск реквизитов» или «Добавление реквизита».
Создать банковские реквизиты с данными из документа	ID реквизита — {=Variable:REQUISITE_ID}, RQ_ACC_NUM — {=Document:BANK_ACCOUNT}, RQ_BANK_NAME — {=Document:BANK_NAME}. Данные из полей сделки или лида.
Массовое добавление банковских реквизитов	В цикле: ID реквизита — {=Iterator:Value}. Итератор передаёт ID реквизитов. Заполните RQ_ACC_NUM, RQ_BANK_NAME и др. из переменных или одного шаблона.
Банковские реквизиты для подготовки счёта	После «Добавление реквизита»: ID реквизита — {=A1988_22222_92566_99999:id_requisite}, Страна — Россия, RQ_ACC_NUM, RQ_BIC, RQ_BANK_NAME. Подставится в документы CRM.
Банковский реквизит из результата поиска реквизитов	После «Поиск реквизитов»: ID реквизита — {=A1988_22222_92566_99999:search_result_first_string}, RQ_ACC_NUM — {=Variable:ACCOUNT}. Добавьте счёт к первому найденному реквизиту.
Интеграция с 1С	ID реквизита — {=Variable:REQUISITE_ID}, RQ_ACC_NUM — {=Variable:ACCOUNT_FROM_1C}, RQ_BANK_NAME — {=Variable:BANK_NAME_1C}. Данные из внешней системы.
Добавить второй счёт к реквизиту	ID реквизита — {=Variable:REQUISITE_ID} (тот же реквизит), RQ_ACC_NUM — другой счёт, RQ_BANK_NAME — другой банк. У одного реквизита может быть несколько банковских реквизитов.
Банковские реквизиты после конвертации лида	После создания компании и реквизита: ID реквизита — из «Добавление реквизита», RQ_ACC_NUM, RQ_BANK_NAME — из полей лида через переменные.
Банковский реквизит из карточки сделки	ID реквизита — {=Variable:COMPANY_REQUISITE_ID}. Получите ID реквизита компании (поиск по ENTITY_ID — {=Document:COMPANY_ID}). RQ_ACC_NUM — {=Variable:DEAL_BANK_ACCOUNT}.

Роботизация бизнеса (RPA)

Элементы

Удаление элемента процесса

Данное активити позволяет удалить элемент RPA - бизнес-процесса. Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент.

Идентификатор элемента: в этом поле нужно указать ID элемента RPA БП, который вы планируете удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Поиск по элементам RPA - процесса

Данное активити выполняет поиск по элементам RPA - бизнес-процесса.
Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором будет осуществлен поиск.

Идентификатор стадии на которой находится элемент: в этом поле нужно указать ID стадии, в которой находится искомый элемент RPA БП.

Идентификатор предыдущей стадии элемента: в этом поле указывается ID стадии, в которой элемент находился до перехода на текущую стадию.

Название элемента: в этом поле указывается название искомого элемента RPA БП.

ID пользователя, создавшего элемент: в данном поле нужно указать ID пользователя, который создал элемент.

ID пользователя, изменившего элемент: в данном поле нужно указать ID пользователя, который последним изменил элемент.

Время создания элемента: в этом поле нужно указать дату и время создания элемента.

Количество заданий на элементе для пользователя: в данном поле указывается количество заданий, которое было в элементе для пользователя.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получить данные о текущих заданиях элемента

Данное активити позволяет получить данные о текущих заданиях элемента RPA - бизнес-процесса. Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, информацию о заданиях которого нужно получить.

Идентификатор элемента: в этом поле указывается ID элемента в котором содержатся задания, данные о которых нужно получить.

ID задания: в этом поле указывается ID задания, данные которого нужно получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Создание нового элемента процесса

Данное активити позволяет создать новый элемент RPA - бизнес-процесса. Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором будет создан новый элемент.

Название элемента: в этом поле указывается название элемента, который будет создан.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Обновление данных элемента процесса

Данное активити обновляет данные элемента RPA - бизнес-процесса. Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, данные которого нужно обновить.

Идентификатор элемента: в этом поле указывается ID элемента который будет обновлен.

Идентификатор стадии, на которой находится элемент: в этом поле нужно указать ID стадии на которой находится обновляемый элемент RPA процесса.

Название элемента: в этом поле нужно указать название элемента.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Данные по элементу процесса

Данное активити позволяет получить данные по элементу RPA - бизнес-процесса. Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, данные которого нужно получить.

Идентификатор элемента: в этом поле указывается ID элемента данные по которому нужно получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Стадии

Создать новую стадию

Данное активити создает новую стадию процесса RPA. Название стадии: в этом поле указывается название создаваемой стадии RPA - бизнес-процесса.

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором стадия будет создана.

Символьный код: в этом поле вводится символьный код стадии на латинице.

Цвет стадии в виде НЕХ: в это полу нужно вставить цветовой код стадии в виде HEX кода.
К примеру зеленый цвет в HEX: #008000.
Таблицу с HEX-кодами цветов можно найти в интернете, либо просто перейдя по данной ссылке: ТЫЦ

Код семантики стадии: в этом поле нужно выбрать семантический код стадии, т.е то, что данная стадия означает.
Доступно 2 варианта: Success и FAIL , что в дословном переводе "Успех" и "Провал/неудача".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление стадии

Данное активити удаляет стадию RPA процесса. ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса которая будет удалена.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Информация о стадии

Данное активити отдает информацию о стадии RPA процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса о которой нужно получить информацию.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название стадии;
- Символьный код;
- HEX-код цвета стадии (в виде 6 символов);
- Идентификатор процесса;
- Результат выполнения;
- Сообщение об ошибке.

Список стадий процесса

Данное активити вернет список стадий RPA - процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса список стадий которого надо получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Результат выполнения;
- Сообщение об ошибке.

Изменить стадию

Данное активити позволяет изменять стадии RPA - процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса которую надо изменить.

Название стадии: в этом поле указывается название изменяемой стадии RPA - бизнес-процесса.

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором стадия будет изменена.

Символьный код: в этом поле вводится символьный код стадии на латинице.

Цвет стадии в виде HEX: в это полу нужно вставить цветовой код стадии в виде HEX кода.
К примеру зеленый цвет в HEX: #008000.
Таблицу с HEX-кодами цветов можно найти в интернете, либо просто перейдя по данной ссылке: ТЫЦ

Код семантики стадии: в этом поле нужно выбрать семантический код стадии, т.е то, что данная стадия означает.
Доступно 2 варианта: Success и FAIL , что в дословном переводе "Успех" и "Провал/неудача".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Записи таймлайна

Создать новую запись таймлайна у элемента

Данное активити создает новую запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в данном поле нужно указать ID элемента RPA - бизнес-процесса, в таймлайне которого планируется добавлять новую запись.

ID пользователя: в этом поле указывается ID пользователя от имени которого запись будет добавлена.

Заголовок: в этом поле указывается заголовок добавляемой записи.

Описание: в этом поле указывается описание добавляемой записи.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID новой записи таймлайна;
- Результат выполнения;
- Сообщение об ошибке.

Удалить запись таймлайна у элемента

Данное активити удаляет запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле нужно указать ID записи таймлайна, которую нужно удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Массив записей таймлайна для элемента

Данное активити позволяет получить массив записей таймлайна для элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в данном поле нужно указать ID элемента RPA - бизнес-процесса, в таймлайне которого планируется добавлять новую запись.

ID записи таймлайна: в этом поле указывается ID пользователя от имени которого запись будет добавлена.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID пользователя;
- Заголовок;
- Описание;
- Результат поиска (Массив для итератора);
- Результат поиска (строка);
- Последний результат поиска;
- Количество найденных элементов;
- Результат выполнения;
- Сообщение об ошибке.

Изменить запись таймлайна у элемента

Данное активити изменяет запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле указывается ID записи таймлайна в элементе RPA - бизнес-процесса.

ID пользователя: в этом поле указывается ID пользователя от имени которого запись будет изменена.

Заголовок: в этом поле указывается заголовок изменяемой записи.

Описание: в этом поле указывается описание изменяемой записи.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Открепить/прикрепить запись

Данное активити позволяет прикрепить/открепить запись таймлайна для элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле указывается ID записи таймлайна, которую нужно открепить или прикрепить.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Задания

Удалить задание с процесса

Данное активити позволяет удалить задание для робота из процесса RPA

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса.

Имя робота: в этом поле указывается имя робота.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Добавить пользователя к существующему заданию

Данное активити позволяет добавить пользователя к существующему заданию процесса RPA

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса.

Имя робота: в этом поле указывается имя робота.

Cтрока с пользователем формата "Имя Фамилия [ид пользователя]": в этом поле указывается ID пользователя, которого нужно добавить в задание.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Коментарии

Добавить комментарий в таймлайне элементов

Данное активити позволяет добавить комментарий в таймлайне элементов процесса RPA.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в этом поле указывается ID элемента RPA - бизнес-процесса.

Описание: в этом поле вводится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID комментария;
- Сообщение об ошибке.

Изменить комментарий

Данное активити позволяет изменить комментарий в таймлайне элементов процесса RPA.

Сценарий работы активити бизнес-процесса

ID комментария: в этом поле указывается ID комментария в списке RPA - бизнес-процесса.

Описание: в этом поле вводится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Удалить комментарий

Данное активити позволяет удалить комментарий в таймлайне элементов процесса RPA

Сценарий работы активити бизнес-процесса

ID комментария: в этом поле указывается ID комментария элемента RPA - бизнес-процесса.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Сделки

Поиск Сделки (v.2)

Активити (робот) "Поиск сделки v2" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск сделок по определённым критериям для массовых операций (изменение стадии, назначение ответственного, обновление полей);
• Фильтрация сделок для создания отчётов и аналитики;
• Автоматический поиск связанных сделок при работе с другими сущностями CRM;
• Поиск дубликатов сделок для очистки базы данных;
• Поиск сделок по датам для автоматизации напоминаний и контроля сроков;
• Фильтрация сделок по ответственным для распределения нагрузки или отчётов;
• Поиск сделок по рекламным кампаниям для анализа эффективности маркетинга;
• Поиск сделок в определённых стадиях для автоматизации бизнес-процессов;
• Поиск сделок по сумме для финансовой аналитики;
• Поиск сделок в определённых направлениях (воронках).

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей сделки из CRM вашего портала через REST API (crm.deal.fields);
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Рядом с каждым полем создаётся дополнительное поле "Условие поиска" для выбора оператора сравнения;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно;
- Поддерживается выбор стадий из всех направлений сделок;
- Поддерживается обработка больших объёмов данных (более 50 сделок);
- Результаты возвращаются в виде массива ID сделок, строки с ID через запятую, первого и последнего ID, количества найденных сделок.

Сценарий работы активити (робота) бизнес-процесса

Описание параметров активити (робота)

Основные параметры поиска:
Активити (робот) автоматически создаёт параметры для всех полей сделки. Ниже описаны основные и наиболее часто используемые поля. Обратите внимание, что названия полей могут отличаться в зависимости от настроек вашего портала.

Название поля	Описание и примеры использования
ID	В данном поле указывается числовой идентификатор искомой сделки. Примеры: - ={123} - найти сделку с ID равным 123; - {=Document:ID} - найти сделку с ID из текущего документа; - ={!123} - найти все сделки, кроме сделки с ID 123.
Заголовок (TITLE)	Позволяет указать заголовок искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%договор} - найти все сделки, в заголовке которых содержится слово "договор"; - ={Договор поставки №123} - найти сделку с точным заголовком; - ={!%архив} - найти все сделки, в заголовке которых нет слова "архив".
Тип (TYPE_ID)	В данном поле указывается тип сделки из настроек CRM. Типы сделок настраиваются администратором портала. Примеры: - ={SALE} - найти сделки типа "Продажа"; - ={COMPLEX} - найти сделки типа "Комплексная сделка". Как узнать символьный код типа сделки: - Перейдите в CRM - Настройки - Типы сделок; - Или используйте активити (робот) для получения типов сделок.
Стадии сделки (STAGE_ID)	В данных полях выбираются стадии для искомой сделки. Название этого поля может быть иным, т.к. оно привязывается к названию стадий сделок на вашем портале. Важно: - Можно выбрать несколько стадий, зажав Ctrl и кликнув по нужным стадиям; - Таких полей может быть столько, сколько основных стадий сделок вы создали; - Каждое поле соответствует одной основной стадии. Примеры: - Выберите стадию "Квалификация" - будут найдены все сделки на этой стадии; - Выберите несколько стадий - найдутся сделки на любой из выбранных стадий.
Группа стадии (STAGE_SEMANTIC_ID)	В данном поле указывается группа стадии сделки с помощью символьного кода. Основные группы стадий: - P - "Сделка в работе" (Process); - S - "Сделка заключена" (Success); - F - "Сделка провалена" (Failed). Примеры: - ={P} - найти все сделки в работе; - ={S} - найти все успешно закрытые сделки; - ={F} - найти все проваленные сделки.
Вероятность (PROBABILITY)	В данном поле указывается уровень вероятности успешной сделки (в процентах от 0 до 100). Примеры: - ={50} - найти сделки с вероятностью 50%; - ={>=75} - найти сделки с вероятностью 75% и выше; - ={{20}}##{{60}} - найти сделки с вероятностью от 20% до 60%.
Сумма (OPPORTUNITY)	В данном поле указывается сумма искомой сделки. Примеры: - ={100000} - найти сделки с суммой 100 000; - ={>500000} - найти сделки с суммой больше 500 000; - ={{100000}}##{{500000}} - найти сделки с суммой от 100 000 до 500 000; - ={<=10000} - найти сделки с суммой не более 10 000.
Ставка налога (TAX_VALUE)	В данном поле указывается ставка налога для искомой сделки (в процентах). Примеры: - ={20} - найти сделки со ставкой налога 20%; - ={0} - найти сделки без налога (ставка 0%); - ={!0} - найти все сделки с ненулевой ставкой налога.
Комментарий (COMMENTS)	В данном поле указывается текст комментария для искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%срочно} - найти сделки, в комментариях которых содержится слово "срочно"; - ={!%архив} - найти сделки, в комментариях которых нет слова "архив".
Дата создания (DATE_CREATE)	В данном поле указывается дата создания искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}} - найти сделки, созданные в январе 2025 года; - ={=>{=dateadd({=System:Now}, "-30d")}} - найти сделки, созданные за последние 30 дней.
Дата изменения (DATE_MODIFY)	В данном поле указывается дата изменения искомой сделки. Примеры: - ={{01.03.2025 00:00:00}}##{{31.03.2025 23:59:59}} - найти сделки, изменённые в марте 2025 года; - ={=>{=dateadd({=System:Now}, "-7d")}} - найти сделки, изменённые за последнюю неделю.
Ответственный (ASSIGNED_BY_ID)	В данном поле указывается ответственный за сделку. Можно указать ID пользователя или использовать переменные. Примеры: - ={25} - найти сделки пользователя с ID 25; - {=Document:ASSIGNED_BY_ID} - найти сделки текущего ответственного из документа; - {=User:ID} - найти сделки текущего пользователя.
Дата начала (BEGINDATE)	В данном поле указывается дата начала искомой сделки. Примеры: - ={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}} - найти сделки с датой начала в 2025 году; - ={=>{=System:Now}} - найти сделки, которые начинаются после текущего момента.
Внешний источник (SOURCE_ID)	В данном поле указывается внешний источник в искомой сделке (символьный код источника). Примеры: - ={WEB} - найти сделки из источника "Веб-сайт"; - ={CALL} - найти сделки из источника "Звонок".
Рекламная система (UTM_SOURCE)	В данном поле указывается рекламная система в искомой сделке (из UTM-меток). Примеры: - ={%google} - найти сделки из рекламной системы Google; - ={%yandex} - найти сделки из рекламной системы Yandex.
Тип трафика (UTM_MEDIUM)	В данном поле указывается тип трафика в искомой сделке (из UTM-меток). Примеры: - ={%cpc} - найти сделки с типом трафика "cost per click"; - ={%organic} - найти сделки с органическим трафиком.
Обозначение рекламной кампании (UTM_CAMPAIGN)	В данном поле указываются обозначения рекламной кампании в искомой сделке (из UTM-меток). Примеры: - ={%летняя} - найти сделки из кампании "летняя распродажа".
Направление (CATEGORY_ID)	В данном поле указывается идентификатор направления сделки. Если не указано, то сделка принадлежит к общему направлению. Примеры: - ={0} - найти сделки в общем направлении; - ={5} - найти сделки в направлении с ID 5; - ={!0} - найти все сделки, которые не в общем направлении.
Новая сделка (IS_NEW)	В данном поле указывается флаг новой сделки (сделки в первой стадии). Примеры: - ={Y} - найти новые сделки; - ={N} - найти не новые сделки.
Шаблон регулярной сделки (IS_RECURRING)	В данном поле указывается флаг шаблона регулярной сделки. Примеры: - ={Y} - найти шаблоны регулярных сделок; - ={N} - найти обычные сделки (исключить шаблоны).
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота).

Операторы сравнения для поиска

Данные символы ставятся перед содержимым ячейки:
- ={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".
- ={!%ваше значение} - не содержит.
Пример заполнения: ={!%123}, это значит, что значение в выбранном поле не содержит 123.
- ={ваше значение} - равно.
Пример заполнения: ={123}, это значит, что значение в выбранном поле равно 123. Если в поле используется текст, то этот текст должен совпадать символ в символ.
- ={!ваше значение} - не равно.
Пример заполнения: ={!123}, это значит, что значение в выбранном поле не равно 123.
- ={>ваше значение} - больше.
Пример заполнения: ={>123}, это значит, что значение в выбранном поле больше 123 (только для поля тип "число").
- ={<ваше значение} - меньше.
- ={=>} - больше или равно.
- ={=<} - меньше или равно.

Для полей типа "дата" и "дата/время":
- Содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}
- В случае с переменной: ={=>{=Variable:search_date}}
- При необходимости поиска диапазона "от и до": ={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Примеры использования активити (робота)

Описание примера	Решение
Поиск всех сделок в работе	Параметры: Группа стадии (STAGE_SEMANTIC_ID) - ={P}. Активити (робот) найдёт все сделки со статусом "В работе".
Поиск сделок текущего ответственного с суммой больше 100 000	Параметры: Ответственный - {=Document:ASSIGNED_BY_ID}, Сумма - ={>100000}. Активити (робот) найдёт все сделки ответственного с суммой больше 100 000.
Поиск сделок, созданных за последний месяц	Параметры: Дата создания - ={=>{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все сделки, созданные за последний месяц.
Поиск сделок с заголовком, содержащим "договор"	Параметры: Заголовок - ={%договор}. Активити (робот) найдёт все сделки, в заголовке которых есть слово "договор".
Поиск успешно закрытых сделок из рекламы Google	Параметры: Группа стадии - ={S}, Рекламная система - ={%google}. Активити (робот) найдёт все успешные сделки из Google.
Поиск сделок в определённом направлении	Параметры: Направление - ={5}. Активити (робот) найдёт все сделки в направлении с ID 5.
Поиск сделок с суммой от 50 000 до 200 000	Параметры: Сумма - ={{50000}}##{{200000}}. Активити (робот) найдёт все сделки с суммой в указанном диапазоне.
Поиск сделок, кроме шаблонов регулярных сделок	Параметры: Шаблон регулярной сделки - ={N}. Активити (робот) найдёт только обычные сделки, исключая шаблоны.
Поиск новых сделок текущего пользователя	Параметры: Новая сделка - ={Y}, Ответственный - {=User:ID}. Активити (робот) найдёт все новые сделки текущего пользователя.
Поиск проваленных сделок за последний квартал	Параметры: Группа стадии - ={F}, Дата изменения - ={{01.01.2025 00:00:00}}##{{31.03.2025 23:59:59}}. Активити (робот) найдёт все проваленные сделки в первом квартале 2025 года.

Сценарий работы робота

Возвращаемые параметры данного активити (робота):
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных сделок. Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми. Удобно для передачи в другие активити (роботы).
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска. Полезно, когда нужно получить только первую найденную сделку.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных сделок.
- Соответствует условиям (math_search_results) - строка, указывающая результат поиска. Возможные значения: Y (найдены сделки) или N (сделки не найдены).
- Логи ошибок (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении.

Важно о возвращаемых параметрах: Если сделки не найдены, параметр math_search_results будет равен N, а count_search будет равен 0. Всегда проверяйте значение параметра math_search_results перед использованием результатов в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Динамическая поддержка полей:
Активити (робот) динамически поддерживает все поля сделки, доступные в вашем портале Битрикс24, включая пользовательские поля. Это означает, что вы можете искать по любым критериям.

Стадии сделок:
Для поиска по стадиям используются специальные поля, которые формируются на основе настроек вашего портала. Названия полей соответствуют названиям направлений сделок.

Комбинирование условий:
При указании нескольких полей для поиска, все условия объединяются по принципу "И" (AND). Будут найдены только те сделки, которые соответствуют всем указанным условиям.

Обработка больших объёмов данных:
Активити (робот) автоматически обрабатывает случаи, когда результатов больше 50 сделок. Все сделки будут корректно обработаны и возвращены в результатах.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр сделок в CRM. Рекомендуется использовать пользователя с правами администратора системы.

Использование в итераторе:
Для обработки большого количества сделок рекомендуется использовать итератор с параметром search_results_array. Это позволит обработать все сделки последовательно.

Изменение Сделки

Активити (робот) "Изменение Сделки" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое обновление полей сделки на основе данных из других систем или документов;
• Массовое изменение сделок (стадия, ответственный, сумма, вероятность) по определённым условиям;
• Автоматизация перехода сделок между стадиями в зависимости от событий;
• Обновление данных сделки после выполнения определённых действий (подписание договора, оплата и т.д.);
• Синхронизация данных сделки с внешними системами;
• Автоматическое назначение ответственного в зависимости от суммы, типа или других параметров;
• Расчёт и применение НДС и скидок к товарам сделки;
• Прикрепление файлов к сделке из других сущностей CRM.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей сделки из CRM вашего портала;
- Для каждого поля (кроме недоступных для редактирования) создаётся параметр, который можно заполнить для изменения значения;
- Можно изменить одно или несколько полей одновременно;
- При указании параметров для работы с товарами (НДС, скидки) активити автоматически пересчитывает цены всех товаров в сделке;
- Поддерживается прикрепление файлов через ID файлов на диске;
- Активити (робот) возвращает ID изменённой сделки для использования в дальнейших шагах бизнес-процесса.

Описание параметров активити (робота)



Основные параметры:

Название поля

Описание и примеры использования

ID Сделки (o_deal_id)

Обязательное поле. В данном поле необходимо указать числовой идентификатор (ID) сделки, которую необходимо изменить. Примеры: - 123 - изменить сделку с ID 123; - {=Document:ID} - изменить текущую сделку из документа; - {=A1988_22222_92566_99999:search_results} - изменить сделку из результата предыдущего активити; - {=Iterator:Value} - изменить сделку для каждого элемента в итераторе. Важно: Если ID сделки указан в формате [123] (в квадратных скобках), активити автоматически извлечёт числовое значение.

Параметры для работы с полями сделки:

Название поля	Описание и примеры использования
Название (TITLE)	В данном поле можно указать новое значение названия сделки. Примеры: - Договор поставки №123; - ={Договор {={=Document:ID}}}; - Для очистки поля передайте пробел: ={ }
Тип (TYPE_ID)	В данном поле можно изменить тип сделки. Значения берутся из справочника CRM. Примеры: - SALE - тип "Продажа"; - COMPLEX - тип "Комплексная сделка". Символьный код типа можно найти в CRM - Настройки - Типы сделок или использовать специальное активити.
Стадия сделки (STAGE_ID)	В данном поле можно изменить стадию сделки. Примеры: - NEW - стадия "Новая"; - QUALIFICATION - стадия "Квалификация". Как узнать символьный код стадии: 1. Добавьте штатное активити "Изменение документа"; 2. Выберите поле "стадия"; 3. Нажмите F12 и выберите инструмент "выбор элемента страницы"; 4. Найдите нужную стадию в списке. ВАЖНО! НЕЛЬЗЯ изменить одновременно направление и стадию сделки. Делайте это поочерёдно в отдельных активити.
Направление (CATEGORY_ID)	ВАЖНО! Активити (робот) не может изменить направление сделки, т.к механизм REST API Б24 не позволяет это делать напрямую. Используйте штатное активити "Смена направления сделки" или "Изменение документа".
Вероятность (PROBABILITY)	В данном поле можно изменить вероятность заключения сделки (от 0 до 100). Примеры: - ={50} - установить вероятность 50%; - ={{=min({=Variable:PROBABILITY} + 50, 100)}} - увеличить вероятность на 50; - ={0} - сбросить вероятность.
Сумма (OPPORTUNITY)	В данном поле можно изменить предполагаемую сумму. Поле заполняется автоматически из товарного раздела. Примеры: - ={100000} - установить сумму 100 000; - ={{={=Variable:OPPORTUNITY} * 1.1}} - увеличить сумму на 10%; - Для очистки: ={"##"} Важно: Изменение суммы вручную может конфликтовать с автоматическим расчётом из товаров.
Валюта (CURRENCY_ID)	В данном поле можно изменить валюту расчётов. Примеры: - RUB - рубли; - USD - доллары США; - EUR - евро.
Ставка налога (TAX_VALUE)	В данном поле указывается ставка налога (в процентах). Примеры: - ={20} - установить ставку НДС 20%; - ={0} - установить ставку 0%. Важно: Работает только если настроено поле "Способ начисления НДС" (i_active_nds).
Компания (COMPANY_ID)	В данном поле можно изменить привязанную компанию. Примеры: - ={123} - привязать компанию с ID 123; - {=Document:COMPANY_ID} - из текущего документа; - Для отвязки передайте 0.
Контакты (CONTACT_IDS)	В данном поле можно изменить привязанные контакты. Можно указать несколько ID через запятую. Примеры: - ={456,789,101112} - привязать несколько контактов; - {=Document:CONTACT_IDS} - массив из документа. Важно: Это поле заменяет все существующие связи. Для добавления контакта сначала получите текущие через "Получение данных Сделки".
Ответственный (ASSIGNED_BY_ID)	В данном поле можно изменить ответственного за сделку. Примеры: - ={user_25} - назначить пользователя с ID 25; - ={25} - также можно указать только ID; - {=Document:ASSIGNED_BY_ID} - из документа. Важно: В поле должен быть только ID без лишних символов (или в формате user_ID).
Дата начала (BEGINDATE)	В данном поле можно изменить дату начала сделки. Примеры: - ={01.01.2025 00:00:00}; - {=System:NowLocal} - текущая дата и время.
Дата завершения (CLOSEDATE)	В данном поле можно изменить предполагаемую дату завершения. Примеры: - ={31.12.2025 23:59:59}; - ={{=dateadd({=Variable:CLOSEDATE}, "30d")}} - на 30 дней позже.
Источник (SOURCE_ID)	В данном поле указывается источник сделки. Примеры: - WEB - Веб-сайт; - CALL - Звонок; - EMAIL - Email.
Комментарий (COMMENTS)	В данном поле можно изменить комментарий сделки. Примеры: - Важная сделка; - ={{={=Variable:COMMENTS} & " | Дополнительная информация"}} - добавить к существующему.
UTM-метки	Поддерживаются поля: UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN, UTM_CONTENT, UTM_TERM. Примеры: - google - рекламная система; - cpc - тип трафика.
Завершена (CLOSED)	Примеры: - Y или 1 - сделка завершена; - N или 0 - сделка не завершена.
Пользовательские поля (UF_*)	Активити автоматически создаёт параметры для всех пользовательских полей вашего портала.

Примеры использования:

№	Сценарий	ID Сделки	Изменяемое поле	Значение
1	Сменить стадию	{=Document:ID}	STAGE_ID	QUALIFICATION
2	Назначить ответственного	{=Document:ID}	ASSIGNED_BY_ID	user_25
3	Установить сумму	{=Variable:DEAL_ID}	OPPORTUNITY	={500000}
4	Привязать компанию	{=Document:ID}	COMPANY_ID	={123}
5	Изменить название	{=Document:ID}	TITLE	Договор №{=Document:ID}
6	Установить вероятность	{=Document:ID}	PROBABILITY	={75}
7	Добавить комментарий	{=Document:ID}	COMMENTS	Обработано: {=System:Date}
8	Изменить дату завершения	{=Document:ID}	CLOSEDATE	={{=dateadd({=System:Now}, "14d")}}
9	Установить источник	{=Document:ID}	SOURCE_ID	WEB
10	Завершить сделку	{=Document:ID}	CLOSED	Y

Сценарий работы активити (робота)



Возвращаемые параметры для данного активити:

• ID изменённой сделки (deal_id) - числовой идентификатор изменённой сделки;
• Успех операции (success) - результат выполнения операции (Y/N);
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- Нельзя изменить направление сделки через это активити - используйте штатные средства Битрикс24;
- Нельзя одновременно изменить направление и стадию - делайте это в разных активити;
- При изменении суммы вручную учитывайте, что она может быть перезаписана при изменении товаров;
- Пользователь, от имени которого запускается активити, должен иметь права на изменение сделки.

Удаление Сделки

Данное активити позволяет удалить сущность "Сделка", указав её ID.

Сценарий работы активити бизнес-процесса

ID сделки: в данном поле нужно указать ID удаляемой сделки.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат выполнения (Y/N);
- Сообщение об ошибке;
- Таймаут операции.

Получение данных по сущности: Сделка

Активити (робот) "Получение данных по сущности: Сделка" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение всех данных сделки по её ID;
• Получение значений пользовательских полей сделки;
• Получение данных связанных контактов сделки;
• Формирование отчётов и документов на основе данных сделки;
• Передача данных сделки в другие системы или активити;
• Подготовка данных для печати (с форматированием);
• Получение данных сделки из другой воронки или направления;
• Анализ и аудит данных сделок;
• Копирование данных между сделками;
• Интеграция с внешними системами через REST API.

Как работает активити (робот):
- Активити (робот) получает все данные сделки по указанному ID через REST API (crm.deal.get);
- Автоматически получает список всех доступных полей сделки, включая пользовательские поля;
- Может получать данные связанных контактов сделки (crm.deal.contact.items.get);
- Поддерживает форматирование данных для печати;
- Возвращает все поля сделки как отдельные параметры для использования в бизнес-процессе;
- Работает с любыми сделками, к которым есть доступ у указанного пользователя.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID сущности	В данном поле указывается ID сущности "сделка", данные которой необходимо получить. Это обязательный параметр. Примеры: - {=Document:ID} - получить данные текущей сделки; - 123 - получить данные сделки с ID 123; - {=Variable:DEAL_ID} - использовать ID из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска.
Для печати	Варианты: да/нет. Данное поле позволяет включить вывод данных в удобном для печати текстовом виде. При включении этой опции данные форматируются для удобного отображения в документах и отчётах.
Сообщение об ошибке	Варианты: да/нет. Позволяет выводить ошибки в журнал БП. Рекомендуется включать при отладке бизнес-процесса.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию, при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити (робота), и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Примеры использования активити (робота)

Описание примера	Решение
Получение данных текущей сделки	Параметры: ID сущности - {=Document:ID}. Активити (робот) вернёт все данные текущей сделки, включая стандартные и пользовательские поля.
Получение данных сделки с форматированием для печати	Параметры: ID сущности - {=Document:ID}, Для печати - Да. Активити (робот) вернёт данные сделки в формате, удобном для использования в документах.
Получение данных связанной сделки из переменной	Параметры: ID сущности - {=Variable:RELATED_DEAL_ID}. Активити (робот) получит данные сделки, ID которой хранится в переменной RELATED_DEAL_ID.
Получение данных сделки из результата поиска	Параметры: ID сущности - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) получит данные первой найденной сделки из предыдущего активити поиска.
Получение данных сделки для копирования в новую сделку	Параметры: ID сущности - {=Document:ID}. После получения данных, используйте возвращаемые параметры (TITLE, OPPORTUNITY, STAGE_ID и др.) для создания новой сделки.
Получение данных сделки для формирования отчёта	Параметры: ID сущности - {=Document:ID}, Для печати - Да. Используйте возвращаемые параметры для формирования текстового отчёта о сделке.
Получение данных сделки и её контактов	Параметры: ID сущности - {=Document:ID}. Активити (робот) автоматически получит данные связанных контактов и вернёт их имена в отдельных параметрах.
Получение данных сделки через итератор	Параметры: ID сущности - {=Iterator:Value}. Для каждого ID сделки из итератора активити (робот) получит все данные этой сделки.
Получение данных сделки для отправки во внешнюю систему	Параметры: ID сущности - {=Document:ID}. Используйте возвращаемые параметры для формирования запроса к внешней системе (webhook, API интеграция).
Получение данных сделки для проверки условий	Параметры: ID сущности - {=Variable:CHECK_DEAL_ID}. После получения данных используйте возвращаемые параметры в условиях бизнес-процесса для принятия решений.

Возвращаемые параметры данного активити (робота):
- Все поля сделки - активити (робот) возвращает все стандартные и пользовательские поля сделки как отдельные параметры. Например: ID, TITLE, STAGE_ID, OPPORTUNITY, CURRENCY_ID, ASSIGNED_BY_ID, COMPANY_ID, CONTACT_ID и другие.
- Данные контактов - если к сделке привязаны контакты, их имена будут возвращены в отдельных параметрах.
- Сообщение об ошибке (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении. При успешном выполнении содержит сообщение "deal_get_data_error_2: [количество полей]".
- Соответствует условиям (math_search_results) - строка, указывающая результат получения данных. Возможные значения: Y (данные получены) или N (сделка не найдена).

Важно о возвращаемых параметрах: Если сделка не найдена или у пользователя нет доступа к ней, параметр math_search_results будет равен N. Всегда проверяйте значение этого параметра перед использованием данных сделки в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательный параметр:
Для успешного получения данных обязательно должен быть указан параметр "ID сущности". Без указания ID сделки активити (робот) не сможет получить данные.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр указанной сделки. Если у пользователя нет прав, активити (робот) вернёт ошибку.

Пользовательские поля:
Активити (робот) автоматически получает все пользовательские поля сделки. Названия параметров для пользовательских полей соответствуют их символьным кодам (например, UF_CRM_1234567890).

Связанные контакты:
Если к сделке привязаны контакты, активити (робот) автоматически получит их данные через отдельный запрос (crm.deal.contact.items.get) и вернёт имена контактов в отдельных параметрах.

Форматирование для печати:
При включении опции "Для печати" данные форматируются для удобного отображения. Это особенно полезно при формировании документов и отчётов.

Создание сделки с товарами

Активити (робот) "Создание сделки с товарами" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Автоматическое создание сделок на основе данных из лидов или других сущностей;
• Создание сделок с предзаполненными товарными позициями;
• Автоматизация процесса конвертации лида в сделку с товарами;
• Создание сделок при интеграции с внешними системами (1С, интернет-магазины);
• Массовое создание сделок с определёнными параметрами;
• Создание сделок в определённом направлении (воронке);
• Автоматическое назначение ответственного и привязка к контактам/компаниям.

Как работает активити (робот):
- Активити (робот) создаёт новую сделку с указанными параметрами;
- Поддерживается добавление товарных позиций непосредственно при создании;
- Можно указать направление (воронку), стадию, ответственного;
- Поддерживается привязка к контактам и компаниям;
- Возвращается ID созданной сделки для использования в дальнейших шагах БП;
- Активити (робот) работает через REST API Битрикс24 (crm.deal.add).

Описание параметров активити (робота)

Основные параметры:

Название поля	Описание и примеры использования
Название сделки	Название создаваемой сделки. Примеры: - Сделка от {=System:Date}; - Заказ №{=Variable:ORDER_NUMBER}; - {=Document:TITLE} - название из текущего документа.
Направление (воронка)	ID направления (воронки), в котором будет создана сделка. Примеры: - 0 - общая воронка (по умолчанию); - 1, 2, 3... - ID конкретного направления; - {=Variable:CATEGORY_ID} - из переменной.
Стадия сделки	Символьный код стадии, на которой будет создана сделка. Примеры: - NEW - стадия "Новая"; - C1:NEW - стадия "Новая" в воронке 1; - {=Variable:STAGE_ID} - из переменной.
Ответственный	ID ответственного за сделку. Примеры: - {=Document:ASSIGNED_BY_ID} - ответственный из текущего документа; - user_25 - конкретный пользователь; - {=User:ID} - текущий пользователь.
Контакт	ID контакта для привязки к сделке. Примеры: - {=Document:CONTACT_ID} - контакт из текущего документа; - {=Variable:CONTACT_ID} - из переменной; - 123 - конкретный ID.
Компания	ID компании для привязки к сделке. Примеры: - {=Document:COMPANY_ID} - компания из текущего документа; - {=Variable:COMPANY_ID} - из переменной; - 456 - конкретный ID.
Сумма	Сумма сделки (заполняется автоматически из товаров). Примеры: - {=Variable:AMOUNT}; - 100000.
Валюта	Код валюты сделки. Примеры: - RUB - рубли; - USD - доллары; - EUR - евро.
Источник	Код источника сделки из справочника CRM. Примеры: - WEB - веб-сайт; - CALL - звонок; - {=Document:SOURCE_ID} - из документа.
Комментарий	Комментарий к сделке. Примеры: - Создано автоматически {=System:Date}; - {=Document:COMMENTS}.

Параметры товарных позиций:

Название поля	Описание и примеры использования
Товары (массив)	Массив товарных позиций для добавления в сделку. Каждый элемент содержит ID товара, количество, цену. Формат: [{"PRODUCT_ID": 123, "QUANTITY": 2, "PRICE": 1000}]
ID товара	ID товара из каталога Битрикс24. Примеры: - {=Variable:PRODUCT_ID}; - 123.
Количество	Количество товара. Примеры: - {=Variable:QUANTITY}; - 1.
Цена	Цена товара за единицу. Примеры: - {=Variable:PRICE}; - 1000.
Скидка	Размер скидки на товар (в процентах или абсолютном значении).
Ставка НДС	Ставка налога для товара. Примеры: - 20 - 20% НДС; - 0 - без НДС.

Примеры использования:

№	Сценарий	Название	Направление	Ответственный
1	Создание из лида	{=Document:TITLE}	0	{=Document:ASSIGNED_BY_ID}
2	Создание в конкретной воронке	Новая сделка	2	user_1
3	Создание с привязкой к контакту	Заказ клиента	0	{=User:ID}
4	Создание с товарами	Заказ №{=Variable:ORDER_NUM}	0	{=Variable:MANAGER_ID}
5	Создание из интеграции	Заказ из интернет-магазина	1	user_10
6	Создание на определённой стадии	Горячая сделка	0	{=Document:ASSIGNED_BY_ID}
7	Создание с суммой	Сделка на {=Variable:AMOUNT} руб.	0	{=User:ID}
8	Создание с комментарием	Сделка по рекомендации	0	{=Variable:RESPONSIBLE_ID}
9	Создание с источником	Входящий звонок	0	{=Document:ASSIGNED_BY_ID}
10	Создание с UTM-метками	Сделка из рекламы	0	user_5

Возвращаемые параметры для данного активити:

• ID сделки (deal_id) - числовой идентификатор созданной сделки;
• Успех операции (success) - Y при успехе, N при ошибке;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- При создании сделки с товарами сумма рассчитывается автоматически;
- Для добавления товаров нужно указать ID товаров из каталога Битрикс24;
- Пользователь должен иметь права на создание сделок в указанном направлении;
- При указании стадии учитывайте направление (например, C1:NEW для воронки 1).

Рекомендации:
- Используйте переменные для динамического формирования названия сделки;
- При интеграции с внешними системами сохраняйте внешний ID в пользовательском поле для связи;
- Для массового создания сделок используйте итератор с паузами между операциями.

Смарт-процессы

Смарт-процессы

Создать новый смарт-процесс

Данное активити позволяет создать новый смарт-процесс.

Сценарий работы активити бизнес-процесса

Название:	В данном поле указывается название создаваемого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться поля "Дата начала" и "Дата завершения" .
Поле "Клиент":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле "Клиент".
Использовать в пользовательском поле:	Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле "Реквизиты вашей компании".
Печать документов:	Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле  "Наблюдатели".
Использовать корзину:	Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового смарт-процесса;
- Сообщение об ошибке.

 

Удалить смарт-процесс

Данное активити позволяет удалить смарт-процесс.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в данном поле указывается ID удаляемого смарт-процесса.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по смарт-процессу

Данное активити позволяет получить данные указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в этом поле нужно указать ID смарт-процесса, данные которого нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID;
- Название;
- Символьный код;
- Кем создан;
- Идентификатор типа смарт-процесса;
- Результат выполнения;
- Сообщение об ошибке.

 

Поиск смарт-процессов

Данное активити позволяет найти смарт-процесс по указанным параметрам.

Сценарий работы активити бизнес-процесса

Название:	В данном поле указывается название искомого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет указать, используются ли в искомом смарт-процессе пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет указать, используются ли в искомом смарт-процессе пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет указать, используются ли в искомом смарт-процессе поля "Дата начала" и "Дата завершения" .
Поле "Клиент":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Клиент".
Использовать в пользовательском поле:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Реквизиты вашей компании".
Печать документов:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет указать, используются ли в искомом смарт-процессе поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Наблюдатели".
Использовать корзину:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Если при запуске поиска смарт-процессов по фильтру "Ответственный" по конкретному сотруднику (обычно один из администраторов портала), активити выдает идентификаторы как реально существующих СП, привязку которых вы видите наглядно, так и тех, которые вы не видите наглядно (к примеру смарт-процесс с ID_31 (смарт-счета)), то стоит учитывать, что это может быть особенностью работы метода crm.type.list.

Ограничить количество результатов до: в этом поле указывается предельное количество результатов, которое вернет активити, значение указывается цифрой.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

Изменить смарт-процесс

Данное активити позволяет изменить смарт-процесс.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в данном поле указывается ID изменяемого смарт-процесса.

Название:	В данном поле указывается название изменяемого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Идентификатор типа смарт-процесса:	В этом поле нужно указать ID типа смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться поля "Дата начала" и "Дата завершения".
Поле "Клиент":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле "Клиент".
Использовать в пользовательском поле:	Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле "Реквизиты вашей компании".
Печать документов:	Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле  "Наблюдатели".
Использовать корзину:	Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Мониторинг событий смарт-процессов

Данное активити позволяет мониторить события указанного Вами смарт-процесса.

Сценарий работы активити бизнес-процесса

Смарт-процесс: в данном поле из выпадающего списка нужно выбрать смарт-процесс за событиями которого активити будет наблюдать.

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

Событие: в этом поле нужно из выпадающего списка нужно выбрать один из видов событий за которыми активити будет следить.
Варианты событий: Добавление/Изменение.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.

Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID смарт-процесса;
- Сообщение об ошибке.

 

Стадии

Добавить стадию смарт-процесса

Данное активити позволяет добавить новую стадию для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором будет добавлена стадия.

ID направления: в этом поле нужно указать ID направления в рамках которого будет создана стадия.

Название стадии: в данном поле указывается название стадии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID новой стадии;
- Сообщение об ошибке.

 

Удалить стадию смарт-процесса

Данное активити позволяет удалить стадию указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором будет удалена стадия.

ID стадии: в данном поле указывается ID удаляемой стадии.

ID направления: в данном поле указывается ID направления в котором находится удаляемая стадия.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по стадии смарт-процесса

Данное активити позволяет получить данные по стадии указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в данном поле указывается ID стадии данные которой нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Идентификатор типа смарт процесса;
- ID направления;
- Сущность;
- Статус;
- Название стадии;
- Результат выполнения;
- Сообщение об ошибке.

 

Получить все стадии смарт-процесса

Данное активити позволяет получить все стадии указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором находится стадия.

ID направления: в данном поле указывается ID направления в котором находится стадия.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

 

Изменить стадию смарт-процесса

Данное активити позволяет изменить стадию в указанном смарт-процессе.

Сценарий работы активити бизнес-процесса

ID стадии: в данном поле указывается ID изменяемой стадии.

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором находится стадия.

ID направления: в этом поле нужно указать ID направления в котором содержится стадия.

Название стадии: в данном поле указывается название стадии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Направления

Создать новое направление смарт-процесса

Данное активити позволяет создать новое направление для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором будет создано направления.

Имя направления: в этом поле нужно указать имя создаваемого направления.

По умолчанию: в данном поле из выпадающего списка можно выбрать будет ли создаваемое направление, направлением по умолчанию или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового направления;
- Сообщение об ошибке.

 

Удалить направление смарт-процесса

Данное активити позволяет удалить направление для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором будет удалено направление.

ID направления: в этом поле нужно указать ID удаляемого направления.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по направлению смарт-процесса

Данное активити позволяет получить данные о направлении для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса.

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором содержится направление, данные по которому планируется получить.

ID направления: в этом поле нужно указать ID направления.

По умолчанию: в данном поле из выпадающего списка можно выбрать является ли направление данные которого надо получить, направлением по умолчанию или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Имя направления;
- Результат выполнения;
- Сообщение об ошибке.

 

Получить все направления смарт-процесса

Данное активити позволяет получить все направления указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса направления которого нужно получить.

Ограничить количество до: в этом поле нужно указать ограничение по количеству получаемых результатов в виде числового значения.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

 

Изменить данные направления смарт-процесса

Данное активити позволяет изменить данные направления указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID процесса в котором находится изменяемое направление.

ID направления: в этом поле нужно указать ID направления, данные которого будут изменены.

Имя направления: в этом поле нужно указать имя изменяемого направления.

По умолчанию: в данном поле из выпадающего списка можно выбрать будет ли изменяемое направление, направлением по умолчанию или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Элементы

Создать новый элемент смарт-процесса

Данное активити позволяет создать новый элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса:	в данном поле нудно указать ID типа смарт-процесса, в котором будет создан новый элемент.
Название:	в этом поле указывается название нового элемента.
Ответственный:	в данном поле указывается ID сотрудника, который будет ответственным за создаваемый элемент.
Доступно для всех:	в данном поле из выпадающего списка нужно выбрать будет ли данный элемент общедоступен (виден), варианты да/нет.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр --> Форма на сайт), с помощью которой элемент был создан.
Дата начала:	в этом поле указывается дата начала работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Дата завершения:	в этом поле указывается дата завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Компания:	в данном поле указывается ID компании с которой данный элемент будет связан.
Контакт:	в данном поле указывается ID контакта с которым данный элемент будет связан.
Наблюдатели:	в данном поле указывается ID сотрудника, который будет в роли наблюдателя в создаваемом элементе.
Направление:	в данном поле указывается ID направления, к которому создаваемый элемент будет относиться.
Реквизиты Вашей компании:	в данном поле указываются ID реквизитов Вашей компании.

   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- Сообщение об ошибке.

Получить данные по элементу смарт-процесса

Данное активити позволяет получить данные по элементу смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID типа смарт-процесса.

ID элемента: в этом поле нужно указать ID элемента смарт-процесса, данные которого нужно получить.

Активити работает только с простыми типами полей: строка, целое число, число, дата/время, дата, да/нет, адрес, ссылка, приваязка к справочникам CRM, привязка к элементам CRM. Поля, которых нет в данном списке - не поддерживаются ввиду того, что БП используют ограниченные типы полей, которые нельзя считать и передать. Если у Вас возникают вопросы по расширению списка поддерживаемых полей, рекомендуем обратиться в ТП Б24.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название;
- Внешний код;
- Создано CRM-формой;
- ID компании;
- ID контакта;
- Направление;
- ID связанного лида;
- ID связанной сделки;
- ID связанного предложения;
- ID связанного заказа;
- Стадия;
- Предыдущая стадия;
- Источник;
- Сумма;
- Валюта;
- Реквизиты Вашей компании;
- Результат выполнения;
- Сообщение об ошибке.

Удалить элемент смарт-процесса

Данное активити позволяет удалить элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID типа смарт-процесса.

ID элемента: в этом поле нужно указать ID элемента смарт-процесса, который нужно удалить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Изменить данные элемента смарт-процесса

Данное активити позволяет изменить элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса:	в данном поле нудно указать ID типа смарт-процесса, в котором будет изменен элемент.
ID элемента:	в этом поле нужно указать ID изменяемого элемента смарт-процесса.
Название:	в этом поле указывается название изменяемого элемента.
Внешний код:	в данном поле нужно указать внешний код элемента.
Ответственный:	в данном поле указывается ID сотрудника, который будет ответственным за элемент.
Доступно для всех:	в данном поле из выпадающего списка нужно выбрать будет ли данный элемент общедоступен (виден), варианты да/нет.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр->Форма на сайт), с помощью которой элемент был создан.
Дата начала:	в этом поле указывается дата начала работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Дата завершения:	в этом поле указывается дата завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
ID Компании:	в данном поле указывается ID компании с которой данный элемент будет связан.
ID Контакта:	в данном поле указывается ID контакта с которым данный элемент будет связан.
ID связанного лида:	в этом поле нужно указать ID связанного с элементом лида.
ID связанного контакта:	в этом поле нужно указать ID связанного с элементом контакта.
ID связанной сделки:	в этом поле нужно указать ID связанной с элементом сделки.
ID связанного предложения:	в этом поле нужно указать ID связанного с элементом предложения.
ID связанного заказа:	в этом поле нужно указать ID связанного с элементом заказа.
Наблюдатели:	в данном поле указывается ID сотрудника, который будет в роли наблюдателя в изменяемом элементе.
Направление:	в данном поле указывается ID направления, к которому изменяемый элемент будет относиться.
Стадия:	в этом поле указывается ID стадии в которой находится элемент.
Источник:	в данном поле можно изменить источник элемента. Значения берутся из одноимённого справочника CRM.
Дополнительно об источнике:	в этом поле указываются дополнительные данные об источнике.
Сумма:	данное поле аналогично по функционалу полю из сущности сделка, т.е в нем отображается/заполняется общая денежная сумма по элементу.
Режим расчета суммы:	в данном поле из выпадающего списка нужно выбрать активен ли режим автоматического расчета суммы или нет.
Валюта:	в данном поле указывается валюта с в которой происходит расчет.
Реквизиты Вашей компании:	в данном поле указываются ID реквизитов Вашей компании.

   

Если вам нужно перенести элементы поля тип "Список" из одной сущности в другую, к примеру из Компании в Контакт, то, просто так это сделать не получится, даже если это одно и то же поле, которое было конвертировано из Лида в любую другую сущность.
Однако, для полей элементов Смарт-процесса данное правило не актуально, т.к в рамках одного смарт-процесса, элементы поля тип "Список" имеют идентичные ID.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Поиск элементов смарт-процесса

Активити (робот) "Поиск элементов смарт-процесса" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск элементов смарт-процесса по различным критериям (название, стадия, ответственный);
• Фильтрация элементов для создания отчётов и аналитики;
• Поиск связанных элементов при работе с контактами, компаниями или сделками;
• Поиск элементов в определённой воронке (направлении) смарт-процесса;
• Поиск элементов по датам начала, завершения или последней коммуникации;
• Массовые операции над группой элементов (изменение стадии, назначение ответственного);
• Поиск элементов по сумме для финансовой аналитики;
• Интеграция с другими сущностями CRM (лиды, сделки, контакты, компании);
• Автоматизация процессов на основе найденных элементов;
• Поиск элементов по пользовательским полям смарт-процесса.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей выбранного смарт-процесса через REST API (crm.item.fields);
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Поддерживается выбор воронки (направления) и стадии для более точного поиска;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно;
- Поддерживается обработка больших объёмов данных (более 50 элементов) через специальную обработку;
- Результаты возвращаются в виде массива ID элементов, строки с ID через запятую, первого и последнего ID, количества найденных элементов.

Сценарий работы активити (робота) бизнес-процесса

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип смарт-процесса	В данном поле нужно выбрать из выпадающего списка смарт-процесс, в котором будет осуществляться поиск элементов. Это обязательный параметр. Примеры: - Выберите нужный смарт-процесс из выпадающего списка; - Список смарт-процессов формируется автоматически на основе настроек вашего портала.
Воронка	В этом поле из выпадающего списка нужно выбрать направление (воронку), в которой находится искомый элемент смарт-процесса. Примеры: - Выберите нужную воронку из выпадающего списка; - Если воронка не указана, поиск будет осуществляться по всем воронкам.
Стадия	В этом поле указывается ID стадии, в которой находится элемент. Примеры: - Выберите нужную стадию из выпадающего списка; - Можно выбрать несколько стадий, зажав Ctrl и кликнув по нужным стадиям.
ID	В этом поле нужно указать ID искомого элемента смарт-процесса. Примеры: - ={123} - найти элемент с ID равным 123; - {=Document:ID} - использовать ID из текущего документа; - ={!123} - найти все элементы, кроме элемента с ID 123.
Название	В этом поле указывается название искомого элемента. Поддерживает поиск по частичному совпадению. Примеры: - ={%заявка} - найти элементы, название которых содержит "заявка"; - ={Заявка на ремонт} - найти элемент с точным названием; - ={!%тест} - найти элементы, название которых не содержит "тест".
Ответственный	В данном поле указывается ID сотрудника, который указан как ответственный в элементе. Примеры: - {=Document:ASSIGNED_BY_ID} - использовать ответственного из текущего документа; - ={25} - найти элементы пользователя с ID 25; - {=User:ID} - найти элементы текущего пользователя.
Доступно для всех	В данном поле из выпадающего списка нужно выбрать, является ли элемент общедоступным (виден всем). Варианты: - Да - элемент виден всем пользователям; - Нет - элемент виден только определённым пользователям.
Создано CRM-формой	В данном поле указывается ID CRM формы (Контакт-центр -> Форма на сайт), с помощью которой элемент был создан. Примеры: - ={5} - найти элементы, созданные формой с ID 5.
Дата начала	В этом поле указывается дата начала работы с элементом. Формат: день.месяц.год час:минута:секунда. Примеры: - ={=>08.12.2021 14:00:00} - найти элементы с датой начала после указанной даты; - ={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}} - найти элементы с датой начала в 2025 году.
Дата последней коммуникации	В этом поле указывается дата и/или время последней коммуникации с клиентом. Примеры: - ={=>{=dateadd({=System:Now}, "-7d")}} - найти элементы с коммуникацией за последние 7 дней.
Дата завершения	В этом поле указывается дата завершения работы с элементом. Формат: день.месяц.год час:минута:секунда. Примеры: - ={=<31.12.2025 23:59:59} - найти элементы с датой завершения до конца 2025 года.
Компании	В данном поле указывается ID компании, с которой искомый элемент связан. Примеры: - ={123} - найти элементы, связанные с компанией ID 123; - {=Document:COMPANY_ID} - использовать ID компании из текущего документа.
ID Контакта	В данном поле указывается ID контакта, с которым искомый элемент связан. Примеры: - ={456} - найти элементы, связанные с контактом ID 456; - {=Document:CONTACT_ID} - использовать ID контакта из текущего документа.
ID связанного лида	В этом поле нужно указать ID связанного с элементом лида. Примеры: - ={789} - найти элементы, связанные с лидом ID 789.
ID связанного предложения	В этом поле нужно указать ID связанного с элементом предложения.
ID связанного заказа	В этом поле нужно указать ID связанного с элементом заказа.
Наблюдатели	В данном поле указывается ID сотрудника, который является наблюдателем в искомом элементе. Примеры: - ={25} - найти элементы, где пользователь с ID 25 является наблюдателем.
Направление	В данном поле указывается ID направления, к которому искомый элемент относится.
Источник	В данном поле можно указать источник элемента. Значения берутся из одноимённого справочника CRM. Примеры: - ={WEB} - найти элементы из источника "Веб-сайт"; - ={CALL} - найти элементы из источника "Звонок".
Дополнительно об источнике	В этом поле указываются дополнительные данные об источнике.
Сумма	Данное поле аналогично по функционалу полю из сущности сделка - в нем отображается/заполняется общая денежная сумма по элементу. Примеры: - ={>100000} - найти элементы с суммой больше 100 000; - ={{10000}}##{{50000}} - найти элементы с суммой от 10 000 до 50 000.
Режим расчета суммы	В данном поле из выпадающего списка нужно выбрать, активен ли режим автоматического расчета суммы или нет.
Валюта	В данном поле указывается валюта, в которой происходит расчет. Примеры: - ={RUB} - найти элементы в рублях; - ={USD} - найти элементы в долларах.
Реквизиты Вашей компании	В данном поле указываются ID реквизитов Вашей компании.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса.
Текст статуса	В данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания (Время ожидания ответа от приложения)	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Операторы сравнения для поиска

Данные символы ставятся перед содержимым ячейки:
- ={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".
- ={!%ваше значение} - не содержит.
Пример заполнения: ={!%123}, это значит, что значение в выбранном поле не содержит 123.
- ={ваше значение} - равно.
Пример заполнения: ={123}, это значит, что значение в выбранном поле равно 123.
- ={!ваше значение} - не равно.
Пример заполнения: ={!123}, это значит, что значение в выбранном поле не равно 123.
- ={>ваше значение} - больше.
- ={<ваше значение} - меньше.
- ={=>} - больше или равно.
- ={=<} - меньше или равно.

Для полей типа "дата" и "дата/время":
- Содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}
- В случае с переменной: ={=>{=Variable:search_date}}
- При необходимости поиска диапазона "от и до": ={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Примеры использования активити (робота)

Описание примера	Решение
Поиск элементов смарт-процесса "Заявки" на стадии "Новая"	Параметры: Тип смарт-процесса - Заявки, Стадия - Новая. Активити (робот) найдёт все элементы на указанной стадии.
Поиск элементов по ответственному из текущего документа	Параметры: Тип смарт-процесса - [выбрать нужный], Ответственный - {=Document:ASSIGNED_BY_ID}. Активити (робот) найдёт все элементы, за которые отвечает тот же сотрудник.
Поиск элементов, связанных с контактом ID 456	Параметры: Тип смарт-процесса - [выбрать нужный], ID Контакта - ={456}. Активити (робот) найдёт все элементы, связанные с указанным контактом.
Поиск элементов с суммой больше 100 000 рублей	Параметры: Тип смарт-процесса - [выбрать нужный], Сумма - ={>100000}, Валюта - ={RUB}. Активити (робот) найдёт все элементы с суммой больше 100 000 рублей.
Поиск элементов с названием, содержащим "ремонт"	Параметры: Тип смарт-процесса - [выбрать нужный], Название - ={%ремонт}. Активити (робот) найдёт все элементы, в названии которых есть слово "ремонт".
Поиск элементов в определённой воронке	Параметры: Тип смарт-процесса - [выбрать нужный], Воронка - [выбрать нужную]. Активити (робот) найдёт все элементы в указанной воронке.
Поиск элементов, созданных за последний месяц	Параметры: Тип смарт-процесса - [выбрать нужный], Дата начала - ={=>{=dateadd({=System:Now}, "-1m")}}. Активити (робот) найдёт все элементы, созданные за последний месяц.
Поиск элементов, связанных с компанией из текущего документа	Параметры: Тип смарт-процесса - [выбрать нужный], Компании - {=Document:COMPANY_ID}. Активити (робот) найдёт все элементы, связанные с компанией из текущего документа.
Поиск элементов с датой завершения в текущем квартале	Параметры: Тип смарт-процесса - [выбрать нужный], Дата завершения - ={{01.01.2025 00:00:00}}##{{31.03.2025 23:59:59}}. Активити (робот) найдёт все элементы с датой завершения в первом квартале 2025 года.
Поиск общедоступных элементов текущего пользователя	Параметры: Тип смарт-процесса - [выбрать нужный], Ответственный - {=User:ID}, Доступно для всех - Да. Активити (робот) найдёт все общедоступные элементы текущего пользователя.

Сценарий работы робота

Возвращаемые параметры данного активити (робота):
- Результат поиска (массив для итератора) (search_results_array) - массив чисел с ID найденных элементов смарт-процесса. Используется для итерации по результатам в бизнес-процессе.
- Результат поиска (строка) (search_results_string) - строка со всеми результатами поиска, разделёнными запятыми. Удобно для передачи в другие активити (роботы).
- Первый результат поиска (search_result_first_string) - строка с первым результатом поиска. Полезно, когда нужно получить только первый найденный элемент.
- Последний результат поиска (search_result_last_string) - строка с последним результатом поиска.
- Количество найденных элементов (count_search) - числовое значение, указывающее количество найденных элементов.
- Сообщение об ошибке (s_error_logs) - строка с описанием ошибки или сообщением об успешном выполнении.

Важно о возвращаемых параметрах: Если элементы не найдены, количество найденных элементов будет равно 0. Всегда проверяйте количество найденных элементов перед использованием результатов в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательный параметр:
Для успешного поиска обязательно должен быть указан параметр "Тип смарт-процесса". Без указания типа смарт-процесса поиск не будет выполнен.

Динамическая поддержка полей:
Активити (робот) автоматически получает список всех доступных полей выбранного смарт-процесса, включая пользовательские поля. Это означает, что вы можете искать по любым полям, доступным в вашем смарт-процессе.

Воронки и стадии:
Воронки и стадии загружаются динамически для выбранного смарт-процесса. Если вы измените смарт-процесс, список воронок и стадий обновится автоматически.

Обработка больших объёмов данных:
Активити (робот) автоматически обрабатывает случаи, когда результатов больше 50 элементов, используя специальную функцию more50. Все элементы будут корректно обработаны и возвращены в результатах.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр элементов смарт-процесса. Рекомендуется использовать пользователя с правами администратора системы.

Мониторинг событий элементов смарт-процессов

Активити наблюдает за событиями внутри смарт-процесса и если происходит событие указанное в настройках,  возвращает в виде результата ID нового элемента, Смарт процесса или результат выполнения.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в этом поле указывается ID смарт-процесса за событиями которого наблюдает активити.

ID-элемента: в этом поле указывается ID элемента смарт-процесса.
Данное поле нужно для тех случаев когда требуется отслеживать события по конкретному элементу смарт-процесса. Если необходимо отслеживать все элементы смарт-процесса, то данное поле не заполняется.

Событие: в данном поле из выпадающего списка нужно выбрать тип события, на которое будет реагировать данное активити.
Доступно на выбор 3 типа событий: Добавление, Изменение, Удаление элемента любого смарт-процесса

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Данное активити в первую очередь предназначено для использования в конструкторе БП.
Использование в конструкторе роботов может привести к самопроизвольным срабатываниям из-за несовершенства логики работы мехнизма роботов с методами слежения за сущностями.

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- ID смарт-процесса;
- Сообщение об ошибке.

Сотрудники

Поиск сотрудников

Данное активити позволяет найти сотрудника по заданным параметрам.

При настройке данного активити, доступно к заполнению довольно обширное количество пользовательских полей, заполнение этих полей опционально и является обязательным, при условии, что это одни из параметров, по которым будет осуществляться поиск.
Результатом работы данного активити, является вывод в ленту CRM ID искомого сотрудника, а так же данных его профиля, если таковые заполнены.

Сценарий работы активити бизнес-процесса

ID: указание ID искомого сотрудника.
Данный пункт рассчитан на вывод данных только 1 сотрудника.

Подразделения: в данном поле указывается код подразделения, т.е его ID, так же можно выбрать подразделение из контекстного меню "..."/ "Категории пользователей"/"Сотрудники и отделы"/ выбрать подходящий отдел. Подразделение/отдел или департамент, это по сути одно и тоже.
Пример заполнения: [D1] , где "1", это ID подразделения, так если выбирать через контекстное меню, то поле может быть заполнено так: BITRIX: Все сотрудники отдела [D1];

Какие параметры выводить: данное поле позволяет ограничить перечень доступных к выводу параметров.
Варианты выбора:

• Только ID/Все данные/Сокращенный список параметров;
• Только ID: активити выдаст только ID пользователя;
• Все данные: Все доступные данные о пользователе;
• Сокращенный список параметров: 24 поля , ID пользователя, e-mail, фамилия, имя , отчество, пол, должность, день рождения, номер телефона мобильный и рабочий, факс, сайт или ссылка на соц сети, улица, город, индекс, страна, номер подразделения в котором работает.

Уволен ли сотрудник(сотрудники)?: варианты да/нет, позволяет указать, уволен ли искомый сотрудник или нет.

Данное поле ЖЕЛАТЕЛЬНО к заполнению, если не указать уволен ли сотрудник или нет, то в результате поиска вы получите всех сотрудников, которые когда-либо работали в отделе, включая уволенных.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Какие параметры выводить: в данном пункте доступны варианты выбора из выпадающего списка.
1. Только ID: в результате поиска выводит только ID искомого сотрудника.
2. Все данные: выводит все доступные данные о сотруднике.
3. Сокращенный список параметров: выводятся только основные параметры о сотруднике(ID, имя, e-mail).

Если какие-либо данные у сотрудников будут совпадать, то активити будет выводить данные сотрудников, у которых эти данные совпадают.
Т.е если у 2 сотрудников совпал телефон или e-mail, то в результате активити выдаст ID этих пользователей.
Однако изначально активити рассчитано на поиск 1 сотрудника.
Если вы хотите вывести один из возвращаемых параметров "Результат.." , то вам необходимо выбрать из выпадающего списка параметр "Все данные".

Если нужно осуществить поиск по полю "Рабочий телефон", то в активити это поле называется "Телефон компании".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса:  данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат..(ID,EMAIL и пр.)
- ID сотрудника.
- Данные, которые указаны в учетной записи сотрудника(Ф.И.О., почта, телефон и пр.).

Пригласить сотрудника

Данное активити позволяет отправить сотруднику приглашение на портал.

Сценарий работы активити бизнес-процесса

Почта, куда должно прийти приглашение: в данном поле указывается e-mail адрес для отправки приглашения.

Данное поле не поддерживает работу с массивами.

Экстранет:  будет ли данный сотрудник экстанет пользователем или нет.

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

ID группы (проекта): в данном поле указывается ID группы (проекта), в которой будет состоять приглашенный на портал сотрудник.

ID подразделения: в данном поле указывается ID подразделения,в котором будет состоять приглашенный на портал сотрудник.

Если сотрудник штатный, то поле "ID подразделения" обязательно к заполнению.

Текст приветствия: в данном поле указывается текст приветствия для приглашенного сотрудника.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID приглашенного пользователя.
- Сообщение об ошибке.

Получение отдела сотрудника

Данное активити даёт возможность получить id отдела в котором работает выбранный для анализа сотрудник портала. Это необходимо, когда нужно выбрать другого пользователя из отдела в котором состоит конкретный сотрудник, участвующий в бизнес-процессе.

Сценарий работы активити бизнес-процесса

ID сотрудника - в данное поле необходимо вставить ID сотрудника, отдел которого Вы хотите узнать.

Вывести информацию по названию отдела: варианты: да/нет.
Данный пункт позволяет вывести информацию об отделе сотрудника в текстовом виде.

Результатом работы приложения будет получение ID отдела сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

ВАЖНО!
Если у Вас сотрудник участвует сразу в нескольких отделах, то наше активити Вам не поможет, т.к. всегда будет возвращать первый попавшейся.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы роботов

   
   Возвращаемые параметры данного активити:
   - ID отдела (первый, если он в списке)
   - ID отделов пользователя (массив для итератора).
   - Названия отделов пользователя (массив для интегратора)
   - Количество найденных элементов.

Выбор сотрудника по e-mail

Данное активити позволяет выбрать сотрудника по его e-mail адресу. Это особенно важно, когда вы хотите назначать задачи экстранет пользователям, т.к. по другому у вас не получится это сделать в рамках бизнес-процесса. 

Сценарий работы активити бизнес-процесса

Email - в это поле необходимо вставить E-mail сотрудника, которого вы хотите выбрать.
На текущий момент, нет возможности удобно получать список экстранет-пользователей в бизнес-процессах и приходится выстраивать систему через e-mail.
Чтобы получить e-mail, необходимо либо создавать пользовательское поле типа список и туда заносить всех ваших экстранет пользователей, а потом с помощью бизнес-процесса сопоставлять полученного человека и его e-mail. Можно пойти проще. Сделать сразу список e-mail и в нём выбирать значение. 

Добавлять "user_" к ID пользователя: в данном поле указывается, будет ли добавлена текстовая приставка "user_" к ID пользователя.

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.

Результатом работы приложения будет получение ID конкретного сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID сотрудника.
- Сообщение об ошибке.

Изменить данные сотрудника

Данное активити позволяет изменить данные сотрудника по заданным в настройках параметрам.

Сценарий работы активити бизнес-процесса

Пользовательские поля нельзя получить методом rest. Это значит, что пользовательские поля не поддерживаются и если таковые были созданы, то они не появятся в списке полей в меню настройки активити.

ID сотрудника: в данном поле указывается ID сотрудника, данные которого нужно изменить.

Активность: в данном поле выбирается активен пользователь и может совершать действия или нет. Если нет, то пользователь даже не сможет зайти на портал.

В данном активити значительно больше полей, однако их назначение довольно легко понять, если у Вас возникли сложности, то вы можете обратиться за разъяснением их функционала в нашу ТП. 

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Выбор сотрудника по должности

Данное активити позволяет получить id сотрудника, который работает на портале зная всего лишь название его должности. Это особенно удобно когда у вас множество бизнес-процессов и в них приписаны должности людей, а не конкретные люди, т.к. при увольнении сотрудника вам придётся переписывать все бизнес-процессы в которых уволенный сотрудник участвовал.

Сценарий работы активити бизнес-процесса

Должность: наш специальный алгоритм собирает в данное поле все доступные на портале должности, выбрать  необходимую должность можно из выпадающего списка… Стоит учитывать, что если у вас есть несколько одинаковых названий должностей, то следует их именовать по другому, например, используя цифры: Менеджер 1 или Менеджер 2. 

Добавлять "user_" к ID пользователя: в данном поле указывается, будет ли добавлена текстовая приставка "user_" к ID пользователя.

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.

Резервный пользователь: данное поле обязательно для заполнения и заполняется на тот случай, если сотрудник с искомой должностью уволен. Если сотрудник не был уволен, то данные, заполненные в этом поле игнорируются, а если был, то активити выдаст ID резервного пользователя.

Результатом работы приложения будет получение ID конкретного сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Сценарий работы робота

   
   Возвращаемые параметры данного активити:
   - ID пользователя (первый, если он в списке)
   - ID пользователей (массив для итератора).
   - Количество найденных элементов.

Списки

Первый или последний элемент в списке

Данное активити позволяет выводить первый или последний элементы списка, указав ID и тип этого списка.

Сценарий работы активити бизнес-процесса

Тип инфоблока(списка): из выпадающего списка нужно выбрать тип инфоблока (списка), в котором содержится первый или последний элемент в списке.
Доступно 2 варианта:

• Инфоблок списка;
• Инфоблок процессов;

ID инфоблок (списка): в этом поле указывается ID списка, в котором содержится первый или последний элементы.

Расположение элемента: в этом поле нужно выбрать из выпадающего списка какой элемент нужно вывести: первый или последний.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Соответствует условиям.
- ID выбранного элемента списка.
- Сообщение об ошибке.

Поиск элемента списка

Данное активити позволяет находить элементы списков, указав содержимое данного элемента и место, где стоит искать данный элемент. Поиск может быть осуществлен по любым полям, и результат поиска выводится в массив. 
Результатом работы является получение ID элемента списка.

Сценарий работы активити бизнес-процесса

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
Если поле является списком, то нужно искать ID элемента, а не его значение.
Для этого нужно:
1. Перейти в режим редактирования элемента списка
2. Нажать F12 и выбрать селектор элементов страницы. 
3. Выбрать поле со списком.
4. Внизу появится список с ID.
Если осуществляется поиск списка групп, то поле "Где искать элемент" не заполняется.

Если в выпадающем списке нет списка, в котором расположен искомый элемент, то причин может быть 3:

• Вы создали список уже после установки активити, и чтобы активити "увидело" этот список, его (активити) нужно переустановить.
• Количество списков более 100, либо у списков слишком большая вложенность. У Б24 есть ограничение по размеру файла, в котором описан перечень списков и элементов, которые они содержат. Если размер файла превышает лимит, то активити попросту не увидит некоторые списки.
  
• У меню с выпадающим списком есть ограничение на отображение не более 50 элементов.

ID группы: в данном поле указывается ID группы, в которой лежит список. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

ID списка: в данном поле указывается ID списка, который расположен в группе. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

По какому полю выполнять поиск: позволяет выбрать тип поля, по которому будет выполняться поиск.
Доступно 4 варианта типов полей:

1. Вид поля "Код" (Код пользовательского поля); 
2. Тип "Детальное описание"; 
3. Тип "Анонс" (Предварительное описание); 
4. Тип "Название элемента"; 
5. Тип "Код штатного поля". Узнать тип поля можно в редакторе полей (действия>настроить поля).

1. Если выбран тип "Привязка к элементам CRM" и указана только одна сущность (любая), то осуществлять поиск нужно по ID.

2. Если установлен тип "Код" и указанно несколько сущностей(любых), то поиск нужно осуществлять по ID с префиксом.

Префиксы(Содержимое искомого поля):
L_26635 - Лид
C_843 - Контакт
CO_709 - Компания
D_839 - Сделка

Тип поля "код" устанавливается при создании поля в редакторе полей.
Поиск элемента по типу поля "код" не будет работать, если не указать данный тип поля при создании его в редакторе полей.
Это же правило распространяется на тип поля "Строка" или "Число".

CODE - это обозначение вида пользовательских полей при вводе параметров поиска. Оно относится к любым пользовательским полям, вне зависимости от того, какого ого типа (Например: Число, строка, дата  и.т.д)
NAME, DETAIL_TEXT, PREVIEW_TEXT - это системные виды полей.

Код искомого поля: данный код берется из пункта "настройка полей", в выбранном инфо блоке списка.
Если код искомого поля пуст, то активити будет искать согласно полю "Название".
Данное поля только для полей тип "Код".

Если поиск элементов осуществляется по "Код штатного поля", то коды штатных полей Б24 можно узнать перейдя в справку.
В случае, когда осуществляется поиск по штатному полю с кодом "DATE_CREATE" (Дата создания элемента), правильное заполнение поля выглядит так: #DTДата.Месяц.Год.

Пример: #DT23.06.2022.

Пример: NAIMENOVANIE_MATERIALA

Тип условия поиска: в данном поле указывается условие для поиска элемента.
Доступны варианты: равно, не равно, больше или равно, меньше или равно, больше, меньше, содержит, не содержит.

ВАЖНО!
Для полей тип "Список" нельзя использовать числовые значения, например "Содержит 283".

Содержимое искомого элемента: в данном пункте указывается название искомого элемента списка.
Пример: Трос

Данные символы ставятся перед содержимым ячейки:
={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=> больше или равно.
Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<  меньше или равно.
Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так: Вид пользовательского поля##Код поля##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Вид пользовательского поля: это тип пользовательского поля (строка, число и прочее смотря какой у вас) заполняется на английском.
Код поля: берется в настройках поля из адресной строки. 
Пример заполнения:
datetime##UF_CRM_1611588337##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора) 

Поиск элемента списка по нескольким полям

Активити "Групповой поиск элементов списка" предназначено для использования в бизнес-процессах и роботах, когда требуется найти элементы списка Битрикс24 по нескольким условиям одновременно.

Сценарий работы активити бизнес-процесса

Активити (робот) анализирует выбранный список и находит элементы, удовлетворяющие набору условий. Для каждого условия указывается тип поля, буквенный код, код сравнения и искомое значение. Результатом будет массив ID найденных элементов и ID первого элемента из списка найденных.

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

Чтобы определить ID элемента:

1. Перейдите в режим редактирования элемента списка.
2. Нажмите F12 и включите выбор элемента на странице.
3. Укажите нужное поле списка.
4. Внизу появится значение с нужным ID.

Если осуществляется поиск списка групп, поле "Где искать элемент" не заполняется.

Если после установки активити (робота) список не отображается в выпадающем меню, убедитесь, что активити переустановлено после создания новых списков, общее количество списков не превышает 100 и глубина вложенности разумная, а также учитывайте ограничение на отображение не более 50 элементов в выпадающем меню.

Описание параметров активити

Название поля	Описание и примеры использования
Где искать элемент	Выберите список, в котором выполняется поиск. Для поиска по групповым спискам поле оставьте пустым. Пример: lists_567.
ID группы	Укажите идентификатор группы соцсети, если используется списочный инфоблок в группе. Пример: {=Variable:GROUP_ID}.
ID списка	Задайте идентификатор инфоблока для поиска. Пример: {=Variable:IBLOCK_ID}.
Параметры поиска элемента(ов)	Укажите одно или несколько условий в формате ТИП##КОД##УСЛОВИЕ##ЗНАЧЕНИЕ. Примеры: CODE##NAME##1##Трос; NAME##7##Заказ {=Document:ID}.
Тип условия для всех параметров	Выберите тип агрегирования условий: 1 — все условия (И); 2 — любое условие (ИЛИ).
Делать отладочные сообщения в журнал БП	Варианты: Да/нет. Включайте только при необходимости детальной диагностики, так как активити использует дополнительные запросы.
Запускать от имени	Укажите сотрудника, от имени которого выполняется поиск. Рекомендуется задавать сотрудника с административными правами. Пример: {=Template:TargetUser}.
Устанавливать текст статуса	Варианты: Да/нет. При выборе «Да» активити обновляет статус шага бизнес-процесса.
Текст статуса	Текстовое описание текущего шага. Пример: Копия {=Document:TITLE}.
Ожидать ответа	Системное поле, определяет необходимость ожидания результата от приложения.
Период ожидания. Время ожидания ответа от приложения	Укажите период ожидания (не менее 5 минут). Пример: 10m.

Формат условий поиска

Условия задаются последовательностью: тип поля##буквенный код##код условия##значение.

Типы полей: 

CODE — пользовательские поля;

NAME — название; 

DETAIL_TEXT — детальный текст;

PREVIEW_TEXT — текст анонса.

Коды условий: 

• Равно - 1 (=); 
• Не равно - 2 (!=);
• Больше или равно - 3 (>=);
• Меньше или равно - 4 (<=);
• Больше - 5 (>);
• Меньше - 6 (<);
• Содержит - 7 (%);
• НЕ Содержит - 8 (!%).

Примеры условий:

• CODE##UF_SUMMA##1##{=Variable:TARGET_SUM}
• DETAIL_TEXT##7##СПБ
• NAME##7##Контракт {=Document:ID}
• PREVIEW_TEXT##8##Архив

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123}, это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123}, это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123}, это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123}, это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123}, это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>ваше значение} - больше или равно.
Пример заполнения: ={=>123}, это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<ваше значение} - меньше или равно.
Пример заполнения: ={=<123}, это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.

Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:

Вид пользовательского поля##Код поля##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Вид пользовательского поля: это тип пользовательского поля (строка, число и прочее смотря какой у вас) заполняется на английском.
Код поля: берется в настройках поля из адресной строки.
Пример заполнения:
datetime##UF_CRM_1611588337##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Для полей типа число или дата диапазон задаётся повторением параметра CODE с разными кодами условий.
Пример:
Ищем элемент за период с 01.03.2025 09:00:00 по 03.03.2025 09:00:00.
Заполняем поле: CODE##UF_CRM_DATE##3##{01.03.2025 09:00:00} и CODE##UF_CRM_DATE##4##{03.03.2025 09:00:00}.

При использовании множественного параметра "Параметры поиска элемента(ов)" каждое поле ввода в форме добавляет строку в общий массив content_element_search.
Убедитесь, что условия заполнены последовательно, иначе активити (робот) вернет ошибку формата.

Примеры использования активити

Описание примера	Решение
Поиск договора по названию и сумме с обязательным совпадением обоих условий	Где искать элемент — lists_567; Параметры поиска — CODE##UF_CONTRACT_NAME##1##Договор {=Document:ID}; CODE##UF_SUMMA##3##100000; Тип условия — 1.
Нахождение заявок, в детальном тексте которых указан город СПБ	Параметры поиска — DETAIL_TEXT##7##СПБ; Тип условия — 2; Результат используется в итераторе для уведомления {=User:ID}.
Выбор элементов, название которых содержит номер счёта документа	Параметры поиска — NAME##7##Счет {=Document:ACCOUNT_NUMBER}; Тип условия — 1; Группа — {=Variable:GROUP_ID}.
Поиск элементов с анонсом, не содержащим слово "Архив"	Параметры поиска — PREVIEW_TEXT##8##Архив; Тип условия — 2; ID списка — {=Variable:IBLOCK_ID}.
Поиск заявок с датой создания в диапазоне текущей недели	Параметры поиска — datetime##UF_DATE_CREATE##{{01.03.2025 00:00:00}}##{{07.03.2025 23:59:59}}; Тип условия — 1; Результат используется для уведомления {=User:ID}.
Получение списка элементов, где сумма больше значения из переменной	Параметры поиска — CODE##UF_SUMMA##5##{=Variable:TARGET_SUM}; Тип условия — 2; Делать отладку — нет.
Поиск элементов с точным совпадением пользовательского поля "Статус"	Параметры поиска — CODE##UF_STATUS##1##{=Variable:STATUS_TEXT}; Тип условия — 1; Запускать от имени — {=Template:TargetUser}.
Отбор элементов, у которых поле "Регион" не содержит значение {=Variable:REGION_BLOCK}	Параметры поиска — CODE##UF_REGION##8##{=Variable:REGION_BLOCK}; Тип условия — 2.
Поиск элементов по нескольким условиям с типом "ИЛИ"	Параметры поиска — CODE##UF_PRIORITY##1##Высокий, NAME##7##{=Document:TITLE}; Тип условия — 2.
Выбор элементов с детальным текстом, содержащим ссылку на текущий бизнес-процесс	Параметры поиска — DETAIL_TEXT##7##{=Workflow:ID}; Тип условия — 2; Устанавливать текст статуса — да; Текст статуса — Найдено {=System:Date}.

Сценарий работы активити робота

Возвращаемые параметры активити (робота):

• Соответствует условиям;
• Количество найденных элементов;
• Массив ID найденных элементов;
• Строка с ID найденных элементов через запятую;
• Первый ID из результатов;
• Последний ID из результатов;

Важно корректно заполнять множественные параметры: пустые строки условий могут привести к отсутствию результатов или ошибке формата. Перед запуском активити (робота) убедитесь, что у выбранного пользователя достаточно прав на чтение элементов указанного списка.

Изменение элемента списка

Данное активити позволяет добавлять элементы списка.

Сценарий работы активити бизнес-процесса

В каком списке меняем элемент: в этом поле нужно выбрать из выпадающего списка, список в котором будет изменен элемент.

Если список добавлен после установки данного активити, то он не будет отображен в выпадающем списке.

ID элемента: в этом поле указывается ID элемента, который нужно изменить.

Какое поле меняется: в этом поле указывается код поля и его значение через решетку (код поля##новое значение)
Пример: KovroviyGazon##321.

Чтобы все верно заполнить, нужно:

• Знать код поля которое планируется изменить в элементе (его можно посмотреть в настройках полей)
  
• Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

Если вы решили добавить в список файл через переменную тип "файл", то добавить можно только один файл за раз.

Делать отладочные сообщения в журнал БП:варианты да/нет.

Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Добавление элемента списка

Данное активити позволяет добавлять элементы списка.

Сценарий работы активити бизнес-процесса

В каком списке добавляем элемент: в этом поле нужно выбрать из выпадающего списка, список в который будет добавлен новый элемент.

Если список добавлен после установки данного активити, то он не будет отображен в списке.

Название элемента (NAME): в этом поле указываем название добавляемого элемента.

Поле нового элемента списка: при заполнении этого пункта, новое поле не создается, а добавляется в созданный элемент, это значит, что поле, которое Вы указываете должно быть уже создано.
Заполняется поле так: код поля##новое значение. Пример: KovroviyGazon##321
Чтобы все верно заполнить, нужно:

• Знать код поля которое планируется добавить в элемент (его можно посмотреть в настройках полей)
  
• Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

Если вы решили добавить в список файл через переменную тип "файл", то добавить можно только один файл за раз.

Делать отладочные сообщения в журнал БП:варианты да/нет.

Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID нового элемента списка.

Удаление элемента списка

Данное активити позволяет удалять элементы списка, указав где расположен удаляемый элемент и указав его ID.

Сценарий работы активити бизнес-процесса

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находиться.

ВАЖНО!
Если список создан после установки активити, то его не будет в выпадающем списке, для того, чтобы он появился, нужно переустановить активити. Это происходит из-за того, что активити получает перечень списков в момент установки.

ID группы: в этом поле указывается ID группы в которой находится удаляемый список.

ID списка: в этом поле нужно указать ID списка, который расположен в указанной выше группе.

ID удаляемого элемента: в этом поле указывается ID удаляемого элемента списка.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Соответствует условиям.
- ID элемента списка.
- Сообщение об ошибке.

Счета (старые)

Редактирование счета

Данное активити позволяет редактировать все поля сущности "Счет", включая пользовательские.

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID счета:	В данном поле указывается ID счета, который необходимо редактировать.
Номер:	В данном поле указывается номер редактируемого счета.
Комментарий:	В данном поле указывается комментарий менеджера.
Дата выставления:	В данном поле указывается дата выставления счета.
Дата создания:	В данном поле указывается дата создания счета.
Дата комментария к статусу:	В данном поле указывается дата комментария к статусу счета
Срок оплаты:	В данном пункте указывается до какой даты необходимо оплатить счет.
Тема:	В данном поле указывается тема выставленного счета.
Печатная форма счёта:	В данном поле указывается идентификатор печатной формы счета. (printable)
Дата оплаты:	В данном поле указываются дата оплаты счета. Дата указывается в формате Битрикс: 2019-07-30T03:00:00+03:00 (Год - месяц - дата - время + часовой пояс)
Номер документа оплаты:	В данном поле указывается номер документа оплаты.
Тип плательщика:	В данном поле указывается ID типа плательщика. ID плательщика, это ID платежной системы.  ID берется из списка плательщиков.
Комментарий к статусу:	В данном поле указываются комментарии к статусу.
Ответственный:	В данном поле указывается ID ответственного.
Статус:	В данном поле из выпадающего меню выбирается подходящий статус счета.
UF_COMPANY_ID:	В данном поле указывается ID компании, которой выставлен счет. Указывается, если плательщик Юридическое лицо
UF_CONTACT_ID:	В данном поле указывается ID плательщика, если тот является Физическим лицом, либо в виде контакта компании.
UF_MYCOMPANY_ID:	В данном поле указывается ID фирмы, которая выставляет счет.
UF_DEAL_ID:	В данном поле указывается идентификатор связанной сделки.
UF_QUOTE_ID:	В данном поле указывается идентификатор связанного коммерческого предложения.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), сам счет является элементом смарт-процесса, т.е для редактирования элемента используйте соответствующее активити из категории "Смарт-процессы".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик.

Возвращаемые параметры данного активити:
- Сообщение об ошибке.
- Успех редактирования.
- Таймаут операции.

Получение статуса счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

Сценарий работы активити бизнес-процесса

ID счета (условие): в данный пункт вводится ID статуса счета, за которым необходимо проследить.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), так же у смарт-процессов нет статусов, но есть направления, т.е для получения направления смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
Возвращаемыми параметрами будут статус счета, которому присвоено значение. Эти значения будут уникальны для каждого портала.
Это значение можно узнать, установив активити "Слежение за статусом счета", нажав F12 и выбрав "просмотр элементов" в пункте, где можно выбрать подходящий статус счета.
Должен появится выделенный пункт с HTML-кодом "select-id", если нажать радом с ним стрелку, то появится список статусов и присвоенные для них значения.

Создание счета

Данное активити создаёт сущность Счет на основании Сделки из которой оно запускается. Если в Сделке правильно указаны все реквизиты контрагента, то они все будут перенесены в созданный счет. Так же активити позволяет возвращать динамическую ссылку на счет, чтобы Вы могли её отправить клиенту в письме из бизнес-процесса.

Название	Описание
Префикс для номера счёта:	позволяет указать префикс для счета.
Использовать номерацию Битрикс24:	позволяет выбрать,будет ли использована нумерация Б24 или нет.
Принудительно выставлять счет только на:	данное поле позволяет принудительно выставлять счет только на Компанию либо на контакт. При работе с данным полем есть ньюансы: Если выбрать "Не важно", то при наличии Компании и Контакта, счет выставляется на Компанию и привязывается Контакт. Если выбрать "Компания", то счет будет выставлен на Компанию без привязки Контакта, даже если он есть в сделке.
Ответственный за счет:	в данном поле можно указать ответственного за созданный счет. Если данное поле не заполнить, то ответственный будет взят из настроек поля "Запускать от имени".
Статус счета:	в данном поле из выпадающего меню выбирается подходящий статус счета.
Срок оплаты в днях:	в данном пункте указывается срок оплаты счета в днях.
ID компании продавца:	в данном пункте указывается ID компании-продавца .
ID реквизита организации продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита организации продавца.
ID банковского реквизита продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID банковского реквизита продавца.
ID способа оплаты из настроек CRM (для контакта): (Это поле обязательно к заполнению)	в данном пункте указывается ID способа оплаты из настроек CRM для контакта. Из-за ошибки в переводе со стороны Б24, это поле отвечает за вывод печатной формы счета для контакта.
ID способа оплаты из настроек CRM (для компании): (Это поле обязательно к заполнению)	в данном пункте указывается ID способа оплаты из настроек CRM для компании. Из-за ошибки в переводе со стороны Б24, это поле отвечает за вывод печатной формы счета для компании.
ID реквизита покупателя (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита покупателя. Если данное поле заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.
Создавать реквизит для физ. лица (если пустой):	в данном пункте указывается, создавать ли реквизиты для физического лица.
Какой тип реквизита создавать:	в данном поле указывается какой тип реквизита создавать из выпадающего меню.
ID пресета ИП для физ. лица (если не указан, будет искаться с именем "ИП"):	в данном поле указывается ID пресета ИП для физ. лица
ID пресета для физ. лица (шаблон для реквизитов):	в данном поле указывается ID пресета(шаблона) для физ. лица
Ставка НДС:	позволяет выбрать из выпадающего списка ставку НДС.
Принудительно выставлять НДС:	позволяет принудительно выставить НДС, выбрав нужный параметр из выпадающего меню.

Данное активити создает счета "старого" типа. Новый тип счетов относится к смарт-процессам.
Т.е для создания счета нового типа, нужно использовать соответствующее активити и в смарт-процессе с ID_31 (данный смарт-процесс скрыт, однако он отвечает за создание новых счетов) создать элемент смарт-процесса.

Если Вы хотите создать счет для физ. лица, у которого нет реквизитов, то следующие поля обязательны к заполнению:

• Статус счета;
  
• Срок оплаты в днях;
  
• ID компании продавца;
  
• ID реквизита организации продавца (если реквизитов несколько, то и поле "ID банковского реквизита продавца);
  
• ID способа оплаты из настроек CRM (для контакта. печатная форма);
  
• Создавать реквизит для физ. лица (если пустой);
  
• Какой тип реквизита создавать.
• ID пресета для физ. лица (Настройки CRM-->С чего начать-->Шаблоны реквизитов)
  

Предустановленные товары (ID##количество##ед. измерения##цена):  позволяет добавить в счет товары из каталога. 

Если Вам нужно добавить товар из каталога, но при этом его название в счете должно быть отличным от каталожного, то после указания цены нужно добавить ## и указать нужное название товара. Это не изменит название товара в каталоге, но в конкретно созданном счете оно будет другим.  
Пример:Название товара по каталогу "Продление интернета_50Мбит" , в счете нужно назвать Продление интернета_50Мбит для ООО "КаршерингMSK".
Заполняем так: 1684##1##шт##35000##Продление интернета_50Мбит для ООО "КаршерингMSK" 

Название	Описание
Выставить счёт на остаток товаров в сделке:	позволяет выставить счет на разницу товаров указанных в сделке и товаров, которые уже имеются в счетах, при условии, что количество товаров и суммы в счетах не будут превышать аналогичные значения в сделке. Т.е если есть счет, где к примеру продано 5 авто и 4 сникерса, а новый счет выставляется с количеством 7 авто и 4 сникерсами, то активировав данную настройку, в новом счете будет 2 авто, а сникерсы в счет не попадут.
Частичная оплата (в процентах, по-умолчанию 100):	в данном пункте указывается процентная составляющая предоплаты.
Фиксированная сумма предоплаты:	позволяет указать фиксированную сумму предоплаты.
Сократить сумму за счет:	в данном поле можно выбрать за счет чего будет сокращена сумма за счет.
Округлять до целых (при расчете частичной оплаты):	в данном пункте указывается, округлять ли до целых чисел, при расчете частичной оплаты.
Комментарий к счёту (скрытый для покупателя):	позволяет добавить комментарий к счету, который будете видеть только Вы.
Делать отладочные сообщения в журнал БП:	позволяет выводить отладочные сообщения в журнал БП.

Если Сделка создана с компанией у которой нет реквизитов, то счет не выставится даже когда они будут добавлены в компанию, т.к. реквизиты привязываются к сделке.
Решение - перевыбрать компанию в Сделке.

Если вы столкнулись с такой ошибкой при выполнении активити: во время создания счета была обнаружена ошибка: Не введено значение обязательного поля "Печатная форма счёта", нужно заполнять поле "ID способа оплаты из настроек CRM (для компании)".
ID этого способа можно посмотреть в настройках способов оплаты вашего портала.

Возможности:

1. Счёт создаётся автоматически нашим активити.
2. При создании отдаёт ссылку для отправки на почту, поэтому можно в БП это сразу организовать.
3. Счет отслеживает нумерацию и может её сам устанавливать в рамках нескольких юр. лиц (Префиксы допускаются) Нумерация в рамках 1 года, т.е. с первого января другого года будут опять с нуля.
4. Есть возможность автоматически дробить счет на части (предоплата несколькими счетами)
5. Есть возможность отслеживать статус оплаты счета или любой другой статус.
6. Есть возможность выбирать разные платёжные реквизиты плательщика (в одной компании несколько юр. лиц)
7. Есть возможность выставлять счета от разных юр. лиц.
8. Есть возможность автоматически создавать реквизиты для физ. лиц, чтобы можно было выстроить грамотный обмен с 1С.

Обратите внимание на данную схему.
Она отображает все возможные сценарии, которые вам следует учитывать при проектировании бизнес-процесса в Битрикс24, т.к. каждая ветка является отдельным сценарием и его придётся выделять в бизнес-процессе.

Описание полей:

ID компании продавца: в данном поле необходимо указать ID Вашего юридического лица от которого будет выставляться счёт. Для того, чтобы узнать какое число необходимо вписывать это поле, следует перейти в CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ

В этом списке следует выбрать необходимую Вам компанию и посмотреть её id. Если Вы не видите данное поле, то настройте в шестерёнке его (ID) отображение.

Обращаем Ваше внимание на то, что в созданной вами компании от которой вы собираетесь выставлять счета, должен быть только 1 набор реквизитов (ИНН, КПП и так далее). Если Вы не заполните реквизиты, то счет будет создаваться с пустыми графами.

Для создания реквизитов следует зайти внутрь компании и добавить реквизиты.

 

ID реквизита организации продавца (если не указан, берется 1-й из списка):  в данном поле следует указать id набора реквизитов компании-продавца. Бывают такие случаи, что у одной Вашей компании могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов.

К сожалению, в новой карточке не выводится ID реквизитов и Вам потребуется переключится на отображение старой карточки CRM, чтобы уточнить ID реквизитов. CRM > НАСТРОЙКИ > ДРУГИЕ > ОБЩЕЕ > ВКЛЮЧИТЬ НОВУЮ КАРТОЧКУ CRM - НЕТ

Потом вы возвращаетесь к CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ 

На вкладке "Реквизиты" Вы можете увидеть ID реквизита. Если вы не видите данного поля, то в настройках заголовка следует его отобразить. 

ID банковского реквизита продавца: в данном поле следует указывать ID банковских реквизитов продавца. Бывают случаи, когда у одной компании с одним набором реквизитов существует несколько наборов банковских реквизитов (открыты счета в разных банках и их требуется указывать в счетах на оплату).

Для получения ID банковского реквизита вам необходимо открыть реквизиты компании и нажать F12 в браузере. Появится для отладки и просмотра кода. В данной панели есть режим, который позволяет выбирать графический элемент, чтобы увидеть код этого элемента. Посмотрите на картинку ниже.  

Вы нажимаете на значок выбора элемента и потом указываете на поле "Названия банка". Внизу появится код элемента. Вам нужен будет код типа BANK_DETAILS[n0] ... цифра в квадратных скобках будет тем самым ID. Его нужно использовать без буквы N. 

Для корректного создания счета, вы должны учитывать следующие моменты:
1. Для сущности Контакт реквизиты нужны из-за коллизий при обмене с 1С, и счет мы можем выставлять только с реквизитами.
2. Для сущности Компания реквизиты нужны в обязательном порядке!
3. Тип сущности покупателя должен совпадать с типом платёжной системы, т.е. если покупатель контакт, то и тип платёжной системы должен быть для контакта.
4. Смотрите результат запуска создания счёта в журнале бизнес-процесса. Там будут отображаться все шаги и вы сможете увидеть ошибку, если счёт не создался.

Реквизиты создаются по следующей логике:

• Если в сущности Сделка выбрана Компания, то реквизиты будут браться только из компании.
  
• Если в сущности Сделка выбран Контакт, то реквизиты будут браться только из Контакт.
• Если в сущности Сделка выбраны и Контакт и Компания, то реквизиты будут браться только из Компании.

ID реквизита покупателя: в данном поле следует указать id набора реквизитов покупателя. Бывают такие случаи, что у покупателя могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов. В описании поля ID реквизита продавцам (выше в данной инструкции) вы можете найти информацию как можно найти значение.

Если поле ID реквизита покупателя заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.

Создавать реквизит для физ. лица: эта опция необходима когда у Вас имеется обмен Битрикс24 и 1С конфигурации, которая не поддерживает сопоставление по e-mail. Если Вы установите "Да", то при создании счёта для физического лица система проверит наличие реквизитов. Если она их не найдёт, то создаст новый набор реквизитов тип ИП и автоматически проставит ИНН 000000000001 или очередной. Для каждого физ. лица будет присвоен ИНН и это позволит Вам сопоставлять клиента в двух системах.

ID пресета для физ. лица (если не указан, будет искаться с именем "ИП"): данная опция позволяет выбрать id типа набора реквизитов. Если Вы не трогали настройка типов реквизитов, то можете оставить эту опцию. Если Вы меняли название типов реквизитов, то вам необходимо зайти в настройки Битрикс24 и посмотреть ID типа реквизитов ИП.  CRM > НАСТРОЙКИ > ШАБЛОНЫ РЕКВИЗИТОВ

Тип реквизита Компании/Контакта "по умолчанию" для каждого типа сущности можно настроить отдельно.
Т.е если у вас в Сделке есть Компания или Контакт, у которого по умолчанию выбраны реквизиты для ИП, то при переходе в карточку Контакта или Компании вы можете обнаружить, что там по умолчанию указан другой тип реквизитов.
При выставлении счета из Сделки будет браться именно тот тип реквизита, который выбран по умолчанию в Сделке.
Стоит учитывать этот момент при выставлении счетов, т.к при срабатывании БП это может вызывать ошибку.

ID способа оплаты из настроек CRM: в данном поле необходимо указать способ оплаты. Для того, чтобы узнать какое число необходимо вписывать сюда, следует перейти: "CRM > НАСТРОЙКИ > СПОСОБЫ ОПЛАТЫ

В данном списке следует выбрать обработчик способа оплаты, который вы хотите использовать в счете. В способах оплаты указываются данные по ответственным лица, которые будут подписывать счет. Там же загружается бланк с фоном счета и картинка с печатями и подписями.

При наведении на название интересующей вас платёжной системы внизу появится ссылка на страницу редактирования. Для того чтобы использовать её в нашем активити вам необходимо взять последнюю цифру из данной ссылки, т.к. она является ID платёжной системы. 

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

Тип плательщика: в данном поле вы выбираете тип плательщика (юр. лицо или физическое). Это требуется для того, чтобы бланк правильно сформировался, т.к. есть внутренние требования системы и когда вы выбираете физ. лицо, то плательщиком будет на название компании, а ФИО вашего клиента. Это нужно учитывать при создании бизнес-процесса.  

Частичная оплата (в процентах, по-умолчанию 100): это поле позволит Вам делить количество позиций, указанных в счете. Например, у вас в рамках сделки выставляется два счета по 50% (предоплата и окончательная оплата). В данном поле Вы устанавливаете 50 и при создании счета количество всех позиций будет поделено на 2. При этом сами позиции останутся такими, как вы укажите в сделке. Сумма и налоги пересчитаются автоматически исходя из нового количества.

Округлять до целых (при расчете частичной оплаты): в данном поле можно установить округление количества в позициях сделки если выбрали не 100%, а меньшее значение, Например, в одной из позиций сделки у Вас указано количество 3. При делении получится значение 1,5. Эта опция позволит округлить полученное число до целого значения.

ID реквизита плательщика (если не указан, берется 1-й из списка): в данном поле вы можете указать какие выбрать реквизиты клиента для выставления счета. Не редко бывают случаи, когда в рамках одной компании бывают несколько юридических лиц, которые вам могут оплатить. Если в Сделке выбран один набор из множества реквизитов, то он автоматически будет использован нами при создании счета.

Если вы будете использовать наши процессы из примера, то следует учитывать следующие моменты:
1. Вы можете скачать готовый бизнес-процесс, который требуется импортировать в ваш портал.
2. При импортировании затрётся ваш процесс, в который вы будете грузить пример.
3. При импорте в вашем портале будут созданы все поля, которые участвуют в нашем примере сущности Сделка. Вам необходимо будет сделать их отображаемыми в карточке Сделки.
4. Перед импортом необходимо установить наше приложение и в его настройках установить активити "Создание Счета" и "Слежение за статусом счета"
5. Особенностью Битрикс24 (при импорте сторонних бизнес-процессов) является тот факт, что нужно будет проверить правильность подставленных дополнительных значений в местах:
- во всех элементах изменение документа (Прописываем ID счета) - нужно прописать значение из доп. результатов - Создание Счета - ID Созданного Счета
- во всех элементах изменение переменных (Прописываем значение) - нужно прописать значение из доп. результатов - Получение статуса счета - Статус счета
- во всех элементах отправки писем.

Кейс № 1 - Простое создание Счёта

Давайте рассмотрим пример в котором мы просто создаём Счёт от одной организации автоматически с помощью нашего приложения. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

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

В этой схеме мы заложили проверку на зависание приложения, чтобы ответственный за сделку смог вовремя вмешаться в процесс. Так же в процесс добавлена проверка на повторное создание счета, чтобы не делать дубликатов.  

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 1

Кейс № 2 - Простое создание Счёта и слежение за оплатой

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе рассматривается модель создания счета с наличием проверки его оплаты. При обмене данными с 1С конфигурациями, робот в Битрикс24 не получает сведений от системы, что счет был оплачен и Вы не можете ничего делать. Наше активити "Слежение за статусом счета" решает данный вопрос простым методом. Оно (активити) обращается через наш сервер к вашему порталу и опрашивает конкретный счет на предмет оплаты. Если говорить конкретнее, то оно может не только отслеживать оплату, а любой статус счета.

Мы не рекомендуем делать проверку статуса счета чаще чем 1 раз в час, т.к. вы будете создавать большую нагрузку на сервера 1С-Битрикс и наш сервер, а это неминуемо приведёт к блокировке вашего портала.

В рамках данного кейса рассматривается вариант при котором проверяется создавался ли ранее счет или нет. Если бизнес-процесс обнаруживает, что ранее он создавался, то автоматически запускается механизм проверки его статуса. Это позволяет огородить вас от дубликатов счетов, которые возникают по причине ошибок персонала.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 2

Кейс № 3 - Создание Счета со слежением и отправкой на почту клиенту

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения, отправляем его клиенту и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе появляются дополнительные проверки и поля, которые необходимы для нормальной работы всего процесса. Самое главное в автоматических алгоритмах - это не создавать неприятностей для ваших клиентов из-за своей беспечности, поэтому приходится проверять логику процесса несколько раз, чтобы убедиться в правильности выбранного пути. Мы дополнительно вынесли e-mail адрес для отправки писем, чтобы можно было точно его указать, т.к. в раках компании или контакта может быть куча адресов и какой из них правильный знает только менеджер, а машина может ошибиться. 

После завершения нескольких проверок бизнес-процесс получает от нашего активити ссылку на счет и вставляет её в письмо. В теле письма представленного бизнес-процесса уже внесена соответствующая переменная. 

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 3

Кейс № 4 - Создание Счёта от нескольких ваших организаций.

Давайте рассмотрим пример в котором мы создаём Счёт от разных ваших компаний в зависимости от условий оплаты (компания с НДС и без НДС). Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе создаются две альтернативные ветки каждая из которых соответствует своей компании со своими реквизитами и платёжной системой, которые вы предварительно должны настроить. Особенностью такой схемы является то, что в рамках нашего активити присваивается своя нумерация для счетов. Для полноценного запуска вам необходимо будет создать в системе два счета (для каждой вашей компании отдельно) с каким-то номером (можно с префиксом) и при запуске наше активити начнёт считать очередной номер начиная с того, который будет указан в вашем счете. Это особенно актуально, когда вы вели до этого момента оформление счетов в других программах и нумерация у вас есть. Возьмите из программы, в которой оформлялись счета крайний номер и создайте пустой счет с этим номером.

Если мы говорим про 1С-конфигурации, то важно использовать и префиксы, чтобы при выгрузке документов номер назначался такой, какой необходимо. Если в 1С ведётся работа по нескольким организациям и счета грузятся из Битрикс24, то нужно учитывать следующее:

1. Счета будут выгружаться с номерами и префиксами.

2. При проведении документа в 1С номер будет затираться на тот, который 1С считает очередным для проведённых документов.

3. Все счета нужно будет создавать ТОЛЬКО! в Битрикс24 если Вы не хотите, чтобы нумерация у Вас сбилась.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 4

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик

Возвращаемые параметры для данного активити:
- ID созданного счета.
- Номер созданного счета.
- Публичная ссылка на созданного счета.
- ID нового реквизита.
- Сообщение об ошибке.

Слежение за статусом счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

Сценарий работы активити бизнес-процесса

ID счета (условие): в данном поле указывается ID статуса счета, за которым необходимо проследить.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), так же у смарт-процессов нет статусов, но есть направления по этому используйте соответствующее активити из категории "Смарт-процессы" --> "Мониторинг событий элементов СП".

Подходящий статус счета (условие): выбор из выпадающего списка подходящего статуса счета.

ВАЖНО!
Период слежения длится в течении  одного месяца, после чего останавливается.
Это связанно с тем, что забивается база данных сведениями, которые не востребованы, что ведет за собой ухудшение быстродействия приложения в целом. 

Количество запросов зависит от общего количества счетов в системе т.к. "слежение" получает ВСЕ обновления ВСЕХ счетов, даже тех, результат обновления которых нас не интересует.

Пример:
БП создал один счёт и следит за его статусом, а в ручную создали 1000 счетов и за ними никто не следит.
В таком случае события будут приходить по 1001 счету, т.е по любому изменению любого счета. Т.е количество запросов зависит от таких изменений.
Как только вы получаете нужное событие, "слежение" срабатывает и мы перестаем получать эти запросы.

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

ВАЖНО!
Данное поле на данный момент не доступно для корректировки.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
Возвращаемыми параметрами будут статус счета, которому присвоено значение. Эти значения будут уникальны для каждого портала. Это значение можно узнать, выбрав "просмотр элементов" в пункте, где можно выбрать подходящий статус счета.
Должен появится выделенный пункт с HTML-кодом "select-id", если нажать радом с ним стрелку,то появится список статусов и присвоенные для них значения.

Получение данных по сущности счет

Данное активити получает все возможные данные из полей Счета (включая пользовательские), для того, чтобы их можно было использовать в рамках бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности "Счет", из которой планируется получить все данные. 

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), а сам счет является элементом смарт-процесса. Для получения данных по элементу смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Для печати: выводит данные в доступном для печати виде.

Ссылка на счет: варианты да/нет.
Указав "Да", активити выведет в возвращаемых параметрах ссылку на необходимый счет.

Сообщение об ошибке: да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Счет" 

Поиск счетов в сделке по статусу

Данное активити ищет в сделке все счета у которых нет статуса "Оплачено" или у них статус указан в параметрах.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

ID Сделки (обязательное): в данном пункте указывается ID сделки, в которой будет осуществлен поиск счета.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Данное активити работает только со "старым" типом счетов. Новый тип счетов относится к смарт-процессам (ID_31), а сами счета являются элементами этого смарт-процесса. Для поиска элементов смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Статус счета: в данном поле указывается статус искомого счета.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры данного активити:
- Найденные счета;
- Найденные счета (массив для итератора);
- Сообщение об ошибке.

Удаление счета

Данное активити позволяет удалить сущность "Счет", указав её ID.

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID удаляемого счета.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), т.е для удаления элемента смарт-процесса используйте соответствующее активити из категории "Смарт процессы".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат выполнения (Y/N).
- Сообщение об ошибке.
- Таймаут операции.

Поиск счетов

Данное активити позволяет осуществлять поиск счетов по выбранным параметрам.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

Название	Описание
Номер:	В данном поле указывается номер искомого счета.
Валюта:	В данном пункте указывается валюта, указанная в искомом счете.
Дата создания:	В данном поле указывается дата создания, искомого счета.
Дата комментария к статусу:	В данном поле указывается дата комментария к статусу.
Дата оплаты:	В данном поле указывается дата оплаты искомого счета.
Дата изменения статуса:	В данном поле указывается дата изменения статуса искомого счета.
Дата изменения:	В данном поле указывается дата изменения искомого счета.
Кем создан:	В данном пункте указывается кем создан искомый счет.
Кто изменил поле оплаты:	В данном поле указывается кто изменил поле оплаты.
Кто изменил статус:	В данном поле указывается кто изменил статус искомого счета.
ID:	В данном пункте указывается ID искомого счета.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), т.е для поиска счета, который является элементом смарт-процесса, используйте соответствующее активити из категории "Смарт процессы".

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы активити бизнес-процесса

Возвращаемые параметры для данного активити:
- Массив для итератора;
- Результат поиска (строка);
- Количество найденных элементов;
- Соответствует условиям;
- Сообщение об ошибке.

Перезаполнение товаров счета

Данное активити позволяет автоматически перезаполнять товары в Счёте при изменении Сделки. Это позволяет облегчать работу менеджерам. Особенно актуально, когда в счетах более 10 позиций.

Сценарий работы бизнес-процесса

ID Счёта: в данном пункте указывается ID счета, который планируется перезаполнять.

Данное активити работает только со "старыми" счетами, а новый тип счетов относится к смарт-процессам, и счета в нем являются элементами смарт-процесса. Т.е для работы с элементами смарт-процесса "счет" (его ID_31), нужно использовать соответствующее активити из категории "Смарт-процессы".

ID Сделки (Если ID счета не задано): в данном пункте указывается ID сделки к которой привязан счет. Если указан ID счета, то ID сделки не обязателен к заполнению.

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

Принудительно выставлять НДС: позволяет выбрать из выпадающего списка будет ли НДС добавлен в стоимость или поверх счета.

Ставка налога: позволяет выбрать из выпадающего списка, ставку налога.

Предустановленные товары (ID##количество##ед. измерения##цена): в данном пункте добавляются товары, которые ранее были предустановлены.

Поле "Предустановленные товары" нужно для того, чтобы добавлять дополнительные товары в счет помимо тех, что уже есть в сделке. Т.е если у вас в сделке есть некий товар "Чашка" и выставлен счет на эту чашку, то указав в поле "Предустановленные товары"  товар "доставка", этот товар будет дополнительно добавлен в счет и в счете будет уже 2 товара.
Если Вам не нужно добавлять дополнительный товар в счет, то это поле нужно оставить пустым.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Счета (новые)

Создать новый счет(новый)

Данное активити позволяет создавать новые элементы внутри смарт-процесса тип "счет".
Созданные этим активити элементы будут являться "счетами" и отобразятся в сущности, во вкладке "Счета".

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса: в этом поле указывается ID типа смарт-процесса в котором будет создан элемент (смарт-счет).
Для смарт-процессов тип "счет" этот ID всегда 31.

Тип реквизита Компании/Контакта "по умолчанию" для каждого типа сущности можно настроить отдельно.
Т.е если у вас в Сделке есть Компания или Контакт, у которого по умолчанию выбраны реквизиты для ИП, то при переходе в карточку Контакта или Компании вы можете обнаружить, что там по умолчанию указан другой тип реквизитов.
При выставлении счета из Сделки будет браться именно тот тип реквизита, который выбран по умолчанию в Сделке.
Стоит учитывать этот момент при выставлении счетов, т.к при срабатывании БП это может вызывать ошибку.

Направление: это поле доступно только при первичной настройке и позволяет указать направление, к которому относятся элементы смарт-процесса с которыми планируется работать.

Название	Описание
ID сделки:	в данном поле указывается ID сделки, к которой будет привязан созданный счет.
Ответственный за счет:	в этом поле нужно указать ID сотрудника, который будет ответственен за созданный счет
Количество платежей, на которое разделить сумму сделки:	в данном поле цифрой указывается количество платежей на которое можно разделить сумму сделки. При активации данной настройки (заполнение поля), нужно учитывать, что разделение работает ТОЛЬКО тогда, когда товарная позиция в счете 1 и количество этого товара тоже равно 1. Если позиций товара или его количество будет более 1, то приложение выдаст ошибку с уведомлением.
Принудительно выставлять счет только на:	данное поле позволяет принудительно выставлять счет только на Компанию либо на контакт. При работе с данным полем есть нюансы:  Если выбрать "Не важно", то при наличии Компании и Контакта, счет выставляется на Компанию и привязывается Контакт. Если выбрать "Компания", то счет будет выставлен на Компанию без привязки Контакта, даже если он есть в сделке.
Статус счета:	в этом поле из выпадающего списка нужно выбрать статус, в котором будет находиться счет при создании.
Срок оплаты в днях:	в данном пункте указывается срок оплаты счета в днях.
ID компании продавца:	в данном пункте указывается ID компании-продавца.
ID реквизита организации продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита организации продавца.
ID банковского реквизита продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID банковского реквизита продавца.
ID способа оплаты из настроек CRM (для контакта. Печатная форма):	в данном пункте указывается ID способа оплаты из настроек CRM для контакта.
ID способа оплаты из настроек CRM (для компании. Печатная форма):	в данном пункте указывается ID способа оплаты из настроек CRM для компании.
ID реквизита покупателя (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита покупателя. Если данное поле заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.
Создавать реквизит для физ. лица (если пустой):	варианты да/нет. в данном пункте указывается, создавать ли реквизиты для физического лица или нет. Если Вы хотите создать счет для физ. лица, у которого нет реквизитов, то следующие поля обязательны к заполнению: Статус счета; Срок оплаты в днях; ID компании продавца; ID реквизита организации продавца (если реквизитов несколько, то и поле "ID банковского реквизита продавца); ID способа оплаты из настроек CRM (для контакта. печатная форма); Создавать реквизит для физ. лица (если пустой); Какой тип реквизита создавать. ID пресета для физ. лица (Настройки CRM-->С чего начать-->Шаблоны реквизитов)
Какой тип реквизита создавать:	в данном поле нужно выбрать тип реквизита, который нужно создавать, Физ. лицо или ИП.
ID пресета ИП для физ. лица (если не указан, будет искаться с именем "ИП"):	в данном поле указывается ID пресета ИП для физ. лица.
ID пресета для физ. лица:	в данном поле указывается ID пресета(шаблона) для физ. лица.
Ставка НДС:	в данном поле нужно выбрать из выпадающего списка ставку НДС, которая будет применяться при выставлении счета. Сами ставки настраиваются в настройках CRM в пункте "налоги".
Принудительно выставлять НДС:	позволяет принудительно выставить НДС, выбрав нужный параметр из выпадающего меню.
Предустановленные товары (ID##количество##ед. измерения (буквами)##цена):	позволяет добавить в счет товары из каталога. Если Вам нужно добавить товар из каталога, но при этом его название в счете должно быть отличным от каталожного, то после указания цены нужно добавить ## и указать нужное название товара. Это не изменит название товара в каталоге, но в конкретно созданном счете оно будет другим.   Пример:  Название товара по каталогу "Продление интернета_50Мбит" , в счете нужно назвать Продление интернета_50Мбит для ООО "КаршерингMSK" Заполняем так: 1684##1##шт##35000##Продление интернета_50Мбит для ООО "КаршерингMSK"
Выставить счёт на остаток товаров в сделке:	варианты да/нет. Позволяет выставить счет на разницу товаров указанных в сделке и товаров, которые уже имеются в счетах, при условии, что количество товаров и суммы в счетах не будут превышать аналогичные значения в сделке. Т.е если есть счет, где к примеру продано 5 авто и 4 сникерса, а новый счет выставляется с количеством 7 авто и 4 сникерсами, то активировав данную настройку, в новом счете будет 2 авто, а сникерсы в счет не попадут.
Частичная оплата (в процентах, по-умолчанию 100):	в данном пункте указывается процентная составляющая предоплаты.
Фиксированная сумма предоплаты:	позволяет указать фиксированную сумму предоплаты.
Сократить сумму за счет:	в данном поле можно выбрать за счет чего будет сокращена сумма за счет. Варианты: стоимость товара/количество товара.
Округлять до целых (при расчете частичной оплаты):	варианты да/нет. Позволяет указать округлять ли до целых чисел, при расчете частичной оплаты или нет.
Комментарий к счёту (скрытый для покупателя):	позволяет добавить комментарий к счету, который будете видеть только Вы.

Если Сделка создана с компанией у которой нет реквизитов, то счет не выставится даже когда они будут добавлены в компанию, т.к. реквизиты привязываются к сделке.
Решение - перевыбрать компанию в Сделке.

Если вы столкнулись с такой ошибкой при выполнении активити: во время создания счета была обнаружена ошибка: Не введено значение обязательного поля "Печатная форма счёта" , нужно заполнять поле "ID способа оплаты из настроек CRM (для компании)". ID этого способа можно посмотреть в настройках способов оплаты вашего портала.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID созданного счета.
- ID нового реквизита.
- Сообщение об ошибке.

Поиск счета(новые)

Данное активити позволяет осуществлять поиск элементов смарт-процесса тип "счет".

Сценарий работы активити бизнес-процесса

Название	Описание
Название:	в данном поле нужно указать название искомого счета.
Ответственный:	в данном поле указывается ответственный за счет, который будет искать активити.
Доступно для всех:	выпадающий список с вариантами да/нет. Позволяет указать доступен ли данный счет для всех или для конкретных пользователей.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр->Форма на сайт), с помощью которой элемент был создан.
Поля "Дата начала" и "Дата завершения":	в этих полях указывается дата начала и завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
ID компании:	в данном поле указывается ID компании с которой искомый элемент (счет) связан.
ID контакта:	в данном поле указывается ID контакта с которым искомый элемент (счет) связан.
ID связанной сделки:	в данном поле указывается ID сделки с которой искомый элемент (счет) связан.
Стадия:	в этом поле из выпадающего списка нужно выбрать стадию, на которой элемент (счет) находится.
Источник:	в данном поле указывается источник элемента. Значения берутся из одноимённого справочника CRM.
Дополнительно об источнике:	в этом поле указываются дополнительные данные об источнике.
Сумма:	в этом поле указывается общая денежная сумма по элементу.
Сумма налога:	в этом поле указывается сумма налога в денежном эквиваленте. Т.е если у Вас сумма товаров в сделке на 3000р и ставка налога составляет 10%, то сумма налога будет 10% от 3000, т.е 300р.
Валюта:	в этом поле указывается валюта, в которой выставлен счет.
Реквизиты Вашей компании:	в этом поле указывается ID реквизита Вашей компании, в которой был выставлен счет.

Для поиска счета с суммой 0, нужно в поле "Сумма" указать не 0, а ##.
Так же, стоит учитывать, что поиск по названию не поддерживает спец. символы. Т.е если в названии есть "№" или подобные символы, то активити не найдет счет с таким названием.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

Слежение за статусом счета(новые)

Данное активити позволяет отслеживать статус смарт счета, при условии, что известен его ID.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса: в этом поле указывается ID типа смарт-процесса за статусом которого наблюдает активити. Для смарт процессов тип "счет" этот ID всегда 31.

Направление: это поле доступно только при первичной настройке и позволяет указать направление, к которому относятся элементы смарт процесса с которыми планируется работать.

ID счета (условие): в данном поле нужно указать ID счета, за статусом которого активити будет наблюдать.

Подходящий статус счета (условие): в этом поле из выпадающего списка можно выбрать статус чета, за которым будет происходить наблюдение.

Если вы добавили новый статус счета, то переустанавливать активити не обязательно. Данный статус должен самостоятельно подтянуться в список статусов.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Статус счета;
- Название статуса счета;
- ID счета;
- Сообщение об ошибке.

 

Удалить счет(новый)

Данное активити позволяет удалить элемент смарт процесса тип "счет".

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID элемента смарт-процесса тип "счет", который нужно удалить. Этот элемент сп, по сути и является счетом.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Изменить счет(новый)

Данное активити позволяет изменить элемент смарт-процесса тип "счет".
Созданные этим активити элементы будут являться "счетами" и отобразятся в сущности, во вкладке "Счета".

Сценарий работы активити бизнес-процесса

Название	Описание
ID счета:	в этом поле нужно указать ID элемента смарт-процесса тип "счет".
Название:	в данном поле указывается название изменяемого счета.
Ответственный за счет:	в этом поле нужно указать ID сотрудника, который будет ответственен за измененный счет.
Доступно для всех:	в данном поле указывается, будет ли данный счет общедоступным или нет.
Создано CRM-формой:	в данном пункте указывается ID компании указываются специфические данные, которые можно получить при создании счет с помощью CRM-форм.
ID компании:	в этом поле указывается ID компании, на которую выставлен счет.
ID контакта:	в этом поле указывается ID контакта, на который выставлен счет.
ID связанной сделки:	в этом поле указывается ID сделки, к которой данный счет имеет отношение.
Наблюдатели:	в данном поле можно указать сотрудника, который будет наблюдателем в счете после его изменения.
Статус счета:	в этом поле из выпадающего списка нужно выбрать статус, в котором будет находиться счет после изменения.
Источник:	в этом поле можно указать идентификатор источника из соответствующего каталога
Сумма:	в этом поле нужно указать общую сумму за товары в счете.
Сумма налога:	в данном поле указывается сумма налога, в которой был создан счет, значение указывается не в процентной составляющей.
Валюта:	в данном поле указывается валюта в которой выставлен счет.
Реквизиты Вашей компании:	в этом поле нужно указать ID реквизитов компании-продавца из каталога реквизитов (CRM-> Настройки-> С чего начать-> Реквизиты ваших компаний)

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения.
- Сообщение об ошибке.

 

Получение данных по счету(новому)

Данное активити позволяет получить данные по элементу смарт-процесса тип "счет".

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID элемента смарт-процесса тип "счет", данные которого нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название;
- Ответственный;
- Создано CRM-формой;
- Дата начала;
- Дата завершения;
- ID компании;
- ID контакта;
- ID связанной сделки;
- Статус счета;
- Источник;
- Дополнительно об источнике;
- Сумма;
- Сумма налога;
- Валюта;
- Реквизиты Вашей компании;
- Результат выполнения;
- Сообщение об ошибке.

 

Партнерский REST

Получить список клиентов (коробка)

Активити (робот) "Получить список клиентов Коробка" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение данных по клиентам коробочной версии Битрикс24 из партнёрского кабинета;
• Фильтрация клиентов по продукту, коду лицензии и сроку действия;
• Постраничная выборка записей для отчётов и CRM;
• Выбор одной конкретной записи из страницы по номеру строки;
• Синхронизация контактов и данных Market24 с внешними системами;
• Проверка подписки Market24 и даты её окончания;
• Автоматизация напоминаний по окончанию лицензии;
• Экспорт списка организаций с порталами и лимитами пользователей;
• Связка с бизнес-процессов по событию из переменных партнёра;
• Контроль количества найденных записей и навигации по страницам.

Как работает активити (робот):
- Выполняется запрос к партнёрскому API (метод clients.box.list) с идентификатором партнёра и секретным ключом;
- Фильтры передаются в теле запроса: поля с префиксом filter_ в активити преобразуются в ключи фильтра API;
- Из ответа выбирается одна запись: номер записи (row_rec) должен совпадать с порядковым индексом элемента в массиве list (нумерация с 1);
- Для вложенных блоков contact и market24 поля раскладываются в возвращаемые параметры с префиксами list_contact_ и list_market24_;
- Если список пуст или запись не найдена, возвращается math_search_results = N и остальные поля не заполняются;
- Возвращаются также параметры навигации: всего записей, число страниц, номер страницы, размер страницы.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Идентификатор партнера	Обязательный числовой идентификатор партнёра в партнёрском кабинете. Примеры: 1092905; {=Variable:PARTNER_ID}. Важно: без корректного partner_id запрос к API не выполняется.
Секретный ключ партнера	Обязательный ключ из карточки партнёра (partner_core). Примеры: {=Variable:PARTNER_CORE}.
Номер записи	Должен совпадать с ключом нужной записи в массиве list (в коде сравнивается с индексом в списке; указывайте номер записи в соответствии с порядком ответа API).
ID (фильтр)	Необязательный фильтр filter_id — идентификатор клиента в выборке.
Продукт	Необязательный фильтр filter_product — строка продукта.
Лицензия	Необязательный фильтр filter_licenseCode.
Срок действия: с / по	Необязательные фильтры filter_dateToFrom и filter_dateToTo в формате даты.
Номер страницы	Необязательный фильтр filter_page для постраничной выборки.
Запускать от имени	Укажите пользователя с правами, достаточными для выполнения запроса; рекомендуется администратор.
Устанавливать текст статуса	Параметр интерфейса робота: отображение статуса в истории бизнес-процесса при отладке.
Текст статуса	Текст статуса при включённой опции отображения.
Ожидать ответа	Служебный параметр: ожидание ответа приложения.
Период ожидания	Таймаут ожидания ответа от приложения (не менее 5 минут по смыслу настройки робота).

Примеры использования активити (робота)

Описание примера	Решение
Первая запись на первой странице без фильтра	partner_id и partner_core из констант партнёра, row_rec = 1, filter_page не задан или 1.
Фильтр по коду лицензии	filter_licenseCode = {=Variable:LICENSE_CODE}, row_rec = 1, partner_id = {=Variable:PARTNER_ID}.
Клиенты с действующей лицензией в диапазоне дат	filter_dateToFrom = {=System:Date}, filter_dateToTo через переменную с датой окончания периода.
Вторая строка на текущей странице	filter_page = {=Variable:PAGE}, row_rec = 2.
Передача партнёра из документа сделки	partner_id = {=Document:UF_CRM_PARTNER_ID} при заполненном пользовательском поле.
Поиск по продукту	filter_product = «Битрикс24», row_rec = 1.
Использование только обязательных полей	partner_id, partner_core, row_rec заполнены; фильтры пустые; проверка math_search_results.
Итерация по страницам в бизнес-процессе	Переменная PAGE увеличивается в цикле; filter_page = {=Variable:PAGE}, row_rec = 1 на каждой итерации.
Идентификация клиента по ID	filter_id = {=Variable:CLIENT_ID}, row_rec = 1.
Использование результата после проверки	Условие в БП: если «Все условия» (math_search_results) = Y, иначе ветка «нет данных».

Возвращаемые параметры данного активити (робота):
- list_id — идентификатор записи клиента;
- list_name — наименование организации;
- list_product — продукт;
- list_licenseId, list_licenseCode — лицензия;
- list_email, контактные поля list_contact_*;
- list_dateFrom, list_dateTo, list_buyDate, list_siteUrl, list_clientLang, list_maxUsers;
- list_market24_subscription, list_market24_dateTo — подписка Market24;
- list_totalCount, list_pageCount, list_pageNumber, list_pageSize — навигация;
- math_search_results — Y при успешном получении записи, N если список пуст или запись не найдена.

Важно: Номер записи row_rec должен соответствовать индексу в массиве list, возвращаемому API. При смене фильтров или страницы проверяйте list_totalCount и при необходимости корректируйте row_rec и filter_page.

Получить список клиентов Б24 (облако)

Активити (робот) "Получить список клиентов Б24 (облако)" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение списка облачных порталов клиентов из партнёрского кабинета;
• Фильтрация по адресу портала, лицензии, языку и датам;
• Отбор по датам регистрации, привлечения, активности и последней покупки;
• Работа с реферером и почтой для аналитики и рассылок;
• Постраничный просмотр больших выборок;
• Выбор одной записи из страницы по номеру строки;
• Синхронизация данных портала с CRM и учётными системами;
• Контроль подписки Market24 по клиенту облака;
• Связка с купонами и лицензиями в отчётах;
• Автоматические уведомления при появлении записи по фильтру.

Как работает активити (робот):
- Запрос к партнёрскому API (clients.cloud.list) с partner_id и partner_core;
- Параметры filter_* преобразуются в фильтр запроса (portalUrl, licenseCode, lang, диапазоны дат и др.);
- Из массива list выбирается одна запись, у которой индекс совпадает с row_rec минус 1 в логике перебора;
- Блок market24 раскладывается в list_market24_subscription и list_market24_dateTo;
- При пустом ответе math_search_results = N;
- Возвращаются параметры навигации по списку.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Идентификатор партнера	Обязательный ID партнёра. Пример: {=Variable:PARTNER_ID}.
Секретный ключ партнера	Обязательный ключ partner_core. Пример: {=Variable:PARTNER_CORE}.
Номер записи	Номер строки в массиве list для возврата (согласуйте с индексацией ответа API).
Адрес портала	Необязательный filter_portalUrl — URL портала клиента.
Лицензия, язык	filter_licenseCode, filter_lang.
Срок действия, даты	filter_dateToFrom, filter_dateToTo; даты создания, привлечения, активности, продаж — пары filter_*From / filter_*To.
Реферер, почта	filter_referer, filter_email.
Номер страницы	filter_page для постраничной выборки.
Запускать от имени	Пользователь с достаточными правами, рекомендуется администратор.
Устанавливать текст статуса, текст статуса	Отображение статуса шага в истории бизнес-процесса.
Ожидать ответа, период ожидания	Параметры ожидания ответа приложения в роботе.

Примеры использования активити (робота)

Описание примера	Решение
Первая запись списка	partner_id, partner_core, row_rec = 1, без фильтров.
Поиск по домену портала	filter_portalUrl = «https://client.bitrix24.ru», row_rec = 1.
Клиенты с активностью за квартал	filter_lastActivityDateFrom и filter_lastActivityDateTo в границах квартала, filter_page = 1, row_rec = 1.
Фильтр по почте	filter_email = {=Variable:EMAIL}, row_rec = 1.
Страница каталога партнёра	filter_page = {=Variable:PAGE}, row_rec = 1 для чтения первой строки страницы.
Уточнение по лицензии	filter_licenseCode = {=Variable:LICENSE}, row_rec = 1.
Новые порталы за период	filter_openDateFrom, filter_openDateTo — диапазон регистрации.
Аналитика реферера	filter_referer заполнен из переменной кампании, row_rec = 1.
Проверка результата	После шага условие по math_search_results = Y для продолжения ветки.
Язык интерфейса	filter_lang = ru или en в зависимости от сегмента.

Возвращаемые параметры данного активити (робота):
- list_id, list_portalUrl, list_lang;
- даты: list_dateTo, list_regDate, list_affDate, list_lastActivityDate, list_lastSaleDate;
- list_referer, list_coupon, list_email, list_contact;
- list_licenseId, list_licenseCode;
- list_market24_subscription, list_market24_dateTo;
- навигация: list_totalCount, list_pageCount, list_pageNumber, list_pageSize;
- math_search_results — Y или N.

Важно: Уточняйте у документации партнёрского API точный смысл индексов list и номера страницы, чтобы row_rec указывал на нужную запись.

Получить список чеков и купонов

Активити (робот) "Получить список чеков и купонов" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение списка чеков и купонов из партнёрского кабинета;
• Фильтрация по активности, дате покупки, типу действия, лицензии и номеру заказа;
• Выбор одной записи со страницы результата по номеру строки;
• Связка покупки с порталом и идентификатором клиента;
• Контроль периода и типа периода лицензии;
• Интеграция с учётом заказов по orderId;
• Проверка применения модуля по mpModuleCode;
• Отчёты по покупателям и сайтам;
• Условные ветки бизнес-процесса при наличии или отсутствии записей;
• Синхронизация с внутренней CRM по email покупателя.

Как работает активити (робот):
- Выполняется запрос coupon.list к партнёрскому API с partner_id и partner_core;
- Поля filter_* передаются в фильтр (active, buyDateFrom, buyDateTo, action, licenseCode, orderId, page);
- Из списка list выбирается одна запись по совпадению индекса с номером записи row_rec;
- Поля ответа префиксируются list_;
- При отсутствии данных math_search_results = N.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Идентификатор партнера	Обязательный параметр. Пример: {=Variable:PARTNER_ID}.
Секретный ключ партнера	Обязательный partner_core из карточки партнёра.
Номер записи	Номер строки в результате для возврата полей одной записи.
Номер страницы	filter_page — постраничная выборка.
Активность	filter_active — булев фильтр по активности купона.
Дата покупки: с / по	filter_buyDateFrom, filter_buyDateTo.
Тип	filter_action — тип действия в терминах API.
Лицензия	filter_licenseCode.
Номер заказа	filter_orderId — строковый идентификатор заказа.
Запускать от имени, статус, ожидание	Стандартные параметры робота Битрикс24 для прав и ожидания ответа.

Примеры использования активити (робота)

Описание примера	Решение
Первая запись без фильтра	partner_id, partner_core, row_rec = 1.
Только активные купоны	filter_active = Y, row_rec = 1, filter_page = 1.
Покупки за месяц	filter_buyDateFrom и filter_buyDateTo на границы месяца.
Поиск по заказу	filter_orderId = {=Variable:ORDER_ID}, row_rec = 1.
По коду лицензии	filter_licenseCode = {=Variable:LICENSE_CODE}, row_rec = 1.
Вторая строка на странице	row_rec = 2 при непустом списке.
Страница результатов	filter_page = {=Variable:PAGE}, row_rec = 1.
Фильтр по типу действия	filter_action задаётся согласно допустимым значениям API.
Проверка успеха	Условие: math_search_results = Y перед использованием list_buyerEmail.
Обогащение CRM	При Y передать list_clientId и list_portalUrl в следующее активити (робот).

Возвращаемые параметры данного активити (робота):
- list_id, list_siteCheck, данные покупателя list_buyerName, list_buyerEmail, list_buyerLang;
- list_active, list_action, list_buyDate, list_orderId, list_sitesNumber;
- лицензия: list_licenseId, list_licenseCode, list_period, list_periodType, list_toLicenseId;
- list_b24Id, list_portalUrl, list_clientId, list_mpModuleCode;
- навигация: list_totalCount, list_pageCount, list_pageNumber, list_pageSize;
- math_search_results — признак успешного получения записи.

Важно: Если список пуст, возвращается только math_search_results = N. Проверяйте это поле перед использованием list_* в следующих шагах.

Мониторинг лицензии Битрикс24

Активити (робот) "Мониторинг лицензии Битрикс24" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое отслеживание изменения тарифа на портале Битрикс24;
• Реагирование на события изменения тарифа в бизнес-процессах;
• Автоматизация процессов при изменении тарифа портала;
• Мониторинг лицензий клиентов через партнерский API;
• Интеграция с внешними системами на основе событий изменения тарифа;
• Автоматическое уведомление об изменении тарифа;
• Отслеживание смены тарифных планов клиентов;
• Автоматическое выполнение действий при изменении тарифа;
• Контроль демо-периодов и сроков действия лицензий;
• Синхронизация данных о тарифах с внешними системами.

Как работает активити (робот):
- Активити (робот) подписывается на события изменения тарифа через партнерский API Битрикс24 (partners.1c-bitrix.ru);
- При запуске проверяется наличие действующего обработчика через метод get.callback.list;
- Если обработчик существует и запись в events совпадает с текущим workflow_id, робот просто ждёт событий;
- Если обработчик существует, но запись в events не совпадает, запись обновляется;
- Если обработчика нет, создаётся новый через метод add.callback.bitrix24.portal.change.tariff;
- При получении события изменения тарифа от партнерского API робот возвращает данные о смене тарифа;
- Активити (робот) работает через систему callback от внешнего ресурса, а не через события Битрикс24;
- Поддерживается опция принудительного удаления существующих обработчиков перед созданием нового.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Идентификатор партнера	В данном поле указывается идентификатор партнера в партнерском кабинете Битрикс24. Это обязательный параметр. Примеры: - 1092905 - числовой идентификатор партнера; - {=Variable:PARTNER_ID} - использовать идентификатор из переменной предыдущего активити (робота); - {=Document:ID} - использовать ID из документа (если ID документа совпадает с идентификатором партнера). Важно: Идентификатор партнера можно получить в партнерском кабинете Битрикс24. Убедитесь, что указанный идентификатор корректен.
Секретный ключ партнера	В данном поле указывается секретный ключ партнера, который был указан в партнерской карточке. Это обязательный параметр. Используется для формирования подписи запросов к партнерскому API. Примеры: - 1234567 - секретный ключ партнера; - {=Variable:PARTNER_CORE} - использовать ключ из переменной предыдущего активити (робота). Важно: Секретный ключ партнера должен совпадать с ключом, указанным в партнерской карточке. Ключ используется для авторизации запросов к партнерскому API.
Удалить обработчик	В данном поле указывается, нужно ли удалять существующие обработчики перед созданием нового. Это необязательный параметр типа булево (да/нет). Варианты выбора: - Нет (false) - не удалять существующие обработчики, использовать существующий если он есть; - Да (true) - удалять все существующие обработчики перед созданием нового. Примеры использования: - Нет - использовать существующий обработчик если он есть, создавать новый только если его нет; - Да - всегда удалять существующие обработчики и создавать новый при каждом запуске робота. Когда использовать: - Для принудительного обновления обработчика при каждом запуске; - Для очистки старых обработчиков перед созданием нового; - Для обеспечения единственности обработчика на портал.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Примеры использования активити (робота)

Описание примера	Решение
Отслеживание изменения тарифа для конкретного партнера	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Активити (робот) подпишется на события изменения тарифа и будет ожидать callback от партнерского API.
Принудительное обновление обработчика при каждом запуске	Параметры: Идентификатор партнера - {=Variable:PARTNER_ID}, Секретный ключ партнера - {=Variable:PARTNER_CORE}, Удалить обработчик - Да. Активити (робот) удалит все существующие обработчики и создаст новый при каждом запуске.
Использование параметров из переменных	Параметры: Идентификатор партнера - {=Variable:PARTNER_ID}, Секретный ключ партнера - {=Variable:PARTNER_CORE}, Удалить обработчик - Нет. Активити (робот) использует данные из переменных предыдущих активити (роботов) для настройки мониторинга.
Мониторинг тарифа с автоматическим удалением обработчика	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Да. Активити (робот) удалит существующие обработчики, создаст новый и будет ожидать события изменения тарифа.
Использование существующего обработчика	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Если обработчик уже существует и запись в events совпадает с текущим workflow_id, активити (робот) просто будет ожидать событий без создания нового обработчика.
Обновление записи при несовпадении workflow_id	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Если обработчик существует, но запись в events не совпадает с текущим workflow_id, активити (робот) обновит запись в events для корректной работы.
Создание нового обработчика при отсутствии существующего	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Если обработчика нет в списке, активити (робот) создаст новый через метод add.callback.bitrix24.portal.change.tariff.
Мониторинг тарифа с использованием данных из документа	Параметры: Идентификатор партнера - {=Document:ID}, Секретный ключ партнера - {=Variable:PARTNER_CORE}, Удалить обработчик - Нет. Активити (робот) использует ID документа как идентификатор партнера и ключ из переменной.
Ожидание события изменения тарифа	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Активити (робот) настроит подписку и будет ожидать события изменения тарифа от партнерского API. При получении события вернёт данные о смене тарифа.
Автоматическое удаление обработчика после получения события	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. После получения события изменения тарифа в файле partner_callback.php обработчик автоматически удаляется через метод delete.callback.bitrix24.portal.change.tariff перед отправкой результата в бизнес-процесс, а запись из events также удаляется.

Возвращаемые параметры данного активити (робота):
- ID обработчика (callback_id) - числовой идентификатор обработчика callback, созданного для отслеживания изменения тарифа. Используется для идентификации обработчика в системе.
- Тип обработчика (callback_type) - тип события, на который подписан обработчик. Всегда равен "BITRIX24_PORTAL_CHANGE_TARIFF" для данного активити (робота).
- Адрес портала (b24_portal) - адрес портала Битрикс24, для которого произошло изменение тарифа.
- Внешний код портала (portal_external_id) - внешний код портала (например CP_111111 или B24_33333), для которого произошло изменение тарифа.
- Предыдущий тариф (old_tariff) - название предыдущего тарифа до изменения.
- Новый тариф (new_tariff) - название нового тарифа после изменения.
- Срок (period) - срок действия тарифа в числовом формате.
- Единицы измерения срока (period_type) - единицы измерения срока (дни, месяцы, годы и т.д.).
- Демо (is_demo) - булево значение, указывающее является ли тариф демо-версией (true/false).
- all_conditions (math_search_results) - строка, указывающая результат выполнения активити (робота). Всегда равен "Y" при успешном получении события.

Примеры использования возвращаемых параметров:
- Использовать данные о смене тарифа для обновления информации в CRM;
- Сохранить информацию о новом тарифе в переменные для дальнейшей обработки;
- Отправить уведомление об изменении тарифа с использованием данных old_tariff и new_tariff;
- Проверить является ли тариф демо-версией через параметр is_demo;
- Использовать portal_external_id для идентификации портала в внешних системах;
- Рассчитать срок действия тарифа на основе period и period_type;
- Создать задачу или дело при изменении тарифа с использованием данных о портале;
- Использовать callback_id для логирования или отладки.

Важно о возвращаемых параметрах: Параметры возвращаются только при получении события изменения тарифа от партнерского API. Если событие не получено в течение периода ожидания, активити (робот) завершится по таймауту. Всегда проверяйте наличие значения параметра math_search_results перед использованием возвращаемых данных в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешной настройки мониторинга обязательно должны быть заполнены следующие параметры:
- Идентификатор партнера;
- Секретный ключ партнера.

Работа с партнерским API:
Активити (робот) работает через партнерский API Битрикс24 (partners.1c-bitrix.ru), а не через стандартные события Битрикс24. Callback приходит напрямую от партнерского API на специальный endpoint partner_callback.php. События срабатывают асинхронно, поэтому бизнес-процесс может продолжить выполнение через некоторое время после настройки мониторинга.

Проверка существующего обработчика:
При запуске активити (робот) проверяет наличие действующего обработчика через метод get.callback.list. Если обработчик существует и запись в events совпадает с текущим workflow_id, робот просто ждёт событий без создания нового обработчика. Это позволяет избежать дублирования обработчиков.

Обновление записи в events:
Если обработчик существует, но запись в events не совпадает с текущим workflow_id, активити (робот) обновит запись в events для корректной работы. Это обеспечивает правильную привязку обработчика к текущему бизнес-процессу.

Автоматическое удаление обработчика:
После получения события изменения тарифа в файле partner_callback.php обработчик автоматически удаляется через метод delete.callback.bitrix24.portal.change.tariff перед отправкой результата в бизнес-процесс через bizproc.event.send, а запись из events также удаляется. Это предотвращает накопление неиспользуемых обработчиков.

Параметр "Удалить обработчик":
Если параметр "Удалить обработчик" установлен в "Да", активити (робот) удалит все существующие обработчики перед созданием нового.

Ограничение на количество обработчиков:
Партнерский API позволяет создать только один обработчик на портал. Если попытаться создать второй обработчик для того же портала, будет возвращена ошибка CALLBACK_ALREADY_EXISTS. Активити (робот) автоматически обрабатывает эту ситуацию и использует существующий обработчик или удаляет его перед созданием нового в зависимости от параметра "Удалить обработчик".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на работу с партнерским API. Рекомендуется использовать пользователя с правами администратора системы.

Удаление отслеживания:
При удалении активити (робота) автоматически удаляются подписки на события и записи в events, настроенные для данного активити (робота). Это предотвращает накопление неиспользуемых подписок на события.

Производительность:
Мониторинг изменения тарифа создаёт подписки на события через партнерский API, которые могут увеличить нагрузку на систему при большом количестве отслеживаемых порталов. Рекомендуется использовать мониторинг только для действительно необходимых случаев и удалять неиспользуемые активити (роботы) мониторинга.

Мониторинг создания порталов Битрикс24

Активити (робот) "Мониторинг создания порталов Битрикс24" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое отслеживание создания новых порталов в партнерском кабинете Битрикс24;
• Реагирование на события создания порталов в бизнес-процессах;
• Автоматизация процессов при создании новых порталов клиентами;
• Мониторинг новых клиентов через партнерский API;
• Интеграция с внешними системами на основе событий создания порталов;
• Автоматическое уведомление о создании новых порталов;
• Отслеживание регистрации новых клиентов;
• Автоматическое выполнение действий при создании портала;
• Сбор информации о новых порталах для аналитики;
• Синхронизация данных о новых порталах с внешними системами.

Как работает активити (робот):
- Активити (робот) подписывается на события создания порталов через партнерский API Битрикс24 (partners.1c-bitrix.ru);
- При запуске проверяется наличие действующего обработчика через метод get.callback.list;
- Если обработчик существует и запись в events совпадает с текущим workflow_id, робот просто ждёт событий;
- Если обработчик существует, но запись в events не совпадает, запись обновляется;
- Если обработчика нет, создаётся новый через метод add.callback.add.bitrix24.partner.portal;
- При получении события создания портала от партнерского API робот возвращает данные о новом портале;
- Активити (робот) работает через систему callback от внешнего ресурса, а не через события Битрикс24;
- Поддерживается опция принудительного удаления существующих обработчиков перед созданием нового.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Идентификатор партнера	В данном поле указывается идентификатор партнера в партнерском кабинете Битрикс24. Это обязательный параметр. Примеры: - 1092905 - числовой идентификатор партнера; - {=Variable:PARTNER_ID} - использовать идентификатор из переменной предыдущего активити (робота); - {=Document:ID} - использовать ID из документа (если ID документа совпадает с идентификатором партнера). Важно: Идентификатор партнера можно получить в партнерском кабинете Битрикс24. Убедитесь, что указанный идентификатор корректен.
Секретный ключ партнера	В данном поле указывается секретный ключ партнера, который был указан в партнерской карточке. Это обязательный параметр. Используется для формирования подписи запросов к партнерскому API. Примеры: - 1234567 - секретный ключ партнера; - {=Variable:PARTNER_CORE} - использовать ключ из переменной предыдущего активити (робота). Важно: Секретный ключ партнера должен совпадать с ключом, указанным в партнерской карточке. Ключ используется для авторизации запросов к партнерскому API.
Удалить обработчик	В данном поле указывается, нужно ли удалять существующие обработчики перед созданием нового. Это необязательный параметр типа булево (да/нет). Варианты выбора: - Нет (false) - не удалять существующие обработчики, использовать существующий если он есть; - Да (true) - удалять все существующие обработчики перед созданием нового. Примеры использования: - Нет - использовать существующий обработчик если он есть, создавать новый только если его нет; - Да - всегда удалять существующие обработчики и создавать новый при каждом запуске робота. Когда использовать: - Для принудительного обновления обработчика при каждом запуске; - Для очистки старых обработчиков перед созданием нового; - Для обеспечения единственности обработчика на портал.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Примеры использования активити (робота)

Описание примера	Решение
Отслеживание создания порталов для конкретного партнера	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Активити (робот) подпишется на события создания порталов и будет ожидать callback от партнерского API.
Принудительное обновление обработчика при каждом запуске	Параметры: Идентификатор партнера - {=Variable:PARTNER_ID}, Секретный ключ партнера - {=Variable:PARTNER_CORE}, Удалить обработчик - Да. Активити (робот) удалит все существующие обработчики и создаст новый при каждом запуске.
Использование параметров из переменных	Параметры: Идентификатор партнера - {=Variable:PARTNER_ID}, Секретный ключ партнера - {=Variable:PARTNER_CORE}, Удалить обработчик - Нет. Активити (робот) использует данные из переменных предыдущих активити (роботов) для настройки мониторинга.
Мониторинг создания порталов с автоматическим удалением обработчика	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Да. Активити (робот) удалит существующие обработчики, создаст новый и будет ожидать события создания порталов.
Использование существующего обработчика	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Если обработчик уже существует и запись в events совпадает с текущим workflow_id, активити (робот) просто будет ожидать событий без создания нового обработчика.
Обновление записи при несовпадении workflow_id	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Если обработчик существует, но запись в events не совпадает с текущим workflow_id, активити (робот) обновит запись в events для корректной работы.
Создание нового обработчика при отсутствии существующего	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Если обработчика нет в списке, активити (робот) создаст новый через метод add.callback.add.bitrix24.partner.portal.
Мониторинг создания порталов с использованием данных из документа	Параметры: Идентификатор партнера - {=Document:ID}, Секретный ключ партнера - {=Variable:PARTNER_CORE}, Удалить обработчик - Нет. Активити (робот) использует ID документа как идентификатор партнера и ключ из переменной.
Ожидание события создания портала	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. Активити (робот) настроит подписку и будет ожидать события создания портала от партнерского API. При получении события вернёт данные о новом портале.
Автоматическое удаление обработчика после получения события	Параметры: Идентификатор партнера - 1092905, Секретный ключ партнера - 1234567, Удалить обработчик - Нет. После получения события создания портала в файле partner_callback.php обработчик автоматически удаляется через метод delete.callback.add.bitrix24.partner.portal перед отправкой результата в бизнес-процесс, а запись из events также удаляется.

Возвращаемые параметры данного активити (робота):
- ID обработчика (callback_id) - числовой идентификатор обработчика callback, созданного для отслеживания создания порталов. Используется для идентификации обработчика в системе.
- Тип обработчика (callback_type) - тип события, на который подписан обработчик. Всегда равен "ADD_BITRIX24_PARTNER_PORTAL" для данного активити (робота).
- Адрес портала (b24_portal) - адрес портала Битрикс24, который был создан.
- Внешний код портала (portal_external_id) - внешний код портала (например CP_111111 или B24_33333), который был создан.
- Email контакта (contact_email) - email контакта, связанного с созданным порталом.
- Данные контакта (contact_name) - данные контакта, связанного с созданным порталом.
- Реферер (referrer) - информация о реферере, откуда пришёл клиент.
- Тариф (tariff) - тариф, выбранный при создании портала.
- all_conditions (math_search_results) - строка, указывающая результат выполнения активити (робота). Всегда равен "Y" при успешном получении события.

Примеры использования возвращаемых параметров:
- Использовать данные о новом портале для создания записи в CRM;
- Сохранить информацию о новом портале в переменные для дальнейшей обработки;
- Отправить уведомление о создании портала с использованием данных contact_email и contact_name;
- Использовать portal_external_id для идентификации портала в внешних системах;
- Использовать referrer для аналитики источников клиентов;
- Сохранить информацию о тарифе для дальнейшего анализа;
- Создать задачу или дело при создании портала с использованием данных о контакте;
- Использовать callback_id для логирования или отладки.

Важно о возвращаемых параметрах: Параметры возвращаются только при получении события создания портала от партнерского API. Если событие не получено в течение периода ожидания, активити (робот) завершится по таймауту. Всегда проверяйте наличие значения параметра math_search_results перед использованием возвращаемых данных в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешной настройки мониторинга обязательно должны быть заполнены следующие параметры:
- Идентификатор партнера;
- Секретный ключ партнера.

Работа с партнерским API:
Активити (робот) работает через партнерский API Битрикс24 (partners.1c-bitrix.ru), а не через стандартные события Битрикс24. Callback приходит напрямую от партнерского API на специальный endpoint partner_callback.php. События срабатывают асинхронно, поэтому бизнес-процесс может продолжить выполнение через некоторое время после настройки мониторинга.

Проверка существующего обработчика:
При запуске активити (робот) проверяет наличие действующего обработчика через метод get.callback.list. Если обработчик существует и запись в events совпадает с текущим workflow_id, робот просто ждёт событий без создания нового обработчика. Это позволяет избежать дублирования обработчиков.

Обновление записи в events:
Если обработчик существует, но запись в events не совпадает с текущим workflow_id, активити (робот) обновит запись в events для корректной работы. Это обеспечивает правильную привязку обработчика к текущему бизнес-процессу.

Автоматическое удаление обработчика:
После получения события создания портала в файле partner_callback.php обработчик автоматически удаляется через метод delete.callback.add.bitrix24.partner.portal перед отправкой результата в бизнес-процесс через bizproc.event.send, а запись из events также удаляется. Это предотвращает накопление неиспользуемых обработчиков.

Параметр "Удалить обработчик":
Если параметр "Удалить обработчик" установлен в "Да", активити (робот) удалит все существующие обработчики перед созданием нового.

Ограничение на количество обработчиков:
Партнерский API позволяет создать только один обработчик на портал. Если попытаться создать второй обработчик для того же портала, будет возвращена ошибка CALLBACK_ALREADY_EXISTS. Активити (робот) автоматически обрабатывает эту ситуацию и использует существующий обработчик или удаляет его перед созданием нового в зависимости от параметра "Удалить обработчик".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на работу с партнерским API. Рекомендуется использовать пользователя с правами администратора системы.

Удаление отслеживания:
При удалении активити (робота) автоматически удаляются подписки на события и записи в events, настроенные для данного активити (робота). Это предотвращает накопление неиспользуемых подписок на события.

Производительность:
Мониторинг создания порталов создаёт подписки на события через партнерский API, которые могут увеличить нагрузку на систему при большом количестве отслеживаемых порталов. Рекомендуется использовать мониторинг только для действительно необходимых случаев и удалять неиспользуемые активити (роботы) мониторинга.

Товары

Замена товара в товарной позиции

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

Сценарий работы активити бизнес-процесса

Тип сущности: позволяет выбрать из выпадающего списка тип сущности, в которой произойдет замена товара.

ID сущности: указывается идентификатор сущности в которой будет заменен товар.

Товар под замену:указывается ID товара, который будет заменен в сущности.

Товар на который надо заменить: указывается ID товара, который будет добавлен в сущность вместо товара, который там был до этого.

Активити просто заменит один товар на другой (который указан), при этом тип товаров, с которые заменяет активити не обязательно должен быть одинаковым.
Вы можете заменить обычный товар на товар тип "услуга".
При этом если в сущности было указано количество товара (в любых ед. измерения), то оно сбросится. 

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Товарные позиции;
- ID товаров (массив);
- Сообщение об ошибке;

Перенос товаров в другую сущность

Данное активити позволяет осуществить перенос и копирование товаров из одной сущности в другую, зная ID и тип сущности из и в которую необходимо осуществить перенос.

Сценарий работы бизнес-процесса

Тип сущности (из которой берутся товары):  выбор типа сущности из которой будет осуществлен перенос товаров.

Активити работает со следующими типами товаров: Лид, Сделка, Счет, Ком. предложение, Смарт-процесс.

ID сущности (из которой берутся товары): в данном поле указывается ID сущности из которой будет осуществлен перенос товаров.

Тип сущности (куда перемещаются товары): выбор типа сущности в которую будет осуществлен перенос товаров.

ID сущности (куда перемещаются товары): в данном поле указывается ID сущности в которую будет осуществлен перенос товаров.

Что делаем с существующими товарами: действие этой настройки относится к сущности, в которую происходит перенос товара. Данный пункт меню позволяет выбрать, оставить или удалить товар, который уже есть в сущности.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Добавление товаров к сущности

Данное активити позволяет добавлять товары в сущности:лид, сделка, счет, предложение.

Сценарий работы бизнес-процесса

Тип сущности: в данном поле указывается в какой тип сущности будет добавлен товар.

Если вы работаете с новыми счетами, то вы должны использовать роботы из категории "смарт процессы" и ID смарт процесса всегда будет "31", именно ID, а не идентификатор типа. Данный смарт-процесс присутствует на портале, но по умолчанию скрыт в компонентах. Перейти в него можно отредактировав ссылку в браузере.

Внимание! Режим работы с заказами больше не поддерживается в Битрикс24.

• Если вы уже работаете в режиме «Сделки + Заказы», то он продолжит работать без изменений.
• При переходе в «Сделки» вернуться в режим «Сделки + Заказы», не получится.
• Информация в данной статье применима к режиму «Сделки + Заказы».

Подробнее читайте в статье Как в магазине работать без заказов.

ID сущности: в данном пункте указывается ID  сущности, в которую будет добавлен товар.

Товары (ID##количество##ед. измерения##цена##название): в данный пункт добавляют товары из предустановленного списка.
Заполняется в таком порядке и через разделители "##" : ID##количество##ед. измерения##цена##название.

Указав название отличное от того, что в каталоге, товар в сущность будет добавлен с указанным в настройках активити названием.

Что делаем с существующими товарами: в данном пункте выбирается оставить товары, которые уже были в сущности или удалить.

ВАЖНО!
Данное активити не работает с типом поля "Деньги".
Так же данным активити нельзя добавлять более 3 одинаковых товаров в рамках одного БП.

Сообщение об ошибке: в данном пункте указывается надо выводить сообщения об ошибке или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы бизнес-процесса

Возвращаемые параметры для данного активити:
Результат выполнения (good_operation): Y - удачно, N - ошибка.
Результат выполнения - текст (да/нет)

Редактирование количества и перенос товара между сущностями

Активити (робот) "Редактирование количества и перенос товара между сущностями" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Изменение количества товара в сделке, лиде, счёте, ком. предложении или смарт-процессе;
• Прибавление или вычитание количества от существующих товарных позиций;
• Добавление товаров из каталога в выбранную CRM сущность;
• Удаление товаров из сущности;
• Перенос товаров между разными сущностями (например, из лида в сделку);
• Удаление дублирующихся товарных позиций в целевой сущности;
• Копирование товаров из текущей сущности в целевую с изменением количества;
• Корректировка остатков товаров в смарт-процессах;
• Синхронизация товарных позиций между сделкой и счётом;
• Автоматизация учёта товаров при конвертации лида в сделку.

Сценарий работы активити (робота) бизнес-процесса

Как работает активити (робот):
- Активити (робот) выполняет операции с товарными позициями: добавить, удалить, вычесть количество, прибавить количество, удалить совпадения;
- Поддерживаются сущности: Лид, Сделка, Счёт, Ком. предложение, Смарт-процессы;
- При включённой опции "Взять товары из текущей сущности" операции выполняются между текущей сущностью (где запущен БП) и целевой сущностью;
- Формат товаров: ID или ID##количество##цена##название;
- Активити (робот) работает через REST API Битрикс24.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Операция	Обязательный параметр. Тип выполняемой операции. Доступные операции: - Добавить товар — добавление товара из каталога в сущность; - Удалить товар — удаление указанных товаров из сущности; - Вычесть количество — уменьшение количества существующего товара; - Прибавить количество — увеличение количества существующего товара; - Удалить совпадения — удаление из целевой сущности товаров, которые есть в текущей сущности.
Тип сущности	Обязательный параметр. Тип целевой сущности CRM. Поддерживаемые типы: Лид, Сделка, Счёт, Ком. предложение, Смарт-процесс (с выбором конкретного процесса). Примеры: для сделки выбирается "Сделка", для смарт-процесса "Расчёт и смета" выбирается соответствующий пункт из списка.
ID элемента сущности	Обязательный параметр. ID целевой сущности, с товарами которой выполняется операция. Примеры: - {=Document:ID} — ID текущей сущности из документа; - 55 — конкретный ID сущности; - {=Variable:DEAL_ID} — ID из переменной.
Взять товары из текущей сущности	При значении "Да" товары берутся из сущности, в которой запущен бизнес-процесс, и операции выполняются с целевой сущностью. При "Нет" работа идёт только с целевой сущностью и списком товаров. Пример: БП запущен в смарт-процессе №55, целевая сущность — Счёт №100. При "Да" товары из смарт-процесса 55 переносятся/вычитаются в счёте 100.
Товары	Список товаров. Формат: ID товара или ID##количество##цена##название. Примеры: - 30047 — только ID товара (для удаления или при количестве 1); - 30047##5 — товар 30047, количество 5; - 30047##2##1500##Услуга — ID 30047, количество 2, цена 1500. Название "Услуга" не переименовывает товар в каталоге, а задаёт текст отображаемый в целевой сущности (в товарной позиции); - {=Variable:PRODUCTS_LIST} — список из переменной. При использовании переменной необходимо самостоятельно в рамках бизнес-процесса собрать все ID товаров, количества, цены и названия в переменную (множественное значение), а затем передать её в активити (робот). Несколько товаров: поле является массивом — каждый товар указывается отдельной строкой в списке значений. Для операций "Вычесть" и "Прибавить" количество в формате ID##N определяет, на сколько изменить.

Примеры использования активити (робота)

Описание	Решение
Добавить товар 30047 в текущую сделку, количество 3	Операция: Добавить товар. Тип сущности: Сделка. ID: {=Document:ID}. Товары: 30047##3
Вычесть 2 шт товара 30047 из текущего лида	Операция: Вычесть количество. Тип сущности: Лид. ID: {=Document:ID}. Товары: 30047##2
Прибавить 5 шт к товару 30047 в счёте	Операция: Прибавить количество. Тип сущности: Счёт. ID: {=Variable:INVOICE_ID}. Товары: 30047##5
Удалить товар 30047 из сделки	Операция: Удалить товар. Тип сущности: Сделка. ID: {=Variable:DEAL_ID}. Товары: 30047
Перенести товары из текущего смарт-процесса в сделку (прибавить)	Операция: Прибавить количество. Тип сущности: Сделка. ID: {=Variable:TARGET_DEAL_ID}. Взять товары из текущей сущности: Да
Удалить из целевой сущности товары, которые есть в текущей	Операция: Удалить совпадения. Тип сущности и ID целевой сущности. Взять товары из текущей сущности: Да
Вычесть 1 шт из товара в текущем смарт-процессе	Операция: Вычесть количество. Тип сущности: Смарт-процесс (текущий). ID: {=Document:ID}. Товары: 30047##1. Взять из текущей: Да
Добавить несколько товаров в ком. предложение	Операция: Добавить товар. Тип: Ком. предложение. ID: {=Variable:QUOTE_ID}. Товары — два отдельных элемента: 30047##2 и 30048##1##2000 (каждый товар в своей строке)
Скопировать товары из лида в сделку при конвертации	Операция: Прибавить количество. Тип: Сделка. ID: {=Variable:NEW_DEAL_ID}. Взять из текущей: Да (БП в лиде)
Корректировка остатка в смарт-процессе "Расчёт и смета"	Операция: Вычесть количество. Тип: Смарт-процесс (Расчёт и смета). ID: {=Document:ID}. Товары: 30047##1

Возвращаемые параметры данного активити:
- Результат выполнения;
- Текст ошибки.

Важно: Пользователь, от имени которого запускается активити (робот), должен иметь права на изменение товаров в указанной сущности. При вычитании количество не может стать отрицательным — будет ошибка.
При операции "Взять товары из текущей сущности" и совпадении текущей и целевой сущности вычитание выполняется по указанному в списке товаров количеству.

Получение товаров из сущности заказ

Данное активити позволяет получить ID товаров из сущности "заказ"

Сценарий работы бизнес-процесса

ID заказа: в этом поле указывается ID заказа из которого планируется получить ID товаров.

Внимание! Режим работы с заказами больше не поддерживается в Битрикс24.

• Если вы уже работаете в режиме «Сделки + Заказы», то он продолжит работать без изменений.
• При переходе в «Сделки» вернуться в режим «Сделки + Заказы», не получится.
• Информация в данной статье применима к режиму «Сделки + Заказы».

Подробнее читайте в статье Как в магазине работать без заказов.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле нужно для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это нужно для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно нужно для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат поиска (Массив для итератора); - ID товаров+ количество (Массив для итератора);
- ID товаров+ сумма (Массив для итератора);
- ID товаров+ количество+ цена (Массив для итератора);
- Всего найдено (Массив для итератора);
- Результат поиска;
- ID товаров+ количество;
- ID товаров+ количество+ цена;
- ID товаров+ сумма;
- Соответствует условиям;
- Сообщение об ошибке.

Поиск Товара (v.2)

Данное активити позволяет осуществлять поиск товара согласно заданных параметров.
Результатом работы является получение ID товара в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Активити работает с товарами CRM, корректная работа с товарами каталога - НЕ ГАРАНТИРУЕТСЯ

Сценарий работы активити бизнес-процесса

Поле "Условие для…" : в данных полях указывается условия для соответствия для полей (равно/неравно, больше или равно, меньше или равно,больше/меньше).

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID:	В данном пункте указывается ID искомого товара.
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара
Валюта:	В данном пункте указывается валюта, указанная в товаре
Название:	В данном пункте указывается название товара
Описание:	В данном пункте указывается описание товара
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Раздел:	В данном пункте указывается ID раздела.
Ставка НДС:	В данном пункте указывается ставка НДС, указанная в товаре.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:<варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска для итератора;
- Результат поиска строка;
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Соответствует условиям;
- Сообщение об ошибке.

Получение товара из сущности

Активити (робот) "Получение товара из сущности" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение списка товарных позиций из сделки, лида, счёта или смарт-процесса;
• Формирование таблицы товаров для отправки в письме или сообщении;
• Анализ и обработка товаров в бизнес-процессе;
• Перенос товаров между сущностями CRM;
• Формирование отчётов по товарным позициям;
• Проверка наличия товаров в сущности перед выполнением действий;
• Получение ID товаров для дальнейшей обработки в итераторе.

Как работает активити (робот):
- Активити (робот) получает все товарные позиции из указанной сущности CRM;
- Результат можно вывести в виде таблицы (HTML или BBCode);
- Поддерживается настройка отображения количества, цены и суммы;
- Возвращается массив ID товаров для дальнейшей обработки в итераторе;
- Активити (робот) работает через REST API Битрикс24.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип Сущности	Обязательный параметр. Выбор типа сущности, товарные позиции которой будут получены. Поддерживаемые типы: Лид; Сделка; Счет; Ком. предложение; Смарт-процесс.
ID сущности	Обязательный параметр. ID сущности, из которой будут взяты товарные позиции. Примеры: - {=Document:ID} - ID текущей сущности из документа; - 123 - конкретный ID сущности; - {=Variable:DEAL_ID} - ID из переменной.
Тип Сущности (при выбранных смарт-процессах)	Этот параметр работает только если в поле "Тип сущности" выбрано "Смарт-процесс". Позволяет выбрать из списка конкретный смарт-процесс для получения товаров.
Способ вывода таблицы	Позволяет вывести результат в виде таблицы. Доступные способы: - HTML - для использования в письмах и документах; - BBCode - для использования в комментариях и сообщениях Битрикс24.
Включить количество в таблицу	Включение данных о количестве товара в выводимую таблицу. Варианты: да/нет.
Включить цену в таблицу	Включение данных о цене товара в выводимую таблицу. Варианты: да/нет.
Включить сумму в таблицу	Включение данных об общей сумме товара в выводимую таблицу. Варианты: да/нет.
Делать отладочные сообщения в журнал БП	Вывод отладочных данных в журнале бизнес-процесса. Варианты: да/нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для информирования пользователя в истории о том, что БП остановился на конкретном шаге.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для определения, нужно ли ожидать реакции от активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Данная опция позволяет ограничить срок ожидания ответа. Технические особенности платформы Битрикс24 иногда создают ситуацию с большой очередью запросов. Для того чтобы не останавливать дальнейшие действия, можно установить своё время ожидания.

Примеры использования:

№	Сценарий	Тип сущности	ID сущности	Способ вывода
1	Получить товары из текущей сделки	Сделка	{=Document:ID}	HTML
2	Получить товары из лида	Лид	{=Variable:LEAD_ID}	HTML
3	Получить товары из счёта	Счет	{=Variable:INVOICE_ID}	BBCode
4	Получить товары из ком. предложения	Ком. предложение	{=Variable:QUOTE_ID}	HTML
5	Получить товары из смарт-процесса	Смарт-процесс	{=Document:ID}	HTML
6	Сформировать таблицу для письма	Сделка	{=Document:ID}	HTML (с ценой и суммой)
7	Получить ID для итератора	Сделка	{=Document:ID}	-
8	Таблица для комментария	Сделка	{=Document:ID}	BBCode
9	Проверка наличия товаров	Лид	{=Document:ID}	-
10	Анализ товаров в другой сделке	Сделка	{=Variable:OTHER_DEAL_ID}	HTML

Возвращаемые параметры для данного активити:

• Товарные позиции (products_table) - таблица с товарами в выбранном формате (HTML или BBCode);
• ID товаров (массив) (product_ids_array) - массив ID товаров для использования в итераторе;
• Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

Важно:
- Если в возвращаемых параметрах с названием "ID товаров (массив)" есть нули, то позиция не является товаром, а является текстовым описанием;
- Такое является следствием ручного ввода товара, а не выбором его из списка;
- Пользователь, от имени которого запускается активити, должен иметь права на просмотр товаров в указанной сущности.

Удаление товара

Данное активити позволяет удалять товар из каталога, указав его ID.

Сценарий работы бизнес-процесса

 






















ID товара: в данном пункте указывается ID товара, который планируется удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
1 - успешное удаление.
0 - удалить товар не удалось.

Создание товара

Данное активити позволяет создать товар в CRM.

Сценарий работы бизнес-процесса

Название	Описание
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара
Валюта:	В данном пункте указывается валюта, указанная в товаре
Название:	В данном пункте указывается название товара
Описание:	В данном пункте указывается описание товара
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен:	Доступно значение: да/нет. В данном поле указывается доступность товара.
Раздел:	В данном пункте указывается ID раздела.
Сортировка:	В данном поле указывается индекс сортировки товара.
Ставка НДС:	В данном пункте указывается ставка НДС.
НДС включен в цену:	Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID нового товара.
- Сообщение об ошибке.

Редактирование товара

Данное активити позволяет изменять поля сущности "Товар".

Сценарий работы бизнес-процесса

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID:	В данном пункте указывается ID редактируемого товара.
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара.
Валюта:	В данном пункте указывается валюта расчетов, указанная в товаре
Название:	В данном пункте указывается название товара.
Описание:	В данном пункте указывается описание товара.
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен:	Доступно значение: да/нет. В данном поле указывается доступность товара.
Раздел:	В данном пункте указывается ID раздела.
Сортировка:	В данном поле указывается индекс сортировки товара.
Ставка НДС:	В данном пункте указывается ставка НДС, указанная в товаре.
НДС включён в цену:	Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Для работы с полем тип "Привязка к сотруднику" используйте числовое значение без доп. символов или букв.
Пример заполнения поля: 12345 , где 12345 - ID сотрудника.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Получение данных по сущности товар

Данное активити позволяет получить все данные по сущности "товар" в том числе и из пользовательских полей.

Сценарий работы активити бизнес-процесса

ID товара: в данном пункте указывается ID товара, данные которого необходимо получить.

Выводить версию для печати: поле с выпадающим списком из вариантов да/нет.
Позволяет указать, будут ли данные о товаре, выведены в обычном виде или в виде таблицы, подходящей для печати.

ВАЖНО!
Данное активити не работает с массивами.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Товар", включая данные пользовательских полей.

Получение параметров товаров из сущности

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

Сценарий работы активити бизнес-процесса

Тип Сущности: выбор типа сущности, товарные позиции которой будут отображены.

ID сущности: ID сущности, из которой будут взяты товарные позиции.

Условие отбора: в этом поле нужно указать параметры, которые вы хотите получить в результате работы активити.
Пример заполнения:  1#1, где 1 до решетки - номер товарной позиции, 1 после решетки - номер параметра товарной позиции.
Разделителем между параметрами является пробел.
Товарные позиции:

• 1- ID товара;
• 2- Название товара;
• 3 - Количество товара;
• 4 - Цена;
• 5 - Сумма;
• 6 - Налог;
• 7- Скидка.
  

 1#1 1#2 1#3 - вернет в доп. параметрах 2658 Tesla Model X 10 , где 2658- ID товара, Tesla Model - название товара, 10 - количество товара.

Мы получаем только те параметры товаров, которые вы видите во вкладке "Товары", выбранной Вами сущности.
Если вы указываете один параметр для получения каждого товара, то после заполнения параметра нужно добавлять пробел.

Делать отладочные сообщения в журнал БП: вывод отладочных данных в журнале бизнес-процесса.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

Возвращаемые параметры данного активити:
- Данные товара.
- Сообщение об ошибке.

Вычисление себестоимости товара каталога

Активити (робот) "Вычисление себестоимости товара каталога" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Расчёт себестоимости товара на основе данных документов прихода;
• Получение цены товара из последнего проведённого документа прихода;
• Расчёт средней себестоимости товара за определённый период;
• Автоматизация расчёта себестоимости при создании или обновлении товара;
• Использование себестоимости для расчёта прибыли и наценки;
• Обновление закупочной цены товара на основе данных документов;
• Анализ динамики изменения себестоимости товара;
• Автоматизация учёта себестоимости при работе с торговым каталогом;
• Расчёт себестоимости для отчётности и аналитики;
• Использование себестоимости в бизнес-процессах формирования цен.

Как работает активити (робот):
- Активити (робот) находит все документы, в которых фигурирует указанный товар;
- Поддерживается два типа расчёта: по последнему проведённому документу или за определённый период;
- При расчёте по последнему проведённому документу возвращается цена из самого последнего проведённого документа прихода;
- При расчёте за период суммируются цены из документов прихода за указанный период (1, 3, 6 или 12 месяцев);
- Активити (робот) работает через REST API Битрикс24 (catalog.document.element.list и catalog.document.list);
- Возвращается себестоимость товара для использования в дальнейших шагах бизнес-процесса.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID товара	В данном поле указывается идентификатор товара торгового каталога, для которого нужно рассчитать себестоимость. Это необязательный параметр. Примеры использования: - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - 123 - использовать ID товара 123; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Если товар не указан или товар не найден в документах, активити (робот) завершится с ошибкой. Убедитесь, что указанный товар существует и участвует в документах прихода.
Тип расчета	В данном поле указывается тип расчёта себестоимости товара. Это необязательный параметр. Варианты выбора: - Крайний проведенный документ (1) - использовать цену из последнего проведённого документа прихода; - За определённый период (2) - суммировать цены из документов прихода за указанный период. Примеры использования: - Крайний проведенный документ - получить актуальную себестоимость из последнего документа; - За определённый период - рассчитать среднюю себестоимость за период для анализа динамики цен.
Период	В данном поле указывается период времени для расчёта себестоимости. Это необязательный параметр. Используется только при выборе типа расчёта "За определённый период". Варианты выбора: - 1 месяц (1); - 3 месяца (3); - 6 месяцев (6); - 12 месяцев (12). Примеры использования: - 1 месяц - рассчитать себестоимость за последний месяц; - 3 месяца - рассчитать себестоимость за последний квартал; - 6 месяцев - рассчитать себестоимость за последнее полугодие; - 12 месяцев - рассчитать себестоимость за последний год.

Примеры использования активити (робота)

Описание примера	Решение
Расчёт себестоимости по последнему документу	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - Крайний проведенный документ. Активити (робот) вернёт себестоимость товара из последнего проведённого документа прихода в параметре price_product.
Расчёт себестоимости за последний месяц	Параметры: ID товара - {=Document:PRODUCT_ID}, Тип расчета - За определённый период, Период - 1 месяц. Активити (робот) вернёт суммарную себестоимость товара из документов прихода за последний месяц.
Расчёт себестоимости за квартал	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - За определённый период, Период - 3 месяца. Активити (робот) вернёт суммарную себестоимость товара из документов прихода за последний квартал.
Автоматическое обновление закупочной цены	Сначала используйте активити (робот) "Вычисление себестоимости товара каталога" с параметрами ID товара - {=Variable:PRODUCT_ID}, Тип расчета - Крайний проведенный документ, затем используйте активити (робот) "Обновить товар торгового каталога" с параметрами ID товара - {=Variable:PRODUCT_ID}, Закупочная цена - {=A1988_22222_92566_99999:price_product}.
Расчёт себестоимости для отчётности	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - За определённый период, Период - 6 месяцев. Активити (робот) вернёт суммарную себестоимость за полугодие, которую можно использовать для формирования отчётов.
Расчёт себестоимости при создании товара	После создания товара используйте активити (робот) "Вычисление себестоимости товара каталога" с параметрами ID товара - {=A1988_22222_92566_99999:id_new_product}, Тип расчета - Крайний проведенный документ для получения актуальной себестоимости.
Расчёт средней себестоимости за год	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип расчета - За определённый период, Период - 12 месяцев. Активити (робот) вернёт суммарную себестоимость товара из документов прихода за последний год.
Массовый расчёт себестоимости через итератор	Параметры: ID товара - {=Iterator:Value}, Тип расчета - Крайний проведенный документ. Активити (робот) вернёт себестоимость для каждого товара из итератора в параметре price_product.
Расчёт себестоимости для анализа прибыли	Используйте активити (робот) "Вычисление себестоимости товара каталога" для получения себестоимости, затем используйте формулу для расчёта прибыли: ={{={=Variable:SELLING_PRICE} - {=A1988_22222_92566_99999:price_product}}}}.
Расчёт себестоимости при изменении цены в сделке	Параметры: ID товара - {=Document:PRODUCT_ID}, Тип расчета - Крайний проведенный документ. Активити (робот) вернёт актуальную себестоимость товара, которую можно использовать для расчёта прибыли при изменении цены в сделке.

Возвращаемые параметры данного активити (робота):
- Себестоимость товара (price_product) - строковое значение себестоимости товара, рассчитанной на основе данных документов;
- Готовность операции (ok_ready) - логическое значение (true/false), указывающее, была ли операция успешной.

Значения параметра price_product:
- При типе расчёта "Крайний проведенный документ" - цена из последнего проведённого документа прихода;
- При типе расчёта "За определённый период" - сумма цен из документов прихода за указанный период;
- Пустая строка или 0 - если документы не найдены или товар не участвует в документах.

Примеры использования возвращаемого параметра:
- Использовать price_product для обновления закупочной цены товара;
- Использовать price_product для расчёта прибыли и наценки;
- Использовать price_product в условиях бизнес-процесса для проверки себестоимости;
- Использовать price_product для формирования отчётов и аналитики;
- Использовать price_product для автоматизации ценообразования;
- Использовать ok_ready для проверки успешности расчёта.

Важно о возвращаемых параметрах: Если документы не найдены, параметр price_product будет равен 0 или пустой строке, а ok_ready будет равен false. Всегда проверяйте значение возвращаемых параметров перед использованием в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Необязательные параметры:
Все параметры активити (робота) являются необязательными, но для успешного расчёта себестоимости рекомендуется указать ID товара.

Проверка существования товара в документах:
Активити (робот) проверяет наличие указанного товара в документах прихода. Если товар не найден в документах или документы отсутствуют, активити (робот) завершится с ошибкой "Не найдены документы в которых фигурирует указанный Вами продукт".

Типы документов:
Активити (робот) работает только с документами прихода (тип документа 'A'). Документы других типов не учитываются при расчёте себестоимости.

Ограничение количества документов:
При расчёте учитываются только последние 50 документов, в которых фигурирует товар. Для более точного расчёта рекомендуется регулярно обновлять данные документов.

Расчёт за период:
При выборе типа расчёта "За определённый период" учитываются только проведённые документы прихода за указанный период времени. Непроведённые документы не учитываются.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр документов каталога. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом расчёте себестоимости через итератор рекомендуется ограничивать количество обрабатываемых товаров. Для массового расчёта используйте модуль "Массовый запуск Бизнес-процессов".

Часовые пояса в активити

Параметры дат и часовые пояса в активити.

Когда вы заполняете поля с датами, нужно учитывать, что значение "Время сервера" не сохраняет часовой пояс для формул {-System:Now}. 
Это значение работает только со статическим значением даты и времени. На практике такой сценарий обычно не используется.  Дата и время рассчитываются динамически.

Для того чтобы сделать поддержку часовых пояса для формул, в том числе, чтобы не сбрасывалось значение при сохранении активити, необходимо перевести текущее время во время необходимого пользователя.

В переменной типа "Дата" и "Дата\Время" в БП сейчас уже имеется информация о смещении, поэтому там оно не нужно.

=toUserDate({=Document:ASSIGNED_BY_ID})  - эта формула используется для того, чтобы привести текущее значение даты и времени к времени пользователя.

=workdateadd({=System:Now}, "2h", {=Document:ASSIGNED_BY_ID}) - эта функция позволяет добавлять определенное время к текущему времени (согласно настройкам часового пояса на ПК пользователя), т.е если по МСК 12:00, то эта формула прибавит N-е количество часов, например 2 и получится 14:00.

Вариации товара

Добавить вариацию товара

Активити (робот) "Добавить вариацию товара" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое создание вариаций товара при добавлении нового товара в каталог;
• Создание вариаций товара с различными характеристиками (размер, цвет, артикул);
• Автоматизация создания вариаций товара на основе данных из сделок или других сущностей CRM;
• Массовое создание вариаций товара для товаров с множественными характеристиками;
• Создание вариаций товара при импорте данных из внешних систем;
• Автоматическое создание вариаций товара при изменении статуса сделки;
• Создание вариаций товара для товаров с различными ценами и валютой;
• Автоматизация создания вариаций товара при работе с торговым каталогом;
• Создание вариаций товара с указанием количества и резервирования;
• Автоматическое создание вариаций товара при синхронизации с внешними каталогами.

Как работает активити (робот):
- Активити (робот) создаёт новую вариацию товара в каталоге CRM с указанными параметрами;
- Вариация автоматически привязывается к указанному товару (parentId);
- Поддерживается указание всех основных характеристик вариации (наименование, код, размеры, вес, цены);
- Можно указать параметры активности, доступности, количества и резервирования;
- Поддерживается указание НДС и валюты закупочной цены;
- Активити (робот) возвращает ID созданной вариации для использования в дальнейших шагах бизнес-процесса;
- Поддерживается указание пользовательских свойств товара (property1635, property1637 и др.).

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID товара	В данном поле указывается числовой идентификатор (ID) товара, к которому будет привязана создаваемая вариация. Это обязательный параметр. Примеры использования: - 30287 - привязать вариацию к товару с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:product_id} - использовать ID товара из результата поиска; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID товара существует в каталоге. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается текстовое наименование создаваемой вариации товара. Это обязательный параметр. Примеры использования: - Тест вариации - простое наименование; - {=Document:TITLE} - размер {=Variable:SIZE} - использовать наименование из документа и переменной; - Вариация товара #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли вариация товара активна. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация будет активна и доступна для использования; - Нет (N) - вариация будет неактивна. Примеры использования: - Да - создать активную вариацию; - Нет - создать неактивную вариацию для последующей активации.
Доступность к покупке	В данном поле указывается, доступна ли вариация товара для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация доступна для покупки; - Нет (N) - вариация недоступна для покупки. Примеры использования: - Да - создать вариацию, доступную для покупки; - Нет - создать вариацию, которая временно недоступна для покупки.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - для товаров, где каждый экземпляр имеет свой уникальный штрихкод; - Нет - для товаров, где все экземпляры имеют одинаковый штрихкод.
Наличие набора	В данном поле указывается, является ли вариация товара набором. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация является набором; - Нет (N) - вариация не является набором. Примеры использования: - Да - для вариаций, которые представляют собой набор товаров; - Нет - для обычных вариаций товара.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка вариации товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - для товаров, которые можно заказать под заказ; - Нет - для товаров, которые можно купить только при наличии на складе.
Символьный код	В данном поле указывается символьный код вариации товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается детальное описание вариации товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание вариации товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания вариации товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - для простого текстового описания; - HTML - для описания с HTML-разметкой.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены вариации товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - для товаров с ценой в рублях; - USD - для товаров с ценой в долларах; - EUR - для товаров с ценой в евро.
Доступное количество	В данном поле указывается доступное количество вариации товара на складе. Это необязательный параметр. Примеры использования: - 1 - указать количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета вариации товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - для товаров, где требуется точный учет количества; - Выключен - для товаров, где количественный учет не требуется; - По умолчанию - использовать настройки товара.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для вариации товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - для подписок с ежемесячной оплатой; - Год - для подписок с годовой оплатой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену вариации товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - для товаров, где НДС уже включен в цену; - Нет - для товаров, где НДС добавляется к цене.

Примеры использования активити (робота)

Описание примера	Решение
Создание вариации товара при добавлении нового товара в каталог	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара {=Variable:PRODUCT_NAME}", Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Нет, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара с указанием размера и цвета	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Товар {=Document:TITLE} - Размер {=Variable:SIZE}, Цвет {=Variable:COLOR}", Активность - Да, Доступность к покупке - Да, Символьный код - ={{={=Variable:PRODUCT_CODE} & "_" & {=Variable:SIZE} & "_" & {=Variable:COLOR}}}}, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара для товара с подпиской	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Подписка на {=Variable:SERVICE_NAME}", Активность - Да, Доступность к покупке - Да, Разрешение подписки на товар - Да, Единица времени периода оплаты - Месяц, Длина периода оплаты - 1, НДС включен в цену - Да.
Создание вариации товара с указанием закупочной цены в валюте	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Вариация товара {=Document:TITLE}", Активность - Да, Доступность к покупке - Да, Валюта закупочной цены - USD, Закупочная цена - {=Variable:PURCHASE_PRICE}, НДС включен в цену - Нет.
Создание вариации товара с количественным учетом	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с учетом количества", Активность - Да, Доступность к покупке - Да, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}, Зарезервированное количество - {=Variable:RESERVED_QUANTITY}, НДС включен в цену - Да.
Создание вариации товара для товара под заказ	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Вариация товара {=Document:TITLE} под заказ", Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, НДС включен в цену - Да.
Создание вариации товара с детальным описанием в HTML	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с HTML описанием", Активность - Да, Доступность к покупке - Да, Детальное описание - {=Variable:HTML_DESCRIPTION}, Тип детального описания - HTML, НДС включен в цену - Да.
Создание вариации товара для набора товаров	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Набор товаров {=Document:TITLE}", Активность - Да, Доступность к покупке - Да, Наличие набора - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание вариации товара с уникальными штрихкодами	Параметры: ID товара - {=Variable:PRODUCT_ID}, Наименование - "Вариация товара с уникальными штрихкодами", Активность - Да, Доступность к покупке - Да, Уникальные штрихкоды для каждого экземпляра - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Массовое создание вариаций товара через итератор	Параметры: ID товара - {=Iterator:Value}, Наименование - "Вариация товара #{=Iterator:Value}", Активность - Да, Доступность к покупке - Да, Доступное количество - 1, НДС включен в цену - Да.

Возвращаемые параметры данного активити (робота):
- ID вариации товара (id_offer_product) - числовой идентификатор созданной вариации товара, который можно использовать для дальнейших операций в бизнес-процессе.

Примеры использования возвращаемого параметра:
- Передать ID в следующее активити (робот) для получения данных вариации;
- Использовать в условиях для проверки успешности создания вариации;
- Сохранить в переменную для использования в других шагах процесса;
- Создать связь между вариацией и другими сущностями CRM;
- Использовать ID для обновления данных вариации товара.

Важно о возвращаемых параметрах: Если создание вариации товара завершилось с ошибкой, параметр id_offer_product будет равен 0. Всегда проверяйте значение возвращаемого параметра перед использованием в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного создания вариации товара обязательно должны быть заполнены следующие параметры:
- ID товара (parentId);
- Наименование (name).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед созданием вариации. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Порядок параметров:
Параметры ID товара и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на создание вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству создаваемых вариаций:
При массовом создании вариаций через итератор рекомендуется не создавать более 100 вариаций за один запуск бизнес-процесса. Для массового создания используйте модуль "Массовый запуск Бизнес-процессов".

Удаление вариации товара

Активити (робот) "Удаление вариации товара" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Удаление вариаций товара по их ID;
• Удаление неактивных или устаревших вариаций товара;
• Удаление вариаций товара с нулевым количеством на складе;
• Массовое удаление вариаций товара, соответствующих определённым критериям;
• Очистка старых или неактуальных вариаций товара;
• Удаление вариаций товара после выполнения определённых условий в бизнес-процессе;
• Автоматическое удаление вариаций товара при изменении статуса сделки или товара;
• Удаление вариаций товара при интеграции с внешними системами;
• Очистка вариаций товара для оптимизации работы с каталогом;
• Удаление тестовых вариаций товара после завершения разработки.

Как работает активити (робот):
- Активити (робот) удаляет вариацию товара по указанному ID через REST API Битрикс24;
- Поддерживается удаление только одной вариации за один запуск активити (робота);
- Активити (робот) возвращает результат удаления (успешно или нет) для дальнейшего использования в бизнес-процессе;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.delete);
- Для массового удаления вариаций используйте итератор с активити (роботом) "Поиск вариаций товара".

Описание параметров активити (робота)

Название поля

Описание и примеры использования

ID вариации товара

В данном поле указывается идентификатор вариации товара, которую нужно удалить. Это обязательный параметр. Примеры использования: - {=Variable:OFFER_ID} - удалить вариацию с ID из переменной предыдущего активити (робота); - 123 - удалить вариацию с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата активити (робота) "Поиск вариаций товара"; - {=A1988_22222_92566_99999:id_offer_product} - использовать ID вариации из результата активити (робота) "Добавить вариацию товара"; - {=Document:OFFER_ID} - удалить вариацию, если ID вариации указан в документе; - {=Iterator:Value} - удалить вариацию для каждого ID из итератора. Как получить ID вариации: - Из результата активити (робота) "Добавить вариацию товара" (параметр id_offer_product); - Из результата активити (робота) "Поиск вариаций товара" (параметр search_results_array или search_result_first_string); - Из результата активити (робота) "Получить данные по вариации товара" (параметр id); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если вариация связана с документом. Важно: Удаление вариации товара является необратимой операцией. После удаления вариацию нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой.

Примеры использования активити (робота)

Описание примера	Решение
Удаление вариации товара по ID	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) удалит вариацию с указанным ID и вернёт результат удаления в параметре good_delete (true - успешно, false - ошибка).
Удаление вариации после её создания (откат)	Параметры: ID вариации товара - {=A1988_22222_92566_99999:id_offer_product}. Активити (робот) удалит только что созданную вариацию товара, если она была создана с ошибкой или не соответствует требованиям.
Удаление первой найденной вариации	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) удалит первую вариацию из результата поиска вариаций товара.
Удаление неактивной вариации товара	Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Активность - N для поиска неактивных вариаций, затем используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}.
Удаление вариации с нулевым количеством	Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Доступное количество - 0 для поиска вариаций с нулевым количеством, затем используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}.
Массовое удаление вариаций через итератор	Сначала используйте активити (робот) "Поиск вариаций товара" для получения списка ID вариаций в параметре search_results_array, затем используйте итератор с активити (роботом) "Удаление вариации товара" с параметром ID вариации товара - {=Iterator:Value}.
Удаление вариации при изменении статуса сделки	В условии бизнес-процесса проверьте статус сделки, и если статус соответствует определённому значению, используйте активити (робот) "Удаление вариации товара" с параметром ID вариации товара - {=Document:OFFER_ID}.
Удаление тестовых вариаций товара	Сначала используйте активити (робот) "Поиск вариаций товара" с параметром Наименование - "Тест" для поиска тестовых вариаций, затем используйте итератор с активити (роботом) "Удаление вариации товара" для удаления всех найденных тестовых вариаций.
Удаление вариации с проверкой результата	Параметры: ID вариации товара - {=Variable:OFFER_ID}. После выполнения активити (робота) проверьте возвращаемый параметр good_delete в условии бизнес-процесса. Если good_delete = true, вариация успешно удалена. Если good_delete = false, произошла ошибка при удалении.
Удаление вариации товара при интеграции с внешними системами	Параметры: ID вариации товара - {=Variable:EXTERNAL_OFFER_ID}. Активити (робот) удалит вариацию товара при синхронизации данных с внешней системой, если вариация была удалена во внешней системе.

Возвращаемые параметры данного активити (робота):
- Успешное удаление (good_delete) - логическое значение (true/false), указывающее, было ли удаление успешным.

Значения параметра good_delete:
- true - вариация товара успешно удалена;
- false - произошла ошибка при удалении вариации товара (вариация не существует, нет прав доступа и т.д.).

Примеры использования возвращаемого параметра:
- Использовать good_delete в условиях бизнес-процесса для проверки успешности удаления;
- Использовать good_delete для отправки уведомлений о результате удаления;
- Использовать good_delete для логирования результатов операции;
- Использовать good_delete для выполнения дополнительных действий при успешном удалении;
- Использовать good_delete для обработки ошибок при неудачном удалении.

Важно о возвращаемых параметрах: Если удаление завершилось с ошибкой, параметр good_delete будет равен false. Всегда проверяйте значение возвращаемого параметра перед выполнением дальнейших действий в бизнес-процессе. Удаление вариации товара является необратимой операцией.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного удаления вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации товара (id_offer).

Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед удалением. Если вариация с указанным ID не существует, активити (робот) вернёт good_delete = false.

Необратимость операции:
Удаление вариации товара является необратимой операцией. После удаления вариацию нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции.

Массовое удаление:
Для массового удаления вариаций используйте комбинацию активити (робота) "Поиск вариаций товара" и итератора с активити (роботом) "Удаление вариации товара".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на удаление вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству удаляемых вариаций:
При массовом удалении вариаций через итератор рекомендуется не удалять более 100 вариаций за один запуск бизнес-процесса. Для массового удаления используйте модуль "Массовый запуск Бизнес-процессов".

Проверка связанных данных:
Перед удалением вариации товара убедитесь, что она не используется в активных сделках, предложениях или заказах. Удаление вариации, используемой в активных документах, может привести к ошибкам в работе системы.

Получить данные по вариации товара

Активити (робот) "Получить данные по вариации товара" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Получение всех данных вариации товара по её ID для дальнейшей обработки;
• Извлечение конкретных полей вариации (наименование, код, размеры, вес, цены);
• Получение информации о количестве товара на складе;
• Получение данных о статусе активности и доступности вариации товара;
• Проверка параметров вариации товара перед выполнением операций;
• Извлечение данных вариации для использования в других активити (роботах);
• Получение информации о ценах и валюте вариации товара;
• Автоматизация обработки данных вариаций в бизнес-процессах;
• Получение данных вариации для аналитики и отчётности;
• Извлечение данных вариации для интеграции с внешними системами.

Как работает активити (робот):
- Активити (робот) получает все данные вариации товара по указанному ID через REST API Битрикс24;
- Возвращаются все доступные поля вариации (ID, наименование, код, размеры, вес, цены, количество, статусы и т.д.);
- Поддерживается получение информации о количестве товара на складе и резервировании;
- Возвращаются данные о статусе активности, доступности для покупки и других параметрах;
- Все поля вариации возвращаются в возвращаемых параметрах активити (робота);
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.get);
- Поддерживается обработка множественных ID вариаций (массивы для итератора).

Описание параметров активити (робота)

Название поля

Описание и примеры использования

ID вариации товара

В данном поле указывается идентификатор вариации товара, данные которой нужно получить. Это обязательный параметр. Если указан массив ID, будет обработан только первый элемент массива. Примеры использования: - {=Variable:OFFER_ID} - получить данные вариации с ID из переменной предыдущего активити (робота); - 123 - получить данные вариации с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска вариаций; - {=A1988_22222_92566_99999:id_offer_product} - использовать ID вариации из результата активити (робота) "Добавить вариацию товара"; - {=Document:OFFER_ID} - получить данные вариации, если ID вариации указан в документе; - {=Iterator:Value} - получить данные вариации для каждого ID из итератора. Как получить ID вариации: - Из результата активити (робота) "Добавить вариацию товара" (параметр id_offer_product); - Из результата активити (робота) "Поиск вариаций товара" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если вариация связана с документом. Важно: Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой "Результатов не найдено". Всегда проверяйте существование вариации перед получением данных.

Примеры использования активити (робота)

Описание примера	Решение
Получение всех данных вариации товара по ID	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт все доступные поля вариации: ID, наименование, код, размеры, вес, цены, количество, статусы и другие поля. Все данные будут доступны в возвращаемых параметрах активити (робота).
Получение данных вариации после её создания	Параметры: ID вариации товара - {=A1988_22222_92566_99999:id_offer_product}. Активити (робот) вернёт все данные только что созданной вариации товара для проверки корректности создания.
Получение данных первой найденной вариации	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) вернёт все данные первой вариации из результата поиска.
Проверка количества товара на складе	Параметры: ID вариации товара - {=Document:OFFER_ID}. Активити (робот) вернёт данные вариации, включая доступное количество в возвращаемом параметре quantity, которое можно использовать в условиях бизнес-процесса.
Проверка статуса активности вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт данные вариации, включая статус активности в возвращаемом параметре active, который можно использовать в условиях для проверки активности вариации.
Получение цены и валюты вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт данные вариации, включая закупочную цену в возвращаемом параметре purchasingPrice и валюту в возвращаемом параметре purchasingCurrency.
Получение данных вариации для обновления	Параметры: ID вариации товара - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) вернёт все данные вариации, которые можно использовать в активити (роботе) "Обновить вариацию товара" для частичного обновления полей.
Массовое получение данных вариаций через итератор	Параметры: ID вариации товара - {=Iterator:Value}. Активити (робот) вернёт данные вариации для каждого ID из итератора. Все данные будут доступны в возвращаемых параметрах для каждого элемента итератора.
Получение наименования и описания вариации	Параметры: ID вариации товара - {=Variable:OFFER_ID}. Активити (робот) вернёт наименование вариации в возвращаемом параметре name и описание в возвращаемом параметре detailText, которые можно использовать для формирования отчётов или уведомлений.
Проверка доступности вариации для покупки	Параметры: ID вариации товара - {=Document:OFFER_ID}. Активити (робот) вернёт данные вариации, включая статус доступности в возвращаемом параметре available, который можно использовать в условиях для проверки возможности покупки.

Возвращаемые параметры данного активити (робота):
Активити (робот) возвращает все доступные поля вариации товара в виде отдельных возвращаемых параметров. Список полей формируется автоматически на основе настроек каталога вашего портала.

Основные возвращаемые параметры (примеры):
- Наименование (name) - текстовое наименование вариации товара;
- Символьный код (code) - символьный код вариации товара;
- Активность (active) - статус активности вариации (Y/N);
- Доступность к покупке (available) - статус доступности для покупки (Y/N);
- Доступное количество (quantity) - количество товара на складе;
- Закупочная цена (purchasingPrice) - закупочная цена вариации;
- Валюта закупочной цены (purchasingCurrency) - валюта закупочной цены;
- НДС включен в цену (vatIncluded) - статус включения НДС в цену (Y/N);
- Детальное описание (detailText) - детальное описание вариации;
- И другие поля вариации товара в зависимости от настроек каталога.

Примеры использования возвращаемых параметров:
- Использовать параметр name для формирования названия в уведомлениях;
- Использовать параметр quantity для проверки наличия товара на складе;
- Использовать параметр active для проверки активности вариации в условиях;
- Использовать параметр purchasingPrice для расчётов в бизнес-процессе;
- Использовать все параметры для передачи в активити (робот) "Обновить вариацию товара";
- Использовать параметры для формирования отчётов и аналитики.

Важно о возвращаемых параметрах: Если вариация с указанным ID не найдена, активити (робот) завершится с ошибкой "Результатов не найдено". Всегда проверяйте существование вариации перед использованием возвращаемых параметров в дальнейших шагах бизнес-процесса. Список возвращаемых параметров может отличаться в зависимости от настроек каталога вашего портала.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного получения данных вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации товара (id_offer).

Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед получением данных. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой "Результатов не найдено".

Обработка множественных ID:
Если в параметре указан массив ID вариаций, будет обработан только первый элемент массива. Для обработки множественных ID используйте итератор.

Список возвращаемых параметров:
Список возвращаемых параметров формируется автоматически на основе настроек каталога вашего портала и может отличаться в зависимости от конфигурации системы.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом получении данных вариаций через итератор рекомендуется ограничивать количество обрабатываемых элементов. Для массовой обработки используйте модуль "Массовый запуск Бизнес-процессов".

Поиск вариаций товара

Активити (робот) "Поиск вариаций товара" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск вариаций товара по ID главного товара;
• Поиск вариаций товара по различным характеристикам (наименование, код, размеры, вес);
• Фильтрация вариаций товара по параметрам активности и доступности;
• Поиск вариаций товара по количеству на складе;
• Поиск вариаций товара по ценам и валюте;
• Фильтрация вариаций товара по режиму количественного учета;
• Поиск вариаций товара с определенными свойствами (размер, цвет, артикул);
• Массовый поиск вариаций товара для обработки в итераторе;
• Поиск активных или неактивных вариаций товара;
• Автоматизация процессов на основе найденных вариаций товара.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей вариации товара из каталога CRM вашего портала;
- Для каждого поля (кроме недоступных для поиска) создаётся параметр, который можно использовать для фильтрации;
- Поддерживается поиск по ID главного товара (parentId) - необязательный параметр;
- Можно указать любые поля вариации товара для фильтрации результатов поиска;
- Поддерживается поиск по множественным критериям одновременно;
- Результаты возвращаются в виде массива ID вариаций, строки с ID через запятую, первого и последнего ID, количества найденных вариаций;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.offer.list);
- Поддерживается обработка больших объёмов данных (более 50 вариаций) через batch-запросы;
- Можно ограничить количество результатов поиска с помощью параметра "Ограничение количества результатов".

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID главного товара	В данном поле указывается числовой идентификатор (ID) главного товара, вариации которого нужно найти. Это необязательный параметр. Примеры использования: - 30287 - найти все вариации товара с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:product_id} - использовать ID товара из результата поиска; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Если указан ID главного товара, будут найдены только вариации, принадлежащие этому товару. Можно комбинировать с другими параметрами поиска для более точной фильтрации.
Наименование	В данном поле указывается наименование вариации товара для поиска. Это необязательный параметр. Примеры использования: - Тест вариации - найти вариации с точным наименованием; - {=Variable:VARIANT_NAME} - использовать наименование из переменной; - Можно использовать операторы поиска для частичного совпадения (зависит от настроек поиска).
Активность	В данном поле указывается статус активности вариации товара для поиска. Это необязательный параметр. Примеры использования: - Y - найти только активные вариации; - N - найти только неактивные вариации; - {=Variable:ACTIVE_STATUS} - использовать статус из переменной.
Доступность к покупке	В данном поле указывается статус доступности вариации товара для покупки. Это необязательный параметр. Примеры использования: - Y - найти только доступные для покупки вариации; - N - найти только недоступные для покупки вариации.
Доступное количество	В данном поле указывается количество товара на складе для поиска. Это необязательный параметр. Примеры использования: - 0 - найти вариации с нулевым количеством; - {=Variable:QUANTITY} - найти вариации с указанным количеством; - Можно использовать операторы сравнения (>, <, >=, <=) для поиска по диапазону.
Ограничение количества результатов	В данном поле указывается максимальное количество результатов поиска, которые нужно вернуть. Это необязательный параметр. Примеры использования: - 10 - вернуть только первые 10 результатов; - 50 - вернуть только первые 50 результатов; - {=Variable:LIMIT} - использовать ограничение из переменной. Важно: Если параметр не указан, будут возвращены все найденные результаты. Рекомендуется использовать ограничение при больших объёмах данных для оптимизации производительности.

Примеры использования активити (робота)

Описание примера	Решение
Поиск всех вариаций товара по ID главного товара	Параметры: ID главного товара - {=Document:PRODUCT_ID}. Активити (робот) вернёт массив ID всех вариаций указанного товара в параметре search_results_array.
Поиск активных вариаций товара с наличием на складе	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только активные и доступные вариации с наличием на складе.
Поиск вариаций товара по наименованию	Параметры: Наименование - {=Variable:VARIANT_NAME}. Активити (робот) вернёт все вариации с указанным наименованием в параметре search_results_array.
Поиск неактивных вариаций товара	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Активность - N. Активити (робот) вернёт все неактивные вариации указанного товара.
Поиск вариаций товара с нулевым количеством	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Доступное количество - 0. Активити (робот) вернёт все вариации с нулевым количеством на складе.
Поиск вариаций товара с ограничением результатов	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Ограничение количества результатов - 10. Активити (робот) вернёт только первые 10 найденных вариаций.
Поиск вариаций товара для массовой обработки	Параметры: ID главного товара - {=Iterator:Value}, Активность - Y. Активити (робот) вернёт активные вариации для каждого товара из итератора в параметре search_results_array.
Поиск доступных для покупки вариаций товара	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только вариации, доступные для покупки и имеющие товар на складе.
Поиск вариаций товара по нескольким критериям	Параметры: ID главного товара - {=Document:PRODUCT_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >5. Активити (робот) вернёт активные и доступные вариации с количеством больше 5.
Поиск первой вариации товара	Параметры: ID главного товара - {=Variable:PRODUCT_ID}, Ограничение количества результатов - 1. Активити (робот) вернёт первую найденную вариацию в параметре search_result_first_string.

Возвращаемые параметры данного активити (робота):
- Условия поиска выполнены (math_search_results) - строка, указывающая, выполнены ли условия поиска ("Y" - да, "N" - нет);
- Количество найденных результатов (count_search) - числовое значение количества найденных вариаций товара;
- Массив ID найденных вариаций (search_results_array) - массив числовых идентификаторов найденных вариаций товара (множественное значение);
- Строка с ID найденных вариаций (search_results_string) - строка с идентификаторами найденных вариаций, разделёнными запятой;
- Первый ID из результатов (search_result_first_string) - строковое значение первого идентификатора из найденных вариаций;
- Последний ID из результатов (search_result_last_string) - строковое значение последнего идентификатора из найденных вариаций;
- Лог ошибок (s_error_logs) - строка с информацией о результатах поиска для отладки.

Примеры использования возвращаемых параметров:
- Использовать search_results_array для итератора при массовой обработке вариаций;
- Использовать search_result_first_string для получения первой найденной вариации;
- Использовать count_search для проверки количества найденных результатов;
- Использовать search_results_string для передачи списка ID в другие активити (роботы);
- Использовать math_search_results для проверки успешности поиска в условиях бизнес-процесса.

Важно о возвращаемых параметрах: Если вариации не найдены, параметр math_search_results будет равен "N", а count_search будет равен 0. Всегда проверяйте значение math_search_results перед использованием результатов поиска в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного выполнения поиска необходимо указать хотя бы один параметр поиска. Если не указан ни один параметр, активити (робот) завершится с ошибкой "Не указаны параметры поиска".

Проверка существования вариаций:
Активити (робот) проверяет существование вариаций по указанным критериям. Если вариации не найдены, активити (робот) вернёт math_search_results = "N" и count_search = 0.

Обработка больших объёмов данных:
При поиске большого количества вариаций (более 50) активити (робот) автоматически обрабатывает результаты через batch-запросы для оптимизации производительности.

Ограничение количества результатов:
Рекомендуется использовать параметр "Ограничение количества результатов" при больших объёмах данных для оптимизации производительности и уменьшения времени выполнения активити (робота).

Порядок параметров:
Параметр ID главного товара всегда отображается первым в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом поиске вариаций через итератор рекомендуется ограничивать количество результатов поиска для каждого товара. Для массового поиска используйте модуль "Массовый запуск Бизнес-процессов".

Изменить вариацию товара

Активити (робот) "Обновить вариацию товара" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое обновление параметров вариации товара при изменении данных в сделке;
• Обновление количества товара на складе при поступлении или продаже;
• Изменение статуса активности вариации товара в зависимости от условий бизнес-процесса;
• Обновление цен и валюты вариации товара при изменении курса валют;
• Автоматическое обновление характеристик вариации товара при изменении данных в других сущностях CRM;
• Изменение доступности вариации товара для покупки в зависимости от наличия на складе;
• Обновление описания и свойств вариации товара при синхронизации с внешними системами;
• Массовое обновление вариаций товара через итератор;
• Изменение режима количественного учета вариации товара;
• Обновление параметров подписки для вариации товара с периодической оплатой.

Как работает активити (робот):
- Активити (робот) обновляет существующую вариацию товара в каталоге CRM с указанными параметрами;
- Для обновления необходимо указать ID вариации товара (обязательный параметр);
- Можно обновить любые параметры вариации (наименование, код, размеры, вес, цены);
- Поддерживается обновление параметров активности, доступности, количества и резервирования;
- Можно изменить НДС и валюту закупочной цены;
- Обновляются только те поля, которые указаны в параметрах активити (робота);
- Поддерживается обновление пользовательских свойств товара (property1635, property1637 и др.).

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID вариации	В данном поле указывается числовой идентификатор (ID) вариации товара, которую необходимо обновить. Это обязательный параметр. Примеры использования: - 30287 - обновить вариацию с ID 30287; - {=Document:OFFER_ID} - использовать ID вариации из поля документа (сделки); - {=Variable:OFFER_ID} - использовать ID вариации из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:offer_id} - использовать ID вариации из результата поиска; - {=Iterator:Value} - использовать ID вариации для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID вариации существует в каталоге. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается новое текстовое наименование вариации товара. Это необязательный параметр. Примеры использования: - Тест вариации - простое наименование; - {=Document:TITLE} - размер {=Variable:SIZE} - использовать наименование из документа и переменной; - Вариация товара #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли вариация товара активна. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация будет активна и доступна для использования; - Нет (N) - вариация будет неактивна. Примеры использования: - Да - активировать вариацию; - Нет - деактивировать вариацию для временного скрытия из каталога.
Доступность к покупке	В данном поле указывается, доступна ли вариация товара для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация доступна для покупки; - Нет (N) - вариация недоступна для покупки. Примеры использования: - Да - сделать вариацию доступной для покупки; - Нет - временно запретить покупку вариации.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - включить использование уникальных штрихкодов; - Нет - отключить использование уникальных штрихкодов.
Наличие набора	В данном поле указывается, является ли вариация товара набором. Это необязательный параметр. Варианты выбора: - Да (Y) - вариация является набором; - Нет (N) - вариация не является набором. Примеры использования: - Да - преобразовать вариацию в набор; - Нет - преобразовать набор в обычную вариацию.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка вариации товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - разрешить покупку под заказ; - Нет - запретить покупку при отсутствии товара на складе.
Символьный код	В данном поле указывается новый символьный код вариации товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается новое детальное описание вариации товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание вариации товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания вариации товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - изменить тип описания на простой текст; - HTML - изменить тип описания на HTML-разметку.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены вариации товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - изменить валюту на рубли; - USD - изменить валюту на доллары; - EUR - изменить валюту на евро.
Доступное количество	В данном поле указывается новое доступное количество вариации товара на складе. Это необязательный параметр. Примеры использования: - 1 - установить количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета вариации товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - включить количественный учет; - Выключен - выключить количественный учет; - По умолчанию - использовать настройки товара.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для вариации товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - изменить период оплаты на ежемесячный; - Год - изменить период оплаты на годовой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену вариации товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - включить НДС в цену; - Нет - исключить НДС из цены.

Примеры использования активити (робота)

Описание примера	Решение
Обновление количества товара при поступлении на склад	Параметры: ID вариации - {=Document:OFFER_ID}, Доступное количество - ={{={=Variable:CURRENT_QUANTITY} + {=Variable:INCOMING_QUANTITY}}}}, Режим количественного учета - Включен.
Деактивация вариации товара при отсутствии на складе	Параметры: ID вариации - {=Variable:OFFER_ID}, Активность - Нет, Доступность к покупке - Нет, Доступное количество - 0.
Обновление цены и валюты вариации товара при изменении курса	Параметры: ID вариации - {=Document:OFFER_ID}, Валюта закупочной цены - USD, Закупочная цена - {=Variable:NEW_PRICE}, НДС включен в цену - Да.
Активация вариации товара при поступлении на склад	Параметры: ID вариации - {=Variable:OFFER_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - {=Variable:QUANTITY}, Разрешение покупки при отсутствии товара - Нет.
Обновление наименования и описания вариации товара	Параметры: ID вариации - {=Document:OFFER_ID}, Наименование - "Товар {=Document:TITLE} - Размер {=Variable:SIZE}", Детальное описание - {=Variable:DESCRIPTION}, Тип детального описания - HTML.
Изменение режима количественного учета вариации товара	Параметры: ID вариации - {=Variable:OFFER_ID}, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}.
Обновление параметров подписки для вариации товара	Параметры: ID вариации - {=Document:OFFER_ID}, Единица времени периода оплаты - Месяц, Разрешение подписки на товар - Да.
Массовое обновление вариаций товара через итератор	Параметры: ID вариации - {=Iterator:Value}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Обновление вариации товара при изменении статуса сделки	Параметры: ID вариации - {=Document:OFFER_ID}, Активность - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}, Доступность к покупке - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}.
Обновление вариации товара для товара под заказ	Параметры: ID вариации - {=Variable:OFFER_ID}, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, Доступность к покупке - Да.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного обновления вариации товара обязательно должен быть заполнен следующий параметр:
- ID вариации (id).

Проверка существования вариации:
Активити (робот) проверяет существование указанной вариации перед обновлением. Если вариация с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Обновление только указанных полей:
Активити (робот) обновляет только те поля, которые указаны в параметрах. Поля, которые не указаны, остаются без изменений.

Порядок параметров:
Параметры ID вариации и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на обновление вариаций товара в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству обновляемых вариаций:
При массовом обновлении вариаций через итератор рекомендуется не обновлять более 100 вариаций за один запуск бизнес-процесса. Для массового обновления используйте модуль "Массовый запуск Бизнес-процессов".

Установка и удаление активити на коробочном портале

Установка

1. Заходим в административный раздел, в папку "Контент".
2. Далее "файлы и папки" и переходим в раздел  bitrix/modules/
   
3. Распакуйте архив в папку bitrix/modules/ в корневом каталоге портала с помощью "загрузить".
   
4. Выбираем архив и загружаем.
   
5. Находим архив, нажимаем ПКМ (прав кн мыши) и распаковать (обязательно проверяем, чтобы адрес распаковки был bitrix/modules/)
   
6. После распаковки появится директория kosasrobots
   
7. Далее переходим в настройки/модули и находим модуль "Лаборатория роботов (kosasrobots)" и нажимаем "Установить".
8. После установки, переходите в конструктор БП и используете.
   

Удаление

1. В административном разделе переходим в настройки/модули и находим модуль "Лаборатория роботов (kosasrobots)" и нажимаем "Удалить".
   
2. Далее переходим в "файлы и папки", потом в раздел  bitrix/modules/
3. Находим папку kosasrobots и удаляем её.
4. Удаление завершено.

Торговый каталог

Каталог

Поиск торгового каталога

Активити (робот) "Поиск торгового каталога" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск торговых каталогов по идентификатору информационного блока;
• Поиск каталогов по типу информационного блока;
• Поиск каталогов по идентификатору каталога;
• Поиск каталогов по сайту (lid);
• Поиск каталогов по названию;
• Поиск каталогов по идентификатору родительского информационного блока товаров;
• Поиск каталогов по идентификатору свойства SKU;
• Фильтрация каталогов по параметрам продажи контента;
• Поиск каталогов по идентификатору НДС;
• Фильтрация каталогов по параметру экспорта в Яндекс.Маркет;
• Ограничение количества результатов поиска;
• Автоматизация процессов на основе найденных каталогов.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей торгового каталога из CRM вашего портала;
- Для каждого поля (кроме недоступных для поиска) создаётся параметр, который можно использовать для фильтрации;
- Поддерживается поиск по различным параметрам каталога (идентификатор блока, тип блока, название и т.д.);
- Можно указать ограничение на количество возвращаемых результатов;
- Результаты возвращаются в виде массива ID каталогов, строки с ID через запятую, первого и последнего ID, количества найденных каталогов;
- Активити (робот) работает через REST API Битрикс24 (catalog.catalog.list);
- Поддерживается обработка больших объёмов данных (более 50 каталогов) через batch-запросы.

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) анализирует указанные параметры поиска и находит торговые каталоги, удовлетворяющие заданным условиям. Для поиска можно использовать любые доступные поля каталога. Результатом будет массив ID найденных каталогов и дополнительная информация о результатах поиска.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Идентификатор информационного блока	В данном поле указывается идентификатор информационного блока для поиска каталогов. Это необязательный параметр типа "Число". Примеры: - 21 - найти каталоги с идентификатором информационного блока 21; - {=Variable:IBLOCK_ID} - использовать ID из переменной предыдущего активити (робота); - {=Document:IBLOCK_ID} - использовать ID из поля документа.
Тип информационного блока	В данном поле указывается тип информационного блока для поиска каталогов. Это необязательный параметр типа "Строка". Примеры: - CRM_PRODUCT_CATALOG - найти каталоги с типом "CRM_PRODUCT_CATALOG"; - {=Variable:IBLOCK_TYPE} - использовать тип из переменной предыдущего активити (робота).
Идентификатор каталога	В данном поле указывается идентификатор каталога для поиска. Это необязательный параметр типа "Число". Примеры: - 21 - найти каталог с идентификатором 21; - {=Variable:CATALOG_ID} - использовать ID из переменной предыдущего активити (робота).
Сайт	В данном поле указывается код сайта (lid) для поиска каталогов. Это необязательный параметр типа "Строка". Примеры: - s1 - найти каталоги для сайта s1; - {=Variable:SITE_ID} - использовать код сайта из переменной предыдущего активити (робота).
Название	В данном поле указывается название каталога для поиска. Это необязательный параметр типа "Строка". Примеры: - Товарный каталог CRM - найти каталоги с названием "Товарный каталог CRM"; - {=Variable:CATALOG_NAME} - использовать название из переменной предыдущего активити (робота).
Идентификатор родительского информационного блока товаров	В данном поле указывается идентификатор родительского информационного блока товаров. Это необязательный параметр типа "Число". Примеры: - 22 - найти каталоги с идентификатором родительского блока 22; - {=Variable:PARENT_IBLOCK_ID} - использовать ID из переменной предыдущего активити (робота).
Идентификатор свойства, в котором храниться ссылка на родительский элемент информационного блока Товаров	В данном поле указывается идентификатор свойства SKU. Это необязательный параметр типа "Число". Примеры: - 15 - найти каталоги с идентификатором свойства SKU 15; - {=Variable:SKU_PROPERTY_ID} - использовать ID из переменной предыдущего активити (робота).
Продажа контента	В данном поле указывается параметр продажи контента (Y/N). Это необязательный параметр типа "Да/Нет". Примеры: - Да (Y) - найти каталоги с включенной продажей контента; - Нет (N) - найти каталоги с отключенной продажей контента.
Идентификатор НДС	В данном поле указывается идентификатор НДС для поиска каталогов. Это необязательный параметр типа "Число". Примеры: - 5 - найти каталоги с идентификатором НДС 5; - {=Variable:VAT_ID} - использовать ID из переменной предыдущего активити (робота).
Экспортировать в Яндекс.Маркет	В данном поле указывается параметр экспорта в Яндекс.Маркет (Y/N). Это необязательный параметр типа "Да/Нет". Примеры: - Да (Y) - найти каталоги с включенным экспортом в Яндекс.Маркет; - Нет (N) - найти каталоги с отключенным экспортом в Яндекс.Маркет.
Ограничение количества результатов	В данном поле можно указать максимальное количество возвращаемых результатов поиска. Это необязательный параметр типа "Число". Если не указано, возвращаются все найденные каталоги. Примеры: - 10 - вернуть только первые 10 найденных каталогов; - 50 - вернуть только первые 50 найденных каталогов; - {=Variable:LIMIT} - использовать ограничение из переменной предыдущего активити (робота).

Важно: Для выполнения поиска необходимо указать хотя бы один параметр поиска. Если все параметры пусты, активити (робот) вернёт ошибку "Ни один параметр для поиска не был заполнен".

Возвращаемые параметры

После успешного выполнения поиска активити (робот) возвращает следующие параметры:

math_search_results - результат поиска (Y - найдены каталоги, N - каталоги не найдены);
count_search - количество найденных каталогов (число);
search_results_array - массив ID найденных каталогов (множественное поле типа "Число");
search_results_string - строка с ID найденных каталогов через запятую (например: "21,22,23");
search_result_first_string - ID первого найденного каталога (строка);
search_result_last_string - ID последнего найденного каталога (строка);
s_error_logs - сообщение об ошибке или информационное сообщение (строка).

Важно о возвращаемых параметрах: Если поиск не дал результатов, параметр math_search_results будет равен "N", а параметр s_error_logs будет содержать сообщение об ошибке "Каталоги не найдены". Массив search_results_array будет пустым.

Примеры использования активити

Описание примера	Решение
Найти каталог по идентификатору информационного блока 21	Идентификатор информационного блока — 21. Результат: search_results_array содержит [21], search_results_string = "21", search_result_first_string = "21", search_result_last_string = "21", count_search = 1.
Найти каталоги с типом "CRM_PRODUCT_CATALOG" и ограничить результат до 5 каталогов	Тип информационного блока — CRM_PRODUCT_CATALOG; Ограничение количества результатов — 5. Результат: search_results_array содержит массив ID (максимум 5 элементов), count_search показывает количество найденных каталогов.
Найти каталог по названию "Товарный каталог CRM"	Название — Товарный каталог CRM. Результат: search_results_array содержит ID найденного каталога, search_results_string содержит строку с ID.
Найти каталоги с включенным экспортом в Яндекс.Маркет	Экспортировать в Яндекс.Маркет — Да (Y). Результат: search_results_array содержит массив ID всех каталогов с включенным экспортом.
Найти каталоги по идентификатору НДС из переменной	Идентификатор НДС — {=Variable:VAT_ID}. Результат: search_results_array содержит ID каталогов с указанным НДС.
Найти каталоги для конкретного сайта с ограничением результатов	Сайт — s1; Ограничение количества результатов — 10. Результат: search_results_array содержит максимум 10 ID каталогов для сайта s1.
Найти каталоги по нескольким параметрам одновременно	Идентификатор информационного блока — 21; Тип информационного блока — CRM_PRODUCT_CATALOG; Название — Товарный каталог CRM. Результат: search_results_array содержит ID каталогов, удовлетворяющих всем условиям.
Найти каталоги с отключенной продажей контента	Продажа контента — Нет (N). Результат: search_results_array содержит ID всех каталогов с отключенной продажей контента.
Использовать результат поиска в итераторе для обработки каждого каталога	Идентификатор информационного блока — {=Variable:IBLOCK_ID}. Результат: search_results_array передаётся в итератор, который обрабатывает каждый найденный каталог. В итераторе используется {=Iterator:Value} для получения ID текущего каталога.
Найти первый каталог и использовать его ID в следующем активити	Идентификатор информационного блока — 21. Результат: search_result_first_string содержит ID первого найденного каталога, который можно использовать в следующем активити как {=A1988_22222_92566_99999:search_result_first_string}.

Пример возвращаемых данных

При успешном выполнении поиска активити (робот) возвращает данные в следующем формате:

Пример данных каталога:
"iblockId": "21"
"iblockTypeId": "CRM_PRODUCT_CATALOG"
"id": "21"
"lid": "s1"
"name": "Товарный каталог CRM"
"productIblockId": null
"skuPropertyId": null
"subscription": "N"
"vatId": "5"
"yandexExport": "N"

Возвращаемые параметры активити:
math_search_results = "Y"
count_search = 1
search_results_array = ["21"]
search_results_string = "21"
search_result_first_string = "21"
search_result_last_string = "21"
s_error_logs = "catalog_catalog_search_error_2: 1"

Примечание: Если найдено несколько каталогов, массив search_results_array будет содержать все ID найденных каталогов, а search_results_string будет содержать строку с ID через запятую (например: "21,22,23"). Параметр search_result_first_string содержит ID первого элемента массива, а search_result_last_string - ID последнего элемента массива.

Складской учет

Добавить документ складского учета

Активити (робот) "Добавить документ складского учета" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое создание документов складского учета при поступлении товаров на склад;
• Создание документов оприходования товаров при приемке;
• Автоматизация документооборота при перемещении товаров между складами;
• Создание документов возврата товаров от поставщиков;
• Автоматическое списание товаров со склада;
• Создание документов с автоматическим добавлением товарных позиций;
• Привязка документов к поставщикам (контактам или компаниям);
• Автоматическое проведение документов после создания;
• Интеграция складского учета с бизнес-процессами CRM;
• Массовое создание документов складского учета через бизнес-процессы.

Как работает активити (робот):
- Активити (робот) создаёт новый документ складского учета через API catalog.document.add;
- Поддерживается создание документов различных типов: приход, оприходование, перемещение, возврат, списание;
- После создания документа автоматически добавляются поставщики (контакт или компания), если они указаны;
- Поддерживается автоматическое добавление товаров к документу с указанием количества, цены и складов;
- При указании нескольких товаров используется batch-запрос для оптимизации производительности;
- Поддерживается автоматическое проведение документа после создания, если указан параметр "Провести документ";
- Активити (робот) возвращает ID созданного документа для использования в дальнейших шагах бизнес-процесса;
- Активити (робот) работает через REST API Битрикс24 (catalog.document.add, catalog.documentcontractor.add, catalog.document.element.add, catalog.document.conduct).

Сценарий работы активити (робота) бизнес-процесса

  Активити (робот) создаёт документ складского учета с указанными параметрами. После успешного создания документа автоматически добавляются поставщики (если указаны), затем товары (если указаны), и в конце документ проводится (если указан параметр "Провести документ"). Результатом работы является ID созданного документа, который можно использовать в последующих шагах бизнес-процесса.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип документа	В данном поле указывается тип создаваемого документа складского учета. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Приход товара на склад (A) - для документов поступления товаров на склад; - Оприходование товара (S) - для документов оприходования товаров; - Перемещение товара между складами (M) - для документов перемещения товаров; - Возврат товара (R) - для документов возврата товаров; - Списание товара (D) - для документов списания товаров. Примеры: - Приход товара на склад (A) - создать документ прихода товаров; - Перемещение товара между складами (M) - создать документ перемещения; - Списание товара (D) - создать документ списания товаров. Когда использовать: - Для документирования различных операций складского учета; - Для автоматизации процессов приёмки и отгрузки товаров; - Для учета перемещений товаров между складами.
Заголовок документа	В данном поле указывается заголовок создаваемого документа. Это необязательный параметр типа "Строка". Примеры: - Приход товара от поставщика №123; - Перемещение товаров со склада А на склад Б; - Списание товара {=Document:TITLE}; - Документ от {=System:NowLocal}; - ={{={=Variable:SUPPLIER_NAME} & " - Приход товара"}} - объединить переменную с текстом.
Номер документа	В данном поле указывается номер создаваемого документа. Это необязательный параметр типа "Строка". Примеры: - ПР-001; - ДОК-{=Document:ID}; - ={{=date('Ymd') & "-" & {=Variable:COUNTER}}}} - сгенерировать номер с датой и счётчиком; - {=Variable:DOC_NUMBER} - использовать номер из переменной предыдущего активити (робота).
Общая сумма товаров	В данном поле указывается общая сумма товаров в документе. Это необязательный параметр типа "Число". Примеры: - 150000 - указать сумму 150000; - {=Variable:TOTAL_AMOUNT} - использовать сумму из переменной предыдущего активити (робота); - ={{={=Variable:QUANTITY} * {=Variable:PRICE}}}} - рассчитать сумму из количества и цены.
Валюта	В данном поле указывается валюта документа. Это обязательный параметр. Выбирается из выпадающего списка доступных валют портала. Варианты выбора: - Рубль (RUB) - российский рубль; - Доллар (USD) - доллар США; - Евро (EUR) - евро; - Другие валюты, настроенные в вашем портале. Примеры: - Рубль (RUB) - использовать рубли; - Доллар (USD) - использовать доллары; - {=Variable:CURRENCY} - использовать валюту из переменной (если переменная содержит код валюты).
Комментарий	В данном поле указывается комментарий к документу. Это необязательный параметр типа "Строка". Примеры: - Документ создан автоматически; - Приход товара от поставщика {=Variable:SUPPLIER_NAME}; - ={{="Основание: " & {=Document:TITLE}}}} - добавить комментарий с информацией из документа.
Ответственный	В данном поле указывается ответственный за документ сотрудник. Это обязательный параметр типа "Пользователь". Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственного из текущего документа; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Важно: При выборе сотрудника, в поле должен быть указан только его ID без лишних символов (или в формате user_ID). Если пользователь не найден по указанному ID, документ не будет создан.
Поставщик (контакт)	В данном поле указывается идентификатор контакта-поставщика, который будет привязан к документу. Это необязательный параметр типа "Число". Важно: Необходимо выбирать контакты ТОЛЬКО из раздела "Клиенты > Поставщики". Обычные контакты из раздела CRM не подойдут. Если указан ID обычного контакта (не из раздела поставщиков), операция завершится с ошибкой. Примеры: - 123 - привязать контакт-поставщик с ID 123 из раздела "Клиенты > Поставщики"; - {=Variable:SUPPLIER_CONTACT_ID} - использовать ID контакта-поставщика из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать ID из результата поиска контактов-поставщиков. Когда использовать: - Для привязки документа к контакту-поставщику из раздела "Клиенты > Поставщики"; - Для автоматизации документооборота с поставщиками-контактами; - Если указан, контакт автоматически добавляется к документу после его создания.
Поставщик (компания)	В данном поле указывается идентификатор компании-поставщика, которая будет привязана к документу. Это необязательный параметр типа "Число". Важно: Необходимо выбирать компании ТОЛЬКО из раздела "Клиенты > Поставщики". Обычные компании из раздела CRM не подойдут. Если указан ID обычной компании (не из раздела поставщиков), операция завершится с ошибкой. Примеры: - 456 - привязать компанию-поставщик с ID 456 из раздела "Клиенты > Поставщики"; - {=Variable:SUPPLIER_COMPANY_ID} - использовать ID компании-поставщика из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать ID из результата поиска компаний-поставщиков. Когда использовать: - Для привязки документа к компании-поставщику из раздела "Клиенты > Поставщики"; - Для автоматизации документооборота с поставщиками-компаниями; - Если указана, компания автоматически добавляется к документу после его создания.
Товар	В данном поле указываются товары, которые будут добавлены к документу. Это необязательный параметр типа "Строка" с множественным значением. Каждый товар указывается в строгой последовательности через разделитель ## в формате: id товара##Количество##Цена##Склад источник##Склад получатель. Формат записи товара: - Первое значение (id товара) - идентификатор товара в каталоге (число); - Второе значение (Количество) - количество товара (число с плавающей точкой); - Третье значение (Цена) - цена за единицу товара (число с плавающей точкой); - Четвёртое значение (Склад источник) - идентификатор склада-источника (число); - Пятое значение (Склад получатель) - идентификатор склада-получателя (число). Примеры: - 312##15##1250.5##2##3 - добавить товар с ID 312, количеством 15, ценой 1250.5, со склада 2 на склад 3; - {=Variable:PRODUCT_ID}##{=Variable:QUANTITY}##{=Variable:PRICE}##1##2 - использовать значения из переменных; - 100##10##500##1##1 - добавить товар с ID 100, количеством 10, ценой 500, со склада 1 на склад 1 (для прихода); - Для добавления нескольких товаров укажите каждую строку отдельно в множественном поле. Важно: Формат записи товара должен строго соблюдаться. Все пять значений должны быть указаны через разделитель ##. Если формат не соблюдён (не указаны все 5 значений), активити (робот) завершится с ошибкой "Вы неправильно заполнили товар". Когда использовать: - Для автоматического добавления товаров к документу при его создании; - Для массового добавления товаров через множественное поле; - Для автоматизации заполнения документов товарными позициями.
Провести документ	В данном поле указывается, нужно ли автоматически провести документ после его создания. Это необязательный параметр типа "Да/Нет". Варианты выбора: - Да (Y) - провести документ автоматически после создания; - Нет (N) - оставить документ непроведённым. Примеры: - Да (Y) - автоматически провести документ после создания; - Нет (N) - создать документ без проведения (можно провести вручную позже). Когда использовать: - Для автоматического проведения документов при создании; - Для документов, которые не требуют дополнительной проверки перед проведением; - Если не указано, документ будет создан без проведения.

Важно: Для успешного создания документа необходимо указать обязательные параметры: "Тип документа", "Валюта" и "Ответственный". Если хотя бы один из обязательных параметров не указан, активити (робот) завершится с ошибкой.

Возвращаемые параметры

После успешного выполнения активити (робот) возвращает следующие параметры:

id_new_document - идентификатор созданного документа складского учета (число);
ok_ready - результат выполнения активити (робота) (Y - документ успешно создан, N - произошла ошибка).

Важно о возвращаемых параметрах: Если при создании документа произошла ошибка, параметр ok_ready будет равен "N", и активити (робот) завершится с сообщением об ошибке. Параметр id_new_document будет доступен только при успешном создании документа.

Примеры использования активити

Описание примера	Решение
Создать документ прихода товара на склад с указанием поставщика-контакта	Тип документа — Приход товара на склад (A); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Заголовок документа — Приход товара от поставщика; Поставщик (контакт) — {=Document:CONTACT_ID}. Результат: id_new_document содержит ID созданного документа, к которому привязан контакт-поставщик.
Создать документ перемещения товаров между складами с добавлением товаров	Тип документа — Перемещение товара между складами (M); Валюта — Рубль (RUB); Ответственный — {=Document:ASSIGNED_BY_ID}; Товар — 312##15##1250.5##2##3 (товар ID 312, количество 15, цена 1250.5, со склада 2 на склад 3). Результат: id_new_document содержит ID созданного документа с добавленным товаром.
Создать документ оприходования товара с автоматическим проведением	Тип документа — Оприходование товара (S); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — 100##10##500##1##1; Провести документ — Да (Y). Результат: id_new_document содержит ID созданного и проведённого документа.
Создать документ возврата товара с привязкой к компании-поставщику	Тип документа — Возврат товара (R); Валюта — Доллар (USD); Ответственный — {=Document:ASSIGNED_BY_ID}; Поставщик (компания) — {=Document:COMPANY_ID}; Заголовок документа — Возврат товара поставщику. Результат: id_new_document содержит ID созданного документа, к которому привязана компания-поставщик.
Создать документ списания товара с несколькими товарными позициями	Тип документа — Списание товара (D); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — 200##5##1000##1##0, 201##3##1500##1##0 (два товара: ID 200 и 201, со склада 1, получатель 0 для списания). Результат: id_new_document содержит ID созданного документа с двумя добавленными товарами через batch-запрос.
Создать документ прихода с использованием данных из переменных	Тип документа — Приход товара на склад (A); Валюта — {=Variable:CURRENCY}; Ответственный — {=Variable:RESPONSIBLE_ID}; Заголовок документа — {=Variable:DOC_TITLE}; Номер документа — {=Variable:DOC_NUMBER}; Общая сумма товаров — {=Variable:TOTAL_AMOUNT}. Результат: id_new_document содержит ID созданного документа с данными из переменных.
Создать документ перемещения с товаром из результата поиска	Тип документа — Перемещение товара между складами (M); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — {=A1988_22222_92566_99999:search_result_first_string}##10##500##1##2 (ID товара из результата поиска, количество 10, цена 500, со склада 1 на склад 2). Результат: id_new_document содержит ID созданного документа с товаром из поиска.
Создать документ прихода с товаром и автоматическим проведением	Тип документа — Приход товара на склад (A); Валюта — Рубль (RUB); Ответственный — {=Document:ASSIGNED_BY_ID}; Товар — 150##20##750##0##1 (товар ID 150, количество 20, цена 750, источник 0, получатель склад 1); Провести документ — Да (Y). Результат: id_new_document содержит ID созданного, заполненного товаром и проведённого документа.
Создать документ оприходования с комментарием из поля документа	Тип документа — Оприходование товара (S); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Комментарий — Оприходование товара по сделке {=Document:ID}. Результат: id_new_document содержит ID созданного документа с комментарием, содержащим ID сделки.
Создать документ списания с использованием ID документа в итераторе	Тип документа — Списание товара (D); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — {=Iterator:Value}##1##100##1##0 (ID товара из итератора, количество 1, цена 100, со склада 1, получатель 0). Результат: для каждого товара в итераторе создаётся документ списания с соответствующим товаром.

Пример возвращаемых данных

При успешном выполнении активити (робот) возвращает данные в следующем формате:

Пример данных при успешном создании документа:
id_new_document = 142
ok_ready = "Y"

Использование результата в следующем активити:
Для использования ID созданного документа в следующем активити (роботе) используйте:
{=A1988_22222_92566_99999:id_new_document}
где A1988_22222_92566_99999 - это код активити (робота) "Добавить документ складского учета".

Примечание: После создания документа автоматически выполняются следующие действия (если указаны соответствующие параметры): добавление поставщика (контакт или компания), добавление товаров, проведение документа. Все эти операции выполняются последовательно, и только после их успешного завершения активити (робот) возвращает результат.

Товар

Создание товара торгового каталога

Активити (робот) "Создание товара торгового каталога" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое создание товара в торговом каталоге при добавлении нового товара в систему;
• Создание товара с различными характеристиками (наименование, код, размеры, вес, цены);
• Автоматизация создания товара на основе данных из сделок или других сущностей CRM;
• Массовое создание товаров при импорте данных из внешних систем;
• Автоматическое создание товара при изменении статуса сделки;
• Создание товара для товаров с различными ценами и валютой;
• Автоматизация создания товара при работе с торговым каталогом;
• Создание товара с указанием количества и резервирования;
• Автоматическое создание товара при синхронизации с внешними каталогами;
• Создание товара с указанием раздела каталога для организации структуры товаров.

Как работает активити (робот):
- Активити (робот) создаёт новый товар в торговом каталоге CRM с указанными параметрами;
- Товар автоматически привязывается к указанному каталогу (iblockId);
- Можно указать раздел каталога (iblocksectionid) для организации структуры товаров;
- Поддерживается указание всех основных характеристик товара (наименование, код, размеры, вес, цены);
- Можно указать параметры активности, доступности, количества и резервирования;
- Поддерживается указание НДС и валюты закупочной цены;
- Активити (робот) возвращает ID созданного товара для использования в дальнейших шагах бизнес-процесса;
- Поддерживается указание пользовательских свойств товара (property1917, property1925 и др.).

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Наименование	В данном поле указывается текстовое наименование создаваемого товара. Это обязательный параметр. Примеры использования: - Новый товар - простое наименование; - {=Document:TITLE} - использовать наименование из документа (сделки); - Товар {=Variable:PRODUCT_NAME} - размер {=Variable:SIZE} - использовать наименование из переменной; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
ID каталога	В данном поле указывается каталог, в который будет добавлен товар. Это обязательный параметр. Выбирается из выпадающего списка доступных каталогов. Примеры использования: - Выбрать каталог из списка - выбрать нужный каталог из выпадающего списка; - {=Variable:CATALOG_ID} - использовать ID каталога из переменной предыдущего активити (робота); - {=Document:CATALOG_ID} - использовать ID каталога из поля документа. Важно: Убедитесь, что выбранный каталог существует в системе. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.
ID раздела каталога	В данном поле указывается числовой идентификатор (ID) раздела каталога, в который будет добавлен товар. Это необязательный параметр. Примеры использования: - 123 - добавить товар в раздел с ID 123; - {=Variable:SECTION_ID} - использовать ID раздела из переменной предыдущего активити (робота); - {=Document:SECTION_ID} - использовать ID раздела из поля документа; - {=A1988_22222_92566_99999:section_id} - использовать ID раздела из результата поиска. Важно: Если раздел не указан, товар будет добавлен в корневой раздел каталога. Убедитесь, что указанный раздел существует в выбранном каталоге.
Активность	В данном поле указывается, будет ли товар активен. Это необязательный параметр. Варианты выбора: - Да (Y) - товар будет активен и доступен для использования; - Нет (N) - товар будет неактивен. Примеры использования: - Да - создать активный товар; - Нет - создать неактивный товар для последующей активации.
Доступность к покупке	В данном поле указывается, доступен ли товар для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - товар доступен для покупки; - Нет (N) - товар недоступен для покупки. Примеры использования: - Да - создать товар, доступный для покупки; - Нет - создать товар, который временно недоступен для покупки.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - для товаров, где каждый экземпляр имеет свой уникальный штрихкод; - Нет - для товаров, где все экземпляры имеют одинаковый штрихкод.
Наличие набора	В данном поле указывается, является ли товар набором. Это необязательный параметр. Варианты выбора: - Да (Y) - товар является набором; - Нет (N) - товар не является набором. Примеры использования: - Да - для товаров, которые представляют собой набор товаров; - Нет - для обычных товаров.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - для товаров, которые можно заказать под заказ; - Нет - для товаров, которые можно купить только при наличии на складе.
Символьный код	В данном поле указывается символьный код товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается детальное описание товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - для простого текстового описания; - HTML - для описания с HTML-разметкой.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - для товаров с ценой в рублях; - USD - для товаров с ценой в долларах; - EUR - для товаров с ценой в евро.
Доступное количество	В данном поле указывается доступное количество товара на складе. Это необязательный параметр. Примеры использования: - 1 - указать количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - для товаров, где требуется точный учет количества; - Выключен - для товаров, где количественный учет не требуется; - По умолчанию - использовать настройки каталога.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - для подписок с ежемесячной оплатой; - Год - для подписок с годовой оплатой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - для товаров, где НДС уже включен в цену; - Нет - для товаров, где НДС добавляется к цене.

Примеры использования активити (робота)

Описание примера	Решение
Создание товара при добавлении нового товара в каталог	Параметры: Наименование - {=Variable:PRODUCT_NAME}, ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Нет, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание товара с указанием раздела каталога	Параметры: Наименование - "Товар {=Document:TITLE}", ID каталога - {=Variable:CATALOG_ID}, ID раздела каталога - {=Variable:SECTION_ID}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Создание товара для товара с подпиской	Параметры: Наименование - "Подписка на {=Variable:SERVICE_NAME}", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Разрешение подписки на товар - Да, Единица времени периода оплаты - Месяц, Длина периода оплаты - 1, НДС включен в цену - Да.
Создание товара с указанием закупочной цены в валюте	Параметры: Наименование - "Товар {=Document:TITLE}", ID каталога - {=Document:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Валюта закупочной цены - USD, Закупочная цена - {=Variable:PURCHASE_PRICE}, НДС включен в цену - Нет.
Создание товара с количественным учетом	Параметры: Наименование - "Товар с учетом количества", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}, Зарезервированное количество - {=Variable:RESERVED_QUANTITY}, НДС включен в цену - Да.
Создание товара для товара под заказ	Параметры: Наименование - "Товар {=Document:TITLE} под заказ", ID каталога - {=Document:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, НДС включен в цену - Да.
Создание товара с детальным описанием в HTML	Параметры: Наименование - "Товар с HTML описанием", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Детальное описание - {=Variable:HTML_DESCRIPTION}, Тип детального описания - HTML, НДС включен в цену - Да.
Создание товара для набора товаров	Параметры: Наименование - "Набор товаров {=Document:TITLE}", ID каталога - {=Document:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Наличие набора - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Создание товара с уникальными штрихкодами	Параметры: Наименование - "Товар с уникальными штрихкодами", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Уникальные штрихкоды для каждого экземпляра - Да, Доступное количество - {=Variable:QUANTITY}, НДС включен в цену - Да.
Массовое создание товаров через итератор	Параметры: Наименование - "Товар #{=Iterator:Value}", ID каталога - {=Variable:CATALOG_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - 1, НДС включен в цену - Да.

Возвращаемые параметры данного активити (робота):
- ID нового товара каталога (id_new_product) - числовой идентификатор созданного товара, который можно использовать для дальнейших операций в бизнес-процессе.
- Готовность операции (ok_ready) - логическое значение (true/false), указывающее, была ли операция успешной.

Примеры использования возвращаемого параметра:
- Передать ID в следующее активити (робот) для получения данных товара;
- Использовать в условиях для проверки успешности создания товара;
- Сохранить в переменную для использования в других шагах процесса;
- Создать связь между товаром и другими сущностями CRM;
- Использовать ID для создания вариаций товара;
- Использовать ID для обновления данных товара.

Важно о возвращаемых параметрах: Если создание товара завершилось с ошибкой, параметр id_new_product будет равен null, а ok_ready будет равен false. Всегда проверяйте значение возвращаемых параметров перед использованием в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного создания товара обязательно должны быть заполнены следующие параметры:
- Наименование (name);
- ID каталога (iblockId).

Проверка существования каталога:
Активити (робот) проверяет существование указанного каталога перед созданием товара. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Порядок параметров:
Параметры Наименование, ID каталога и ID раздела каталога всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на создание товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству создаваемых товаров:
При массовом создании товаров через итератор рекомендуется не создавать более 100 товаров за один запуск бизнес-процесса. Для массового создания используйте модуль "Массовый запуск Бизнес-процессов".

Удаление товара торгового каталога

Активити (робот) "Удаление товара торгового каталога" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Удаление товаров по их ID;
• Удаление неактивных или устаревших товаров;
• Удаление товаров с нулевым количеством на складе;
• Массовое удаление товаров, соответствующих определённым критериям;
• Очистка старых или неактуальных товаров;
• Удаление товаров после выполнения определённых условий в бизнес-процессе;
• Автоматическое удаление товаров при изменении статуса сделки;
• Удаление товаров при интеграции с внешними системами;
• Очистка товаров для оптимизации работы с каталогом;
• Удаление тестовых товаров после завершения разработки.

Как работает активити (робот):
- Активити (робот) удаляет товар по указанному ID через REST API Битрикс24;
- Поддерживается удаление только одного товара за один запуск активити (робота);
- Активити (робот) возвращает результат удаления (успешно или нет) для дальнейшего использования в бизнес-процессе;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.delete);
- Для массового удаления товаров используйте итератор с активити (роботом) "Поиск товара торгового каталога".

Описание параметров активити (робота)

Название поля

Описание и примеры использования

ID товара каталога

В данном поле указывается идентификатор товара торгового каталога, который нужно удалить. Это обязательный параметр. Примеры использования: - {=Variable:PRODUCT_ID} - удалить товар с ID из переменной предыдущего активити (робота); - 123 - удалить товар с ID 123; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата активити (робота) "Поиск товара торгового каталога"; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Document:PRODUCT_ID} - удалить товар, если ID товара указан в документе; - {=Iterator:Value} - удалить товар для каждого ID из итератора. Как получить ID товара: - Из результата активити (робота) "Создание товара торгового каталога" (параметр id_new_product); - Из результата активити (робота) "Поиск товара торгового каталога" (параметр search_results_array или search_result_first_string); - Из результата активити (робота) "Данные товара каталога" (параметр id); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если товар связан с документом. Важно: Удаление товара торгового каталога является необратимой операцией. После удаления товар нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Примеры использования активити (робота)

Описание примера	Решение
Удаление товара по ID	Параметры: ID товара каталога - {=Variable:PRODUCT_ID}. Активити (робот) удалит товар с указанным ID и вернёт результат удаления в параметре ok_ready (true - успешно, false - ошибка).
Удаление товара после его создания (откат)	Параметры: ID товара каталога - {=A1988_22222_92566_99999:id_new_product}. Активити (робот) удалит только что созданный товар торгового каталога, если он был создан с ошибкой или не соответствует требованиям.
Удаление первого найденного товара	Параметры: ID товара каталога - {=A1988_22222_92566_99999:search_result_first_string}. Активити (робот) удалит первый товар из результата поиска товаров торгового каталога.
Удаление неактивного товара	Сначала используйте активити (робот) "Поиск товара торгового каталога" с параметром Активность - N для поиска неактивных товаров, затем используйте активити (робот) "Удаление товара торгового каталога" с параметром ID товара каталога - {=A1988_22222_92566_99999:search_result_first_string}.
Удаление товара с нулевым количеством	Сначала используйте активити (робот) "Поиск товара торгового каталога" с параметром Доступное количество - 0 для поиска товаров с нулевым количеством, затем используйте активити (робот) "Удаление товара торгового каталога" с параметром ID товара каталога - {=A1988_22222_92566_99999:search_result_first_string}.
Массовое удаление товаров через итератор	Сначала используйте активити (робот) "Поиск товара торгового каталога" для получения списка ID товаров в параметре search_results_array, затем используйте итератор с активити (роботом) "Удаление товара торгового каталога" с параметром ID товара каталога - {=Iterator:Value}.
Удаление товара при изменении статуса сделки	В условии бизнес-процесса проверьте статус сделки, и если статус соответствует определённому значению, используйте активити (робот) "Удаление товара торгового каталога" с параметром ID товара каталога - {=Document:PRODUCT_ID}.
Удаление тестовых товаров	Сначала используйте активити (робот) "Поиск товара торгового каталога" с параметром Наименование - "Тест" для поиска тестовых товаров, затем используйте итератор с активити (роботом) "Удаление товара торгового каталога" для удаления всех найденных тестовых товаров.
Удаление товара с проверкой результата	Параметры: ID товара каталога - {=Variable:PRODUCT_ID}. После выполнения активити (робота) проверьте возвращаемый параметр ok_ready в условии бизнес-процесса. Если ok_ready = true, товар успешно удалён. Если ok_ready = false, произошла ошибка при удалении.
Удаление товара при интеграции с внешними системами	Параметры: ID товара каталога - {=Variable:EXTERNAL_PRODUCT_ID}. Активити (робот) удалит товар торгового каталога при синхронизации данных с внешней системой, если товар был удалён во внешней системе.

Возвращаемые параметры данного активити (робота):
- Успешное удаление (ok_ready) - логическое значение (true/false), указывающее, было ли удаление успешным.

Значения параметра ok_ready:
- true - товар торгового каталога успешно удалён;
- false - произошла ошибка при удалении товара торгового каталога (товар не существует, нет прав доступа и т.д.).

Примеры использования возвращаемого параметра:
- Использовать ok_ready в условиях бизнес-процесса для проверки успешности удаления;
- Использовать ok_ready для отправки уведомлений о результате удаления;
- Использовать ok_ready для логирования результатов операции;
- Использовать ok_ready для выполнения дополнительных действий при успешном удалении;
- Использовать ok_ready для обработки ошибок при неудачном удалении.

Важно о возвращаемых параметрах: Если удаление завершилось с ошибкой, параметр ok_ready будет равен false. Всегда проверяйте значение возвращаемого параметра перед выполнением дальнейших действий в бизнес-процессе. Удаление товара торгового каталога является необратимой операцией.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного удаления товара торгового каталога обязательно должен быть заполнен следующий параметр:
- ID товара каталога (id_product).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед удалением. Если товар с указанным ID не существует, активити (робот) вернёт ok_ready = false.

Необратимость операции:
Удаление товара торгового каталога является необратимой операцией. После удаления товар нельзя восстановить. Всегда проверяйте необходимость удаления перед выполнением операции.

Массовое удаление:
Для массового удаления товаров используйте комбинацию активити (робота) "Поиск товара торгового каталога" и итератора с активити (роботом) "Удаление товара торгового каталога".

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на удаление товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству удаляемых товаров:
При массовом удалении товаров через итератор рекомендуется не удалять более 100 товаров за один запуск бизнес-процесса. Для массового удаления используйте модуль "Массовый запуск Бизнес-процессов".

Проверка связанных данных:
Перед удалением товара торгового каталога убедитесь, что он не используется в активных сделках, предложениях или заказах. Удаление товара, используемого в активных документах, может привести к ошибкам в работе системы.

Данные товара каталога

Активити (робот) "Обновить товар торгового каталога" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое обновление параметров товара при изменении данных в сделке;
• Обновление количества товара на складе при поступлении или продаже;
• Изменение статуса активности товара в зависимости от условий бизнес-процесса;
• Обновление цен и валюты товара при изменении курса валют;
• Автоматическое обновление характеристик товара при изменении данных в других сущностях CRM;
• Изменение доступности товара для покупки в зависимости от наличия на складе;
• Обновление описания и свойств товара при синхронизации с внешними системами;
• Массовое обновление товаров через итератор;
• Изменение режима количественного учета товара;
• Обновление параметров подписки для товара с периодической оплатой.

Как работает активити (робот):
- Активити (робот) обновляет существующий товар в торговом каталоге CRM с указанными параметрами;
- Для обновления необходимо указать ID товара (обязательный параметр);
- Можно обновить любые параметры товара (наименование, код, размеры, вес, цены);
- Поддерживается обновление параметров активности, доступности, количества и резервирования;
- Можно изменить НДС и валюту закупочной цены;
- Обновляются только те поля, которые указаны в параметрах активити (робота);
- Поддерживается обновление пользовательских свойств товара (property1917, property1925 и др.).

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID товара	В данном поле указывается числовой идентификатор (ID) товара, который необходимо обновить. Это обязательный параметр. Примеры использования: - 30287 - обновить товар с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска товаров; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID товара существует в каталоге. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается новое текстовое наименование товара. Это необязательный параметр. Примеры использования: - Тест товара - простое наименование; - {=Document:TITLE} - использовать наименование из документа; - Товар #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли товар активен. Это необязательный параметр. Варианты выбора: - Да (Y) - товар будет активен и доступен для использования; - Нет (N) - товар будет неактивен. Примеры использования: - Да - активировать товар; - Нет - деактивировать товар для временного скрытия из каталога.
Доступность к покупке	В данном поле указывается, доступен ли товар для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - товар доступен для покупки; - Нет (N) - товар недоступен для покупки. Примеры использования: - Да - сделать товар доступным для покупки; - Нет - временно запретить покупку товара.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - включить использование уникальных штрихкодов; - Нет - отключить использование уникальных штрихкодов.
Наличие набора	В данном поле указывается, является ли товар набором. Это необязательный параметр. Варианты выбора: - Да (Y) - товар является набором; - Нет (N) - товар не является набором. Примеры использования: - Да - преобразовать товар в набор; - Нет - преобразовать набор в обычный товар.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - разрешить покупку под заказ; - Нет - запретить покупку при отсутствии товара на складе.
Символьный код	В данном поле указывается новый символьный код товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается новое детальное описание товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - изменить тип описания на простой текст; - HTML - изменить тип описания на HTML-разметку.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - изменить валюту на рубли; - USD - изменить валюту на доллары; - EUR - изменить валюту на евро.
Доступное количество	В данном поле указывается новое доступное количество товара на складе. Это необязательный параметр. Примеры использования: - 1 - установить количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - включить количественный учет; - Выключен - выключить количественный учет; - По умолчанию - использовать настройки каталога.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - изменить период оплаты на ежемесячный; - Год - изменить период оплаты на годовой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - включить НДС в цену; - Нет - исключить НДС из цены.

Примеры использования активити (робота)

Описание примера	Решение
Обновление количества товара при поступлении на склад	Параметры: ID товара - {=Document:PRODUCT_ID}, Доступное количество - ={{={=Variable:CURRENT_QUANTITY} + {=Variable:INCOMING_QUANTITY}}}}, Режим количественного учета - Включен.
Деактивация товара при отсутствии на складе	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Нет, Доступность к покупке - Нет, Доступное количество - 0.
Обновление цены и валюты товара при изменении курса	Параметры: ID товара - {=Document:PRODUCT_ID}, Валюта закупочной цены - USD, Закупочная цена - {=Variable:NEW_PRICE}, НДС включен в цену - Да.
Активация товара при поступлении на склад	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - {=Variable:QUANTITY}, Разрешение покупки при отсутствии товара - Нет.
Обновление наименования и описания товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Товар {=Document:TITLE}", Детальное описание - {=Variable:DESCRIPTION}, Тип детального описания - HTML.
Изменение режима количественного учета товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}.
Обновление параметров подписки для товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Единица времени периода оплаты - Месяц, Разрешение подписки на товар - Да.
Массовое обновление товаров через итератор	Параметры: ID товара - {=Iterator:Value}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Обновление товара при изменении статуса сделки	Параметры: ID товара - {=Document:PRODUCT_ID}, Активность - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}, Доступность к покупке - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}.
Обновление товара для товара под заказ	Параметры: ID товара - {=Variable:PRODUCT_ID}, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, Доступность к покупке - Да.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного обновления товара обязательно должен быть заполнен следующий параметр:
- ID товара (id_product).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед обновлением. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Обновление только указанных полей:
Активити (робот) обновляет только те поля, которые указаны в параметрах. Поля, которые не указаны, остаются без изменений.

Порядок параметров:
Параметры ID товара и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на обновление товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству обновляемых товаров:
При массовом обновлении товаров через итератор рекомендуется не обновлять более 100 товаров за один запуск бизнес-процесса. Для массового обновления используйте модуль "Массовый запуск Бизнес-процессов".

Поиск товара торгового каталога

Активити (робот) "Поиск товара торгового каталога" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Поиск товаров по ID каталога;
• Поиск товаров по различным характеристикам (наименование, код, размеры, вес);
• Фильтрация товаров по параметрам активности и доступности;
• Поиск товаров по количеству на складе;
• Поиск товаров по ценам и валюте;
• Фильтрация товаров по режиму количественного учета;
• Поиск товаров с определёнными свойствами (размер, цвет, артикул);
• Массовый поиск товаров для обработки в итераторе;
• Поиск активных или неактивных товаров;
• Автоматизация процессов на основе найденных товаров.

Как работает активити (робот):
- Активити (робот) автоматически получает список всех доступных полей товара из каталога CRM вашего портала;
- Для каждого поля (кроме недоступных для поиска) создаётся параметр, который можно использовать для фильтрации;
- Поддерживается поиск по ID каталога - обязательный параметр;
- Можно указать любые поля товара для фильтрации результатов поиска;
- Поддерживается поиск по множественным критериям одновременно;
- Результаты возвращаются в виде массива ID товаров, строки с ID через запятую, первого и последнего ID, количества найденных товаров;
- Активити (робот) работает через REST API Битрикс24 (catalog.product.list);
- Поддерживается обработка больших объёмов данных (более 50 товаров) через batch-запросы;
- Можно ограничить количество результатов поиска с помощью параметра "Ограничение количества результатов".

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Каталог	В данном поле указывается каталог товаров, в котором необходимо выполнить поиск. Это обязательный параметр. Выбирается из выпадающего списка доступных каталогов. Примеры использования: - Выбрать каталог из списка - выбрать нужный каталог из выпадающего списка; - {=Variable:CATALOG_ID} - использовать ID каталога из переменной предыдущего активити (робота); - {=Document:CATALOG_ID} - использовать ID каталога из поля документа. Важно: Убедитесь, что выбранный каталог существует в системе. Если каталог с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается наименование товара для поиска. Это необязательный параметр. Примеры использования: - Тест товара - найти товары с точным наименованием; - {=Variable:PRODUCT_NAME} - использовать наименование из переменной; - Можно использовать операторы поиска для частичного совпадения (зависит от настроек поиска).
Активность	В данном поле указывается статус активности товара для поиска. Это необязательный параметр. Примеры использования: - Y - найти только активные товары; - N - найти только неактивные товары; - {=Variable:ACTIVE_STATUS} - использовать статус из переменной.
Доступность к покупке	В данном поле указывается статус доступности товара для покупки. Это необязательный параметр. Примеры использования: - Y - найти только доступные для покупки товары; - N - найти только недоступные для покупки товары.
Доступное количество	В данном поле указывается количество товара на складе для поиска. Это необязательный параметр. Примеры использования: - 0 - найти товары с нулевым количеством; - {=Variable:QUANTITY} - найти товары с указанным количеством; - Можно использовать операторы сравнения (>, <, >=, <=) для поиска по диапазону.

Примеры использования активити (робота)

Описание примера	Решение
Поиск всех товаров в каталоге	Параметры: Каталог - {=Variable:CATALOG_ID}, Наименование - не указывать. Активити (робот) вернёт массив ID всех товаров указанного каталога в параметре search_results_array.
Поиск активных товаров с наличием на складе	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только активные и доступные товары с наличием на складе.
Поиск товаров по наименованию	Параметры: Каталог - {=Variable:CATALOG_ID}, Наименование - {=Variable:PRODUCT_NAME}. Активити (робот) вернёт все товары с указанным наименованием в параметре search_results_array.
Поиск неактивных товаров	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - N. Активити (робот) вернёт все неактивные товары указанного каталога.
Поиск товаров с нулевым количеством	Параметры: Каталог - {=Variable:CATALOG_ID}, Доступное количество - 0. Активити (робот) вернёт все товары с нулевым количеством на складе.
Поиск товаров с ограничением результатов	Параметры: Каталог - {=Variable:CATALOG_ID}, Ограничение количества результатов - 10. Активити (робот) вернёт только первые 10 найденных товаров.
Поиск товаров для массовой обработки	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y. Активити (робот) вернёт активные товары для каждого каталога из итератора в параметре search_results_array.
Поиск доступных для покупки товаров	Параметры: Каталог - {=Variable:CATALOG_ID}, Доступность к покупке - Y, Доступное количество - >0. Активити (робот) вернёт только товары, доступные для покупки и имеющие товар на складе.
Поиск товаров по нескольким критериям	Параметры: Каталог - {=Variable:CATALOG_ID}, Активность - Y, Доступность к покупке - Y, Доступное количество - >5. Активити (робот) вернёт активные и доступные товары с количеством больше 5.
Поиск первого товара	Параметры: Каталог - {=Variable:CATALOG_ID}, Ограничение количества результатов - 1. Активити (робот) вернёт первый найденный товар в параметре search_result_first_string.

Возвращаемые параметры данного активити (робота):
- Условия поиска выполнены (math_search_results) - строка, указывающая, выполнены ли условия поиска ("Y" - да, "N" - нет);
- Количество найденных результатов (count_search) - числовое значение количества найденных товаров;
- Массив ID найденных товаров (search_results_array) - массив числовых идентификаторов найденных товаров (множественное значение);
- Строка с ID найденных товаров (search_results_string) - строка с идентификаторами найденных товаров, разделёнными запятой;
- Первый ID из результатов (search_result_first_string) - строковое значение первого идентификатора из найденных товаров;
- Последний ID из результатов (search_result_last_string) - строковое значение последнего идентификатора из найденных товаров;
- Лог ошибок (s_error_logs) - строка с информацией о результатах поиска для отладки.

Примеры использования возвращаемых параметров:
- Использовать search_results_array для итератора при массовой обработке товаров;
- Использовать search_result_first_string для получения первого найденного товара;
- Использовать count_search для проверки количества найденных результатов;
- Использовать search_results_string для передачи списка ID в другие активити (роботы);
- Использовать math_search_results для проверки успешности поиска в условиях бизнес-процесса.

Важно о возвращаемых параметрах: Если товары не найдены, параметр math_search_results будет равен "N", а count_search будет равен 0. Всегда проверяйте значение math_search_results перед использованием результатов поиска в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного выполнения поиска необходимо указать хотя бы один параметр поиска кроме обязательного параметра "Каталог". Если не указан ни один дополнительный параметр поиска, активити (робот) завершится с ошибкой "Ни один параметр для поиска не был заполнен".

Проверка существования товаров:
Активити (робот) проверяет существование товаров по указанным критериям. Если товары не найдены, активити (робот) вернёт math_search_results = "N" и count_search = 0.

Обработка больших объёмов данных:
При поиске большого количества товаров (более 50) активити (робот) автоматически обрабатывает результаты через batch-запросы для оптимизации производительности.

Ограничение количества результатов:
Рекомендуется использовать параметр "Ограничение количества результатов" при больших объёмах данных для оптимизации производительности и уменьшения времени выполнения активити (робота).

Порядок параметров:
Параметр "Каталог" всегда отображается первым в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Производительность:
При массовом поиске товаров через итератор рекомендуется ограничивать количество результатов поиска. Для массового поиска используйте модуль "Массовый запуск Бизнес-процессов".

Изменение товара торгового каталога

Активити (робот) "Обновить товар торгового каталога" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое обновление параметров товара при изменении данных в сделке;
• Обновление количества товара на складе при поступлении или продаже;
• Изменение статуса активности товара в зависимости от условий бизнес-процесса;
• Обновление цен и валюты товара при изменении курса валют;
• Автоматическое обновление характеристик товара при изменении данных в других сущностях CRM;
• Изменение доступности товара для покупки в зависимости от наличия на складе;
• Обновление описания и свойств товара при синхронизации с внешними системами;
• Массовое обновление товаров через итератор;
• Изменение режима количественного учета товара;
• Обновление параметров подписки для товара с периодической оплатой.

Как работает активити (робот):
- Активити (робот) обновляет существующий товар в торговом каталоге CRM с указанными параметрами;
- Для обновления необходимо указать ID товара (обязательный параметр);
- Можно обновить любые параметры товара (наименование, код, размеры, вес, цены);
- Поддерживается обновление параметров активности, доступности, количества и резервирования;
- Можно изменить НДС и валюту закупочной цены;
- Обновляются только те поля, которые указаны в параметрах активити (робота);
- Поддерживается обновление пользовательских свойств товара (property1917, property1925 и др.).

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID товара	В данном поле указывается числовой идентификатор (ID) товара, который необходимо обновить. Это обязательный параметр. Примеры использования: - 30287 - обновить товар с ID 30287; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки); - {=Variable:PRODUCT_ID} - использовать ID товара из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска товаров; - {=A1988_22222_92566_99999:id_new_product} - использовать ID товара из результата активити (робота) "Создание товара торгового каталога"; - {=Iterator:Value} - использовать ID товара для каждого элемента в итераторе. Важно: Убедитесь, что указанный ID товара существует в каталоге. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.
Наименование	В данном поле указывается новое текстовое наименование товара. Это необязательный параметр. Примеры использования: - Тест товара - простое наименование; - {=Document:TITLE} - использовать наименование из документа; - Товар #{=Document:PRODUCT_ID} - {=Variable:COLOR} - комбинированное наименование; - ={{={=Variable:PRODUCT_NAME} & " - " & {=Variable:VARIANT_NAME}}}} - объединение значений из переменных.
Активность	В данном поле указывается, будет ли товар активен. Это необязательный параметр. Варианты выбора: - Да (Y) - товар будет активен и доступен для использования; - Нет (N) - товар будет неактивен. Примеры использования: - Да - активировать товар; - Нет - деактивировать товар для временного скрытия из каталога.
Доступность к покупке	В данном поле указывается, доступен ли товар для покупки. Это необязательный параметр. Варианты выбора: - Да (Y) - товар доступен для покупки; - Нет (N) - товар недоступен для покупки. Примеры использования: - Да - сделать товар доступным для покупки; - Нет - временно запретить покупку товара.
Уникальные штрихкоды для каждого экземпляра	В данном поле указывается, используются ли уникальные штрихкоды для каждого экземпляра товара. Это необязательный параметр. Варианты выбора: - Да (Y) - используются уникальные штрихкоды; - Нет (N) - не используются уникальные штрихкоды. Примеры использования: - Да - включить использование уникальных штрихкодов; - Нет - отключить использование уникальных штрихкодов.
Наличие набора	В данном поле указывается, является ли товар набором. Это необязательный параметр. Варианты выбора: - Да (Y) - товар является набором; - Нет (N) - товар не является набором. Примеры использования: - Да - преобразовать товар в набор; - Нет - преобразовать набор в обычный товар.
Разрешение покупки при отсутствии товара	В данном поле указывается, разрешена ли покупка товара при отсутствии товара на складе. Это необязательный параметр. Варианты выбора: - Да (Y) - покупка разрешена даже при отсутствии товара; - Нет (N) - покупка запрещена при отсутствии товара. Примеры использования: - Да - разрешить покупку под заказ; - Нет - запретить покупку при отсутствии товара на складе.
Символьный код	В данном поле указывается новый символьный код товара. Это необязательный параметр. Примеры использования: - Символьный код - простой код; - {=Variable:PRODUCT_CODE} - использовать код из переменной; - ={{={=Document:PRODUCT_CODE} & "_" & {=Variable:VARIANT_CODE}}}} - объединение кодов.
Детальное описание	В данном поле указывается новое детальное описание товара. Это необязательный параметр. Примеры использования: - Детальное описание - простое описание; - {=Variable:DESCRIPTION} - использовать описание из переменной; - Описание товара с характеристиками: размер {=Variable:SIZE}, цвет {=Variable:COLOR} - комбинированное описание.
Тип детального описания	В данном поле указывается тип детального описания товара. Это необязательный параметр. Варианты выбора: - Текст (text) - обычный текст; - HTML (html) - HTML-разметка. Примеры использования: - Текст - изменить тип описания на простой текст; - HTML - изменить тип описания на HTML-разметку.
Валюта закупочной цены	В данном поле указывается валюта закупочной цены товара. Это необязательный параметр. Варианты выбора: - Рубль (RUB); - Доллар США (USD); - Евро (EUR). Примеры использования: - RUB - изменить валюту на рубли; - USD - изменить валюту на доллары; - EUR - изменить валюту на евро.
Доступное количество	В данном поле указывается новое доступное количество товара на складе. Это необязательный параметр. Примеры использования: - 1 - установить количество 1; - {=Variable:QUANTITY} - использовать количество из переменной; - ={{=intval({=Document:QUANTITY})}} - преобразовать количество из документа в целое число.
Режим количественного учета	В данном поле указывается режим количественного учета товара. Это необязательный параметр. Варианты выбора: - Включен (Y) - количественный учет включен; - Выключен (N) - количественный учет выключен; - По умолчанию (D) - использовать настройки по умолчанию. Примеры использования: - Включен - включить количественный учет; - Выключен - выключить количественный учет; - По умолчанию - использовать настройки каталога.
Единица времени периода оплаты	В данном поле указывается единица времени периода оплаты для товара. Это необязательный параметр. Варианты выбора: - Час (H); - День (D); - Неделя (W); - Месяц (M); - Квартал (Q); - Полугодие (S); - Год (Y). Примеры использования: - Месяц - изменить период оплаты на ежемесячный; - Год - изменить период оплаты на годовой.
НДС включен в цену	В данном поле указывается, включен ли НДС в цену товара. Это необязательный параметр. Варианты выбора: - Да (Y) - НДС включен в цену; - Нет (N) - НДС не включен в цену. Примеры использования: - Да - включить НДС в цену; - Нет - исключить НДС из цены.

Примеры использования активити (робота)

Описание примера	Решение
Обновление количества товара при поступлении на склад	Параметры: ID товара - {=Document:PRODUCT_ID}, Доступное количество - ={{={=Variable:CURRENT_QUANTITY} + {=Variable:INCOMING_QUANTITY}}}}, Режим количественного учета - Включен.
Деактивация товара при отсутствии на складе	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Нет, Доступность к покупке - Нет, Доступное количество - 0.
Обновление цены и валюты товара при изменении курса	Параметры: ID товара - {=Document:PRODUCT_ID}, Валюта закупочной цены - USD, Закупочная цена - {=Variable:NEW_PRICE}, НДС включен в цену - Да.
Активация товара при поступлении на склад	Параметры: ID товара - {=Variable:PRODUCT_ID}, Активность - Да, Доступность к покупке - Да, Доступное количество - {=Variable:QUANTITY}, Разрешение покупки при отсутствии товара - Нет.
Обновление наименования и описания товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Наименование - "Товар {=Document:TITLE}", Детальное описание - {=Variable:DESCRIPTION}, Тип детального описания - HTML.
Изменение режима количественного учета товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Режим количественного учета - Включен, Доступное количество - {=Variable:QUANTITY}.
Обновление параметров подписки для товара	Параметры: ID товара - {=Document:PRODUCT_ID}, Единица времени периода оплаты - Месяц, Разрешение подписки на товар - Да.
Массовое обновление товаров через итератор	Параметры: ID товара - {=Iterator:Value}, Активность - Да, Доступность к покупке - Да, НДС включен в цену - Да.
Обновление товара при изменении статуса сделки	Параметры: ID товара - {=Document:PRODUCT_ID}, Активность - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}, Доступность к покупке - ={{=if({=Document:STAGE_ID}="WON", "Y", "N")}}.
Обновление товара для товара под заказ	Параметры: ID товара - {=Variable:PRODUCT_ID}, Разрешение покупки при отсутствии товара - Да, Доступное количество - 0, Доступность к покупке - Да.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного обновления товара обязательно должен быть заполнен следующий параметр:
- ID товара (id_product).

Проверка существования товара:
Активити (робот) проверяет существование указанного товара перед обновлением. Если товар с указанным ID не существует, активити (робот) завершится с ошибкой.

Обработка boolean полей:
Поля типа boolean (Активность, Доступность к покупке, НДС включен в цену и др.) принимают значения "Y" (Да) или "N" (Нет) и автоматически преобразуются в соответствующий формат при отправке в API.

Обновление только указанных полей:
Активити (робот) обновляет только те поля, которые указаны в параметрах. Поля, которые не указаны, остаются без изменений.

Порядок параметров:
Параметры ID товара и Наименование всегда отображаются первыми в списке параметров активити (робота) для удобства использования.

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на обновление товаров в каталоге. Рекомендуется использовать пользователя с правами администратора системы.

Ограничение по количеству обновляемых товаров:
При массовом обновлении товаров через итератор рекомендуется не обновлять более 100 товаров за один запуск бизнес-процесса. Для массового обновления используйте модуль "Массовый запуск Бизнес-процессов".

Цена

Добавление цены товара

Активити (робот) "Добавить цену товара" предназначено для использования в роботах и может быть полезно в следующих сценариях: создание новой цены для товара в торговом каталоге, добавление оптовой или розничной цены, установка цен для различных валют, настройка цен в зависимости от количества товара, синхронизация цен из внешних систем.

Как работает активити (робот):
- Активити (робот) создаёт новую цену для товара в торговом каталоге с указанными параметрами;
- Поддерживается указание типа цены (базовая, оптовая и т.д.);
- Можно указать валюту для цены из списка доступных валют портала;
- Поддерживается установка цен в зависимости от количества товара (от и до);
- Активити (робот) возвращает ID созданной цены для использования в дальнейших шагах бизнес-процесса;
- Все обязательные параметры проверяются перед созданием цены.

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает параметры от бизнес-процесса, проверяет обязательные поля (ID товара, значение цены, валюта, тип цены), формирует запрос к API Битрикс24 для создания новой цены товара и возвращает ID созданной цены в возвращаемый параметр "ID цены товара".

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID товара	В данном поле указывается идентификатор товара, для которого создаётся цена. Это обязательный параметр. ID товара можно получить методами catalog.product.list, catalog.product.offer.list, catalog.product.service.list, catalog.product.sku.list. Примеры: - 123 - указать ID товара напрямую; - {=Variable:PRODUCT_ID} - использовать ID товара из переменной бизнес-процесса; - {=Document:PRODUCT_ID} - использовать ID товара из поля документа (сделки, лида и т.д.). Важно: Если поле "ID товара" пустое или указан несуществующий товар, активити (робот) завершится с ошибкой. Обязательно укажите корректный ID товара.
Значение цены	В данном поле указывается числовое значение цены товара. Это обязательный параметр. Поддерживаются дробные значения (например, 123.45). Примеры: - 1000 - указать цену 1000; - 1250.50 - указать цену с копейками 1250.50; - {=Variable:PRICE} - использовать значение цены из переменной бизнес-процесса; - ={{={=Document:OPPORTUNITY} * 0.9}} - вычислить цену как 90% от суммы сделки; - ={{=round({=Variable:BASE_PRICE} * 1.2, 2)}} - вычислить цену с наценкой 20% и округлить до 2 знаков после запятой. Важно: Если поле "Значение цены" пустое или равно нулю, активити (робот) завершится с ошибкой. Обязательно укажите положительное значение цены.
Валюта	В данном поле выбирается валюта для цены товара из списка доступных валют портала. Это обязательный параметр. Список валют формируется автоматически при установке активити (робота) на основе настроек портала. Примеры: - RUB - выбрать российский рубль; - USD - выбрать доллар США; - EUR - выбрать евро; - {=Variable:CURRENCY} - использовать валюту из переменной бизнес-процесса (значение должно быть кодом валюты, например RUB, USD). Важно: Если поле "Валюта" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите валюту из списка.
Тип цены	В данном поле выбирается тип цены из списка доступных типов цен портала. Это обязательный параметр. Типы цен формируются автоматически при установке активити (робота) на основе настроек торгового каталога (например, базовая цена, оптовая цена и т.д.). Примеры: - 1 - выбрать тип цены с ID 1 (обычно базовая цена); - 2 - выбрать тип цены с ID 2 (например, оптовая цена); - {=Variable:PRICE_TYPE_ID} - использовать тип цены из переменной бизнес-процесса. Важно: Если поле "Тип цены" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите тип цены из списка.
Количество от	В данном поле указывается минимальное количество товара, начиная с которого действует указанная цена. Это необязательный параметр. Используется для установки оптовых цен или скидок при покупке большого количества товара. Примеры: - 10 - цена действует от 10 штук; - 100 - цена действует от 100 штук; - {=Variable:QUANTITY_FROM} - использовать значение из переменной бизнес-процесса; - Пусто - цена действует для любого количества (начиная с 1).
Количество до	В данном поле указывается максимальное количество товара, до которого действует указанная цена. Это необязательный параметр. Используется вместе с полем "Количество от" для установки диапазона количества, на который распространяется цена. Примеры: - 50 - цена действует до 50 штук; - 999 - цена действует до 999 штук; - {=Variable:QUANTITY_TO} - использовать значение из переменной бизнес-процесса; - Пусто - цена действует без ограничения по максимальному количеству.
Внешний идентификатор	В данном поле указывается внешний идентификатор цены для синхронизации с внешними системами. Это необязательный параметр. Примеры: - EXT_PRICE_001 - указать внешний идентификатор; - {=Variable:EXTERNAL_ID} - использовать внешний идентификатор из переменной бизнес-процесса.
Вес цены (для сортировки)	В данном поле указывается числовое значение для сортировки цен. Это необязательный параметр. Используется для определения порядка отображения цен при наличии нескольких цен у одного товара. Примеры: - 100 - установить вес цены 100; - {=Variable:PRICE_SCALE} - использовать значение из переменной бизнес-процесса.

Возвращаемые параметры:
- ID цены товара (Число) - ID созданной цены товара.
Используйте этот параметр для дальнейшей работы с созданной ценой в бизнес-процессе, например, для обновления цены или получения информации о цене.
- Успех операции (Да/Нет) - Флаг успешного выполнения активити (робота).
Принимает значение "Да" при успешном создании цены, "Нет" при возникновении ошибки.
- Сообщение на ошибке - выводит текст ошибки, если таковая имеется.

Примеры использования активити (робота)

Описание примера	Решение
Создать базовую цену для товара в рублях	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1000, Валюта - RUB, Тип цены - 1. Активити (робот) создаст базовую цену 1000 рублей для товара с указанным ID.
Добавить оптовую цену с минимальным количеством	Параметры: ID товара - {=Document:PRODUCT_ID}, Значение цены - 800, Валюта - RUB, Тип цены - 2, Количество от - 10. Активити (робот) создаст оптовую цену 800 рублей, действующую при покупке от 10 штук товара.
Установить цену в долларах США	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 50, Валюта - USD, Тип цены - 1. Активити (робот) создаст цену 50 долларов США для товара.
Создать цену с вычислением на основе суммы сделки	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{={=Document:OPPORTUNITY} / {=Variable:QUANTITY}}}, Валюта - RUB, Тип цены - 1. Активити (робот) вычислит цену как частное от деления суммы сделки на количество товара.
Добавить цену с наценкой 15% от базовой цены	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{={=Variable:BASE_PRICE} * 1.15}}, Валюта - RUB, Тип цены - 1. Активити (робот) вычислит цену с наценкой 15% от базовой цены из переменной.
Установить цену для диапазона количества товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 700, Валюта - RUB, Тип цены - 2, Количество от - 50, Количество до - 100. Активити (робот) создаст оптовую цену 700 рублей для покупки от 50 до 100 штук товара.
Создать цену с внешним идентификатором для синхронизации	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1200, Валюта - RUB, Тип цены - 1, Внешний идентификатор - EXT_{=Variable:PRODUCT_ID}_PRICE. Активити (робот) создаст цену с внешним идентификатором для последующей синхронизации с внешней системой.
Добавить цену в евро с округлением до 2 знаков	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - ={{=round({=Variable:PRICE_EUR}, 2)}}, Валюта - EUR, Тип цены - 1. Активити (робот) создаст цену в евро, округлённую до 2 знаков после запятой.
Установить цену с приоритетом сортировки	Параметры: ID товара - {=Variable:PRODUCT_ID}, Значение цены - 1500, Валюта - RUB, Тип цены - 1, Вес цены (для сортировки) - 200. Активити (робот) создаст цену с высоким приоритетом сортировки (200), которая будет отображаться первой среди других цен.
Создать цену для товара из сделки с автоматическим вычислением	Параметры: ID товара - {=Document:PRODUCT_ID}, Значение цены - ={{={=Document:OPPORTUNITY} * 0.95}}, Валюта - {=Document:CURRENCY_ID}, Тип цены - 1. Активити (робот) создаст цену со скидкой 5% от суммы сделки в валюте сделки.

Изменить цену товара

Активити (робот) "Изменить цену товара" предназначено для использования в роботах и может быть полезно в следующих сценариях: обновление существующей цены товара в торговом каталоге, изменение цены при изменении курса валют, корректировка цен при изменении условий поставки, обновление оптовых или розничных цен, синхронизация цен из внешних систем, изменение валюты цены, обновление диапазонов количества для оптовых цен.

Как работает активити (робот):
- Активити (робот) обновляет существующую цену товара в торговом каталоге с указанными параметрами;
- Поддерживается изменение значения цены, валюты и других параметров;
- Можно обновить только необходимые поля, не указывая остальные;
- Активити (робот) проверяет обязательные параметры перед обновлением;
- После успешного обновления активити (робот) возвращает флаг успешного выполнения.

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает параметры от бизнес-процесса, проверяет обязательные поля (ID цены товара, значение цены, валюта), формирует запрос к API Битрикс24 для обновления существующей цены товара и возвращает результат выполнения операции.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID цены товара	В данном поле указывается идентификатор существующей цены товара, которую необходимо обновить. Это обязательный параметр. ID цены можно получить методом catalog.price.list, с помошью активити "Поиск цен товаров по фильтру" или из возвращаемого параметра активити (робота) "Добавить цену товара". Примеры: - 456 - указать ID цены напрямую; - {=Variable:PRICE_ID} - использовать ID цены из переменной бизнес-процесса; - {=Variable:id_new_price} - использовать ID цены, полученный после создания цены активити (роботом) "Добавить цену товара". Важно: Если поле "ID цены товара" пустое или указана несуществующая цена, активити (робот) завершится с ошибкой. Обязательно укажите корректный ID цены товара. Цена - это не поле, а отдельный справочник. Каждый раз, когда вы присвваиваете цену товару, в него делается запись с уникальным ID.
Значение цены	В данном поле указывается новое числовое значение цены товара. Это обязательный параметр. Поддерживаются дробные значения (например, 123.45). Примеры: - 1500 - указать новую цену 1500; - 1250.75 - указать новую цену с копейками 1250.75; - {=Variable:NEW_PRICE} - использовать новое значение цены из переменной бизнес-процесса; - ={{={=Variable:OLD_PRICE} * 1.1}} - увеличить цену на 10%; - ={{=round({=Variable:BASE_PRICE} * 0.9, 2)}} - установить цену со скидкой 10% и округлить до 2 знаков после запятой. Важно: Если поле "Значение цены" пустое, активити (робот) завершится с ошибкой. Обязательно укажите новое значение цены.
Валюта	В данном поле выбирается новая валюта для цены товара из списка доступных валют портала. Это обязательный параметр. Список валют формируется автоматически при установке активити (робота) на основе настроек портала. Примеры: - RUB - выбрать российский рубль; - USD - выбрать доллар США; - EUR - выбрать евро; - {=Variable:CURRENCY} - использовать валюту из переменной бизнес-процесса (значение должно быть кодом валюты, например RUB, USD). Важно: Если поле "Валюта" не выбрано, активити (робот) завершится с ошибкой. Обязательно выберите валюту из списка.
ID товара	В данном поле указывается идентификатор товара, к которому относится цена. Это необязательный параметр. Используется для изменения привязки цены к другому товару. Примеры: - 789 - указать новый ID товара напрямую; - {=Variable:NEW_PRODUCT_ID} - использовать ID товара из переменной бизнес-процесса.
Количество от	В данном поле указывается новое минимальное количество товара, начиная с которого действует указанная цена. Это необязательный параметр. Используется для изменения условий оптовых цен. Примеры: - 20 - цена будет действовать от 20 штук; - {=Variable:QUANTITY_FROM} - использовать значение из переменной бизнес-процесса; - Пусто - не изменять текущее значение.
Количество до	В данном поле указывается новое максимальное количество товара, до которого действует указанная цена. Это необязательный параметр. Используется вместе с полем "Количество от" для изменения диапазона количества. Примеры: - 200 - цена будет действовать до 200 штук; - {=Variable:QUANTITY_TO} - использовать значение из переменной бизнес-процесса; - Пусто - не изменять текущее значение.
Внешний идентификатор	В данном поле указывается новый внешний идентификатор цены для синхронизации с внешними системами. Это необязательный параметр. Примеры: - EXT_PRICE_002 - указать новый внешний идентификатор; - {=Variable:EXTERNAL_ID} - использовать внешний идентификатор из переменной бизнес-процесса.
Вес цены (для сортировки)	В данном поле указывается новое числовое значение для сортировки цен. Это необязательный параметр. Используется для изменения порядка отображения цен при наличии нескольких цен у одного товара. Примеры: - 300 - установить новый вес цены 300; - {=Variable:PRICE_SCALE} - использовать значение из переменной бизнес-процесса.

Возвращаемые параметры:
- Успех операции (Да/Нет) - Флаг успешного выполнения активити (робота).
Принимает значение "Да" при успешном обновлении цены, "Нет" при возникновении ошибки.
- Сообщение об ошибке - выводит текст ошибки, если таковая имеется.

Примеры использования активити (робота)

Описание примера	Решение
Обновить значение цены товара	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - 2000, Валюта - RUB. Активити (робот) обновит цену с указанным ID, установив новое значение 2000 рублей.
Увеличить цену на 15%	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{={=Variable:CURRENT_PRICE} * 1.15}}, Валюта - RUB. Активити (робот) вычислит новую цену как текущую цену, увеличенную на 15%.
Изменить валюту цены с рубля на доллар	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:PRICE}, Валюта - USD. Активити (робот) обновит валюту цены на доллар США, сохранив текущее значение цены.
Применить скидку 20% к существующей цене	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{={=Variable:OLD_PRICE} * 0.8}}, Валюта - RUB. Активити (робот) установит новую цену со скидкой 20% от старой цены.
Обновить диапазон количества для оптовой цены	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:PRICE}, Валюта - RUB, Количество от - 25, Количество до - 100. Активити (робот) обновит диапазон количества, на который распространяется оптовая цена.
Изменить цену на основе курса валют	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{={=Variable:PRICE_USD} * {=Variable:EXCHANGE_RATE}}}, Валюта - RUB. Активити (робот) вычислит новую цену в рублях на основе цены в долларах и текущего курса обмена.
Округлить цену до целого числа	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - ={{=round({=Variable:PRICE})}}, Валюта - RUB. Активити (робот) обновит цену, округлив её до ближайшего целого числа.
Обновить цену после создания через активити "Добавить цену товара"	Параметры: ID цены товара - {=Variable:id_new_price}, Значение цены - ={{={=Variable:id_new_price} * 1.05}}, Валюта - RUB. Активити (робот) обновит только что созданную цену, увеличив её на 5%.
Изменить приоритет сортировки цены	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:PRICE}, Валюта - RUB, Вес цены (для сортировки) - 500. Активити (робот) обновит приоритет сортировки цены, установив высокий вес для отображения первой среди других цен.
Синхронизировать цену с внешней системой	Параметры: ID цены товара - {=Variable:PRICE_ID}, Значение цены - {=Variable:EXTERNAL_PRICE}, Валюта - RUB, Внешний идентификатор - EXT_{=Variable:PRICE_ID}. Активити (робот) обновит цену и внешний идентификатор для синхронизации с внешней системой.

Поиск цен товаров по фильтру

Активити (робот) "Поиск цен товаров по фильтру" предназначено для использования в роботах и может быть полезно в следующих сценариях: поиск цен по ID товара, поиск базовых и оптовых цен по типу цены, поиск цен по валюте, поиск цен с диапазоном количества (quantityFrom/quantityTo), поиск цен для массовой обработки через итератор, подготовка списка ID цен для последующего получения данных или удаления.

Как работает активити (робот):
- Активити (робот) формирует фильтр из заполненных параметров поиска;
- Если не заполнен ни один параметр, активити (робот) завершится с ошибкой;
- Выполняет поиск цен через API Битрикс24 и получает список найденных цен;
- Возвращает результаты в виде массива ID (для итератора), строки ID через запятую, первого и последнего результата, а также количество найденных элементов;
- Возвращает флаг результата поиска math_search_results (Y/N).

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает параметры фильтра, выполняет поиск цен товаров и возвращает список ID найденных цен.
Далее эти ID можно передать в итератор, в активити (робот) "Данные по цене товара" для получения подробностей или в активити (робот) "Удалить цену товара" для удаления.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID цены	Поиск по идентификатору цены. Полезно, когда нужно проверить существование цены или отфильтровать конкретную запись. Примеры: - 456 - найти цену с ID 456; - {=Variable:PRICE_ID} - использовать ID цены из переменной бизнес-процесса.
ID товара	Поиск цен, относящихся к конкретному товару. Это один из самых распространённых сценариев. Примеры: - 123 - найти все цены товара с ID 123; - {=Variable:PRODUCT_ID} - использовать ID товара из переменной бизнес-процесса; - {=Document:ID} - использовать ID текущего документа, если документом является товар.
Значение цены	Поиск по значению цены. Допускается указание числового значения, а также сравнительных выражений (например >1000), если это поддерживается API Битрикс24 в фильтрах для цен. Примеры: - 1000 - найти цены со значением 1000; - >1000 - найти цены больше 1000; - {=Variable:PRICE_VALUE} - использовать значение из переменной бизнес-процесса.
Валюта	В данном поле выбирается валюта цены из списка валют портала. Полезно для поиска цен в конкретной валюте. Примеры: - RUB - найти цены в рублях; - USD - найти цены в долларах США; - {=Variable:CURRENCY} - использовать код валюты из переменной.
Тип цены	Поиск по типу цены (например, базовая, оптовая и т.д.). Поле выбирается из списка типов цен торгового каталога. Примеры: - 1 - найти цены типа с ID 1 (часто базовая цена); - 2 - найти цены типа с ID 2 (например, оптовая цена); - {=Variable:PRICE_TYPE_ID} - использовать ID типа цены из переменной бизнес-процесса.
Количество от	Поиск цен, действующих от определённого количества. Удобно для поиска оптовых цен. Примеры: - 10 - найти цены, которые начинаются от 10 единиц; - >=50 - найти цены, где минимальное количество 50 и больше (если поддерживается API); - {=Variable:QUANTITY_FROM} - использовать значение из переменной.
Количество до	Поиск цен, действующих до определённого количества. Используется вместе с полем "Количество от" для диапазона. Примеры: - 100 - найти цены, которые действуют до 100 единиц; - <=500 - найти цены с максимальным количеством до 500 (если поддерживается API); - {=Variable:QUANTITY_TO} - использовать значение из переменной.
Внешний идентификатор	Поиск по внешнему идентификатору цены для синхронизации с внешними системами. Примеры: - EXT_PRICE_001 - найти цену по внешнему идентификатору; - EXT_{=Variable:PRODUCT_ID}_BASE - использовать значение, собранное из переменных бизнес-процесса.
Вес цены (для сортировки)	Поиск по весу цены. Используется, если на портале применяются веса для сортировки цен. Примеры: - 100 - найти цены с весом 100; - {=Variable:PRICE_SCALE} - использовать значение из переменной.

Возвращаемые параметры:
- Результат поиска (строка) : Y (найдено) или N (не найдено);
- Количество найденных элементов (Число);
- Массив ID найденных цен (Число, множественное, удобно для итератора);

- Строка ID найденных цен через запятую (Строка) ;
- Первый ID из результата поиска (Строка) ;
- Последний ID из результата поиска (Строка) ;
- Строка для служебных сообщений и отладки (Строка) .

Важно о возвращаемых параметрах: Если цены не найдены, параметр "Результат поиска" будет равен N, а "Количество найденных элементов" будет равено 0.
Всегда проверяйте "Результат поиска" перед использованием параметра "Массив ID найденных цен".

Важно! Ограничения и рекомендации:
- Для успешного запуска должен быть заполнен хотя бы один параметр поиска;
- Рекомендуется по возможности указывать ID товара и тип цены, чтобы получить точные результаты;
- Если ожидается много результатов, используйте итератор по массиву и обрабатывайте цены последовательно.

Примеры использования активити (робота)

Описание примера	Решение
Найти все цены конкретного товара	Параметры: ID товара - {=Variable:PRODUCT_ID}. Активити (робот) вернёт массив ID всех цен данного товара в параметре "Массив ID".
Найти базовую цену товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 1. Активити (робот) вернёт ID базовой цены товара.
Найти оптовые цены товара в рублях	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 2, Валюта - RUB. Активити (робот) вернёт ID оптовых цен в рублях.
Найти цены, действующие от 10 единиц товара	Параметры: ID товара - {=Variable:PRODUCT_ID}, Количество от - 10. Активити (робот) вернёт цены, у которых "Количество от" равно 10.
Найти цены в долларах США по всему каталогу	Параметры: Валюта - USD. Активити (робот) вернёт ID всех цен в валюте USD.
Найти цену по внешнему идентификатору	Параметры: Внешний идентификатор - EXT_PRICE_001. Активити (робот) вернёт ID цены, связанной с записью во внешней системе.
Подготовить список цен для получения подробных данных	Параметры: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 1. Затем используйте итератор по массиву значений и запускайте активити (робот) "Данные по цене товара" с ID цены товара - {=Variable:search_results_array}.
Найти цены для последующего удаления (очистка тестовых данных)	Параметры: Внешний идентификатор - TEST_{=Variable:PRODUCT_ID}. Затем используйте итератор по search_results_array и запускайте активити (робот) "Удалить цену товара" с ID цены товара - {=Variable:search_results_array}.
Найти цены по диапазону количества	Параметры: Количество от - 50, Количество до - 100, Валюта - RUB. Активити (робот) вернёт цены для диапазона 50-100 в рублях.
Найти цены с заданным весом сортировки	Параметры: Вес цены (для сортировки) - 200. Активити (робот) вернёт цены с указанным индексом сортировки.

Данные по цене товара

Активити (робот) "Данные по цене товара" предназначено для использования в роботах и может быть полезно в следующих сценариях: получение текущей цены для расчётов в бизнес-процессе, проверка валюты и типа цены перед изменением, получение диапазона количества для оптовых цен, получение внешнего идентификатора для синхронизации с внешними системами, контроль корректности данных цены по её ID.

Как работает активити (робот):
- Активити (робот) принимает ID цены товара;
- Выполняет запрос к API Битрикс24 для получения данных цены;
- Возвращает основные поля цены (ID товара, значение, валюта, тип цены, количество от/до, внешний идентификатор);
- Возвращает флаг успешного выполнения ok_ready (Да/Нет).

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает ID цены товара, запрашивает данные цены в торговом каталоге и возвращает найденные значения в возвращаемые параметры, чтобы их можно было использовать в дальнейших шагах бизнес-процесса.

Описание параметров активити (робота)

Название поля

Описание и примеры использования

ID цены товара

В данном поле указывается идентификатор цены товара, по которому нужно получить данные. Это обязательный параметр. ID цены можно получить из результата активити (робота) "Добавить цену товара" (параметр id_new_price) или из результатов активити (робота) "Поиск цен товаров по фильтру" (параметр search_results_array). Примеры: - 456 - указать ID цены напрямую; - {=Variable:PRICE_ID} - взять ID цены из переменной бизнес-процесса; - {=Variable:id_new_price} - взять ID цены из результата активити (робота) "Добавить цену товара"; - {=Variable:search_result_first_string} - взять первый найденный ID из результата поиска цен. Важно: Если поле "ID цены товара" пустое или указан несуществующий ID, активити (робот) завершится с ошибкой. Обязательно передавайте корректный идентификатор цены.

Возвращаемые параметры:
- ID цены (Число) - ID цены товара;
- ID товара (Число) - ID товара, к которому относится цена;
- Значение цены (Строка) - значение цены;
- Валюта (Строка) - валюта цены (например RUB, USD, EUR);
- Тип цены (Число) - ID типа цены (например базовая, оптовая и т.д.);
- Количество (от) (Число) - количество "от" (если цена действует от определённого количества);
- Количество (до) (Число) - количество "до" (если цена действует до определённого количества);
- Внешний идентификатор (Строка) - внешний идентификатор цены (если используется для синхронизации);
- Успех операции (статус выполнения) - (Да/Нет), флаг успешного выполнения активити (робота).

Важно о возвращаемых параметрах: Если цена не найдена, параметр "Успех операции" будет равен "Нет".
Рекомендуется сначала проверить параметр "Успех операции", и только после этого использовать параметры Цена, Валюта и другие.

Примеры использования активити (робота)

Описание примера	Решение
Получить данные цены по ID из переменной	Параметры: ID цены товара - {=Variable:PRICE_ID}. Активити (робот) вернёт данные цены, а вы сможете использовать Цена и Валюта в дальнейших шагах.
Получить данные цены сразу после создания	Параметры: ID цены товара - {=Variable:id_new_price}. Активити (робот) вернёт данные созданной цены, чтобы проверить корректность заполнения.
Получить данные первой найденной цены после поиска	Параметры: ID цены товара - {=Variable:search_result_first_string}. Активити (робот) вернёт данные первой найденной цены из результата активити (робота) "Поиск цен товаров по фильтру".
Проверить валюту цены перед конвертацией	Параметры: ID цены товара - {=Variable:PRICE_ID}. После выполнения активити (робота) используйте возвращаемый параметр Валюта для проверки (например, RUB) и выбора нужной ветки бизнес-процесса.
Получить диапазон количества для оптовой цены	Параметры: ID цены товара - {=Variable:PRICE_ID}. После выполнения активити (робота) используйте "Количество (от)" и "Количество (до)", чтобы определить для какого количества действует оптовая цена.
Получить ID товара по ID цены	Параметры: ID цены товара - 456. Активити (робот) вернёт productId, чтобы затем работать с товаром (например, обновлять поля товара или формировать уведомления).
Получить тип цены для ветвления логики (базовая/оптовая)	Параметры: ID цены товара - {=Variable:PRICE_ID}. Используйте возвращаемый параметр "Тип цены" для выбора сценария обновления или проверки.
Получить внешний идентификатор цены для синхронизации	Параметры: ID цены товара - {=Variable:PRICE_ID}. Используйте возвращаемый параметр "Внешний идентификатор" для сопоставления цены с записью во внешней системе.
Проверить, что цена существует перед удалением	Параметры: ID цены товара - {=Variable:PRICE_ID}. Если ok_ready = "Да", можно безопасно запускать активити (робот) "Удалить цену товара" с тем же ID.
Собрать текст для уведомления с ценой и валютой	Параметры: ID цены товара - {=Variable:PRICE_ID}. После выполнения активити (робота) сформируйте сообщение вида "Цена: [значение] [валюта]" на основе возвращаемых параметров price и currency.

Удалить цену товара

Активити (робот) "Удалить цену товара" предназначено для использования в роботах и может быть полезно в следующих сценариях: удаление тестовых цен после загрузки, очистка некорректных цен по списку, удаление устаревших цен при смене прайс-листов, удаление цен после переноса данных из внешней системы, удаление дублей цен.

Как работает активити (робот):
- Активити (робот) принимает ID цены товара, которую необходимо удалить;
- Выполняет удаление цены через API Битрикс24;
- Возвращает флаг успешного выполнения ok_ready (Да/Нет).

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) получает ID цены товара и выполняет удаление.
Рекомендуется предварительно получить данные по цене активити (роботом) "Данные по цене товара" и убедиться, что удаляется нужная запись.

Описание параметров активити (робота)

Название поля

Описание и примеры использования

ID цены товара

В данном поле указывается идентификатор цены товара, которую нужно удалить. Это обязательный параметр. ID цены можно получить из результата активити (робота) "Добавить цену товара" (параметр "ID цены") или из результатов активити (робота) "Поиск цен товаров по фильтру" (параметр "Результат поиска (Массив)"). Примеры: - 456 - указать ID цены напрямую; - {=Variable:PRICE_ID} - использовать ID цены из переменной бизнес-процесса; - {=Variable:id_new_price} - удалить цену, созданную ранее этим же бизнес-процессом; - {=Variable:search_result_first_string} - удалить первую цену из результата поиска. Важно: Удаление цены необратимо. Перед удалением рекомендуется выполнить проверку (например, получить данные цены и сравнить ID товара, Валюту, Тип цены). Если указан неверный ID, активити (робот) завершится с ошибкой.

Возвращаемые параметры:
- Успех операции (Да/Нет) - флаг успешного выполнения активити (робота).
Значение "Да" означает, что цена была удалена, "Нет" - произошла ошибка.

Важно о возвращаемых параметрах: Рекомендуется всегда проверять параметр "Успех операции".
Если параметр возвращает значение "Нет", не выполняйте дальнейшие действия, которые предполагают, что цена уже удалена.

Важно! Ограничения и рекомендации:
- Удаляйте только те цены, в корректности которых вы уверены;
- Для массового удаления используйте итератор по списку ID цен (параметр "Результат выполнения (массив)");
- Рекомендуется выполнять удаление от имени пользователя с правами администратора каталога.

Примеры использования активити (робота)

Описание примера	Решение
Удалить цену по ID из переменной	Параметры: ID цены товара - {=Variable:PRICE_ID}. Активити (робот) удалит цену с указанным ID и вернёт ok_ready.
Удалить цену, созданную ранее в бизнес-процессе	Параметры: ID цены товара - {=Variable:id_new_price}. Активити (робот) удалит цену, созданную активити (роботом) "Добавить цену товара".
Удалить первую цену из результата поиска	Параметры: ID цены товара - {=Variable:search_result_first_string}. Активити (робот) удалит первую найденную цену.
Массово удалить найденные тестовые цены по внешнему идентификатору	Параметры поиска (в отдельном шаге): Внешний идентификатор - TEST_{=Variable:PRODUCT_ID}. Далее используйте итератор по search_results_array и запускайте удаление с параметром ID цены товара - {=Variable:search_results_array}.
Очистить дубли цен товара (удалить все, кроме одной)	Параметры поиска: ID товара - {=Variable:PRODUCT_ID}, Тип цены - 1. Затем сравните count_search и при необходимости удалите лишние ID из search_results_array через итератор, оставив одну цену.
Удалить устаревшую оптовую цену после смены прайс-листа	Параметры: ID цены товара - {=Variable:OLD_WHOLESALE_PRICE_ID}. Активити (робот) удалит устаревшую цену и вернёт ok_ready.
Удалить цены товара в конкретной валюте	Параметры поиска: ID товара - {=Variable:PRODUCT_ID}, Валюта - USD. Затем используйте итератор по search_results_array и удаляйте цены с параметром ID цены товара - {=Variable:search_results_array}.
Удалить цены с диапазоном количества (опт), чтобы создать новые	Параметры поиска: ID товара - {=Variable:PRODUCT_ID}, Количество от - 10. Затем через итератор удалите найденные цены и создайте новые цены активити (роботом) "Добавить цену товара".
Удалить цену после проверки, что она относится к нужному товару	Параметры: ID цены товара - {=Variable:PRICE_ID}. Перед удалением получите данные цены и сравните productId с {=Variable:PRODUCT_ID}, затем выполните удаление с тем же ID.
Удалить цену при ошибке загрузки (откат операции)	Параметры: ID цены товара - {=Variable:id_new_price}. Если после создания цены возникла ошибка в дальнейших шагах, активити (робот) может удалить созданную цену как откат.

Пункт меню "настройки"

В данном уроке описан функционал пункта меню "Настройки" в приложениях "Лаборатория БП" и "Лаборатория роботов".

Процент запросов для уведомлений: эта опция позволяет настроить уведомление об исчерпании запросов к REST.
Т.е вы указываете цифрой значение, которое отображает остаточный процент от общего числа запросов,
при котором администраторы приложения получат уведомление, о том, что запросы к REST скоро закончатся.
Например у Вас 300 000 запросов и Вы поставили 10%, то уведомление придет когда, останется меньше 30 000 запросов.

Создавать задачу при превышении лимита запросов: варианты: да/нет.
При достижении лимита запросов или при их приближении к концу создается задача в Битрикс24.
Выберите "Нет", если не хотите создавать задачу.

Введите количество offline событий:эта опция нужна для создания отложенной очереди обработки эвентов на портале.
Делается это для того, чтобы некоторые активити, обработка событий (эвентов) которых не приоритетна, не мешали обработке других БП и их эвентов. 
Для настройки, нужно указать количество (число) эвентов, которые система сохранит, но выполнит, только после превышения указанного числа эвентов.

Обратите внимание, что более 100 эвентов в очереди оставить нельзя. Даже если вы укажите более, например 101, то при сохранении настроек останется все равно 100 эвентов.
Это нужно для того, чтобы Ваш портал не был заблокирован нашей автоматикой или Б24, когда отложенные 100 (или меньше) эвентов пойдут в обработку.

Offline События: эта настройка позволяет выбрать события REST, которые будут храниться на портале.
Портал хранит указанное количество offline событий для каждого метода, т.е если у вас отмечены для хранения событий методы ONCRMINVOICESETSTATUS и ONCRMLEADUPDATE,
то для каждого из них будет сохранено не более 100 эвентов.
Количество событий, которое представлены фиксировано и не зависит от количества установленных активити, т.к некоторые активити работают с использованием данных событий.
Перечень offline событий и активити, которые его используют:

• ONCRMINVOICESETSTATUS: Слежение за статусом счета.
• ONCRMLEADUPDATE: Завершение по условиям.
• ONCRMDEALUPDATE: Изменение сделки.
• ONCRMCOMPANYUPDATE: Изменение компании.
• ONCRMCONTACTUPDATE: Изменение контакта.
• ONCRMACTIVITYADD, ONCRMACTIVITYUPDATE: Слежение за делом.
• ONTASKUPDATE: Слежение за изменением в задаче.
• ONIMBOTMESSAGEADD, ONIMCOMMANDADD: Создание сообщения в чат от робота.

Чат и боты

Для того, чтобы сделать чат-бота, наносящего пользу вашему бизнесу, не нужно сложное программирование - нужны дополнительные действия в бизнес-процессах Битрикс24 из Приложений24. Мы пройдёмся по всем этапам создания чатботов от момента регистрации на портале до обучения чатбота понимать клиента или коллегу по работе. Покажем, как создать чат-бота в Битрикс24 с помощью приложения "Лаборатория бизнес-процессов" и решать следующие задачи: 

1. 17:42 - Провести первичное общение с клиентом в открытой линии. 

2. 01:10:00 - Создать чат-бота помощника, который будет подсказывать наличие товара в интернет-магазине. 

3. 29:55 - Создать чат-бота для согласования документов и дел в карточках CRM и чате. 

4. 01:30:34 - Создать чат-бота, который может давать ответы на часто задаваемые вопросы как клиентов, так и сотрудников.

Примеры бизнес-процессов, которые описаны в видеоролике - СКАЧАТЬ

Чат

Создание чата

Данное активити позволяет создать новый чат и пригласить туда участников.

Сценарий работы активити бизнес-процесса

Тип чата: данное поле позволяет указать тип чата, который будет создан, т.е открытый для вступления или внутренний чат (закрытый).

Заголовок чата: в данном поле указывается заголовок чата.

Создавать чаты с помощью активити из нашего приложения "Лаборатория роботов" или "Лаборатория БП" и писать сообщения в них (как и любые другие действия) могут только чат-боты, которые созданы с использованием нашего приложения, т.к у них есть права доступа к приложению, сторонние чат-боты работать не будут.

Описание чата: в данном поле указывается заголовок чата.

Цвет чата: в данном поле можно выбрать из выпадающего списка цвет чата.

Один из способов создать чат с привязкой к сущности, это с помощью штатного активити "Изменение наблюдателей".
В данной процедуре очень Важна очередность действий, и это де-факто костыль.

Процедура такая:
1. Создаете БП с активити "Изменение наблюдателей" и указываете одного или нескольких наблюдателей в его настройках.
2. Далее в ручную или роботом из сущности запускаете этот БП, у Вас добавятся наблюдатели, но сам созданный чат вы не увидите.
3. Далее, инициируете создание чата, нажатием на область чата в самой сущности, и после этих действий, все наблюдатели в него подтянутся.
  

Но есть нюанс: все наблюдатели, которые будут добавлены после создания чата с уже имеющимися наблюдателями в чат добавлены не будут и их придется приглашать, а для этого нужно знать ID чата.

Тип сущности (Тип сущности для привязки): в этом поле указывается тип сущности к которой будет прикреплен чат.
На данный момент для работы доступны 3 типа сущностей: Лид, Сделка, Контакт, Компания, Счет, Предложение, Смарт-процесс.
Сущность выбирается из выпадающего списка, однако можно указать тип сущности в дополнительном поле.

Пример заполнения типов сущностей:
Лид: LEAD
Сделка: DEAL
Контакт: CONTACT
Компания: COMPANY
Счет: SMART_INVOICE
Предложение: QUOTE
Смарт-процесс: DYNAMIC_ID Типа СП

ID сущности:ID сущности (число) в этом поле указывается идентификатор сущности, к которой будет привязан чат.

Активити может создать несколько чатов для одной сущности, вернет их ID и прикрепит их к сущности, НО, в самой сущности будь то Сделка или СП будет виден только 1 чат, самый первый, который был создан, в разделе "чаты точно так же".
И это при условии, что пользователь в чате не состоял или в сущности не было изначально активных чатов.
Количество созданых и прикрепленных к сущности чатов может быть каким угодно, но пользователь разделе "Чаты", увидит только 1 чат для 1 конкретной сущности, это особенность работы REST Б24.

Первое приветственное сообщение в чате: в данном поле задается приветственное сообщение, которое увидит пользователь приглашенный или зашедший в чат.

Участники чата(указать одного или более пользователя): в данном поле указываются ID участников чата. 

Участники чатов добавляются только поименно, нельзя добавлять участников отделами или как-либо еще.
Правильное заполнение участников чата: Николай Администратор [13]; Вадим Кириленко [1643]; Игорь Куницын [2868], при этом ID пользователей должны быть внутри квадратных скобок.

Аватар чата (ссылка на картинку): в данном поле ссылка на картинку, которая будет аватаркой чата. Ссылка должна быть публично - доступной для скачивания.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака. 

Создавая чат, нужно сразу же добавлять в него хотя бы 1 пользователя и чат-бота (при необходимости).

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- ID созданного чата
- Успех создания чата
- Таймаут операции

Обновление чата

Данное активити (робот) позволяет обновлять параметры чата в Битрикс24: владельца, название, аватар и цвет.
Результатом работы является обновление указанных параметров чата по его ID.

ВАЖНО!
Запускать активити может ТОЛЬКО владелец чата, который необходимо изменить. Если активити запускает пользователь, который не является владельцем чата, операция обновления не будет выполнена.

НЕЛЬЗЯ менять аватар у чатов, привязанных к CRM сущностям (сделки, лиды, контакты, компании и т.д.). Попытка изменения аватара у таких чатов приведёт к ошибке выполнения активити.

Для обновления чата необходимо указать ID чата и хотя бы один из параметров для обновления:
- ID нового владельца (owner_id);
- Новое название (title_chat);
- Путь к файлу аватара (avatar_chat);
- Цвет чата (color_chat).

Если ни один из параметров обновления не будет указан, активити вернёт ошибку.

Описание параметров активити

Название поля	Описание и примеры использования
ID чата	В данном поле указывается числовой идентификатор чата, который необходимо обновить. Это обязательный параметр. Пример: {=Variable:CHAT_ID} или 12345. Как получить ID чата: - Из результата работы активити "Создание чата" (поле return_id_chat); - Из результата работы активити "Добавление сообщения в чат" (поле return_id_chat); - Сохранённый из предыдущих операций с чатами; - Переменная бизнес-процесса, в которой хранится ID чата. Примеры указания ID: - Прямое указание: 123, 456; - Через переменную: {=Variable:CHAT_ID}; - Из результата предыдущего активити: {=Activity123:return_id_chat}.
ID нового владельца чата	В данном поле указывается идентификатор пользователя, который станет новым владельцем чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:NEW_OWNER_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 123; - Формат Битрикс24: [U1], [U5], [U10]; - Через переменную: {=Variable:OWNER_ID}; - Из поля документа: {=Document:ASSIGNED_BY_ID}. Важно: Изменить владельца может только текущий владелец чата. После смены владельца права на управление чатом переходят к новому владельцу.
Новое название чата	В данном поле указывается новое название (заголовок) чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:NEW_TITLE} или "Проект Альфа". Примеры использования: - Прямое указание: "Новое название чата"; - Через переменную: {=Variable:CHAT_TITLE}; - Из поля документа: "Чат по сделке {=Document:TITLE}"; - С использованием функций: "Чат от {{=date('d.m.Y')}}". Ограничения: Название чата не должно быть пустым. Максимальная длина названия ограничена возможностями API Битрикс24.
Путь к файлу аватара	В данном поле указывается путь к файлу изображения, который будет использован в качестве аватара чата. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:AVATAR_PATH} или "https://example.com/avatar.jpg". Форматы указания пути: - Полный URL: "https://example.com/images/avatar.png"; Требования к файлу: - Файл должен быть доступен для чтения; - Поддерживаемые форматы: JPG, PNG, GIF; - Рекомендуемый размер: не более 2 МБ; - Изображение будет автоматически конвертировано в формат base64. ВАЖНО! Нельзя изменять аватар у чатов, привязанных к CRM сущностям (сделки, лиды, контакты, компании, смарт-процессы и т.д.). Попытка изменения аватара у таких чатов приведёт к ошибке выполнения активити.
Цвет чата	В данном поле из выпадающего списка можно выбрать цвет чата для мобильного приложения. Это необязательный параметр, но хотя бы один из параметров обновления должен быть заполнен. Пример: {=Variable:CHAT_COLOR} или выбор из списка. Доступные цвета: - КРАСНЫЙ (RED); - ЗЕЛЕНЫЙ (GREEN); - МОНЕТНЫЙ ДВОР (MINT); - СВЕТЛО ГОЛУБОЙ (LIGHT_BLUE); - ТЁМНО ГОЛУБОЙ (DARK_BLUE); - ФИОЛЕТОВЫЙ (PURPLE); - ВОДА (AQUA); - РОЗОВАЯ (PINK); - ИЗВЕСТЬ (LIME); - КОРИЧНЕВАЯ (BROWN); - ГОЛУБАЯ (AZURE); - ЦВЕТА (KHAKI); - ХАКИ (SAND); - ПЕСОК (MARENGO); - СЕРЫЙ (GRAY); - ГРАФИТ (GRAPHITE). Примеры использования: - Прямой выбор из списка; - Через переменную: {=Variable:COLOR} (значение должно соответствовать одному из доступных цветов).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Важно: Указанный сотрудник должен быть владельцем чата, иначе обновление не будет выполнено. Рекомендуем выбирать владельца чата или сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Примеры использования активити

Описание примера	Решение
Смена владельца чата при передаче проекта	Параметры: ID чата - {=Variable:PROJECT_CHAT_ID}, ID нового владельца - {=Document:NEW_MANAGER_ID}. При передаче проекта новому менеджеру робот автоматически меняет владельца чата проекта, передавая права управления новому ответственному.
Обновление названия чата при изменении названия сделки	Параметры: ID чата - {=Variable:DEAL_CHAT_ID}, Новое название - "Чат по сделке {=Document:TITLE}". При изменении названия сделки робот синхронизирует название связанного чата, чтобы оно соответствовало текущему названию сделки.
Изменение цвета чата для визуального разделения по приоритетам	Параметры: ID чата - {=Activity123:return_id_chat}, Цвет чата - RED (для высокого приоритета) или GREEN (для низкого приоритета). Робот меняет цвет чата в зависимости от приоритета задачи или проекта для быстрой визуальной идентификации.
Обновление аватара чата при создании нового проекта	Параметры: ID чата - {=Activity456:return_id_chat}, Путь к файлу аватара - {=Variable:PROJECT_LOGO_URL}. При создании нового проекта робот устанавливает логотип проекта в качестве аватара чата для лучшей визуальной идентификации.
Массовое обновление названий чатов при реорганизации	Параметры: ID чата - {=Variable:CHAT_ID}, Новое название - "Отдел {=Variable:NEW_DEPARTMENT_NAME} - {=Variable:CHAT_NUMBER}". При реорганизации отделов робот обновляет названия всех чатов отдела, добавляя новое название отдела в начало названия чата.
Смена владельца и цвета при эскалации задачи	Параметры: ID чата - {=Document:CHAT_ID}, ID нового владельца - {=Document:ESCALATED_TO_ID}, Цвет чата - RED. При эскалации задачи робот передаёт чат новому ответственному и меняет цвет на красный для привлечения внимания к срочной задаче.
Обновление названия чата с датой создания	Параметры: ID чата - {=Variable:CHAT_ID}, Новое название - "Чат от {{=date('d.m.Y', {=Variable:CREATED_DATE})}}". Робот обновляет название чата, добавляя дату его создания для удобства навигации по истории чатов.
Изменение цвета чата в зависимости от статуса проекта	Параметры: ID чата - {=Variable:PROJECT_CHAT_ID}, Цвет чата - {{=if({=Document:STATUS_ID}=="ACTIVE", "GREEN", "GRAY")}}. Робот автоматически меняет цвет чата в зависимости от статуса проекта: зелёный для активных, серый для завершённых.
Обновление названия и владельца при смене ответственного за сделку	Параметры: ID чата - {=Variable:DEAL_CHAT_ID}, ID нового владельца - {=Document:ASSIGNED_BY_ID}, Новое название - "Чат по сделке {=Document:TITLE}". При смене ответственного за сделку робот обновляет владельца чата и синхронизирует название с текущим названием сделки.
Установка корпоративного аватара для всех новых чатов отдела	Параметры: ID чата - {=Activity789:return_id_chat}, Путь к файлу аватара - "https://company.com/logos/department_logo.png". При создании нового чата отдела робот автоматически устанавливает корпоративный логотип отдела в качестве аватара для единообразия визуального стиля.

Сценарий работы активити бизнес-процесса

Активити "Обновление чата" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Смена владельца чата при передаче проекта или задачи другому сотруднику;
• Синхронизация названия чата с названием связанной сущности (сделка, проект, задача);
• Визуальное разделение чатов по приоритетам или статусам через изменение цвета;
• Установка корпоративных аватаров для чатов отделов или проектов;
• Массовое обновление параметров чатов при реорганизации структуры компании;
• Автоматическое обновление названий чатов при изменении статусов или приоритетов;
• Эскалация чатов с изменением владельца и визуального оформления;
• Персонализация чатов с установкой индивидуальных аватаров и цветов.

Особенности работы с параметрами обновления:
- Можно указать только один параметр для обновления (например, только название);
- Можно указать несколько параметров одновременно (например, название и цвет);
- Все указанные параметры будут обновлены в рамках одного вызова активити;
- Если ни один параметр обновления не указан, активити вернёт ошибку;

Лучшие практики использования обновления чатов:
1. Всегда проверяйте права доступа перед обновлением чата (убедитесь, что пользователь является владельцем);
2. Не пытайтесь изменять аватар у чатов, привязанных к CRM сущностям;
3. Используйте переменные для хранения ID чатов для последующего обновления;
4. Сохраняйте return_id_chat из активити создания чата для дальнейшего использования;
5. Комбинируйте несколько параметров обновления для комплексного изменения чата;
6. Используйте цвета для визуального разделения чатов по категориям или приоритетам;
7. Синхронизируйте названия чатов с названиями связанных сущностей для удобства навигации;
8. При смене владельца убедитесь, что новый владелец имеет необходимые права доступа.

Получение ID чата по сущности

Данное активити (робот) позволяет получить ID чата по сущности.
Результатом работы является ID чата, который можно использовать в других активити для работы с чатами (например, отправка сообщений, обновление чата и т.д.).

Как работает активити (робот):
- Вы выбираете Тип чата и указываете ID сущности;
- Для CRM можно дополнительно выбрать Тип CRM сущности, чтобы упростить заполнение;
- Активити выполняет запрос im.chat.get и возвращает ID найденного чата;
- Если чат по указанной сущности не найден, активити завершится с ошибкой.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип чата	Определяет, как формировать запрос к im.chat.get. Доступные значения: - CRM - чат, привязанный к CRM сущности; - LINES - чат открытой линии; - LIVECHAT - чат с коллегами.
Тип CRM сущности	Используется только при Тип чата = CRM. Позволяет выбрать тип CRM сущности из списка (лид, сделка, контакт, компания, счета, смарт-процессы и т.д.). Примеры: LEAD, DEAL, DYNAMIC_167.
ID сущности	Идентификатор сущности. Формат зависит от выбранного Типа чата. Тип чата = CRM - Если вы заполняете поле Тип CRM сущности, то можно не заполнять ID сущности - тогда ID будет взят из текущего документа бизнес-процесса. - Если вы заполняете ID сущности вручную, указывайте его так, как он задан в вашей логике процесса (например, из переменной/поля документа). Тип чата = LINES Укажите идентификатор диалога открытой линии в формате Битрикс24. Пример для LINES: - telegrambot|2|209607941|744.

Примеры использования активити (робота)

Описание примера	Решение
CRM: указать ID сущности вручную	Тип чата = CRM, ID сущности заполнен вручную (например, из переменной или поля документа). Активити вернёт chat_id.
CRM: взять ID из текущего документа БП	Тип чата = CRM, Тип CRM сущности = DEAL, ID сущности не заполнять. Активити возьмёт ID из текущего документа и сформирует ENTITY_ID автоматически.
Сделка: получить ID чата и отправить важную информацию	В роботе сделки добавьте шаг 1: "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = DEAL, ID сущности можно не заполнять). Шаг 2: используйте полученный chat_id в активити отправки сообщения, чтобы написать клиенту или коллеге важную информацию по сделке.
Смарт-процесс: получить ID чата по элементу и уведомить участников	В роботе смарт-процесса добавьте "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = нужный смарт-процесс). Далее используйте chat_id для отправки сообщения в чат по элементу смарт-процесса (например, о смене стадии или необходимости действия).
Счет: получить ID чата и отправить реквизиты/статус	В роботе по счету добавьте "Получение ID чата по сущности" (Тип чата = CRM, Тип CRM сущности = счет). После получения chat_id отправьте сообщение с важной информацией: статус оплаты, сумма, срок оплаты или ссылка на счет.
Добавить пользователя в чат по сущности	Сначала получите chat_id через "Получение ID чата по сущности". Затем используйте chat_id в активити добавления пользователя в чат, чтобы подключить нужного сотрудника (например, юриста или бухгалтера) к обсуждению.
LINES: получить чат открытой линии	Тип чата = LINES, ID сущности = telegrambot|2|209607941|744. Активити вернёт chat_id.

Возвращаемые параметры данного активити:
- ID чата (chat_id) - числовой идентификатор чата, найденный по сущности.

Исключение участников из чата

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

Сценарий работы активити бизнес-процесса

ID чата: указывается идентификатор чата, из которого планируется удалить сотрудника(ов).

Удалять сотрудников из чата может только владелец чата, это значит, что активити должно быть запущено от имени владельца чата.
При этом владелец чата должен быть администратором приложения, чтобы активити сработало.

ID пользователя, которого надо оставить: указываются идентификаторы сотрудников, которых необходимо оставить в чате.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.

Возвращаемые параметры для данного активити:
- Успех операции;
- Сообщение об ошибке.

Поиск ID чата по названию или ФИО участников

Данное активити позволяет искать ID чата по названию чата или ФИО участников при помощи бизнес-процесса.
Результатом работы данного активити будет получение ID чата в виде массива для итератора, строки и соответствия условиям поиска.

Сценарий работы активити бизнес-процесса 

Поисковая фраза: в данном поле указывается название чата или ФИО его участников.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Возвращаемые параметры данного активити:
- Результат поиска (Массив для интегратора)
- Результат поиска (строка)
- Соответствует условиям

Поиск чатов

Активити (робот) "Поиск чатов" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Получение списка последних чатов и диалогов текущего пользователя;
• Отбор только непрочитанных диалогов для дальнейшей обработки в БП;
• Поиск групповых чатов или личных диалогов по типу;
• Фильтрация чатов по названию и тексту последнего сообщения;
• Автоматическая выборка всех доступных чатов с постраничной загрузкой;
• Поиск чатов открытых линий через тип чата;
• Получение ID чатов для массовых операций (добавление участников, отправка сообщений и т.д.).

Как работает активити (робот):
- Активити получает список последних диалогов пользователя;
- Фильтры задаются параметрами активити: тип чата, непрочитанные, открытые линии и др.;
- Дополнительно можно отфильтровать результат по названию, типу чата, закреплению и непрочитанным сообщениям;
- Активити автоматически загружает все страницы списка чатов;
- В ответ возвращаются ID чатов в виде массива, строки, первого и последнего ID;
- Если список не успел полностью загрузиться по времени, в параметре "Есть следующая страница" (has_more) будет Y.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип чата	Чат один на один, групповой чат, чат открытой линии, Чат с BitrixGPT или все типы. При выборе «Чат открытой линии» или «Чат с BitrixGPT» параметр «Только каналы» игнорируется.
Только с непрочитанными	Возвращает только диалоги с непрочитанными сообщениями. Пример: Да.
Только каналы	Оставляет в выборке только каналы. Пример: Да.
Пропускать нераспределенные открытые линии	Исключает нераспределенные чаты открытых линий.
Только с правом управления сообщениями	Оставляет чаты, где пользователь может управлять сообщениями.
Искать в последнем сообщении	Фильтр по тексту последнего сообщения в диалоге. Поддерживаются операторы поиска. Примеры: - ={%счет%} — содержит «счет»; - ={!%спам%} — не содержит «спам»; - ={@срочно,важно} — точное совпадение с одним из значений.
Дата последнего сообщения	Ограничивает выборку чатов по дате последнего сообщения (LAST_MESSAGE_DATE). Пример: {=System:Now}, {=Variable:LAST_CHAT_DATE}.
Поиск по названию	Фильтр по названию чата или диалога. Поддерживаются те же операторы поиска. Пример: ={%Маркетинг%}.
Закрепленные диалоги / Наличие непрочитанных	Дополнительная фильтрация после получения списка: Да — только с признаком, Нет — только без признака.
Ограничение количества результатов	Ограничивает итоговый список ID чатов после всех фильтров. Пример: 10.

Примеры использования активити (робота)

Описание примера	Решение
Получить все непрочитанные чаты пользователя, исключая открытые линии	Только с непрочитанными = Да. Используйте параметр "Массив ID чатов" (search_results_array) для дальнейших шагов БП.
Найти непрочитанные чаты открытых линий	Тип чата = Чат открытой линии, Только с непрочитанными = Да.
Найти чаты с активностью после указанной даты	Дата последнего сообщения = {=dateadd({=System:Now}, "-7d")}, Тип чата = Групповой чат.
Найти групповой чат по части названия "Маркетинг"	Поиск по названию = ={%Маркетинг%}, Тип чата = Групповой чат.
Найти чаты, где в последнем сообщении упоминается «договор»	Искать в последнем сообщении = ={%договор%}.
Исключить чаты с последним сообщением «спам»	Искать в последнем сообщении = ={!%спам%}.
Получить только личные диалоги с непрочитанными сообщениями	Только с непрочитанными = Да, Тип чата = Чат один на один.
Выбрать первые 5 чатов из последних активных	Ограничение количества результатов = 5. Первый ID — в параметре "Строка ID через запятую" (search_result_first_string).
Отобрать только закрепленные групповые чаты	Тип чата = Групповой чат, Закрепленные диалоги = Да.
Найти чаты с BitrixGPT для автоматизации	Тип чата = Чат с BitrixGPT.
Контроль чатов без непрочитанных сообщений	Наличие непрочитанных = Нет. Если значение параметра "Количество найденных чатов" (count_search) = 0 — ветка «чаты не найдены».
Массовая отправка уведомления в найденные чаты	Только с непрочитанными = Да. Передайте значение параметра "Массив ID чатов" (search_results_array) в цикл и используйте идентификатор чата в роботе отправки сообщения.
Выборка чатов с правом управления сообщениями для модерации	Только с правом управления сообщениями = Да, Тип чата = Групповой чат.

Возвращаемые параметры данного активити:
- Условие выполнено (math_search_results) — Y или N;
- Количество найденных чатов (count_search);
- Массив ID чатов (search_results_array);
- Строка ID через запятую (search_results_string);
- Первый ID чата (search_result_first_string);
- Последний ID чата (search_result_last_string);
- Есть следующая страница (has_more) — Y или N;
- Журнал (s_error_logs).

Добавление пользователя в чат открытой линии по CRM сущности

Данное активити позволяет искать ID чата открытой линии по сущности CRM и добавлять туда пользователя при помощи бизнес-процесса.

Сценарий работы активити бизнес-процесса

Тип CRM сущности: в данном поле указывается тип сущности CRM, к которой привязан чат, в который планируется добавлять пользователя.

ID CRM сущности: в данном поле указывается идентификатор сущности CRM к которой привязан чат.

С помощью данного активити НЕЛЬЗЯ добавлять пользователей в обычный чат, только в чат открытых линий.
Так же, другие активити для работы с обычными (открытыми/закрытыми) чатами не совместимы с данным активити.

ID пользователя или бота: в данном поле указывается ID бота или пользователя, которого нужно добавить в чат.

Указывается только один ID бота или пользователя.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Добавление участников в чат

Данное активити позволяет добавлять участников чата, указав ID чата в который необходимо добавить и ID новых участников этого чата.

Сценарий работы активити бизнес-процесса

ID чата: в данном поле указывается ID чата.
Получить данный параметр можно их возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

Добавление участников в чат(указать одного или более пользователя): в данном поле указывается ID участников чата.

ID участника нужно указывать с использованием квадратных скобок. Пример: [12345].

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Сообщение чата

Получение сообщений из чата

Данное активити (робот) предназначено для поиска одного сообщения по ID внутри указанного диалога Битрикс24.
Результатом работы является набор отдельных полей сообщения: автор, дата, текст, статус прочтения, а также текст результата выполнения.

Как работает активити (робот):
- Вы указываете ID чата и ID сообщения;
- Активити (робот) делает постраничные запросы im.dialog.messages.get (по 50 сообщений);
- Если сообщение найдено, активити (робот) возвращает его данные в отдельных полях;
- Если сообщение не найдено в указанном чате, поля сообщения будут пустыми, а текст результата сообщит об этом.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID чата	Обязательный параметр. Идентификатор чата или диалога. Примеры: - chat1489 — обычный чат; - sg25 — чат группы/проекта; - 503 — личный чат с пользователем.
ID сообщения	Обязательный параметр. Целочисленный идентификатор сообщения, которое нужно найти в указанном чате. Пример: 493997.

Примеры использования активити (робота)

Описание примера	Решение
Получить данные конкретного сообщения в рабочем чате	Передайте ID чата как chat1489 и ID сообщения 493997. Активити вернет автора, дату, текст, статус прочтения и текст результата.
Проверить сообщение в чате проекта	Передайте ID чата как sg25 и ID сообщения 120045. Используйте параметр "Текст сообщения" в условии следующего шага для проверки ключевой фразы.
Получить сообщение из личного диалога с сотрудником	Передайте ID чата как 503 (личный чат) и ID сообщения 88991. Используйте значения параметра "Автор сообщения" для проверки, кто отправил сообщение.
Проверить, прочитано ли сообщение	Передайте chat1489 и нужный ID сообщения. В параметре "Статус прочтения" вернется значение: N или Y, его можно использовать в ветвлении БП.
Контроль отсутствия сообщения	Если сообщение не найдено в указанном чате, параметр "Текст результата и ошибок" вернет текст "Сообщение с указанным ID в этом чате не найдено.", что удобно для обработки ошибок.

Возвращаемые параметры данного активити:
- Автор сообщения (author_id);
- Дата создания (date);
- Текст сообщения (text);
- Статус прочтения (unread);
- Текст результата и ошибок (s_error_logs).

Статус прочтения в поле unread возвращается в формате Y/N согласно логике активити (робота).

Поиск сообщений в чате

Данное активити (робот) позволяет выполнить поиск сообщений в чате Битрикс24.
Результатом работы является список найденных сообщений, их тексты и служебные данные (пользователи, файлы, реакции).

Как работает активити (робот):
- Вы указываете ID чата;
- При необходимости задаете строку поиска, период, сортировку, лимит и LAST_ID для пагинации;
- Активити выполняет запрос im.dialog.messages.search;
- В ответ возвращаются найденные сообщения и стандартные поля списка для дальнейшей обработки в БП.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID чата	Обязательный параметр. Числовой идентификатор чата, где выполняется поиск сообщений. Пример: 2421.
Строка поиска	Необязательный параметр. Поиск по тексту сообщений. Рекомендуется использовать строку длиной от 3 символов. Пример: "договор", "счет", "оплата".
Дата начала периода / Дата конца периода	Необязательные параметры. Ограничивают поиск указанным диапазоном дат. Формат: ISO 8601 (RFC3339).
Точная дата	Необязательный параметр. Поиск выполняется в пределах суток указанной даты.
Сортировка по ID	ASC или DESC. По умолчанию DESC.
Лимит сообщений	Необязательный параметр. По умолчанию 50, максимум 200.
LAST_ID для пагинации	Необязательный параметр. Используется для постраничной выборки: укажите ID последнего сообщения из предыдущего результата.

Примеры использования активити (робота)

Описание примера	Решение
Найти все сообщения с ключевым словом за день	Укажите ID чата, строку поиска и точную дату. Получите выборку сообщений и обработайте тексты в следующих шагах БП.
Контроль упоминаний важного слова	Запускайте робот по расписанию с SEARCH_MESSAGE (например, "срочно"), далее проверяйте count_search и отправляйте уведомление при найденных совпадениях.
Постраничный просмотр найденных сообщений	Сохраняйте последний ID из search_result_last_string и передавайте его в LAST_ID для следующего вызова.
Анализ авторов найденных сообщений	Используйте users_json вместе с messages_json, чтобы сопоставить author_id и данные пользователя.
Отдельная обработка сообщений с файлами	Проверяйте count_files и files_json. Если есть вложения, запускайте отдельную ветку БП.

Возвращаемые параметры данного активити:
- Количество найденных сообщений (count_messages);
- Количество пользователей(count_users);
- Количество файлов (count_files);
- Количество реакций (count_reactions);
- JSON с сообщениями, пользователями, файлами и реакциями;
- Тексты сообщений массивом (message_texts_array);
- Стандартные поля поиска : search_results_array, search_results_string, search_result_first_string, search_result_last_string, count_search, math_search_results.

Отправить сообщение в чат от человека

Активити (робот) «Отправить сообщение в чат от человека» предназначено для использования в роботах и может быть полезно в следующих сценариях: отправка личного сообщения коллеге от имени сотрудника, публикация текста в групповой чат от имени ответственного, уведомление участников чата CRM-сущности и автоматическая переписка в рамках бизнес-процесса без участия чат-бота.
Сообщение отправляется от имени пользователя, указанного в поле «Запускать от имени» активити (робота). В чате оно отображается как обычное сообщение сотрудника, а не системное уведомление и не сообщение бота.

Как работает активити (робот):
- Вы выбираете Куда отправить сообщение: личный диалог с сотрудником или групповой чат;
- Указываете ID чата (ID сотрудника или числовой ID чата) и Текст сообщения;
- Активити (робот) выполняет отправку от имени пользователя из поля «Запускать от имени»;
- Сообщение появляется в выбранном диалоге как обычная реплика сотрудника.

Сценарий работы активити бизнес-процесса

Важно:
- Отправитель определяется полем «Запускать от имени». У этого сотрудника должны быть права на отправку сообщений в выбранный чат;
- При выборе «Сотруднику» в поле ID чата указывается ID пользователя, а не ID группового чата;
- При выборе «В чат» указывается только числовой ID чата (без префикса chat);
- Активити (робот) не возвращает ID отправленного сообщения и не ожидает ответа собеседника.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Куда отправить сообщение	Обязательный параметр. Определяет тип получателя. Доступные значения: - Сотруднику — личный диалог с указанным пользователем; - В чат — сообщение в групповой или служебный чат по числовому ID.
ID чата	Обязательный параметр. Значение зависит от поля «Куда отправить сообщение». Если выбрано «Сотруднику»: - {=Document:ASSIGNED_BY_ID} — ответственный по сущности; - {=User:ID} — текущий пользователь; - 25 или [U25] — конкретный сотрудник. Если выбрано «В чат»: - {=Variable:CHAT_ID} — ID из предыдущего шага (например, робота «Получение ID чата по сущности»); - 1489 — числовой ID группового чата (без префикса chat).
Текст сообщения	Обязательный параметр. Текст, который увидят участники диалога. Примеры: - Сделка {=Document:ID} переведена на стадию «Согласование». Проверьте условия до {{=dateadd({=System:Now}, "1d")}}; - Коллеги, прошу согласовать документ по элементу {=Document:TITLE}; - {=Variable:NOTIFY_TEXT} — текст из переменной предыдущего шага.
Запускать от имени	Стандартное поле активити (робота). Определяет, от чьего имени будет отправлено сообщение. Рекомендуется выбирать сотрудника с правами администратора или сотрудника, который реально должен быть автором сообщения в переписке.

Примеры использования активити (робота)

Описание примера	Решение
Уведомить ответственного по сделке в личный чат	Куда отправить = Сотруднику, ID чата = {=Document:ASSIGNED_BY_ID}, Текст = Сделка {=Document:TITLE} требует вашего внимания.
Написать коллеге от имени руководителя	Запускать от имени = руководитель отдела, Куда отправить = Сотруднику, ID чата = {=Variable:EMPLOYEE_ID}, Текст = Подготовь отчёт по сделке {=Document:ID} до {{=dateadd({=System:Now}, "2d")}}.
Отправить сообщение в чат CRM-сущности	Сначала получите chat_id роботом «Получение ID чата по сущности». Затем: Куда отправить = В чат, ID чата = {=Variable:CHAT_ID}, Текст = Обновлена стадия элемента {=Document:TITLE}.
Оповестить групповой чат проекта	Куда отправить = В чат, ID чата = {=Variable:PROJECT_CHAT_ID}, Текст = Задача по проекту {=Variable:PROJECT_NAME} переведена в работу.
Напомнить себе о просроченной задаче	Куда отправить = Сотруднику, ID чата = {=User:ID}, Текст = Напоминание: задача {=Variable:TASK_TITLE} просрочена с {{=date({=Variable:DEADLINE}, "d.m.Y")}}.
Сообщить инициатору процесса о завершении шага	Куда отправить = Сотруднику, ID чата = {=Template:TargetUser}, Текст = Шаг согласования по {=Document:TITLE} выполнен {{=date({=System:Now}, "d.m.Y H:i")}}.
Отправить текст в чат после поиска чатов	Робот «Поиск чатов» возвращает search_result_first_string. Куда отправить = В чат, ID чата = {=Variable:CHAT_ID}, Текст = Новое обращение по клиенту {=Document:TITLE}.
Уведомить наблюдателя сделки	Куда отправить = Сотруднику, ID чата = {=Variable:OBSERVER_ID}, Текст = По сделке {=Document:TITLE} изменена сумма: {=Document:OPPORTUNITY}.
Опубликовать итог согласования в рабочем чате	Куда отправить = В чат, ID чата = 2156, Текст = Согласование завершено. Решение: {=Variable:APPROVAL_RESULT}. Ссылка: {=System:HostUrl}/crm/deal/details/{=Document:ID}/.
Отправить персональное сообщение новому сотруднику	Куда отправить = Сотруднику, ID чата = {=Variable:NEW_USER_ID}, Текст = Добро пожаловать в команду! Ваш наставник: {=Variable:MENTOR_NAME}.

Отличие от активити «Создание сообщения в чат от робота»:
«Отправить сообщение в чат от человека» пишет от имени сотрудника и не требует чат-бота. «Создание сообщения в чат от робота» отправляет сообщение от чат-бота, поддерживает кнопки и может ожидать ответ пользователя.

Создание сообщения в чат от робота

Активити (робот) «Создание сообщения в чат от робота» предназначено для использования в роботах и может быть полезно в следующих сценариях: автоматические ответы в чатах открытых линий, диалоги с кнопками выбора, отправка уведомлений от чат-бота без ожидания ответа и сбор ответа пользователя для дальнейшей обработки в бизнес-процессе.
Сообщение отправляется от имени указанного чат-бота. Активити (робот) поддерживает паузу с индикатором набора текста, до трёх кнопок в одном сообщении и три режима работы — с ожиданием ответа и без него.

Как работает активити (робот):
- Указываете ID чат-бота, ID чата (или он определяется автоматически из последнего события бота) и Текст сообщения;
- Выбираете Вариант работы чат-бота: без кнопок с ожиданием, без кнопок без ожидания или с кнопками и ожиданием нажатия;
- При необходимости задаёте Паузу перед отправкой — перед отправкой показывается индикатор «печатает»;
- В режимах с ожиданием бизнес-процесс приостанавливается до ответа пользователя или нажатия кнопки.

Сценарий работы активити бизнес-процесса

Важно:
- На портале должен быть создан и установлен чат-бот, его ID указывается в параметре «ID чат-бота»;
- Если поле «ID чата» не заполнено, активити (робот) попытается взять ID чата из последнего события ONIMBOTMESSAGEADD для указанного бота;
- В режиме «с кнопками и ожидать ответ» заполняется хотя бы одна кнопка; при нажатии возвращается номер нажатой кнопки;
- В режиме «без кнопок и ожидать ответ» возвращается текст ответа пользователя в поле answer_user;
- Пауза перед отправкой блокирует выполнение робота на указанное количество секунд — используйте её умеренно в массовых сценариях.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID чат-бота	Обязательный параметр. Числовой идентификатор чат-бота на портале. Примеры: - {=Variable:BOT_ID} — ID из переменной или предыдущего шага; - 15 — фиксированный ID бота техподдержки.
ID чата	Необязательный параметр. Числовой идентификатор чата, куда отправляется сообщение. Примеры: - {=Variable:CHAT_ID} — из робота «Получение ID чата по сущности»; - 1489 — ID группового чата; - оставить пустым — если робот запущен в контексте диалога с ботом, ID может определиться автоматически из последнего события ONIMBOTMESSAGEADD.
Вариант работы чат-бота	Обязательный параметр. Доступные значения: - отправить сообщение без кнопок и ожидать ответ — БП ждёт текстовый ответ пользователя; - отправить сообщение без кнопок и не ожидать ответа — сообщение отправляется, БП продолжается сразу; - отправить сообщение с кнопками и ожидать ответ — БП ждёт нажатия одной из кнопок.
Текст сообщения	Обязательный параметр. Текст, который увидит пользователь в чате. Примеры: - Здравствуйте! Уточните, пожалуйста, номер вашего заказа; - Обращение {=Document:ID} принято в работу. Ожидайте ответа специалиста; - {=Variable:BOT_MESSAGE} — текст из переменной.
Пауза перед отправкой сообщения (в секундах)	Необязательный параметр. Перед отправкой бот показывает индикатор «печатает» и ждёт указанное время. Примеры: 3 — короткая пауза для естественности диалога; 10 — дать пользователю прочитать предыдущее сообщение.
Название кнопки 1 / 2 / 3	Необязательные параметры. Используются только при варианте «с кнопками и ожидать ответ». Заполните от одной до трёх кнопок. Примеры: Да, Нет, Перезвоните позже; Согласовано, На доработку, Отмена.
Стиль кнопки 1 / 2 / 3	Необязательный параметр для каждой кнопки. Предустановленные стили интерфейса Битрикс24: Базовый, Основной, Вторичный, Предупреждение. Если стиль не указан, используется «Базовый».
Цвет кнопки 1 / 2 / 3	Необязательный параметр. Устаревший способ задания цвета в формате HEX без решётки (например, d2f95f). При наличии «Стиля кнопки» предпочтительнее использовать стиль.

Примеры использования активити (робота)

Описание примера	Решение
Приветствие в открытой линии без ожидания ответа	ID чат-бота = {=Variable:BOT_ID}, ID чата = {=Variable:CHAT_ID}, Вариант = без кнопок и не ожидать ответа, Текст = Добрый день! Мы получили ваше обращение и скоро ответим.
Запросить у клиента номер заказа и дождаться ответа	Вариант = без кнопок и ожидать ответ, Текст = Укажите, пожалуйста, номер заказа. После ответа используйте {=Variable:answer_user} в следующем шаге.
Согласование через кнопки «Да» и «Нет»	Вариант = с кнопками и ожидать ответ, Название кнопки 1 = Да, Стиль = Основной, Название кнопки 2 = Нет, Стиль = Предупреждение, Текст = Подтверждаете выполнение заявки {=Document:ID}?
Три варианта ответа для оператора	Кнопка 1 = Принято, Кнопка 2 = Передано специалисту, Кнопка 3 = Отложено, Текст = Выберите статус обработки обращения. Проверяйте button_pressed: 1, 2 или 3.
Отправка с паузой «печатает»	Пауза = 5, Вариант = без кнопок и не ожидать ответа, Текст = Формирую ответ по вашему запросу...
Сообщение в чат CRM-сущности	ID чата = {=Variable:CHAT_ID} из робота «Получение ID чата по сущности», Вариант = без кнопок и не ожидать ответа, Текст = По элементу {=Document:TITLE} назначен ответственный {=Document:ASSIGNED_BY_ID}.
Автоопределение чата из диалога с ботом	ID чат-бота = 15, ID чата оставить пустым, Вариант = без кнопок и ожидать ответ, Текст = Уточните тему обращения. Чат определится из последнего события бота.
Обработка ответа пользователя в переменную	После шага с ожиданием ответа сохраните answer_user в переменную {=Variable:CLIENT_REPLY} и используйте в условии или следующем роботе.
Разветвление БП по нажатой кнопке	После шага с кнопками добавьте условие: если button_pressed = 1 — ветка «Согласовано», если 2 — «Отклонено», если 3 — «Отложено».
Уведомление в групповой чат проекта от бота	ID чат-бота = {=Variable:PROJECT_BOT}, ID чата = 2156, Вариант = без кнопок и не ожидать ответа, Текст = Статус проекта обновлён: {=Variable:STATUS_TEXT}.

Важно о возвращаемых параметрах:
- В режиме «без кнопок и не ожидать ответа» поля answer_user и button_pressed будут пустыми;
- В режиме с кнопками button_pressed содержит номер нажатой кнопки (1, 2 или 3);
- Поле id_chat возвращает числовой ID чата, в который было отправлено сообщение.

Возвращаемые параметры данного активити:
- Ответ пользователя (answer_user) — текст ответа в режиме ожидания без кнопок;
- Какая кнопка нажата (button_pressed) — номер кнопки (1, 2 или 3) в режиме с кнопками;
- ID привязанной сущности (document_id) — ID документа, связанного с контекстом диалога;
- ID чата (id_chat) — числовой идентификатор чата, куда отправлено сообщение.

Удалить сообщение в чате

Данное активити (робот) позволяет удалить сообщение в чате Битрикс24.
Результатом работы является признак успешного удаления сообщения.

Важно:
Удалить сообщение может автор сообщения или администратор общего чата. Если прав недостаточно или истек допустимый срок редактирования, активити вернет ошибку.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID сообщения	Обязательный параметр. Числовой идентификатор сообщения, которое нужно удалить. Пример: 34247. Идентификатор можно получить из результатов роботов получения/поиска сообщений в чате.

Примеры использования активити (робота)

Описание примера	Решение
Удалить служебное сообщение с тестовым текстом	Сначала найдите сообщение через "Поиск сообщений в чате", затем передайте найденный ID в этот робот для удаления.
Очистка ошибочно отправленного уведомления	Сохраните ID отправленного сообщения после шага отправки и при условии ошибки процесса вызовите удаление этого сообщения.
Автоматическое удаление временных сообщений	В сценарии с задержкой храните MESSAGE_ID в переменной и удаляйте сообщение после выполнения целевого шага.

Возвращаемые параметры данного активити:
- Сообщение удалено (delete_result) — Y при успешном удалении;
- Лог выполнения (s_error_logs);
- Успех операции (ok_ready).

Изменить сообщение в чате

Данное активити (робот) позволяет изменить сообщение в чате Битрикс24.
Результатом работы является признак успешного изменения сообщения.

Важно:
Изменять сообщение может только автор сообщения. При отсутствии прав или если истек допустимый срок редактирования активити завершится с ошибкой.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID сообщения	Обязательный параметр. Идентификатор сообщения для изменения. Пример: 34239.
Новый текст сообщения	Новый текст сообщения. Если передать пустое значение, сообщение будет удалено методом API.
ATTACH (JSON или N)	Вложение сообщения. Для удаления вложений можно передать N.
KEYBOARD (JSON или N)	Кнопки под сообщением. Для отключения кнопок можно передать N.
MENU (JSON или N)	Пункты контекстного меню. Для отключения можно передать N.
URL_PREVIEW	Y/N — включение или отключение rich-просмотра ссылок.
IS_EDITED	Y/N — отмечать ли сообщение как измененное.

Примеры использования активити (робота)

Описание примера	Решение
Исправить текст ошибочно отправленного сообщения	Передайте ID сообщения и новый текст в поле "Новый текст сообщения".
Убрать кнопки у старого сообщения	Передайте ID сообщения и значение N в поле KEYBOARD.
Скрыть пункты контекстного меню	Передайте ID сообщения и значение N в поле MENU.
Отключить предпросмотр ссылок	Передайте URL_PREVIEW = N при обновлении текста сообщения.
Удалить сообщение через обновление	Передайте пустое значение в поле "Новый текст сообщения".

Возвращаемые параметры данного активити:
- Сообщение изменено (update_result) — Y при успешном изменении;
- Лог выполнения (s_error_logs);
- Успех операции (ok_ready).

Создать объект на основании сообщения в чате

Данное активити (робот) позволяет создать объект на основании сообщения в чате Битрикс24.
Результатом работы является признак успешного создания объекта.

Как работает активити (робот):
- Вы указываете ID сообщения и ID диалога;
- Выбираете тип создаваемого объекта: чат, задача, пост или событие календаря;
- Активити выполняет запрос im.message.share;
- В случае успеха возвращает признак успешного создания объекта.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID сообщения	Обязательный параметр. Идентификатор сообщения, на основании которого создается объект. Пример: 34261.
ID диалога	Обязательный параметр. Идентификатор чата/диалога. Форматы: chatXXX, sgXXX или ID пользователя личного чата. Пример: chat2941.
Тип создаваемого объекта	Обязательный параметр. Доступные значения: - CHAT — чат; - TASK — задача; - POST — пост в ленте; - CALEND — событие календаря.

Примеры использования активити (робота)

Описание примера	Решение
Создать задачу на основании сообщения клиента	Передайте ID сообщения, DIALOG_ID чата клиента и TYPE = TASK, чтобы сформировать задачу из обсуждения.
Сделать публикацию в ленте из важного сообщения	Передайте TYPE = POST, чтобы создать пост в живой ленте на основе выбранного сообщения.
Создать событие календаря из сообщения с договоренностью	Передайте TYPE = CALEND и используйте это в сценариях планирования встреч.
Вынести обсуждение в отдельный чат	Передайте TYPE = CHAT, чтобы создать отдельный чат по конкретному сообщению.

Возвращаемые параметры данного активити:
- Объект создан (share_result) — Y при успешном выполнении;
- Лог выполнения (s_error_logs);
- Успех операции (ok_ready).

Боты

Выход чат-бота из указанного чата

Данное активити позволяет вывести чат-бота из указанного диалога при помощи бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID чата: в данном поле указывается ID чата из которого планируется вывести бота.
Получить данный параметр можно их возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

ID бота: в данном поле указывается ID бота выводимого из чата.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID.

ID нового владельца чата: в данном поле указывается ID пользователя, которого бот добавил в чат вместо себя.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Создание Чат-бота

Данное активити позволяет добавить чат-бота в ваш портал, чтобы потом вести диалоги от него через бизнес-процессы.

Сценарий работы активити бизнес-процесса

ID чата (если хотите добавить туда бота): в данном поле указывается ID чата, в который планируется добавить бота.
Получить данный параметр можно из возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

Код бота: в данном поле указывается уникальный идентификатор (латиницей), по которому можно распознать бота.

Имя бота: в данном поле указывается имя бота, которого планируется создать (латиницей)…

Для открытых линий: в данном поле указывается, будет работать робот в открытых линиях или нет.

Чат-боты для открытых линий не поддерживают работу с кнопками из активити "создание сообщения в чат от робота"

Цвет бота: в данном поле указывается цвет используемый  для иконки бота или диалогового окна.

Почта для связи (если сообщение не прочитано, то отправиться на почту): в данном поле указывается e-mail на который будут присылаться уведомления, если бот недоступен.

ВАЖНО!
НЕЛЬЗЯ ИСПОЛЬЗОВАТЬ email зарегистрированного сотрудника на портале, для регистрации БОТА, нужно использовать технический адрес почты, не фигурирующий на портале.

Аватар бота (ссылка на картинку): в данном поле указывается ссылка на публично доступное изображение.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака.
Ограничение на тип изображений и их размер регулируются настройками портала.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

 Возвращаемые параметры для данного активити:
-ID созданного чат-бота

Смена владельца чата от лица чат-бота

Данное активити позволяет сменить владельца чата на другого от лица чат-бота.

Сценарий работы активити бизнес-процесса

ID чата: в данном пункте указывается ID чата, владельца которого надо сменить.

Новый владелец чата: в данном пункте указывается ID нового владельца чата.

ID чат-бота:в данном пункте указывается ID чат-бота, который участвует в чате, и от имени которого должна произойти смена владельца.

Чат-бот, от имени которого происходит смена владельца чата, должен быть его владельцем.
Данное активити можно использовать только для смены владельца чата с чат-бота на сотрудника или другого чат-бота.
Если владельцем чата является сотрудник, то данное активити не сможет сделать владельцем чата чат-бота из-за особенностей метода REST Б24.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех смены владельца

Удаление чат-бота

Данное активити позволяет удалить чат-бота, указав его данные.
Активити ищет бота последовательно по указанным данным и если находит, то удаляет бота.

Сценарий работы активити бизнес-процесса

ID бота: в данном поле указывается ID бота, которого надо удалить.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID

Код бота: в данном поле указывается код бота, которого надо удалить.
Данный код указывается при создании чат-бота, т.е тот, кто его создавал должен знать этот код. 

Имя бота: в данном поле указывается имя бота, которого надо удалить.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- успех удаления чат-бота.

Уведомления

Отправить персональные уведомления пользователям Битрикс24

Данное активити (робот) позволяет отправлять персональные уведомления пользователям Битрикс24.
Результатом работы является отправка персонального уведомления указанному пользователю с возможностью настройки тегов и вложений.

Описание параметров активити

Название поля	Описание и примеры использования
ID пользователя получателя уведомления	В данном поле указывается числовой идентификатор пользователя, которому будет отправлено персональное уведомление. Это обязательный параметр. Пример: {=Document:ASSIGNED_BY_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 1, 25, 100; - Формат с префиксом: [U1], [U25]; - Можно использовать переменные из предыдущих активити или полей сущности. Как получить ID пользователя-получателя: - Из полей CRM-сущностей (ответственный, контакт и т.д.); - Из результатов активити поиска пользователей; - Использовать текущего пользователя через системные переменные; - Из справочника сотрудников портала.
Текст персонального уведомления	В данном поле указывается текст персонального уведомления, который увидит пользователь. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:MESSAGE_TEXT}. Форматирование текста уведомления: - Можно использовать BB-коды: [b]жирный[/b], [i]курсив[/i], [u]подчёркнутый[/u]; - Поддерживается HTML-разметка для более сложного форматирования; - Можно вставлять ссылки на элементы CRM, задачи, файлы; - Доступны переменные и поля из текущей сущности; - Персональные уведомления могут содержать обращение к пользователю по имени.
Текст уведомления для почты	В данном поле можно указать альтернативный текст уведомления, который будет использоваться при отправке на email. Это необязательный параметр. Если не задано, то используется поле "Текст уведомления". Пример: {=Variable:EMAIL_TEXT}. Когда использовать отдельный текст для почты: - Если основной текст содержит BB-коды, которые некорректно отображаются в email; - Когда нужен более развёрнутый текст для почтового уведомления; - Для добавления дополнительных ссылок и контактов в email-версию; - Если нужен упрощённый текст без форматирования для почты.
Тег уведомления	В данном поле указывается тег, уникальный в рамках системы. Это необязательный параметр, но очень важный для контроля дублирования уведомлений. Пример: {=Variable:NOTIFICATION_TAG} или "PERSONAL_DEAL_123". Важно (особенности работы тегов): При добавлении уведомления с существующим тегом другие уведомления с таким же тегом будут удалены. Это позволяет избежать дублирования однотипных уведомлений у пользователя. Примеры использования тегов: - TAG="PERSONAL_DEAL_123" - для персональных уведомлений о конкретной сделке; - TAG="PERSONAL_TASK_456" - для личных напоминаний о задаче; - TAG="WELCOME_MESSAGE" - для приветственных сообщений; - TAG="BIRTHDAY_GREETING_2025" - для персональных поздравлений. Если отправить новое уведомление с тем же тегом, старое уведомление с этим тегом удалится автоматически.
Дополнительный тег	В данном поле указывается дополнительный тег, без проверки на уникальность. Это необязательный параметр. Используется для дополнительной классификации уведомлений. Пример: {=Variable:SUB_TAG} или "TYPE|PERSONAL". Отличие от основного тега: - Основной тег (TAG) - проверяется на уникальность, удаляет предыдущие уведомления с таким же тегом; - Дополнительный тег (SUB_TAG) - НЕ проверяется на уникальность, используется только для группировки. Примеры использования дополнительного тега: - SUB_TAG="TYPE|PERSONAL" - тип персонального сообщения; - SUB_TAG="CATEGORY|GREETING" - категория приветствий; - SUB_TAG="EVENT|BIRTHDAY" - событие день рождения; - SUB_TAG="PRIORITY|HIGH" - высокий приоритет.
Вложение	В данном поле можно указать вложение к уведомлению в формате Битрикс24. Это необязательный параметр. Используется для передачи структурированных данных в уведомлении. Пример: {=Variable:ATTACH}. Формат вложений: Вложения передаются в специальном формате Битрикс24 Attach, который позволяет создавать изображения, ссылки, файлы, сетки с данными, форматированные блоки информации. Подробнее о формате вложений можно узнать в документации Битрикс24 REST API (раздел im.attach).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. Важно: ID отправителя берётся из поля "Запускать от имени". Уведомление будет отправлено от имени пользователя, указанного в этом поле.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Примеры использования активити

Описание примера	Решение
Поздравление с днём рождения	Параметры: ID пользователя получателя - {=Document:ID} (ID сотрудника), Текст персонального уведомления - "🎉 Поздравляем с Днём рождения, {=Document:NAME}! Желаем крепкого здоровья, профессиональных успехов и достижения всех целей!", Текст уведомления для почты - "Уважаемый {=Document:NAME}! От лица всего коллектива поздравляем Вас с Днём рождения! Желаем счастья, здоровья и новых профессиональных достижений.", Тег уведомления - BIRTHDAY_{=Document:ID}_{=Variable:current_year}, Дополнительный тег - EVENT|BIRTHDAY.
Приветствие нового сотрудника	Параметры: ID пользователя получателя - {=Document:ID} (ID нового сотрудника), Текст персонального уведомления - "Добро пожаловать в команду, {=Document:NAME}! 👋 Мы рады видеть Вас в нашей компании. Если возникнут вопросы, обращайтесь к своему наставнику или в отдел кадров.", Текст уведомления для почты - "Здравствуйте, {=Document:NAME}! Добро пожаловать в нашу компанию! В этом письме Вы найдете основную информацию для начала работы...", Тег уведомления - WELCOME_MESSAGE_{=Document:ID}, Дополнительный тег - TYPE|WELCOME.
Персональное напоминание о встрече	Параметры: ID пользователя получателя - {=Document:ATTENDEE_ID} (ID участника встречи), Текст персонального уведомления - "📅 {=Document:ATTENDEE_NAME}, через 30 минут у Вас встреча: '{=Document:EVENT_NAME}'. Место: {=Document:LOCATION}. Не забудьте подготовить необходимые материалы!", Тег уведомления - MEETING_REMINDER_{=Document:EVENT_ID}_{=Document:ATTENDEE_ID}, Дополнительный тег - TYPE|REMINDER.
Благодарность за выполненную работу	Параметры: ID пользователя получателя - {=Document:RESPONSIBLE_ID} (ответственный за задачу), Текст персонального уведомления - "⭐ {=Document:RESPONSIBLE_NAME}, благодарим за отличную работу над задачей '{=Document:TITLE}'! Ваш профессионализм и ответственный подход высоко ценятся командой.", Тег уведомления - THANK_YOU_{=Document:ID}, Дополнительный тег - TYPE|GRATITUDE.
Уведомление о бонусе	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "💰 Отличная новость, {=Document:USER_NAME}! Вам начислен бонус в размере {=Document:BONUS_AMOUNT} руб. за {=Document:REASON}. Продолжайте в том же духе!", Текст уведомления для почты - "Уважаемый {=Document:USER_NAME}! Информируем Вас о начислении премии в размере {=Document:BONUS_AMOUNT} руб. Основание: {=Document:REASON}.", Тег уведомления - BONUS_NOTIFICATION_{=Document:USER_ID}_{=Variable:timestamp}, Дополнительный тег - TYPE|BONUS.
Персональные поздравления с годовщиной работы	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "🎊 {=Document:USER_NAME}, поздравляем с {=Document:YEARS} летним юбилеем работы в компании! Благодарим за преданность и профессионализм!", Тег уведомления - ANNIVERSARY_{=Document:USER_ID}_{=Document:YEARS}, Дополнительный тег - EVENT|ANNIVERSARY.
Индивидуальное информирование о результатах выполнения задач	Параметры: ID пользователя получателя - {=Document:RESPONSIBLE_ID}, Текст персонального уведомления - "✅ Задача '{=Document:TITLE}' успешно выполнена! Результат: {=Variable:RESULT}. Отличная работа!", Тег уведомления - TASK_COMPLETE_{=Document:ID}, Дополнительный тег - TYPE|TASK_STATUS.
Личное напоминание о необходимости выполнения действий	Параметры: ID пользователя получателя - {=Document:ASSIGNED_BY_ID}, Текст персонального уведомления - "⏰ {=Document:ASSIGNED_BY_PRINTABLE}, напоминаем о необходимости выполнить действие по сделке '{=Document:TITLE}'. Срок истекает {{=dateadd({=Document:CLOSEDATE}, '-1d')}}.", Тег уведомления - ACTION_REMINDER_{=Document:ID}, Дополнительный тег - TYPE|REMINDER.
Индивидуальное сообщение при назначении ответственным	Параметры: ID пользователя получателя - {=Document:NEW_ASSIGNED_BY_ID}, Текст персонального уведомления - "👤 {=Document:NEW_ASSIGNED_BY_PRINTABLE}, Вы назначены ответственным за сделку '{=Document:TITLE}'. Сумма: {=Document:OPPORTUNITY} руб.", Тег уведомления - DEAL_ASSIGNED_{=Document:ID}, Дополнительный тег - TYPE|ASSIGNMENT.
Персональное уведомление о достижении цели	Параметры: ID пользователя получателя - {=Document:USER_ID}, Текст персонального уведомления - "🏆 {=Document:USER_NAME}, поздравляем с достижением цели! Вы выполнили план продаж на {=Variable:PERCENT}%. Так держать!", Тег уведомления - GOAL_ACHIEVED_{=Document:USER_ID}_{=Variable:MONTH}, Дополнительный тег - TYPE|ACHIEVEMENT.

Сценарий работы робота

Активити "Отправка персонального уведомления" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Персональные поздравления сотрудников с днём рождения или годовщиной работы;
• Личные напоминания о важных встречах и мероприятиях;
• Индивидуальное информирование о результатах выполнения задач;
• Персональные благодарности и поощрения от руководства;
• Личные уведомления о бонусах, премиях и достижениях;
• Приветственные сообщения для новых сотрудников;
• Персональные напоминания о необходимости выполнения действий;
• Индивидуальные сообщения при назначении ответственным за задачу или сделку.

Отличие персональных уведомлений от системных и сообщений в чат:
- Персональное уведомление (im.notify.personal.add) - личное сообщение от имени конкретного пользователя или с личным обращением;
- Системное уведомление (im.notify.system.add) - официальное уведомление от системы, более формальное;
- Сообщение в чат (imbot.message.add) - требует наличия чат-бота, отображается как сообщение в чате.

Используйте персональные уведомления для:
- Поздравлений и благодарностей;
- Личных обращений к сотрудникам;
- Неформальных напоминаний и уведомлений;
- Сообщений, требующих индивидуального подхода.

Возвращаемые параметры данного активити:
- Статус отправки (send_status) - Y (успешно) или N (ошибка);
- ID уведомления (notification_id) - числовой идентификатор созданного уведомления (для дальнейшего использования);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования персональных уведомлений:
1. Используйте обращение к пользователю по имени для создания дружественной атмосферы;
2. Персонализируйте текст в зависимости от контекста и получателя;
3. Используйте эмодзи для создания более живого и дружелюбного стиля общения;
4. Для важных формальных уведомлений лучше использовать системные уведомления;
5. Применяйте уникальные теги для предотвращения спама и дублирования сообщений.

Отправка системного уведомления

Данное активити (робот) позволяет отправлять системные уведомления пользователям Битрикс24.
Результатом работы является отправка уведомления указанному пользователю с возможностью настройки тегов и вложений.

Описание параметров активити

Название поля	Описание и примеры использования
ID пользователя	В данном поле указывается числовой идентификатор пользователя, которому будет отправлено системное уведомление. Это обязательный параметр. Пример: {=Document:ASSIGNED_BY_ID} или [U1]. Форматы указания пользователя: - Числовой ID: 1, 25, 100; - Формат с префиксом: [U1], [U25]; - Можно использовать переменные из предыдущих активити или полей сущности. Как получить ID пользователя: - Из полей CRM-сущностей (ответственный, контакт и т.д.); - Из результатов активити поиска пользователей; - Использовать текущего пользователя через системные переменные; - Из справочника сотрудников портала.
Текст уведомления	В данном поле указывается текст системного уведомления, который увидит пользователь. Это обязательный параметр. Поддерживается форматирование текста, BB-коды и HTML-разметка. Пример: {=Variable:MESSAGE_TEXT}. Форматирование текста уведомления: - Можно использовать BB-коды: [b]жирный[/b], [i]курсив[/i], [u]подчёркнутый[/u]; - Поддерживается HTML-разметка для более сложного форматирования; - Можно вставлять ссылки на элементы CRM, задачи, файлы; - Доступны переменные и поля из текущей сущности.
Текст для почты	В данном поле можно указать альтернативный текст уведомления, который будет использоваться при отправке на email. Это необязательный параметр. Если не указан, то в email будет отправлен текст из поля "Текст уведомления". Пример: {=Variable:EMAIL_TEXT}. Когда использовать отдельный текст для почты: - Если основной текст содержит BB-коды, которые некорректно отображаются в email; - Когда нужен более развёрнутый текст для почтового уведомления; - Для добавления дополнительных ссылок и контактов в email-версию; - Если нужен упрощённый текст без форматирования для почты.
Тег уведомления	В данном поле указывается уникальный тег уведомления в рамках системы. Это необязательный параметр, но очень важный для контроля дублирования уведомлений. Пример: {=Variable:NOTIFICATION_TAG} или "DEAL_STATUS_123". Важно (особенности работы тегов): При добавлении уведомления с существующим тегом все предыдущие уведомления с таким же тегом будут автоматически удалены. Это позволяет избежать дублирования однотипных уведомлений у пользователя. Примеры использования тегов: - TAG="DEAL_STATUS_123" - для уведомлений об изменении статуса конкретной сделки; - TAG="TASK_DEADLINE_456" - для напоминаний о дедлайне задачи; - TAG="PAYMENT_REMINDER" - для напоминаний об оплате; - TAG="DAILY_REPORT_2025-01-15" - для ежедневных отчётов с датой. Если отправить новое уведомление с тем же тегом, старое уведомление с этим тегом удалится автоматически.
Дополнительный тег	В данном поле указывается дополнительный тег без проверки на уникальность. Это необязательный параметр. Используется для дополнительной классификации уведомлений. Пример: {=Variable:SUB_TAG} или "CATEGORY|URGENT". Отличие от основного тега: - Основной тег (TAG) - проверяется на уникальность, удаляет предыдущие уведомления с таким же тегом; - Дополнительный тег (SUB_TAG) - НЕ проверяется на уникальность, используется только для группировки. Примеры использования дополнительного тега: - SUB_TAG="CATEGORY|URGENT" - категория срочности; - SUB_TAG="TYPE|PAYMENT" - тип уведомления; - SUB_TAG="PROJECT|25" - привязка к проекту; - SUB_TAG="DEPARTMENT|SALES" - привязка к отделу.
Вложение	В данном поле можно указать вложение к уведомлению в формате Битрикс24. Это необязательный параметр. Используется для передачи структурированных данных в уведомлении. Пример: {=Variable:ATTACH}. Формат вложений: Вложения передаются в специальном формате Битрикс24 Attach, который позволяет создавать изображения, ссылки, файлы, сетки с данными, форматированные блоки информации. Подробнее о формате вложений можно узнать в документации Битрикс24 REST API (раздел im.attach).
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Примеры использования активити

Описание примера	Решение
Уведомление об изменении статуса сделки	Параметры: ID пользователя - {=Document:ASSIGNED_BY_ID} (ответственный за сделку), Текст уведомления - "Сделка #{=Document:ID} «{=Document:TITLE}» переведена на стадию 'Выставлен счёт'. Сумма счёта: {=Document:OPPORTUNITY} руб.", Тег уведомления - DEAL_STATUS_{=Document:ID}, Дополнительный тег - CATEGORY|DEAL_STATUS.
Напоминание о задаче с дедлайном	Параметры: ID пользователя - {=Document:RESPONSIBLE_ID} (ответственный за задачу), Текст уведомления - "⏰ Напоминание: задача «{=Document:TITLE}» должна быть выполнена через 2 часа! Срок: {=Document:DEADLINE}", Текст для почты - "Уважаемый коллега! Напоминаем, что задача '{=Document:TITLE}' должна быть завершена {=Document:DEADLINE}. Ссылка на задачу: [ссылка]", Тег уведомления - TASK_REMINDER_{=Document:ID}, Дополнительный тег - TYPE|DEADLINE_ALERT.
Уведомление руководителя о превышении суммы сделки	Параметры: ID пользователя - 1 (ID руководителя отдела продаж), Текст уведомления - "🔔 Крупная сделка! Менеджер {=Document:ASSIGNED_BY_PRINTABLE} создал сделку на сумму {=Document:OPPORTUNITY} руб. Требуется контроль. Сделка: {=Document:TITLE}", Тег уведомления - BIG_DEAL_ALERT_{=Document:ID}, Дополнительный тег - ALERT|BIG_AMOUNT.
Ежедневная сводка по задачам	Параметры: ID пользователя - {=Variable:user_id} (из переменной цикла по всем сотрудникам), Текст уведомления - "Доброе утро! У вас {=Variable:task_count} активных задач. Задачи с истекающим сроком: {=Variable:urgent_tasks}", Текст для почты - "Ежедневная сводка по задачам на {=Variable:current_date}. Активных задач: {=Variable:task_count}. Срочных задач: {=Variable:urgent_count}. Подробнее в Битрикс24.", Тег уведомления - DAILY_TASKS_{=Variable:current_date}, Дополнительный тег - REPORT|DAILY.
Уведомление об ошибке в процессе	Параметры: ID пользователя - 1 (ID администратора системы), Текст уведомления - "⚠️ ОШИБКА в бизнес-процессе! Процесс: '{=Document:BP_NAME}', Документ: {=Document:ID}, Ошибка: {=Variable:error_message}", Тег уведомления - BP_ERROR_{=Document:BP_ID}_{=Variable:timestamp}, Дополнительный тег - ERROR|CRITICAL.
Информирование руководителей о достижении KPI	Параметры: ID пользователя - {=Variable:MANAGER_ID}, Текст уведомления - "KPI достигнут! Показатель: {=Variable:KPI_NAME}, Значение: {=Variable:KPI_VALUE}, Цель: {=Variable:KPI_TARGET}. Отлично!", Тег уведомления - KPI_ACHIEVED_{=Variable:KPI_ID}_{=Variable:MONTH}, Дополнительный тег - REPORT|KPI.
Уведомление о необходимости согласования документов	Параметры: ID пользователя - {=Document:APPROVER_ID}, Текст уведомления - "Требуется согласование документа '{=Document:TITLE}'. Документ: {=Document:ID}, Инициатор: {=Document:CREATED_BY_PRINTABLE}", Тег уведомления - DOC_APPROVAL_{=Document:ID}, Дополнительный тег - TYPE|APPROVAL.
Автоматическое информирование о статусе выполнения бизнес-процессов	Параметры: ID пользователя - {=Document:ASSIGNED_BY_ID}, Текст уведомления - "Бизнес-процесс '{=Variable:BP_NAME}' завершён. Результат: {=Variable:RESULT}. Документ: {=Document:ID}", Тег уведомления - BP_COMPLETE_{=Document:ID}, Дополнительный тег - TYPE|BP_STATUS.
Информирование о новых назначениях и изменениях в рабочих задачах	Параметры: ID пользователя - {=Document:NEW_ASSIGNED_BY_ID}, Текст уведомления - "Назначение: Вы назначены исполнителем задачи '{=Document:TITLE}'. Срок: {=Document:DEADLINE}, Приоритет: {=Document:PRIORITY}", Тег уведомления - TASK_ASSIGNED_{=Document:ID}, Дополнительный тег - TYPE|ASSIGNMENT.
Уведомление о превышении лимитов	Параметры: ID пользователя - {=Variable:MANAGER_ID}, Текст уведомления - "⚠️ Внимание! Превышен лимит по показателю '{=Variable:LIMIT_NAME}'. Текущее значение: {=Variable:CURRENT_VALUE}, Лимит: {=Variable:LIMIT_VALUE}", Тег уведомления - LIMIT_EXCEEDED_{=Variable:LIMIT_ID}, Дополнительный тег - ALERT|LIMIT.

Сценарий работы робота

Активити "Отправка системного уведомления" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Уведомление ответственного о важных изменениях в сделке, лиде или другой CRM-сущности;
• Напоминания о приближающихся дедлайнах задач и событий;
• Информирование руководителей о достижении KPI или превышении лимитов;
• Уведомление о необходимости согласования документов;
• Автоматическое информирование о статусе выполнения бизнес-процессов;
• Отправка персональных отчётов и сводок по расписанию;
• Уведомление об ошибках или проблемах в автоматизированных процессах;
• Информирование о новых назначениях и изменениях в рабочих задачах.

Отличие системных уведомлений от персональных и сообщений в чат:
- Системное уведомление (im.notify.system.add) - официальное уведомление от системы, отображается в центре уведомлений;
- Персональное уведомление (im.notify.personal.add) - персональное сообщение, больше похоже на личное обращение;
- Сообщение в чат (imbot.message.add) - требует наличия чат-бота, отображается как сообщение в чате.

Используйте системные уведомления для:
- Официальных оповещений о статусах и изменениях;
- Напоминаний о важных событиях;
- Технических уведомлений от автоматизированных процессов;
- Информирования о необходимости действий.

Возвращаемые параметры данного активити:
- Статус отправки (send_status) - Y (успешно) или N (ошибка);
- ID уведомления (notification_id) - числовой идентификатор созданного уведомления (для дальнейшего использования);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования тегов:
1. Используйте уникальные теги для каждого типа уведомлений;
2. Включайте в тег ID документа, чтобы уведомления не смешивались между разными сущностями;
3. Используйте префиксы для категоризации: DEAL_, TASK_, LEAD_, PROJECT_;
4. Добавляйте дату в тег для ежедневных/еженедельных уведомлений;
5. Дополнительный тег используйте для группировки по типам: ALERT|, REPORT|, INFO|, ERROR|.

Удаление уведомления

Данное активити (робот) позволяет удалять уведомления пользователей Битрикс24.
Результатом работы является удаление уведомления по его ID, тегу или дополнительному тегу.

ВАЖНО!
Для удаления уведомления необходимо указать хотя бы один из трёх параметров на выбор:
- ID (идентификатор уведомления);
- TAG (тег уведомления);
- SUB_TAG (дополнительный тег).

Можно также комбинировать несколько параметров для более точного удаления.
Если ни один из параметров не будет указан, активити вернёт ошибку.

Описание параметров активити

Название поля	Описание и примеры использования
ID уведомления	В данном поле указывается числовой идентификатор уведомления, которое необходимо удалить. Это необязательный параметр, но хотя бы один из трёх параметров (ID, Тег или Дополнительный тег) должен быть заполнен. Пример: {=Variable:notification_id} или 12345. Как получить ID уведомления: - Из результата работы активити "Отправка персонального уведомления" (поле notification_id); - Из результата работы активити "Отправка системного уведомления" (поле notification_id); - Сохранённый из предыдущих операций с уведомлениями; - Переменная бизнес-процесса, в которой хранится ID уведомления. Примеры указания ID: - Прямое указание: 123, 456; - Через переменную: {=Variable:notification_id}; - Из результата предыдущего активити: {=Activity123:notification_id}.
Тег уведомления	В данном поле указывается тег уведомления, уникальный в рамках системы. Это необязательный параметр, но хотя бы один из трёх параметров должен быть заполнен. Пример: {=Variable:NOTIFICATION_TAG} или "PERSONAL_DEAL_123". Удаление по тегу: При указании тега будут удалены все уведомления с этим тегом у пользователя. Это особенно удобно для массового удаления однотипных уведомлений. Примеры использования тегов: - TAG="PERSONAL_DEAL_123" - удалить все персональные уведомления о сделке 123; - TAG="PERSONAL_TASK_456" - удалить напоминания о задаче 456; - TAG="WELCOME_MESSAGE" - удалить приветственные сообщения; - TAG="BIRTHDAY_GREETING_2025" - удалить поздравления с днём рождения за 2025 год. Практическое применение: Если вы отправляли уведомления с определённым тегом, вы можете удалить все эти уведомления, указав тот же тег.
Дополнительный тег	В данном поле указывается дополнительный тег уведомления, без проверки на уникальность. Это необязательный параметр, но хотя бы один из трёх параметров должен быть заполнен. Пример: {=Variable:SUB_TAG} или "TYPE|PERSONAL". Удаление по дополнительному тегу: При указании дополнительного тега будут удалены все уведомления с этим SUB_TAG. Это позволяет удалять уведомления по категориям или типам. Примеры использования дополнительного тега: - SUB_TAG="TYPE|PERSONAL" - удалить все персональные сообщения; - SUB_TAG="CATEGORY|GREETING" - удалить все поздравления; - SUB_TAG="EVENT|BIRTHDAY" - удалить все уведомления о днях рождения; - SUB_TAG="PRIORITY|HIGH" - удалить все высокоприоритетные уведомления. Важно: Можно комбинировать несколько параметров для более точного удаления. Например, указать и TAG, и SUB_TAG одновременно.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Примеры использования активити

Описание примера	Решение
Удаление напоминания после выполнения задачи	Параметры: ID уведомления - {=Activity456:notification_id} (ID из активити отправки), Тег уведомления - TASK_REMINDER_{=Document:ID}, Дополнительный тег - TYPE|REMINDER. Когда задача выполнена, робот автоматически удаляет уведомление-напоминание.
Удаление уведомлений при отмене встречи	Параметры: Тег уведомления - MEETING_REMINDER_{=Document:EVENT_ID}, Дополнительный тег - EVENT|MEETING. При отмене или переносе встречи робот удаляет все связанные уведомления, все участники больше не будут получать напоминания об отменённом событии.
Массовая очистка по категории в конце года	Параметры: Дополнительный тег - EVENT|BIRTHDAY_2024. В конце года робот удаляет все поздравительные уведомления прошлого года для поддержания порядка и актуальности уведомлений в системе.
Удаление при смене ответственного за сделку	Параметры: Тег уведомления - DEAL_NOTIFICATION_{=Document:ID}_{=Document:OLD_ASSIGNED_BY_ID}, Дополнительный тег - TYPE|DEAL_ALERT. При смене ответственного робот удаляет уведомления предыдущего ответственного, новому ответственному будут отправлены новые уведомления.
Удаление при закрытии сделки	Параметры: Тег уведомления - DEAL_TEMP_{=Document:ID}, Дополнительный тег - STATUS|TEMPORARY. При успешном закрытии сделки робот удаляет все временные уведомления, после завершения работы по сделке все промежуточные напоминания становятся неактуальными.
Удаление дублирующихся уведомлений	Параметры: Тег уведомления - UNIQUE_NOTIFICATION_{=Document:ID}. При повторной отправке уведомления с уникальным тегом робот сначала удаляет старое уведомление, затем отправляет новое, гарантируя, что пользователь увидит только актуальную версию уведомления.
Удаление устаревших уведомлений о встречах	Параметры: Тег уведомления - {=Variable:MEETING_TAG}, Дополнительный тег - TYPE|MEETING. Автоматическое удаление уведомлений о встречах, которые уже прошли или были отменены.
Очистка при переводе пользователя в другой отдел	Параметры: Дополнительный тег - DEPARTMENT|OLD_DEPT_{=Variable:OLD_DEPARTMENT_ID}. При переводе пользователя робот удаляет все уведомления, связанные с его предыдущим отделом.
Удаление служебных уведомлений по расписанию	Параметры: Дополнительный тег - CATEGORY|SERVICE, Тег уведомления - {=Variable:SERVICE_TAG}. Робот по расписанию удаляет все служебные уведомления определённого типа для очистки системы.
Удаление тестовых уведомлений после завершения тестирования	Параметры: Тег уведомления - TEST_NOTIFICATION_{=Variable:TEST_ID}, Дополнительный тег - TYPE|TEST. После завершения тестирования робот удаляет все тестовые уведомления для очистки системы от временных данных.

Сценарий работы робота

Активити "Удаление уведомления" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Удаление устаревших уведомлений о встречах и событиях;
• Очистка уведомлений при отмене задач или изменении статусов;
• Удаление временных напоминаний после выполнения действия;
• Массовое удаление однотипных уведомлений по тегу;
• Очистка уведомлений при закрытии сделок или завершении проектов;
• Удаление дублирующихся уведомлений;
• Очистка спам-уведомлений или ошибочно отправленных сообщений;
• Удаление уведомлений при переводе пользователя в другой отдел.

Особенности работы с параметрами удаления:
- Можно указать только ID для удаления конкретного уведомления;
- Можно указать только TAG для удаления всех уведомлений с этим тегом;
- Можно указать только SUB_TAG для удаления всех уведомлений с этим дополнительным тегом;
- Можно комбинировать параметры для более точного удаления;
- Если ни один параметр не указан, активити вернёт ошибку.

Связь с другими активити уведомлений:
- Отправка персонального уведомления (notify_personal_add) - создаёт персональное уведомление, возвращает notification_id;
- Отправка системного уведомления (notify_system_add) - создаёт системное уведомление, возвращает notification_id;
- Удаление уведомления (notify_delete) - удаляет уведомления по ID, TAG или SUB_TAG.

Используйте эти активити вместе для полного управления уведомлениями в бизнес-процессах.

Важно помнить:
Удалённые уведомления невозможно восстановить. Убедитесь, что удаляете правильные уведомления, проверив параметры перед запуском робота.

При использовании тегов для удаления будут удалены ВСЕ уведомления с указанным тегом или дополнительным тегом.
Будьте внимательны при массовом удалении.

Возвращаемые параметры данного активити:
- Статус удаления (delete_status) - Y (успешно) или N (ошибка);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования удаления уведомлений:
1. Всегда используйте теги при отправке уведомлений, если планируете их удалять;
2. Сохраняйте notification_id из активити отправки для точечного удаления;
3. Используйте дополнительные теги для категоризации и массового удаления;
4. Удаляйте устаревшие уведомления автоматически при изменении статусов;
5. Комбинируйте параметры для более точного контроля удаления;
6. Регулярно очищайте временные и промежуточные уведомления;
7. При массовых рассылках используйте уникальные теги для каждой категории.

Прочитать уведомления

Данное активити (робот) позволяет отмечать уведомления пользователей Битрикс24 как прочитанные или непрочитанные.
Результатом работы является изменение статуса прочтения для указанных уведомлений.

Основное назначение:
Активити позволяет программно управлять статусом прочтения уведомлений, что полезно для:
- Автоматической отметки уведомлений при выполнении определённых действий;
- Массовой обработки уведомлений по категориям;
- Сброса статуса для повторного привлечения внимания;
- Интеграции с системами обработки задач и уведомлений.

Описание параметров активити

Название поля	Описание и примеры использования
ID уведомлений	В данном поле указывается массив идентификаторов уведомлений, которые необходимо отметить. Это обязательный параметр. Можно указать одно или несколько ID уведомлений. Пример: {=Variable:notification_ids} или "1,2,3,4,5". Как получить ID уведомлений: - Из результата работы активити "Отправка персонального уведомления" (поле notification_id); - Из результата работы активити "Отправка системного уведомления" (поле notification_id); - Из результата активити поиска или получения списка уведомлений; - Сохранённые из предыдущих операций в переменные бизнес-процесса; - Массив ID из итератора или цикла обработки. Форматы указания ID: - Прямое указание нескольких ID: 123, 456, 789; - Через переменную с массивом: {=Variable:notification_ids}; - Из результата предыдущего активити: {=Activity123:search_results_array}; - Строка с ID через запятую: "1,2,3,4,5" (автоматически преобразуется в массив). Важно: Поле поддерживает множественный выбор (Multiple), поэтому можно указать несколько ID одновременно.
Действие	В данном поле выбирается, как отметить уведомления - как прочитанные или непрочитанные. Это необязательный параметр, по умолчанию используется значение Y (прочитанные). Варианты действия: - Y (прочитанные) - уведомления будут отмечены как прочитанные и исчезнут из списка непрочитанных; - N (непрочитанные) - уведомления будут отмечены как непрочитанные и появятся в списке активных уведомлений. Когда использовать разные действия: Отметить как прочитанные (Y): После автоматической обработки уведомления; При выполнении связанной задачи или действия; Для массовой очистки уведомлений определённого типа; При закрытии связанных сделок или проектов. Отметить как непрочитанные (N): Для повторного привлечения внимания к важному уведомлению; При эскалации проблемы или задачи; Если действие требует повторного рассмотрения; Для сброса статуса при изменении условий.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Примеры использования активити

Описание примера	Решение
Автоматическая отметка после выполнения задачи	Параметры: ID уведомлений - {=Variable:saved_notification_id}, Действие - Y (отметить как прочитанные). При завершении задачи робот отмечает связанное уведомление как прочитанное, условие: статус задачи = "Завершена". Уведомление о задаче автоматически исчезает из списка непрочитанных.
Массовая обработка уведомлений по тегу	Параметры: ID уведомлений - {=Activity456:search_results_array} (из результата поиска по тегу), Действие - Y (отметить как прочитанные). После завершения проекта робот отмечает все связанные уведомления как прочитанные, все уведомления автоматически очищаются.
Повторная активация важного уведомления	Параметры: ID уведомлений - {=Variable:urgent_notification_id}, Действие - N (отметить как непрочитанные). Если сотрудник не отреагировал на важное уведомление в течение более 24 часов и задача не выполнена, робот возвращает уведомление в статус "непрочитанное" для повторного привлечения внимания.
Очистка после изменения статуса сделки	Параметры: ID уведомлений - {=Activity789:search_results_array} (из поиска по тегу DEAL_{=Document:ID}), Действие - Y (отметить как прочитанные). При переходе сделки на стадию "Успешно реализовано" робот автоматически отмечает все уведомления по сделке как прочитанные.
Эскалация с возвратом уведомления	Параметры: ID уведомлений - {=Variable:original_notification_id}, Действие - N (отметить как непрочитанные). При эскалации проблемы (проблема не решена в срок) робот возвращает уведомление в статус "непрочитанное" для повторного рассмотрения, одновременно отправляя новое уведомление руководителю.
Итератор для массовой обработки	Параметры: ID уведомлений - {=Variable:current_notification_id}, Действие - Y (если условие выполнено) или N (если нужно вернуть внимание). Обработка большого количества уведомлений через итератор: получить список всех уведомлений определённого типа, обработать каждое уведомление индивидуально с проверкой условий.
Массовая отметка уведомлений после закрытия проекта	Параметры: ID уведомлений - {=Variable:PROJECT_NOTIFICATIONS} (массив ID всех уведомлений проекта), Действие - Y (отметить как прочитанные). При закрытии проекта все связанные уведомления автоматически отмечаются как прочитанные.
Возврат уведомления при изменении приоритета задачи	Параметры: ID уведомлений - {=Variable:TASK_NOTIFICATION_ID}, Действие - N (отметить как непрочитанные). При изменении приоритета задачи с обычного на высокий робот возвращает связанное уведомление в статус "непрочитанное" для привлечения внимания к изменившейся ситуации.
Очистка уведомлений по расписанию	Параметры: ID уведомлений - {=Variable:OLD_NOTIFICATIONS} (получены через поиск по дате), Действие - Y (отметить как прочитанные). Робот по расписанию отмечает все уведомления старше определенной даты как прочитанные для очистки списка непрочитанных.
Управление статусом уведомлений при смене ответственного	Параметры: ID уведомлений - {=Variable:OLD_RESPONSIBLE_NOTIFICATIONS}, Действие - Y (отметить как прочитанные). При смене ответственного за сделку робот отмечает все уведомления предыдущего ответственного как прочитанные, так как они больше не актуальны для него.

Сценарий работы робота

Активити "Отметка уведомлений" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическая отметка уведомлений при выполнении связанных действий;
• Массовая обработка уведомлений по результатам других активити;
• Очистка прочитанных уведомлений определённых типов;
• Повторная активация важных уведомлений для привлечения внимания;
• Управление статусом уведомлений в зависимости от изменения данных;
• Интеграция с системой задач и автоматическая отметка связанных уведомлений;
• Синхронизация статусов уведомлений между разными системами;
• Автоматическая очистка уведомлений при закрытии сделок или проектов.

Особенности работы с массовыми операциями:
- Можно отметить одно уведомление, указав один ID;
- Можно отметить несколько уведомлений, указав массив ID;
- Все указанные уведомления будут обработаны одним запросом;
- При ошибке операция не выполняется ни для одного из ID;
- Поле processed_count показывает фактическое количество обработанных уведомлений.

Интеграция с другими активити уведомлений:
Активити "Отметка уведомлений" является частью комплексной системы управления уведомлениями:
- Отправка персонального уведомления (notify_personal_add) → создаёт уведомление, возвращает notification_id;
- Отправка системного уведомления (notify_system_add) → создаёт уведомление, возвращает notification_id;
- Отметка уведомлений (notify_read_list) → изменяет статус прочтения по ID;
- Удаление уведомления (notify_delete) → удаляет уведомления по ID, TAG или SUB_TAG.

Типичный цикл работы: 1. Создание уведомления (personal_add или system_add) → получение ID; 2. Сохранение ID в переменную для последующего использования; 3. Выполнение бизнес-логики и ожидание действий; 4. Отметка уведомления (read_list) или удаление (delete) в зависимости от результата.

Разница между отметкой и удалением уведомлений:
Отметка уведомлений (notify_read_list): Уведомления остаются в системе, но меняют статус прочтения; Можно вернуть уведомление обратно в статус "непрочитанное"; Сохраняется история уведомлений; Подходит для временного управления видимостью.
Удаление уведомлений (notify_delete): Уведомления полностью удаляются из системы; Операция необратима, восстановить уведомление нельзя; Используется для окончательной очистки; Подходит для устаревших или ошибочных уведомлений.
Рекомендация: Используйте отметку для управления вниманием, а удаление - для окончательной очистки системы.

Возвращаемые параметры данного активити:
- Статус операции (read_status) - Y (успешно) или N (ошибка);
- Количество обработанных уведомлений (processed_count) - число успешно обработанных ID;
- Тип выполненного действия (action_type) - Y (прочитанные) или N (непрочитанные);
- Сообщение об ошибке (s_error_logs) - сообщение о результате выполнения или описание ошибки.

Лучшие практики использования отметки уведомлений:
1. Сохраняйте ID уведомлений в переменные БП для последующей работы с ними;
2. Используйте теги при создании уведомлений для удобного поиска и группировки;
3. Отмечайте уведомления как прочитанные автоматически после выполнения связанных действий;
4. Используйте возврат в статус "непрочитанное" для эскалации и повторного привлечения внимания;
5. При массовой обработке используйте активити поиска для получения списка ID;
6. Проверяйте поле processed_count для контроля успешности операции;
7. Комбинируйте с условиями и итераторами для сложной логики обработки;
8. Используйте отметку вместо удаления, если уведомления могут понадобиться в истории.

Режим отладки

Данная статья описывает как пользоваться режимом отладки в наших активити.

Для активации режима отладки требуется в настройках активити, в поле "Делать отладочные сообщения в журнал БП" выбрать "Да".

После активации этой опции, активити в случае ошибки или неисправности, будет выводить сообщение в журнал БП.

ВАЖНО!
Нужно не забывать выключать режим отладки после использования, т.к данный режим может более - чем в двое увеличить количество запросов к REST Api.

Подробности ошибок описываются после слова ОШИБКА(ERROR).

Если в поле "Делать отладочные сообщения в журнал БП", выбрано значение "Не установлено", то по умолчанию, это значит, что отладочные сообщения выводиться не будут.

Нет описания

Информация по данному активити будет добавлена в ближайшее время.