Получение данных по сущности: Лид

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

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

Как работает активити (робот):
- Активити (робот) получает все данные из полей лида по указанному ID;
- Возвращаются как стандартные, так и пользовательские поля;
- Поддерживается вывод данных в удобном для печати виде;
- Активити (робот) работает через REST API Битрикс24 (crm.lead.get).

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

Название поля	Описание и примеры использования
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_*);
- и другие поля.

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

Ваша корзина пуста

Получение данных по сущности: Лид