.top-button { background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/baseline_keyboard_arrow_up_white_18dp.png) !important; background-position: center; background-color: #47a7f5 !important; background-repeat: no-repeat; box-shadow: -1px 1.5px 3px #999; color: #47a7f5 !important; border-radius:50px !important; position: fixed; bottom: 45px; left: 93.5%; width: 50px; height: 50px !important; font-size: 12px !important; padding: 14.5px !important; z-index: 2; } .top-button:hover{ background-color: #65b9ff !important; color: #65b9ff !important; } .page-header{ background-color: #232838; background-repeat: no-repeat; background-position: center; width: auto; height: 100px; background-image: url(https://confluence.twin24.ai/download/attachments/23986188/logo_twin-02.png); background-size: 10em; color: #fff; font-size: 20px; padding: 20px; } .page-footer{ background-color: #232838; background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/decorated-pattern-dark.png); width: auto; height: 10px; color: #fff; text-align: end; font: small-caption; padding-inline-end: 30px; padding-top: 200px; padding-bottom: 30px; } .page-headline{ background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/Solid256dot8_2changed.png); background-repeat: no-repeat; background-position-x: -227px; background-position-y: center; padding: 20px; background-color: #007bff; width: auto; height: 10px; color: #fff; text-align: center; font: caption; font-weight: 600; } .tabs-menu{ padding-left: 85% !important; }

In the Notifications section you can send automated texts and advertisement messages to your clients using different communication channels.

Working with notification templates

On the side menu click Notifications – templates. As a result the Templates page will open.

TWIN user documentation > Notifications > image-2023-1-29_15-14-52.png

The Templates page contains a list of all notification templates that you can use to send automated texts and advertisement messages to your clients.

Each notification template contains the sender name, the message text, and other parameters.

To send automated texts and advertisement messages to your clients you must register the sender name with your mobile network carrier. The sender name that you plan to use must match the name of your company or your website. After that you need to create a request to the technical support so that you can use the registered sender name in your account.

Creating notification templates

Click Create a notification template at the top of the page.

TWIN user documentation > Notifications > image-2023-1-29_15-30-52.png

As a result a new page will open as shown in the image below.

TWIN user documentation > Notifications > image-2023-1-29_15-34-17.png

To create a new notification template, do the following:

1. In the Template name field enter the name of a new template.

It is recommended to use simple and concise template names. Later this will help you remember why you created a certain notification template.

2. In the Message sent time section select the period of time that you want the system to send automated texts or advertisement messages to your clients.

If necessary you can click on the + button and set an additional time period. If you send notifications after the first time period is over, then the system will send them within the second time period.

TWIN user documentation > Notifications > image-2023-1-29_15-47-37.png

3. In the Message templates by channel field select the necessary communication channel and click Add. The system will use this channel to send notifications to your clients. As a result the section with parameters of the selected communication channel will open.

You can set up one or multiple communication channels at the same time.

Instructions for configuration of notifications by email

TWIN user documentation > Notifications > image-2023-1-29_15-57-53.png

You can use this communication channel provided you send more than 1 000 000 messages per month. To connect this communication channel you need to create a request for technical support.

To configure notifications by email, do following:

In the Message text field enter the text of a message that you want to send.
In the Sender field enter your registered sender name. This name will be displayed in the "From" field.
In the Sending lifetime field specify a period of time (in minutes) during which the system will attempt to send your message to clients. If a message is not sent within the specified period (for example, due to a technical error that the mobile network carrier is responsible for), then the message will receive the Not delivered status.

Instructions for configuration of notifications by SMS

TWIN user documentation > Notifications > image-2023-1-29_19-48-14.png

To configure notifications by email, do following:

In the Message text field enter the text of a message that you want to send.

To make the notification template more universal, you can use variables (i.e., {variable_name}) in the message text. When you send messages, you can specify values for all variables.

In the Sender field enter your registered sender name. This name will be displayed in the "From" field.
In the Sending lifetime field specify a period of time (in minutes) during which the system will attempt to send your message to clients. If a message is not sent within the specified period (for example, due to a technical error that the mobile network carrier is responsible for), then the message will receive the Not delivered status.

Instructions for configuration of PUSH notifications

TWIN user documentation > Notifications > image-2023-1-29_20-0-21.png

You can use this communication channel provided you send more than 100 000 messages per month. To connect this communication channel you need to create a request for technical support.

To configure push notifications, do following:

In the Message text field enter the text of a message that you want to send.

In the Sender field enter your registered sender name. This name will be displayed in the "From" field.
In the Sending lifetime field specify a period of time (in minutes) during which the system will attempt to send your message to clients. If a message is not sent within the specified period (for example, due to a technical error that the mobile network carrier is responsible for), then the message will receive the Not delivered status.

