Маски

Маска — это ссылка на поле внутри сделки или связанных с ней сущностей. Маски используются в тексте шаблонов конструктора или в шаблонах писем для формирования уникальных сообщений, относящихся к конкретной сделке. Рассмотрим простой пример применения масок в тексте письма:

При отправке мы получим письмо следующего вида:

Как мы видим, в наше письмо подтянулись все данные из сделки, сформировав уникальное сообщение по единому шаблону. Маски — это мощный инструмент, позволяющий создавать гибкие шаблоны под множество задач.

Sensei поддерживает работу с масками полей в большинстве своих элементов: «Создать задачу», «Отправить письмо», «Условие», «Примечание», «Задать параметр», «Webhook», «Telegram».

Помимо параметров процессов, маски Sensei работают с тремя основными сущностями amoCRM: «Сделка», «Контакт», «Компания». В общем виде, за исключением специализированных масок, конструкция выглядит следующим образом:

{{Сущность.Поле}}

При этом для сущностей допустимы два варианта написания — на русском и на английском языках: «Сделка/lead», «Контакт/contact», «Компания/company». Поля можно записывать либо полностью дублируя их название из карточки amoCRM, либо записав ID этого поля. В английском варианте с ID полей следует прописывать маски в виде:

{{Сущность.cf.id}}

Рассмотрим типовые примеры масок и их написание. У нас есть поля, которые мы хотим использовать в виде масок при ведении сделки:

Поле сделки: Дата встречи, ID поля: 279 677
Поле контакта: Город, ID поля: 279 683
Поле компании: Сайт, ID поля: 279 685

ID поля легко можно найти, перейдя в настройки карточки и выбрав нужное поле:

Посмотрим, как эти маски будут выглядеть в разных вариантах написания.

Русские варианты масок с ID полей:
{{Сделка.279 677}}
{{Контакт.279 683}}
{{Компания.279 685}}

Русские варианты масок с названиями полей:
{{Сделка.Дата встречи}}
{{Контакт.Город}}
{{Компания.Сайт}}

Английские варианты масок с ID полей:
{{lead.cf.279 677}}
{{contact.cf.279 683}}
{{company.cf.279 685}}

Sensei позволяет составлять арифметические выражения при использовании масок в элементе «Задать параметр».

Пример:
{{Сделка.Поле1}} * ({{Контакт.Поле2}} + {{Сделка.Поле3}} / 4)
Результаты таких вычислений можно записать в числовое поле или в «Бюджет». Но элементами вычислений могут быть маски, ссылающиеся на поля любого типа, т. е. в формулу можно подставить число из текстового поля или из списка.

Можно производить вычисления с полями типа «Дата», например прибавлять или вычитать дни. А с полями типа «Дата и время» можно также прибавлять или вычитать дни и минуты .

Пример:
{{Дата.Сегодня}} + 2year — прибавит 2 года к текущей дате.
{{Дата.Сегодня}} + 5month — прибавит 5 месяцев к текущей дате.
{{Сделка.Дата}}+1 — прибавит +1 день к дате в поле.
{{Сделка.Дата и время}}+1 — прибавит +1 день к дате.
{{Дата.Сегодня}} + 4h — прибавит 4 часа к текущей дате.
{{Сделка.Дата и время}}+180m — прибавит +180 минут ко времени, что эквивалентно 3 часам.

Для формул можно использовать различные математические символы:
— числа с плавающей точкой («.» или «,» для разделения целой и дробной части)
— умножение («*» или «x»)
— деление («÷» или «/»)

Если в формуле будет содержаться ошибка, то в системном примечании сделки будет выведено соответствующее сообщение.

Далее рассмотрим маски, которые отличаются от стандартной конструкции, но также необходимы в работе. Регистр написания не имеет значения.

• {{Пусто}} — удалит текущее значение в поле

