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