Instructions for configuration of notifications in Viber

TWIN user documentation > Notifications > image-2023-1-29_20-2-29.png

To configure notifications in Viber, do following:

In the Message text field enter the text of a message that you want to send.

To make the notification template more universal, you can use variables (i.e., {variable_name}) in the message text. When you send messages, you can specify values for all variables.

In the Sender field enter your registered sender name. This name will be displayed in the "From" field.
In the Image URL field specify the link to the image that will be displayed in your message.
In the Button URL field you specify the address to redirect the user after they click on the button displayed in your message.
In the Button text field enter the text that will be displayed on the button in your message.
In the Sending lifetime field specify a period of time (in minutes) during which the system will attempt to send your message to clients. If a message is not sent within the specified period (for example, due to a technical error that the mobile network carrier is responsible for), then the message will receive the Not delivered status.

Instructions for configuration of notifications in Whatsapp

TWIN user documentation > Notifications > image-2023-1-29_20-29-16.png

To configure notifications in Whatsapp, do following:

In the Sender field enter your registered sender name. This name will be displayed in the "From" field.
In the Template name field specify the registered template name that the system will use to work with WhatsApp Business API.
In the Template namespace field enter the registered template namespace that the system will use to work with WhatsApp Business API.
In the Template data field enter the text of a message that you want to send.
In the Language field specify the language that the system will use to work with WhatsApp Business API.
In the Media URL field enter the link to the image that will be attached to your message.

Instructions for configuration of chat messages

TWIN user documentation > Notifications > image-2023-1-29_20-58-57.png

To configure chat messages, do following:

In the Chat ID field enter the Id of the necessary chat.
In the Bot ID field specify the Id of the script that you want to use in a chat with clients. Script IDs are displayed in the first column on the Bots page.
In the Messenger field select the messenger where the chat is created. The following options are available:
- Whatsapp
- Viber
- Facebook
- Telegram
- Skype
- Slack
- Alice
- Imessage
In the Message text field enter the text of a message that you want to send.

4) To save changes click Create.

Searching for notification templates

If there are a lot of templates on the list, you can filter records you need or search for the necessary record by a template ID or template name.

For this enter the necessary value in the search field at the top of the page.

When you are searching by ID, enter the full ID of the template in the search field. When you are searching by name, you can enter the full template name or its part in the search field.

The results will be displayed automatically.

TWIN user documentation > Notifications > image-2023-1-29_21-16-28.png

To delete the specified search and filter values use the Clear button.

Editing notification template

If you need to change notification parameters (for example, change the message text or add an additional communication channel), you can edit the notification template.

For this select the necessary template on the list and click .

TWIN user documentation > Notifications > image-2023-1-29_22-4-15.png

As a result a new page for editing the template will open.

TWIN user documentation > Notifications > image-2023-1-29_22-7-39.png

Steps for editing a notification template are similar to those described in this section.

Deleting notification templates

If you do not use a certain notification template, you can delete it.

For this select the necessary template on the list and click .

TWIN user documentation > Notifications > image-2023-1-29_22-10-9.png

As a result the selected message will be deleted.

Sending notifications

On the side menu select Notifications – Send notification. As a result the Send notification page will open.

TWIN user documentation > Notifications > image-2023-1-29_22-20-59.png

To send notifications to clients, do the following:

In the Select template field select the necessary notification template that the system will use to send notifications to your clients.
Click New recipient and enter the following contact information:

External ID – recipient ID in an external CRM system.
Phone– recipient's phone number that the system will use to send notifications via all communication channels except for email.
Email – recipient's email address for sending notifications by email

TWIN user documentation > Notifications > image-2023-1-29_22-20-16.png

3. In the Variables section enter variable names and their values that are used in the message text. Variables can only be used when you send notifications in Viber and as SMS.

You need to enter variable names and their values only in case the variables are used in the message text. Otherwise this section is not displayed.

4. To send notifications click Send.

Working with tasks for notifications

В разделе Задания на отправку можно просматривать информацию о текущих заданиях на отправку клиентских рассылок, выполнять поиск и администрирование заданий (создавать, редактировать и удалять задания), а также управлять выполнением заданий на отправку.

Отправка клиентских рассылок в этом разделе выполняется с помощью Twin API.

TWIN user documentation > Notifications > задания3.png

В левом верхнем углу рабочей области страницы расположена кнопка, при помощи которой можно создавать новые задания на отправку (подробнее о том, как добавить новое задание см. Создание нового задания на отправку сообщений).

TWIN user documentation > Notifications > задания.png

