Шаблоны действий
Видеоинструкция
Описание
Шаблон действия — это сохраненный вами набор настроек действия. Удобно применять шаблоны в случаях, когда одно и то же действие вы используете в разных сценариях/рассылках. Шаблоны бывают разных типов:
- SMS потенциальному клиенту;
- SMS обращавшемуся клиенту;
- Сервисные СМС;
- SMS менеджеру;
- E-mail;
- Webhook;
- WhatsApp;
- Email клиенту;
- VK;
- Viber.
Соответствующий тип шаблона можно применять только в соответствующем типе действия. Ниже рассмотрим настройки каждого из типов шаблонов.
Доступные макросы в шаблонах
В шаблонах действий доступно использовать динамические параметры. В указанные места шаблона будет подставляться значение, соответствующее конкретному клиенту в рамках сценария. Ниже представлен список доступных параметров:
Название | Параметр | Описание | Ограничения |
Тип вебхука | type |
Тип вебхука. В качестве значения всегда передается calltouchLeads.
|
— |
Дата и время отправки вебхука в формате Unix Time Stamp | sendingTimestamp |
Дата и время отправки вебхука в формате Unix Time Stamp в секундах.
|
— |
ID клиента | clientId |
ID клиента, в рамках которого осуществлено действие.
Если отсутствует, то значение не указывается. |
— |
Номер клиента | phone |
Телефонный номер клиента из лида в формате 7XXXXXXXXXX.
Если отсутствует, то значение не указывается. |
— |
Email клиента |
Почта клиента user@server.com.
Если отсутствует, то значение не указывается. |
— | |
ФИО клиента | fio |
Имя клиента.
Если отсутствует, то значение не указывается. |
— |
Дата и время первого касания | firstInteractionDate |
Дата и время первого касания клиента в формате yyyy-mm-dd hh:mm:ss.
|
— |
Дата и время последнего касания | lastInteractionDate |
Дата и время последнего касания в формате yyyy-mm-dd hh:mm:ss.
|
— |
Менеджер клиента | clientManager | Менеджер клиента. Если несколько, то перечисляются через запятую. | — |
Теги клиента | clientTags |
Теги клиента.
Если отсутствует, то значение не указывается. |
— |
ID сайта | siteId |
ID проекта Calltouch, в рамках которого осуществлено действие.
|
— |
Название сайта | siteName |
Название проекта Calltouch, в рамках которого осуществлено действие.
|
— |
ID сценария | scenarioId |
Идентификатор сценария, в рамках которого осуществлено действие.
|
— |
Название сценария | scenarioName |
Название сценария, в рамках которого осуществлено действие.
|
— |
Тип сценария | scenarioType |
Тип сценария, в рамках которого осуществлено действие.
Доступные значения:
|
— |
ID аудитории | audienceId |
Идентификатор аудитории, используемой в сценарии.
|
— |
Название аудитории | audienceName |
Название аудитории, используемой в сценарии.
|
— |
Тип аудитории | audienceType |
Тип аудитории, в рамках которой осуществлено действие.
Доступные значения:
|
— |
Тип события | triggerType |
Тип события, в результате которого осуществлено действие.
Доступные значения:
|
Только для триггерных сценариев. |
Источник | source |
Источник сессии, в рамках которой клиент вернулся на сайт.
|
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Канал | medium |
Канал сессии, в рамках которой клиент вернулся на сайт.
|
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Метка utm_campaign | utmCampaign |
Метка utm_campaign, в рамках которой клиент вернулся на сайт. Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_campaign отсутствовала или была пуста, то передается значение <не заполнено>.
|
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Метка utm_content | utmContent |
Метка utm_content, в рамках которой клиент вернулся на сайт. Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_content отсутствовала или была пуста, то передается значение <не заполнено>.
|
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Метка utm_term | utmTerm |
Метка utm_term, в рамках которой клиент вернулся на сайт. Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_term отсутствовала или была пуста, то передается значение <не заполнено>.
|
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
ID посетителя сайта | ctClientId |
Идентификатор вернувшегося посетителя Calltouch. Он представляет из себя значение cookie _ct.
|
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Глобальный ID посетителя сайта | ctGlobalId |
Глобальный идентификатор посетителя Calltouch, общий для сайтов, на которых установлен скрипт Calltouch. Он представляет из себя значение сквозной cookie _ct_client_global_id. Значение параметра формируется только при включении соответствующего сеттинга (требуется обратиться к вашему менеджеру). Если сеттинг не включен или значение отсутствует, то значение не указывается.
|
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Google Client ID | gcid |
Идентификатор Google Client ID.
Если Google Client ID не удалось определить, то значение не указывается. |
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Yandex Client ID | yaClientId |
Идентификатор Yandex Client ID.
Если Yandex Client ID не удалось определить, то значение не указывается. |
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Домен | domain |
Домен сайта в рамках сессии возвращения клиента.
Если домен не удалось определить, то значение не указывается. |
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Страница входа на сайт | urlEntry |
URL входа на сайт в рамках сессии возвращения клиента.
Если не удалось определить, то значение не указывается. |
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Страница выхода | urlExit |
URL выхода с сайта в рамках сессии возвращения клиента.
Если не удалось определить, то значение не указывается. |
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Время на сайте | sessionDuration |
Время, проведенное на сайте в рамках сессии возвращения клиента, в секундах.
Если не удалось определить, то значение не указывается. |
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Достигнутые цели | goals |
Достигнутые цели в рамках сессии возвращения клиента. Передаются через запятую.
Если достигнутых целей не было, то значение не указывается. |
Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Товары в корзине | productsInBasket | Товары, которые были добавлены в корзину в рамках сессии. Передаются по формату: название_1 (категория_1, бренд_1, разновидность_1, цена_1, количество_1), название_2 (категория_2, бренд_2, разновидность_2, цена_2, количество_2). | Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Заказанные товары | orderedProducts | Товары, по которым зафиксирован заказ в рамках сессии. Передаются по формату: название_1 (категория_1, бренд_1, разновидность_1, цена_1, количество_1), название_2 (категория_2, бренд_2, разновидность_2, цена_2, количество_2). | Только для триггеров, связанных с визитом сайта (начало сессии, достижение цели и т.п.) |
Теги | tags |
Теги лида или сделки. Передаются через запятую.
Если тегов нет, то значение не указывается. |
Только для триггеров, связанных с лидами и сделками (новый лид, изменение статуса сделки и т.п.) |
Вид лида | leadKind |
Вид лида.
Доступные значения:
|
Только для триггеров, связанных с лидами (новый лид, изменение лида и т.п.) |
Типы лида | leadTypes |
Типы лида, к которым принадлежит конкретный лид.
Передается через запятую.
Доступные значения:
|
Только для триггеров, связанных с лидами (новый лид, изменение лида и т.п.) |
Комментарий | leadComment |
Комментарий звонка или заявки.
Передается только для триггерных сценариев с событиями «Новый лид» и «Изменение лида». |
Только для триггеров, связанных с лидами (новый лид, изменение лида и т.п.) |
Воронка | dealFunnel |
Воронка сделки.
|
Только для события «Новая сделка» триггерных сценариев. |
Этап | dealStatus |
Этап сделки.
|
Только для триггеров, связанных со сделками (новая сделка, изменение статуса сделки и т.п.) |
Менеджер | dealManager |
Менеджер сделки.
|
Только для триггеров, связанных со сделками (новая сделка, изменение статуса сделки и т.п.) |
Название сделки | dealName |
Название сделки.
|
Только для триггеров, связанных со сделками (новая сделка, изменение статуса сделки и т.п.) |
Выручка | dealRevenue |
Выручка сделки.
|
Только для триггеров, связанных со сделками (новая сделка, изменение статуса сделки и т.п.) |
Ссылка на ближайший лид клиента | clientLastLeadUrl |
Ссылка на ближайший лид пользователя (звонок или заявка). Если у клиента нет лидов, то значение не указывается.
|
— |
Ссылка на ближайшую сделку клиента | clientLastDealUrl |
Ссылка на ближайшую сделку пользователя. Если у клиента нет сделок, то значение не указывается.
|
— |
SMS обращавшемуся клиенту
Текст сообщения. Заполните содержимое сообщения. В тексте сообщения допустимо использовать динамические переменные, в которые будут подставлены актуальные данные о конкретном клиенте. Список доступных параметров представлен в статье Действие «Webhook». Если значение параметра вставить не удалось, то на месте макроса будет пустота. Доступен поиск по названию параметров:
Обратите внимание на следующие моменты:
- Стоимость отправки сообщения зависит от количества символов в нем. Итоговая длина сообщения формируется после подстановки динамических параметров.
- Если после подстановки динамических параметров получилось больше 268 символа, то сообщение отправлено не будет.
Важно! Если в сообщении используется макрос, например ФИО, то стоимость рассылки рассчитывается по самому высокому тарифу (т.е. как за стоимость 268 символов). Имеющиеся средства резервируются под рассылку, а после ее завершения, оставшаяся часть денег возвращается на баланс.
Короткая ссылка. В тексте сообщения можно указать ссылку на посадочную продающую страницу или на страницу с условиями акции. Но использование обычного URL непозволительная роскошь, потому что количество доступных символов ограничено. Поэтому, вы можете воспользоваться генератором коротких ссылок, представленных в шаблоне:
Введите адрес посадочной страницы и значения utm-меток для фиксации переходов из SMS. Также в ссылке будет присутствовать метка calltouch_sms, в которой будет содержаться уникальный ID клиента. По данному идентификатору Calltouch сможет предоставить персонализированную post-view аналитику по клиентам, перешедшим по ссылке, но не совершившим обращение.
Сервисные СМС
Как создать сервисное сообщение?
- Создать Правило сервисного СМС.
Для создания правила перейдите в раздел: Конверсия / Триггерные сценарии / раздел "Шаблон действий" / "Правила сервисных СМС". - Создать Шаблон сервисного СМС на основе правила:
- При создании шаблона вы сможете его проверить на соответствие созданным ранее правилам;
- Если шаблон соответствует правилу/правилам и правило успешно прошло модерацию у операторов мобильной связи, то СМС будет стоить дешевле;
- Если при проверке шаблона на соответствие правилу подходящих правил не отображается, значит данный шаблон нужно отредактировать и привести в соответствие одному из правил.
- Использовать созданный шаблон в рассылках или сценариях.Правило сервисного СМС — это “макет” будущего сообщения. Если текст отправляемого сообщения будет соответствовать правилу, то SMS тарифицируется дешевле.
СМС будет тарифицировано как сервисное в случае, если:
Итоговый текст СМС соответствует тексту правила;
Правило, на основе которого был создан шаблон, успешно прошло модерацию у того оператора мобильной связи, чьим абонентом является получатель.
Создание правила
Создаваемое правило будет отправлено на регистрацию операторам мобильной связи. Правило служит “каркасом” для будущего сообщения. Если сообщение будет соответствовать правилу, то оно будет тарифицировано дешевле.
При создании правила укажите текст SMS, используя динамические переменные.
Динамические переменные — специальные параметры для обозначения, какой именно набор символов может подставляться вместо переменной. Синтаксис напоминает регулярные выражения.
Переменная | Описание переменной |
%w | Набор букв, цифр и/или спецсимволов без пробелов. Пример: Правило: Поступила новая заявка на проекте %w.Текст СМС: Поступила новая заявка на проекте Ласточки. |
%d | Набор цифр и/или спецсимволов без пробела. Пример: Правило: Звоните по номеру: +%dТекст СМС: Звоните по номеру: +79999999999 |
%d+ | Последовательность чисел (не более 10, состоящих из цифр или допустимых спецсимволов, описанных ниже), разделенных пробелом (пробелов может быть несколько, а может не быть вовсе). Пример: Правило: Выберете одно из чисел: %d+, и мы пришлем Вам скидку или другой подарок.Текст СМС: Выберете одно из чисел: 10 20 30 40 50, и мы пришлем Вам скидку или другой подарок. |
%w{1,n} | Последовательность слов (состоящих из букв, цифр/спецсимволов, описанных ниже), разделенных пробелом (или несколькими пробелами), где: n – число слов (не менее 2 и не более N). Пример: Правило: Привет, %w{1,3}! *Текст СМС: Привет, Уилл Байерс! или Привет, Уилл Уилльям Байерс! *Если ожидаются последовательности букв или цифр (например, Имя Отчество), то используйте переменные с последовательностями. |
%d{1,n} | Последовательность чисел (состоящих из цифр и/или спецсимволов, описанных ниже), разделенных пробелом (или несколькими пробелами), где: n – количество чисел (не менее 2 и не более N). Пример: Правило: Обратный звонок с номера +%d, неудачный в %d{1,2}Текст СМС: Обратный звонок с номера +79998887766, неудачный в 12:40 |
Примеры правила и итогового текста СМС:
Правило: Вы записаны в клинику "%w{1,2}" %d в %d. Подтвердите запись.
Текст СМС: Вы записаны в клинику "Доктор Слон" 28.12.2024 в 19:00. Подтвердите запись.
- Мегафон и Теле2 — от 2 до 7 дней.
- МТС — около 2 недель.
- Билайн — 1 и 15 числа каждого месяца.
Рекомендации к оформлению правил
- Правило создается в связке с конкретным именем отправителя. Если имен на проекте несколько, то и правил будет больше;
- Переменные %d, %d{1,n}, %d+, %w, %w{1,n}, %w+ должны быть отделены от статического текста пробелом;
- Следует избегать дублирования правил, кроме случаев, когда правило используется на нескольких именах отправителя;
- В правилах вида: "Код подтверждения: %d", "Пароль: %w" необходимо указывать ресурс (адрес сайта, название приложения).
SMS потенциальному клиенту
Настройки шаблона
Текст сообщения. Требуется ввести текст сообщения, которое вы планируете отправлять клиентам.
При составлении текстов необходимо руководствоваться несколькими моментами:
- Принципами формирования конверсионных текстов — каждый текст должен быть интересным для получателей, т.е. он должен содержать суть предложения, выгоды, если таковые есть (акции, скидки и т. д.), ссылку на сайт либо номер телефона. Текст должен быть емким и понятным, но нужно помнить, что длина СМС ограничена 201 символом и от количества зависит стоимость SMS;
- Законом о рекламе — текст СМС не должен содержать браных слов, порочить честь и достоинство, вводить в заблуждение и т. д. Более подробно по ссылке;
- Политикой операторов — у операторов есть свои правила составления СМС. За основу можно взять требования, предоставленные МТС. Это очень важный блок и с ним необходимо ознакомиться перед составлением текста сообщения. Если коротко, то все акции должны быть описаны полностью, содержать все условия. Если есть ссылка на сайт, то акция должна быть и на сайте. Все акции имеют срок и правила проведения - это нужно учитывать при составлении текста.
От количества символов в сообщении будет зависеть стоимость рассылки, учитывайте это при составлении текста.
Для вашего удобства при составлении шаблона выводится количество частей сообщения и оставшееся количество символов для части:
Короткая ссылка. В тексте сообщения можно указать ссылку на посадочную продающую страницу или на страницу с условиями акции. Но использование обычного URL непозволительная роскошь, потому что количество доступных символов ограничено. Поэтому, вы можете воспользоваться генератором коротких ссылок, представленных в шаблоне:
Введите адрес посадочной страницы и значения utm-меток для фиксации переходов из SMS. Нажмите на кнопку «Сгенерировать ссылку» и вставьте полученный URL в текст сообщения.
Обязательно проверьте работоспособность полученной ссылки, перейдя по ней.
Модерация сообщений
Шаблоны SMS после каждого изменения отправляются на модерацию, в рамках которой сообщение будет проверено на соответствие требований ФЗ о рекламе и требований мобильных операторов. После завершения модерации вы получите уведомление на электронную почту.
Если шаблон не прошел модерацию, то он получит статус «Отклонен», а при наведении курсора на статус вы увидите детализацию причины отклонения:
При отклонении шаблона внесите в него соответствующие правки и отправьте его на модерацию повторно.
SMS менеджеру
Текст сообщения. Заполните содержимое сообщения. В тексте сообщения допустимо использовать динамические переменные, в которые будут подставлены актуальные данные о конкретном клиенте. Список доступных параметров представлен в статье Действие «Webhook». Если значение параметра вставить не удалось, то на месте макроса будет пустота. Доступен поиск по названию параметров:
Обратите внимание на следующие моменты:
- Стоимость отправки сообщения зависит от количества символов в нем. Итоговая длина сообщения формируется после подстановки динамических параметров. Учитывайте это, используя макросы в сообщениях;
- Если после подстановки динамических параметров получилось больше 201 символа, то сообщение отправлено не будет.
Заголовок письма. Заполните название темы письма, отправляемого при достижении событий сценария.
Текст письма. Заполните содержимое письма. В тексте сообщения допустимо использовать динамические переменные, в которые будут подставлены актуальные данные о конкретном клиенте. Список доступных параметров представлен в статье Действие «Webhook». Если значение параметра вставить не удалось, то вставляется пустота. В шаблоне доступен поиск по названию параметров:
Webhook
Адрес обработчика. Необходимо указать HTTP(S) адрес обработчика webhook'ов на вашем сервере, на который будут отправляться HTTP-запросы с нашей стороны автоматически при наступлении определенного события.
Метод передачи данных. Укажите метод, POST или GET. Их отличия вы сможете найти в статье о вебхуках из системы Calltouch.
Передаваемые поля. Выберите параметры, которые нужны вам для работы с клиентом. Список параметров описан в Действие «Webhook».
Отправить тестовый запрос. Для проверки корректности работы вы можете отправить тестовый запрос на ваш обработчик, используя кнопку «Отправить тестовый запрос». Результат отправки будет доступен рядом с кнопкой:
Для создания шаблона Whatsapp доступна интеграция с двумя сервисами рассылок: TextBack / SigmaSMS.
- При выборе сервиса рассылок SigmaSMS необходимо будет ввести логин и пароль от личного кабинета SigmaSMS.
- При выборе сервиса рассылок TextBack требуется заполнить поле «Токен». Для этого нужно зайти в личный кабинет TextBack в раздел "Интеграции" и нажать кнопку "Сгенерировать API токен".
После того как данные будут заполнены, нажмите кнопку "Сохранить". Шаблон поменяет статус на "Доступен".
Email клиенту
Для создания шаблона E-mail доступна интеграция с двумя сервисами рассылок: Unisender / Notisend.
Для настройки интеграции с обоими сервисами понадобится ввести API ключ, который можно будет найти в личном кабинете:
- Unisender. В правом верхнем углу необходимо нажать на значок со своим логином и перейти в настройки. В настройках выбрать раздел "Интеграция и API", где будет указан ключ доступа.
- Notisend. В разделе "Автоматизация" => "API и SMTP" => "Параметры подключения".
Скопированный ключ введите в поле "API ключ" и нажмите кнопку "Сохранить". Шаблон поменяет статус на "Доступен".
VK и Viber
Для создания шаблона VK / Viber доступна интеграция с двумя сервисами рассылок: Imobis / SigmaSMS.
- При выборе сервиса рассылок SigmaSMS необходимо будет ввести логин и пароль от личного кабинета SigmaSMS.
- При выборе сервиса рассылок Imobis требуется заполнить поле «Токен». Найти токен можно в личном кабинете Imobis в разделе "Токены", если его нет — создать.
После того как данные будут заполнены, нажмите кнопку "Сохранить". Шаблон поменяет статус на "Доступен".
Удаление шаблонов
Удалить можно только те шаблоны, которые не задействованы в сценариях или рассылках.
Пресеты шаблонов
Для действий «SMS потенциальным клиентам» и «SMS обращавшимся клиентам» доступны отраслевые и ситуационные шаблоны:
и мы поможем вам
- A/B тестирование (раздел «Подключение»)
- Email-трекинг (раздел «Подключение»)
- Отслеживание офлайн конверсии (раздел «Подключение»)
- Подключение к отслеживанию дополнительных доменов (раздел «Подключение»)
- Подмена номеров на AMP-страницах Google (раздел «Подключение»)