Типы шаблонов экспорта для сообщений: Sms, автоотправка, мессенджеры

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

Что нужно до начала

  • Права на создание объектов администрирования. Если пункта Создать → Администрирование нет, обратитесь к своему администратору
  • Готовый текст сообщения. Для СМС держите его в пределах 70 символов кириллицей: всё, что длиннее, уходит несколькими частями и оплачивается по частям
  • Понимание, откуда будете отправлять: из заказ-наряда, из заказа товара, из карточки клиента. От этого зависит шаг 3

Шаг 1. Выбрать тип шаблона

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

Тип шаблона Канал Когда отправляется
Sms СМС сотрудник вручную из документа или массово из отчёта
Sms с авто-отправкой СМС сама, при переводе документа в нужный статус
Сообщение мессенджеров мессенджеры сотрудник вручную из документа или массово из отчёта
Сообщение мессенджеров с авто-отправкой мессенджеры сама, при переводе документа в нужный статус

Остальные три типа в списке — Html страница, Html наклейка и печатная форма Excel — к сообщениям отношения не имеют.

Список Тип шаблона в карточке шаблона экспорта: Sms, Sms с авто-отправкой, сообщения мессенджеров

Обратите внимание. Шаблоны с автоотправкой и без неё — разные записи. Один шаблон не умеет работать и по кнопке, и автоматически: если нужны оба сценария, заводите два.

Шаг 2. Создать шаблон

Откройте Создать → Администрирование → Шаблон экспорта.

Меню Создать, Администрирование, Шаблон экспорта

Шаг 3. Заполнить наименование и тип документа

В поле Наименование напишите то, что должно быть на кнопке: название шаблона станет её подписью. «Напомнить о записи» понятнее, чем «Шаблон 3».

В поле Тип документа выберите сущность, к которой шаблон привязан: заказ-наряд, заказ товара, продажу, счёт, отгрузку или карточку агента. Именно это поле определяет, где появится кнопка отправки: шаблон, привязанный к заказ-наряду, в продаже не покажется.

Раскрытый список Тип документа в карточке шаблона экспорта

Обратите внимание. Тип документа у шаблона один, и универсального шаблона «на всё» не бывает. Если одно и то же сообщение нужно отправлять из нескольких документов, создайте отдельный шаблон под каждый — даже если текст в них слово в слово одинаковый.

Шаг 4. Выбрать тип шаблона

Поставьте в поле Тип шаблона значение из шага 1.

Шаг 5. Написать текст сообщения

Текст задаётся выражением. Даже простое сообщение без подстановок рекомендуем оборачивать в функцию format:

format("Весь сентябрь диагностика ходовой — БЕСПЛАТНО! Запись по т.200-36-35")

Чтобы подставить данные клиента или документа, добавьте к тексту ссылку на нужное свойство. Здесь this — документ, из которого идёт отправка:

format("Благодарим, что выбрали нас! Ваш бонусный счет составляет {0:N0} бонусов", this.Customer.BonuseBalance)

Полный список объектов и их свойств — в объектной модели.

Шаг 6. Задать условие отправки

Поля Показывать если и Доступно если принимают выражение с состоянием документа. Для шаблона с авто-отправкой это то самое место, где задаётся статус-триггер: в какой статус переведут документ, тогда сообщение и уйдёт. Годится любое из двух полей, заполнять оба не нужно.

Для обычного шаблона поля работают по-разному и независимо: Показывать если решает, есть ли кнопка на панели документа, а Доступно если — можно ли на неё нажать. Если условие показа выполняется, а условие доступности нет, кнопка будет видна, но неактивна — приём полезный: сотрудник знает, что такая отправка существует, но раньше времени ей не воспользуется.

Например, State="executed" означает «когда заказ-наряд завершён».

Значение Состояние заказ-наряда
draft Черновик
scheduled Запланирован
processing В работе
completed Работа сделана
invoiced Выставлен счёт
paid Оплачен
executed Завершён
deficiency Дефектная ведомость
cancelled Отменён

У продажи и заказа товара наборы состояний свои. Посмотреть их можно также в объектной модели.

Шаг 7. Включить шаблон и сохранить

Поставьте галочку Активно и сохраните карточку. Без этой галочки шаблон существует, но нигде не предлагается.

Заполненная карточка шаблона экспорта: наименование, тип документа, тип шаблона Sms, текст сообщения и условие показа

Шаг 8. Для автоотправки — включить её в параметрах

Шаблона с автоотправкой мало: сама автоотправка включается отдельно, в Настройки → Параметры → Отправка сообщений в мессенджеры и SMS. Вкладка доступна только пользователю со статусом Администратор.

Настроек там две, независимых: одна для СМС, вторая для мессенджеров. У каждой три значения — Отключено, Включено и Запрашивать пользователя. Последнее означает, что в момент смены статуса система покажет текст и номер и спросит, отправлять ли.

Параметры приложения, вкладка Отправка сообщений в мессенджеры и SMS: варианты автоотправки

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

Готовые выражения для типовых сообщений

Ниже — заготовки, которые закрывают большинство рассылок. Замените в них телефон и текст на свои.

Обращение по имени, а к клиентам постарше — по имени-отчеству. Порог — 30 лет; отчество подставится, только если оно заполнено в карточке.