В правом верхнем углу расположены кнопки для фильтрации списка заданий по категориям (подробнее см. Фильтрация заданий на отправку сообщений).

TWIN user documentation > Notifications > задания2png.png

Ниже расположены поля для поиска заданий на отправку сообщений (подробнее см. Поиск заданий на отправку сообщений).

TWIN user documentation > Notifications > задания4.png

В центре страницы отображается список заданий на отправку сообщений. В списке содержится следующая информация:

Наименование задания - имя, которое вы присвоили заданию при его создании. По имени вы можете быстро идентифицировать нужное задание в списке.
Статус – показывает, в каком статусе находится задание на отправку сообщений. Возможны следующие статусы:
- Запланированные;
- Выполненные.
Количество – общее число сообщений в рассылке;
Отправлено – число отправленных сообщений;
Доставлено – число сообщений, которые были доставлены получателям;
Создано – дата создания задания на отправку;
Действия – здесь отображаются кнопки для работы с заданием и управления рассылкой. В зависимости от статуса задания могут отображаться кнопки для выполнения следующих действий: просмотр, редактирование и удаление заданий, а также запуск и приостановка рассылки.

Поиск заданий на отправку сообщений

Если список заданий очень большой, то при помощи элементов управления, которые расположены в верхней части страницы, вы можете быстро найти нужное задание.

В системе существует 2 варианта поиска заданий на отправку сообщений:

Поиск заданий по имени;
Поиск заданий по дате.

TWIN user documentation > Notifications > сообщения10.png

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

Для очистки полей поиска от заданных значений используйте кнопку Clear.

Фильтрация заданий на отправку сообщений

На странице Задания на отправку можно выполнять фильтрацию списка заданий по категориям.

При помощи данной функции можно быстро отображать нужные задания на отправку (например, задания, по которым в текущий момент выполняются клиентские рассылки, или задания, по которым клиентские рассылки запланированы, но еще не выполнялись).

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

TWIN user documentation > Notifications > сообщения11.png

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

Для фильтрации заданий доступны для выбора следующие категории:

В процессе - отображаются только такие задания, по которым в текущий момент выполняются клиентские рассылки;
Создано - отображаются все созданные в системе задания со статусом Запланированные, по которым рассылка сообщений клиентам запланирована, но еще не выполнялась;
Пауза - отображаются задания, по которым рассылка сообщений клиентам была прервана;
Завершенные - отображаются все задания, по которым рассылка сообщений клиентам была завершена.

Создание нового задания на отправку сообщений

Чтобы создать задание на отправку сообщений, выполните следующие действия:

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

TWIN user documentation > Notifications > сообщения12.png

В результате откроется окно, как показано на рисунке ниже.

TWIN user documentation > Notifications > сообщения13.png

2) В поле Наименование задание укажите имя нового задания.

TWIN user documentation > Notifications > наименование_задания.png

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

3) Нажмите кнопку Выберите файл и выберите желаемый шаблон c заданными параметрами задания в виде файла в формате Excel.

При помощи ссылок, расположенных под кнопкой выбора файла шаблона, можно загрузить следующие шаблоны заданий:

Смс сообщения;
Рекламные сообщения;
Старт чат сессий;
Запуск чат сессии в WhatsApp;
Универсальный формат (формат api).

4) В поле Ограничитель по времени отправки текстовых сообщений выберите желаемый временной диапазон, в течение система выполнит рассылку сообщений.

TWIN user documentation > Notifications > ограничитель.png

5) Для сохранения изменений нажмите кнопку Создать.

В результате выполненных действий в списке заданий на отправку сообщений появится новая запись.

Редактирование заданий на отправку сообщений

Для редактирования здания на отправку сообщений нажмите кнопку в строке нужного задания.

TWIN user documentation > Notifications > редактирование.png

В результате откроется страница для редактирования выбранного задания.

TWIN user documentation > Notifications > редактирование2.png

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

Удаление заданий на отправку сообщений

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

TWIN user documentation > Notifications > удаление.png

Выбранное задание будет удалено.

Просмотр информации о сообщениях

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

TWIN user documentation > Notifications > image-2022-12-27_11-34-41.png

Подробнее о просмотре отправленных сообщений можно узнать в этой статье.

Проверка номеров

В разделе Проверка номеров отображается список с общей информацией обо всех сообщениях, которые были отправлены клиентам с помощью Twin API.

На странице содержится следующая информация:

Номер телефона клиента, на который было отправлено сообщение
Статус отправки
Дата создания сообщения
Стоимость отправки

В верхней части страницы расположены элементы управления, при помощи которых можно выполнять фильтрацию и поиск записей на странице.

TWIN user documentation > Notifications > проверка номеров.png

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

