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

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

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

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

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

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

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

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

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