Customer.FirstName + (Customer.Birthdate < #today# — 30 * 365 && Customer.MiddleName != "" ? " " + Customer.MiddleName : "")

Обращение по полу. Пол берётся из карточки агента: 1 — мужской, 2 — женский, 0 — не указан.

(Sex = 1 ? "Уважаемый " : Sex = 2 ? "Уважаемая " : "") + FirstName

Приветствие по возрасту. Клиентам младше 25 — «Привет», остальным — «Здравствуйте».

(Birthdate > #today# — 25 * 365 ? "Привет, " : "Здравствуйте, ") + Name

Обратите внимание. Незаполненная дата рождения читается как «клиент постарше»: сработает вариант с отчеством и со «Здравствуйте».

Откуда брать поля

Набор доступных полей зависит от того, откуда уходит сообщение.

Откуда отправляете Как обращаться к данным
Кнопка в документе this — сам документ: Customer.FirstName, Number, DateTimeIn
Рассылка из отчёта, строки которого — клиенты this.Entity — карточка клиента: Entity.FirstName, Entity.MiddleName
Рассылка из отчёта, строки которого — документы this.Entity — документ: Entity.Customer.FirstName
Любая рассылка из отчёта колонки самого отчёта пишутся своим именем: MinDate, BonusAmount

this. в начале можно опускать: допускаются оба варианта написания — Entity.FirstName и this.Entity.FirstName.

Поля, которые нужны чаще всего:

Откуда рассылаете Поля Что подставится
Отчёт Напоминание клиентам о заканчивающихся бонусах MinDate, BonusAmount дата сгорания и сумма бонусов
Отчёт Ведомость активных бонусов ED, BonusCreated дата окончания и начисленная сумма
Отчёт Напоминание клиентам о периодических услугах PerformedHaulDistance пробег, на котором услугу выполняли в прошлый раз
Отчёт Дни рождения агентов Agent.FirstName, Agent.MiddleName, Sex имя, отчество и пол клиента
Заказ товара Number, Customer.FirstName номер заказа и имя клиента
Заказ-наряд DateTimeIn, Estimation, Examiner.Agent.FirstName время записи, оценка длительности работ в минутах, имя приёмщика

Готовые примеры целиком.

Напоминание о заканчивающихся бонусах:

format("{0}, напоминаем: {1:dd.MM.yyyy} закончится действие бонусов на сумму {2:N0}. Успейте потратить их на свой автомобиль. т. 22-333-22",
       Entity.FirstName, MinDate, BonusAmount)

Напоминание о периодической услуге:

format("{0}, последняя замена масла была на пробеге {1}. Проверьте пробег и запишитесь на замену. т. 222-33-22",
       Entity.FirstName, PerformedHaulDistance)

Сообщение о поступившем заказе товара — шаблон на документе:

format("{0}, ваш заказ № {1} поступил на склад. т. 333-22-333", Customer.FirstName, Number)

Напоминание о записи с именем приёмщика — рассылка по заказ-нарядам:

format("{0}, напоминаем, что вы записаны на ремонт {1:dd.MM.yyyy в HH:mm}.{2} Ждём вас! т. 333-22-333",
       Entity.Customer.FirstName, DateTimeIn,
       (Entity.Examiner = null ? "" : " Ваш приёмщик " + Entity.Examiner.Agent.FirstName + "."))

Важно. Шаблон строится на полях того отчёта, из которого идёт рассылка. Один и тот же текст для двух разных отчётов собирается из разных полей — перенести выражение целиком не получится.

Как понять, что всё получилось

Откройте документ того типа, который выбрали на шаге 3: на верхней панели появилась кнопка с названием вашего шаблона, при наведении — подсказка про отправку.

Для автоотправки проверка другая: переведите тестовый документ в статус из шага 6. Сообщение либо уходит само, либо система спрашивает подтверждение — в зависимости от значения, выбранного на шаге 8.

Если что-то пошло не так

Симптом Причина Что делать
Кнопки в документе нет Неверный Тип документа или снята галочка Активно Проверить шаги 3 и 7
Кнопка есть, но неактивна Не выполняется условие Доступно если Сверить состояние документа с выражением из шага 6
Автоотправка не срабатывает Взят тип шаблона без автоотправки, либо настройка в параметрах стоит в Отключено, либо условие указывает на другой статус Пройти шаги 1, 6 и 8 по порядку; заодно проверить баланс — при нулевом СМС не уходят
Вместо имени клиента пришёл текст выражения Текст не обёрнут в format или ошибка в имени свойства Вернуться к шагу 5, сверить свойство с объектной моделью
В сообщении пришла половина текста Длинное СМС ушло частями, часть не доставлена Сократить текст до одной части
При массовой рассылке в списке видны шаблоны для других документов При отправке из отчёта Тип документа не учитывается — предлагаются все шаблоны сообщений Выбирать по названию; поэтому и стоит называть шаблоны понятно (шаг 3)
В списке шаблонов вперемешку сообщения и печатные формы Так и есть, они хранятся вместе Ориентироваться на колонку Тип шаблона

Куда дальше

Перед этим: Мессенджеры через Teletype: как устроена интеграция и какие каналы бывают.

После этого: Массовая рассылка из отчёта: операция создания переговоров.

Рядом: Автоматическая отправка сообщения при смене статуса · Пример: рассылка напоминания о записи · Сколько стоит СМС: длина сообщения, части, дубли.

Rate this post
Яндекс.Метрика