• {{Сделка.Ссылка}} или {{lead.url}} — ссылка на текущую сделку, например: https://домен.amocrm.ru/leads/detail/16 199 523
• {{Сделка.Клиентская ссылка}} - выведет клиентскую ссылку сделки, если в настройках воронки, где расположена сделка, подключен источник сделок «Кнопка и сайт визитка». Подробная информация на сайте amoCRM.
• {{Аккаунт.Домен}} — домен.amocrm.ru или домен.amocrm.com
• {{Сделка.id}} или {{lead.id}} — ID сделки, например: 16 199 523
• {{Сделка.Название}} или {{lead.name}} — название сделки
• {{Сделка.Бюджет}} или {{lead.price}} — бюджет, например: 8890
• {{Сделка.Бюджет.Тысячи}} — бюджет с разделителем, например: 8 890
• {{Сделка.Бюджет.Прописью}} — бюджет прописью, например: восемь тысяч восемьсот девяносто
• {{lead.price.words}} — eight thousand eight hundred ninety
• {{Аккаунт.Валюта}} — данные о валюте аккаунта в именительном падеже
• {{Аккаунт.Валюта.Родительный}} — данные о валюте аккаунта в родительном падеже
• {{Сделка.Воронка}} или {{lead.pipeline}} — название воронки
• {{Сделка.Статус}} или {{lead.status}} — название этапа воронки
• {{Контакт.Ссылка}} или {{contact.url}} — ссылка на основной контакт сделки, например: домен.amocrm.ru/contacts/detail/44 092 879
• {{Контакт.id}} или {{contact.id}} — ID контакта, например: 44 092 879
• {{Контакт.ПолноеИмя}} или {{contact.name}} — имя контакта, например: Иван Петров
• {{Контакт.Фамилия}} — фамилия контакта, например: Петров*
• {{Контакт.КороткоеИмя}} — Иван*
• {{Компания.Ссылка}} или {{company.url}} — ссылка на компанию сделки, например: домен.amocrm.ru/companies/detail/44 092 873
• {{Компания.id}} или {{company.id}} — ID комании, например: 44 092 873
• {{Компания.Название}} или {{company.name}} — название комании, например: Xoome

* Что бы маска корректно извлекала имя или же фамилию, они должны быть корректно записаны и разделены в карточке контакта.

Для даты и времени:

• {{Время}} или {{time}} — текущее время, например: 19:40
• {{Дата Время}} или {{datetime}} — текущие дата и время, например: 07.05.2020 19:40
• {{Дата.Формат.Расширенный}} — расширенный формат даты, например: 7 мая 2020 г.
• {{Дата.Сегодня}} или {{date}} — текущая дата, например: 07.05.2020
• {{Дата.Сегодня.Год}} или {{year}} — текущий год, например: 2020
• {{Дата.Сегодня.Месяц}} или {{month}} — текущий месяц числом, например: 10
• {{Дата.Сегодня.День}} или {{day}} — текущее число месяца, например: 30
• {{Дата.Сегодня.Час}} или {{hour}} — текущий час, например: 23
• {{Дата.Сегодня.Минута}} или {{minute}} — текущее количество минут, например: 59
• {{Дата.Сегодня.Месяц}} или {{month}} — текущий месяц, например: 12,
• {{Дата.Сегодня.Год}} или {{Год}} — текущий год, например: 2021,
• {{Дата.ДеньНедели}} или {{weekday.long}} — текущий день недели, например: вторник,
• {{Дата.ДеньНедели.Короткий}} или {{weekday.short}} — текущий день недели, например: вт,
• {{Дата.ДеньНедели.Номер}} или {{weekday.number}} — номер текущего дня недели, например: 2.

Для номера телефона и email: (125 557 и 125 559 — ID полей)

• {{Контакт.Телефон}}, {{Контакт.125 557}} или {{contact.cf.125 557}} — первый номер телефона в amoCRM
• {{Контакт.Телефон.Рабочий}} или {{contact.cf.125 557.work}} — рабочий телефон
• {{Контакт.Телефон.Раб.прямой}} или {{contact.cf.125 557.workdd}} — рабочий телефон, прямой
• {{Контакт.Телефон.Мобильный}} или {{contact.cf.125 557.mob}} — мобильный телефон
• {{Контакт.Телефон.Факс}} или {{contact.cf.125 557.fax}} — факс
• {{Контакт.Телефон.Домашний}} или {{contact.cf.125 557.home}} — домашний телефон
• {{Контакт.Телефон.Другой}} или {{contact.cf.125 557.other}} — другой телефон
• {{Контакт.Email}}, {{Контакт.125 559}} или {{contact.cf.125 559}} — первый email основного контакта в amoCRM
• {{Контакт.Email.Рабочий}} или {{contact.cf.125 559.work}} — рабочий email основного контакта
• {{Контакт.Email.Личный}} или {{contact.cf.125 559.priv}} — личный email основного контакта
• {{Контакт.Email.Другой}} или {{contact.cf.125 559.other}} — другой email основного контакта

