Изменение Контакта

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

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

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

Полезные советы:
- При выборе сотрудника в поле "привязка к пользователю" должен быть только его ID без лишних символов;
- Чтобы очистить поля типа "строка" - нужно передать пробел: ={ };
- Для очистки полей типа "список" - передайте кавычки: =" ".

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

Название поля	Описание и примеры использования
ID Контакта	Обязательный параметр. ID контакта, которого необходимо изменить. Если поле имеет привязку к элементам инфоблоков (привязка к спискам), для изменения значения нужно указывать ID элемента. Примеры: - `{=Document:ID}` - ID текущего контакта; - `123` - конкретный ID контакта; - `{=Variable:CONTACT_ID}` - ID из переменной.
Очистить почты и(или) телефоны	Удаление почт или телефонов в контакте. Варианты: почта, телефон, почта и телефон, не очищать.
Обращение	Обращение к клиенту (мистер, товарищ, госпожа и т.д.).
Имя	Новое значение имени контакта.
Фамилия	Новое значение фамилии контакта.
Отчество	Новое значение отчества контакта.
Дата рождения	Новое значение даты рождения контакта.
Тип контакта	Изменение типа контакта. Значения берутся из справочника CRM.
Источник	Изменение источника контакта. Значения берутся из справочника CRM.
Описание	Тип источника, из которого контакт попал в CRM.
Должность	Изменение должности контакта.
Адресные поля	Адрес, город, почтовый индекс, район, область, страна (устаревшие поля, сейчас используются реквизиты).
Комментарий	Изменение комментария контакта.
Доступен для всех	Варианты: да/нет. Доступен ли контакт для всех сотрудников.
Ответственный	Изменение ответственного за контакт. Указывается ID пользователя.
Компания	Изменение компании, которая относится к контакту. Указывается ID компании.
Компании	Изменение нескольких компаний для контакта (когда один контакт привязан к множеству компаний).
UTM-метки	Рекламная система, тип трафика, обозначение рекламной кампании, содержание кампании, условие поиска.
Телефон	Добавление телефонов. Активити только добавляет, не удаляет существующие.
EMAIL	Добавление адресов электронной почты. Активити только добавляет, не удаляет существующие.
Сайт	Добавление адресов сайтов. Активити только добавляет, не удаляет существующие.
Мессенджеры	Добавление адресов интернет-мессенджеров.

ВАЖНО!
- Запускать изменение сразу более 1000 сущностей не стоит. Это может привести к проблемам с обработкой на стороне Б24;
- Если планируете изменение более 1000 сущностей, встройте в БП счётчик и после 1000 изменений делайте паузу на 15 минут.

Перенос полей типа "Список" между сущностями:
Если нужно перенести элементы поля типа "Список" из одной сущности в другую (например, из Компании в Контакт), ID элементов в каждом типе сущности будут свои. Для переноса нужно сопоставлять элементы списка в переменной типа "Список".

Формат сопоставления (каждый элемент с новой строки):
[6891] 10671
[6893] 10673
Где значение в квадратных скобках - ID элемента в сущности-получателе, за скобками - в сущности-источнике.

Примеры использования:

№	Сценарий	ID Контакта	Изменяемое поле	Значение
1	Изменить ответственного	`{=Document:ID}`	Ответственный	`user_25`
2	Обновить должность	`{=Variable:CONTACT_ID}`	Должность	`Директор`
3	Привязать к компании	`{=Document:ID}`	Компания	`{=Variable:COMPANY_ID}`
4	Добавить телефон	`{=Document:ID}`	Телефон	`+79001234567`
5	Изменить тип контакта	`{=Document:ID}`	Тип контакта	`CLIENT`
6	Обновить ФИО	`{=Variable:CONTACT_ID}`	Имя, Фамилия	`Иван`, `Петров`
7	Очистить телефоны	`{=Document:ID}`	Очистить	Телефон
8	Добавить комментарий	`{=Document:ID}`	Комментарий	`Обновлено: {=System:Date}`
9	Изменить источник	`{=Document:ID}`	Источник	`WEB`
10	Добавить email	`{=Document:ID}`	EMAIL	`{=Variable:EMAIL}`

Возвращаемые параметры для данного активити:

ID контакта (contact_id) - числовой идентификатор изменённого контакта;
Сообщение об ошибке (error_message) - текст ошибки при неуспешном выполнении.

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

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

Изменение Контакта