Тег
Тег — особая текстовая конструкция внутри большого выражения, которая автоматически заменяется на переменное значение (взятое, например, из базы данных Такси-Мастер, из карточки заказа и т. д.). Теги предназначены для того, чтобы в тексте сообщения заменять себя на значение, которое в большинстве случаев берется из программы Такси-Мастер. Теги вставляются в шаблоны СМС-сообщений.
Тегов в шаблоне может быть как угодно много, они могут встречаться как угодно часто, но их написание должно точно соответствовать правилам:
- Тег заключается в знаки %: %ПримерТега%.
- Тег является регистрозависимым, то есть %Тег% и %тег% — это разные теги.
Содержание
Общие теги
Существует множество общих тегов, то есть тех тегов, которые работают во всех СМС-сообщениях. Ниже приведены теги, которые могут быть использованы для устройств, отправляющих СМС-сообщения в сети GSM. Для удобства они поделены на группы.
Список полей из карточки заказа:
- %Phone% — номер телефона заказчика.
- Например, шаблон Заказчик (%Phone%)..., если номер клиента - 7159561, преобразует текст СМС так: Заказчик (7159561)....
- %CPhone% — номер телефона на отзвон.
- %Src% — адрес подачи.
- %Dest% — адрес назначения.
- %Amount% — сумма за заказ (поле Сумма в карточке заказа).
- Например, шаблон %Src% - %Dest%, %Amount% позволит вставлять в текст сообщения адрес подачи, адрес назначения и сумму за заказ и разделить их тире и запятой.
- %Disc% — результирующая скидка в рублях.
- Например, шаблон Скидка: %Disc% р при скидке 5% и стоимости заказа 100 рублей преобразуется в сообщение Скидка: 5 р.
- %ITime% — время поступления заказа.
- %PTime% — время подачи, то есть время, в которое нужно начать выполнение заказа. Полезно для оповещения водителей о предварительных заказах.
- %Cou% —
- %CarType% — тип автомобиля (наименование).
- %CarCallID% — позывной автомобиля.
- %CarGosNum% — госномер автомобиля. Этот тег удобен для отправки заказчикам в шаблоне вида ...госномер %CarGosNum%....
- Например, в шаблоне Машина подана: номер %CarGosNum%, цвет %CarColor% содержится информация о госномере и о цвете автомобиля.
- %CarColor% — цвет автомобиля.
- %CarMark% — марка автомобиля.
- %Min% — время до подачи, которое водитель указал в TMDriver, когда принимал заказ.
- %Client% — имя клиента (берется из карточки заказа).
- %ClientName% — имя клиента или заказчика (берется из карточки телефона). Обратите внимание: тег не ссылается на данные из карточки физического или юридического лица. Работает только для массовых рассылок.
- %ClientCaption% — имя заказчика из карточки физического или юридического лицасм. список изменений.
- %CarArrive% — фактическое время подачи машины, указанное в часах и минутах. В отличие от %Min%, абсолютное время («Машина будет в 12:45») является более надежным, чем относительное («Машина будет через 5 минут»), поскольку из-за задержки отправки сообщения не теряет актуальность.
- %Description% — примечание к заказу. Будьте осторожны: объемы данных в этом поле могут быть велики с точки зрения номинального объема СМС.
- %orderid% — уникальный идентификатор заказа (его номер)см. список изменений.
- %PrizePhoneCnt% — количество заказов до призового (текст задается в параметрах).
- %TaximeterDistance% — расстояние по таксометру в километрах.
- %TaximeterDuration% — общее время в пути.
Список полей из карточки водителя:
- %DrvAmount% — текущий счет водителя. Тег удобен для оповещения водителей о состоянии их счетов при выходе на смену.
- %DriverCellPhone% — сотовый телефон водителя.
- %DriverHomePhone% — домашний телефон водителя.
- %DriverName% — полное имя водителя (ФИО).
Список дополнительных данных:
- %DateTime% — текущие дата и время. Формат даты и времени задается в параметрах.
- %Date% — текущая дата. Формат даты задается в параметрах.
- %Time% — текущее время. Формат времени задается в параметрах.
Специфические теги
Есть также специфические теги, предназначенные для массовой рассылки. Массовая рассылка — это отдельная возможность модуля, и для нее представлены следующие теги:
- %SpamStart% — начало выбранного периода, статистика за который будет рассылаться. Дата выводится в формате dd.mm.yyyy.
- %SpamStop% — конец выбранного периода статистики. Дата выводится в формате dd.mm.yyyy.
- %OrdersCnt% — количество заказов, выполненных за выбранный период статистики.
Формат тегов
Теги могут быть выведены в соответствии с особым форматом, который задается в параметрах модуля СМС. Он задает маску, по которой затем формируется значение. Маска может содержать следующие заменяемые значения:
- dd — день (число), например, 22.
- mm — номер месяца, например, 03.
- yyyy — год, обозначенный четырьмя цифрами, например, 2000.
- hh — часы, например, 22.
- nn — минуты (задействована буква “n”, поскольку “m” уже обозначает месяц), например, 58.
- ss — секунды, например, 00.
Переменные могут быть разделены пробелами, знаками . или -, а также другими знаками, однако использование других знаков не рекомендуется.