В разделе Проверка номеров можно сформировать отчет с подробной информацией об отправленных сообщениях. Для этого при помощи полей поиска отобразите желаемые записи и нажмите кнопку Экспорт. Отчет будет сформирован и загружен автоматически в виде файла в формате Excel.

Просмотр отправленных сообщений

В разделе Просмотр сообщений отображается список, в котором представлена общая информация по всем клиентским рассылкам (номер получателя, статус сообщения, канал связи, который система использовала для отправки сообщения, время создания сообщения и др.).

В верхней части страницы расположены элементы управления для фильтрации и поиска сообщений.

TWIN user documentation > Notifications > image-2022-12-27_11-37-33.png

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

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

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

В поле Все статусы можно выбрать желаемый статус сообщений.

Все статусы – отображаются все сообщения.
Создан – отображаются все созданные, но еще не отправленные сообщения.
Отправляется – отображаются все сообщения, которые в текущий момент находятся в состоянии отправки получателям.
Доставлено – отображаются все сообщения, которые были доставлены получателям.
Не доставлено – отображаются все сообщения, которые не были доставлены получателям.
Отменено – отображаются все сообщения, отправка которых была отменена пользователем.
Ошибка – отображаются все сообщения, при отправке которых возникла ошибка (например, техническая ошибка со стороны оператора).
Отложено – отображаются сообщения, отправка которых отложена до наступления того периода времени, который задан в шаблоне уведомления.
Создано, но необязательное – отображаются все созданные, но еще не отправленные сообщения, для которых не задан признак Обязательно.
Пропущено, но необязательное – отображаются сообщения, которые из-за технических неполадок не были доставлены по указанному каналу связи (например, рассылка по Viber), но для отправки которых система использовала альтернативный канал связи (например, sms).

Для просмотра текста сообщения нажмите кнопку напротив нужного сообщения.

TWIN user documentation > Notifications > image-2022-12-27_11-38-21.png

Откроется окно просмотра сообщения.

TWIN user documentation > Notifications > image-2022-12-23_16-5-27.png

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

Идентификатор сообщения – уникальный идентификатор сообщения.
Идентификатор загрузки – уникальный идентификатор партии сообщений отправки. Связан с каждым сообщением в партии.
Идентификатор группы –
Идентификатор отправки – уникальный идентификатор партии сообщений, который препятствует отправке сообщений в один и тот же канал. Связан с каждым сообщением в партии.

Статус доставки сообщения – текущий статус доставки сообщения.

DELIVERED – сообщение успешно обработано и доставлено получателю.

UNDELIVERED – сообщение успешно отправлено, но не доставлено получателю.

PENDING – сообщение успешно отправлено получателю, но отчет о доставке еще не получен.

PAUSED – сообщение успешно обработано, но еще не отправлено.

READ – сообщение прочитано.

ERROR – при отправке сообщения произошла ошибка.

CREATED – сообщение успешно создано, но еще не отправлено.

SENT – сообщение принято к отправке.

QUEUED – сообщение, которое находится в очереди.

SKIPPED – сообщение из очереди, которые не были доставлены.

CANCELED – отмененное сообщение, которое должно было отправиться через некоторое время.

DELAYED – сообщение из очереди, которое отправится через некоторое время.

Описание статуса – описывает статус сообщения.
Канал отправки – отображает канал связи, куда было отправлено сообщение.
Отправитель – указывается отправитель сообщения.
Указывается только для канала отправки SMS
Получатель – номер телефона клиента, которому адресовано сообщение.
Текст сообщения – содержимое сообщения, отправленного клиенту.
Стоимость сообщения – стоимость отправки сообщения клиенту.

Оператор сотовой сети – оператор связи, через которого было отправленно сообщение.

Практически всегда остается пустым по той причине, что большинство провайдеров не предоставляют эту информацию.

Идентификатор шаблона сообщения – идентификатор шаблона сообщения, который использовался для создания этого сообщения.
Наименование шаблона сообщения – наименование шаблона сообщения, который использовался для создания этого сообщения.
Переменные –
Количество частей сообщения – при отправке, сообщение делится на части и стоимость отправки высчитывается в зависимости из скольки частей состояло сообщение.
Количество просмотров и кликов Email –
Короткая ссылка – сокращенная ссылка из текста сообщения.
Количество кликов по ссылке – сколько раз клиент кликнул по ссылке.
Не отображается при отправке через шаблоны сообщений.
Дата регистрации сообщения в системе – дата и время создания сообщения в системе.
Дата отправки – дата и время отправки сообщения.
Дата получения статуса о доставке – дата и время получения сообщения.
Дата начала отправки (для DELAYED сообщений) –
Дата окончания доставки – дата и время окончания доставки сообщений.