Добавить компанию в задачу по группе
Робот «Добавить компанию в задачу по группе». Находит компанию по группе задачи и добавляет ее в CRM-связи задачи.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для организаций, в которых проект или группа закреплены за конкретной компанией CRM. Устраняет ручной выбор компании в задачах проекта, если связь уже хранится в пользовательском поле компании.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| Код поля компании с группой | Строка | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- В компаниях CRM подготовьте поле, где хранится ID группы или проекта. Для одной группы должно находиться ровно одно соответствие.
- Добавьте робота в контекст текущей задачи, у которой указан проект.
- В поле настройки передайте точный код пользовательского поля компании, например
UF_CRM_PROJECT_GROUP. - Проверьте, что значение поля компании совпадает с числовым ID группы задачи.
- При успехе передайте ID найденной компании следующему шагу либо используйте его в уведомлении.
Учебный пример и ожидаемый результат
Текущая задача относится к группе 50. У единственной компании 700 в поле UF_CRM_PROJECT_GROUP записано 50. Ожидается добавление этой компании к CRM-связям задачи с сохранением прежних связей. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID компании: целое число.
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Задача определяется из текущего контекста, отдельного поля её ID в настройке нет. Без проекта, при отсутствии компании или нескольких совпадениях действие останавливается. Компания не создаётся; совпадение названий группы и компании не используется.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.