Для сущности «Компания» маски для телефона и почты аналогичны маскам «Контакта».

Для многострочного поля Адрес: (183 763 — id поля, «Адрес» — название поля)

• {{Сделка.Адрес}}, {{Сделка.183 763}} или {{lead.cf.183 763}} — вывод всех полей адреса в одну строку, через запятую
• {{Сделка.Адрес.Адрес}} или {{lead.cf.183 763.address_line₁}} — адрес
• {{Сделка.Адрес.Адрес2}} или {{lead.cf.183 763.address_line₂}} — вторая строка адреса
• {{Сделка.Адрес.Город}} или {{lead.cf.183 763.city}} — город
• {{Сделка.Адрес.Регион}} или {{lead.cf.183 763.state}} — регион
• {{Сделка.Адрес.Индекс}} или {{lead.cf.183 763.zip}} — индекс
• {{Сделка.Адрес.Страна}} или {{lead.cf.183 763.country}} — страна

Для ответственного сотрудника/менеджера:

• {{lead.responsible.id}} — ID ответственного за сделку
• {{Сделка.Ответственный}} или {{lead.responsible.name}} — имя ответственного за сделку
• {{Сделка.Ответственный.Телефон}} или {{lead.responsible.phone}} — телефон ответственного за сделку
• {{Сделка.Ответственный.Почта}} или {{lead.responsible.email}} — email ответственного за сделку
• {{contact.responsible.id}} — ID ответственного за контакт
• {{Контакт.Ответственный}} или {{contact.responsible.name}} — имя ответственного за контакт
• {{Контакт.Ответственный.Телефон}} или {{contact.responsible.phone}} — телефон ответственного за контакт
• {{Контакт.Ответственный.Почта}} или {{contact.responsible.email}} — email ответственного за контакт
• {{company.responsible.id}} — ID ответственного за компанию
• {{Компания.Ответственный}} или {{company.responsible.name}} — имя ответственного за компанию
• {{Компания.Ответственный.Телефон}} или {{company.responsible.phone}} — телефон ответственного за компанию
• {{Компания.Ответственный.Почта}} или {{company.responsible.email}} — email ответственного за компанию

Для каталогов и списков:

• Сделка. Название поля — все уровни вложенности поля, типа Каталоги и списки через разделитель «;»
• Сделка. Название поля.1 — первый уровень вложенности поля

Рассмотрим пример, где при постановке задачи мы можем создать удобный для понимания текст с уникальным содержанием, используя маски:

В сделке такая задача будет выглядеть следующим образом:

Рассмотрим пример применения масок в тексте письма. Маски позволяют создавать уникальные письма, содержание которых будет относиться к конкретному клиенту и доносить именно ту информацию, которая ему нужна.

Сформированное при отправке письмо:

В элементе «Условие» мы можем использовать маски для сравнения полей. В данном примере, если сделка приходит через телефонию, то номер контакта попадёт в название сделки. Таким образом, мы проверяем, пришла ли сделка через телефонию или у неё другой источник:

Элемент «Примечание» позволяет создавать запись в карточке сделки. С помощью масок его также можно сделать уникальным. В данном примере создадим примечание, которое сообщает об исполнении конкретного этапа в бизнес-процессе:

Расположим примечание перед отправкой письма:

В сделке мы увидим наше кастомизированное примечание:

Рассмотрим пример расчёта бюджета сделки, с помощью умножения значений двух полей внутри элемента «Задать параметр».

В результате мы получим в поле «Бюджет» значение арифметического выражения:

Рассмотрим пример, когда нам требуется отправить СМС с помощью стороннего сервиса. Для отправки нам нужно создать веб-хук с номером телефона и текстом сообщения, например:

https://testsms.ru/api/v1/?to={{Контакт.Телефон}}&text=Здравствуйте {{Контакт.Имя}}, мы получили Вашу заявку. Наш менеджер {{Сделка.Ответственный}} свяжется с Вами в ближайшее время.&user_name=username&api_key=apikey&action=calls.send_sms

Таким образом, мы можем создавать универсальные веб-хуки, в которых данные будут автоматически подтягиваться из сделки.

Мы можем отправлять уникальные сообщения менеджерам через элемент «Telegram». Составим шаблон такого сообщения:

Теперь, как только клиент оставит заявку на сайте, сотруднику тут же придет сообщение в Telegram, где в краткой форме будет изложена суть задачи: