Подключение Sensei
Доступ к закрытым материалам Sensei
Доступ к кейсу «Russia.Study»
Маски
Маска — это ссылка на поле внутри сделки или связанных с ней сущностей. Маски используются в тексте шаблонов конструктора или в шаблонах писем для формирования уникальных сообщений, относящихся к конкретной сделке. Рассмотрим простой пример применения масок в тексте письма:
При отправке мы получим письмо следующего вида:
Как мы видим, в наше письмо подтянулись все данные из сделки, сформировав уникальное сообщение по единому шаблону. Маски — это мощный инструмент, позволяющий создавать гибкие шаблоны под множество задач.

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

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

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

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

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

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

Поле сделки: Дата встречи, ID поля: 279677
Поле контакта: Город, ID поля: 279683
Поле компании: Сайт, ID поля: 279685

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

Русские варианты масок с ID полей:
{{Сделка.279677}}
{{Контакт.279683}}
{{Компания.279685}}

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

Английские варианты масок с ID полей:
{{lead.cf.279677}}
{{contact.cf.279683}}
{{company.cf.279685}}


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

Пример:
{{Сделка.Поле1}} * ( {{Контакт.Поле2}} + {{Сделка.Поле3}} / 4 )

Результаты вычислений можно записать только в числовое поле или в «Бюджет». Но элементами вычислений могут быть маски, ссылающиеся на поля любого типа, т.е. в формулу можно подставить число из текстового поля или из списка.

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

Пример:
{{Сделка.Дата}}+1 — прибавит +1 день к дате в поле.
{{Сделка.Дата и время}}+1 — прибавит +1 день к дате.
{{Сделка.Дата и время}}+180m — прибавит +180 минут ко времени, что эквивалентно 3 часам.

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

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


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

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

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

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

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

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

  • {{Сделка.Адрес}}, {{Сделка.183763}} или {{lead.cf.183763}} — вывод всех полей адреса в одну строку, через запятую
  • {{Сделка.Адрес.Адрес}} или {{lead.cf.183763.address_line_1}} — адрес
  • {{Сделка.Адрес.Адрес2}} или {{lead.cf.183763.address_line_2}} — вторая строка адреса
  • {{Сделка.Адрес.Город}} или {{lead.cf.183763.city}} — город
  • {{Сделка.Адрес.Регион}} или {{lead.cf.183763.state}} — регион
  • {{Сделка.Адрес.Индекс}} или {{lead.cf.183763.zip}} — индекс
  • {{Сделка.Адрес.Страна}} или {{lead.cf.183763.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 ответственного за компанию

«Создать задачу»
Рассмотрим пример, где при постановке задачи мы можем создать удобный для понимания текст с уникальным содержанием, используя маски:
В сделке такая задача будет выглядеть следующим образом:
«Отправить письмо»
Рассмотрим пример применения масок в тексте письма. Маски позволяют создавать уникальные письма, содержание которых будет относиться к конкретному клиенту и доносить именно ту информацию, которая ему нужна.
Сформированное при отправке письмо:
«Условие»
В элементе «Условие» мы можем использовать маски для сравнения полей. В данном примере, если сделка приходит через телефонию, то номер контакта попадёт в название сделки. Таким образом, мы проверяем, пришла ли сделка через телефонию или у неё другой источник:
«Примечание»
Элемент «Примечание» позволяет создавать запись в карточке сделки. С помощью масок его также можно сделать уникальным. В данном примере создадим примечание, которое сообщает об исполнении конкретного этапа в бизнес-процессе:
Расположим примечание перед отправкой письма:
В сделке мы увидим наше кастомизированное примечание:
«Задать значение поля»
Рассмотрим пример расчёта бюджета сделки, с помощью умножения значений двух полей внутри элемента «Задать значение поля».
В результате мы получим в поле «Бюджет» значение арифметического выражения:
«Webhook»
Рассмотрим пример, когда нам требуется отправить смс с помощью стороннего сервиса. Для отправки нам нужно создать веб-хук с номером телефона и текстом сообщения, например:

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