Информация о контакте в Смарт-Процессе
Возвращает ID, телефоны и выбранное поле контакта, привязанного к элементу смарт-процесса.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для координатора смарт-процесса, которому нужны данные связанного контакта. В заявке известен элемент, а для последующего действия нужны телефон и дополнительный реквизит контакта. Робот читает контактную связь и возвращает доступные данные отдельными результатами.
Что делает и когда применять
Робот пригодится, когда нужно быстро получить контактные данные клиента, привязанного к элементу смарт-процесса.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Передайте тип смарт-процесса и ID элемента. Если нужно дополнительное поле контакта, укажите его действительный код; заголовок поля в интерфейсе вместо кода не подходит.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Информация о контакте в смарт-процессе». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Передайте тип смарт-процесса и ID элемента. Если нужно дополнительное поле контакта, укажите его действительный код; заголовок поля в интерфейсе вместо кода не подходит.
- Заполните ID смарт-процесса, ID элемента, Код дополнительного поля контакта. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID смарт-процесса (smartId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID элемента (elementId) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Код дополнительного поля контакта (other) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- ID смарт-процесса (
smartId):170. - ID элемента (
elementId):901. - Код дополнительного поля контакта (
other):UF_CRM_CLIENT_ROLE.
Для элемента с контактом 601 вернутся его ID, доступные телефоны и значение выбранного дополнительного поля. Один телефон и полный список телефонов возвращаются раздельно, поэтому способ выбора адресата задавайте явно.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID контакта (contactId) |
целое число |
Мобильный телефон контакта (contactPhone) |
строка |
Телефоны контакта (contactPhones) |
строка, несколько значений |
Значение дополнительного поля (other) |
строка |
Статус (status) |
да/нет |
Ошибка (error) |
строка |
Используйте «ID контакта» для связи, список телефонов для проверки, дополнительное поле для условия. Не отправляйте сообщения по первому номеру без проверки его роли в вашем сценарии.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.