Блок Обмен сообщениями

Уведомление

Уведомление предназначено для

  • информирования о текущем состоянии выполнения сценария

  • записи важной информации в лог-файлы

  • отправки специальных SIP пакетов на устройства

Используется при откладке сценария, а также для поиска и устранения ошибок выполнения.

В зависимости от режима, компонент Уведомление записывает информацию в лог-файл на сервере, где он выполняется или выводит её на экран.

Существуют следующие режимы:

  • Лог-журнал

  • Уведомление API

  • Сообщение SIP

Уведомление

Название

Описание

Режим

  • Лог-журнал. Подробнее в Уведомление Лог-журнал

  • Уведомление API. Подробнее в Уведомление API

  • Сообщение SIP. Подробнее в Уведомление Сообщение SIP

Дополнительные поля

Определены в зависимых от Режима разделах

Переход

Следующий компонент сценария. Переход по-умолчанию

Описание

Описание компонента

Уведомление Лог-журнал

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

Запись в лог-файл на сервере:

• для служебных сценариев - файл scr_*.log в директории /usr/lib/rostell/_workdir/[роль svc]/log/script

• для IVR сценариев - файл scr_*.log в директории /usr/lib/rostell/_workdir/[роль ivr]/log/script

Можно получить в Web-интерфейсе Мониторинг - Трассировка звонков и сценариев

Свойства специализированных полей

Название

Описание

Текст

Аргумент, содержащий текст уведомления, записываемый в лог журнал

Уведомление API

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

  • HTML отображаются только на данной вкладке браузера

  • Webkit отображается по всему браузеру как вслывающее окно, но должно быть https соединение и дано разрешение в настройках браузера на показ уведомлений.

Свойства специализированных полей режима Уведомление API

Название

Описание

Текст

Аргумент, содержащий текст уведомления, отображаемый на экране

Пользователь

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

Тип отображения

  • Авто – Способ уведомления на усмотрение приложения.

  • WebKit – Уведомление с помощью WebKit.

  • HTML – Уведомление с помощью средств HTML.

Тип уведомления

  • Инфо – Способ уведомления на усмотрение приложения.

  • Успех – Уведомление с помощью WebKit.

  • Предупреждение – Уведомление с помощью средств HTML.

  • Ошибка – Уведомление с помощью средств HTML.

Цвет фона

(только для HTML) Цвет фона в формате HEX

Цвет текста

(только для HTML) Цвет текста в формате HEX

Группа

Уведомления объединенные в группу. Предыдущее уведомление будет скрыто новым, если группы совпадают.

Автоскрытие,с

Время через,которое пропадет уведомление. По умолчанию равно бесконечности (значение 0)

Дублировать в лог

Выключатель дополнительного логирования сообщения в лог (аналогично режиму Лог-журнал).

Причины ошибки в переменную

Переменная в которую будет записана причина ошибки

Переход,ошибка

Компонент, на который передается управление, если возникла ошибка

Уведомление Сообщение SIP

SIP-уведомление используется для отправки сообщения на SIP-устройство. Запись в лог-файл на сервере

  • файл sip в директории /usr/lib/rostell/_workdir/sg/log/sip/

  • файл trn в директории /usr/lib/rostell/_workdir/sg/log/sip/

При необходимости дополнительного логирования рекомендуется использовать Уведомление в режиме Лог журнал

Свойства режима Сообщение SIP

Название

Описание

Сообщение

SIP Method при отправке сообщения

  • NOTIFY

  • INFO

  • MESSAGE

Пользователь

Получатель события в формате tel:username или username, где в качестве username могут подставляться логин и номер учетной записи SIP-пользователя.

Дополнительные заголовки

Подставляемые в SIP-запрос дополнительные заголовки. Аргумент содержит мультистрочное значение, формат каждой из строк: HeaderName: HeaderValue

From

Подставляемое в отправляемый SIP-запрос значение для заголовка From.

Event

Подставляемое в отправляемый SIP-запрос значение для заголовка Event.

Content-Type

Подставляемое в отправляемый SIP-запрос значение для заголовка Content-Type.

Content

Текст сообщения, подставляемый в тело отправляемого SIP-запроса.

Ожидать подтверждения

Выключатель режима ожидания SIP-ответа на отправленный SIP-запрос.

Отчет в переменную

(Ожидать подтверждения = да) Переменная в которую будет сохранен отчет.

Время,с

(Ожидать подтверждения = да) Время ожидания подтверждения.

Причины ошибки в переменную

Переменная в которую будет записана причина ошибки

Переход,ошибка

Компонент, на который передается управление, если возникла ошибка

Переход,время

(Ожидать подтверждения = да) Компонент, на который передается управление, если истекло время ожидания подтверждения

Получение E-mail

Компонент управляет получением одного письма. Получается самое старое непрочитанное.

Поддерживается протокол POP3 с возможностью работать поверх SSL.

При обработке письма необходимо выбрать какие части письма необходимо парсить и выбрать в какие переменные необходимо сохранить эту информацию

Название

Описание

Протокол

POP3

Адрес сервера

Адрес почтового сервера (IP или FQDN).

Порт сервера

Порт сервера для отправки письма.

SSL

  • Да - использовать SSL протокол

  • Нет - не использовать шифрование

Логин

Логин для авторизации.

Пароль

Пароль для авторизации.

Отправитель в переменную

Переменная для поля “Отправитель”

Получатель в переменную

Переменная для поля “Получатель”

Тема в переменную

Переменная для поля “Тема”

ID сообщения в переменную

Переменная для ID сообщения

Кодировка

  • Нет - без перекодирования

  • Utf-8

  • Utf-16

  • Utf-32

  • cp-1251

  • koi8-r

  • Указать название - ввести название кодировки в поле Название кодировки.

Сохранять заголовки

  • Да - необходимо распарсить письмо и получить Заголовки. В переменную из поля Заголовки в переменную

  • Нет - не сохранять (не нужна дополнительная обработка)

Сохранять текст

  • Да - необходимо распарсить письмо и получить MIME-части с Content-Type: text/plain. В переменную из поля Текст в переменную.

  • Нет - не сохранять (не нужна дополнительная обработка)

Сохранять HTML

  • Да - необходимо распарсить письмо и получить MIME-части с Content-Type: text/html. В переменную из поляе HTML в переменную

  • Нет - не сохранять (не нужна дополнительная обработка)

HTML в переменную

Сохраненит HTML в переменную

Сохранять первое тело

  • Да - необходимо распарсить письмо и получить первое тело. В переменную поля Тело(1) в переменную Будет сохранен текст из первой текстовой части MIME-содержимого письма (text/plain, text/html, …​).

  • Нет - не сохранять (не нужна дополнительная обработка)

Сохранять исходный текст

  • Да - необходимо распарсить письмо и получить исходный текст сообщения. В переменную поля Исходный текст в переменную (MIMIE формат)

  • Нет - не сохранять (не нужна дополнительная обработка)

Сохранять прикрепленные файлы

  • Да - необходимо распарсить письмо и сохранить прикрепленные файлы. В результате в поле Каталог с вложениями в переенную вернется путь с сохраненными файлами.

  • Нет - не сохранять (не нужно сохранение файлов)

Удалять с сервера

  • Да - удалять письмо с сервера

  • Нет - оставлять письмо на сервере

Переход

Компонент, на который передается управление, если прием письма выполнен успешно. Переход по-умолчанию

Переход, пусто

Компонент, на который передается управление, если писем нет

Переход, ошибка

Компонент, на который передается управление, если возникла ошибка при приеме письма

Описание

Описание компонента

Отправка E-mail

Осуществляет отправку email-сообщения на указанный ящик электронной почты.

Для зашифрованного соединения (свойство "SSL-авторизация") компонент использует протокол StartTLS. Это означает, что соединение изначально идет по незащищенному порту 25, а затем шифруется, в отличии от протокола SSL, где соединение изначально происходит по защищенным портам. Именно поэтому, в большинстве случаев в свойстве "Порт почтового сервера" следует указывать незащищенный порт 25, вместо 465.

Свойства:

Название

Описание

Протокол

SMTP

Адрес сервера

Адрес почтового сервера (IP или FQDN).

Порт сервера

Порт сервера для отправки письма.

SSL

  • Да - использовать SSL протокол

  • Нет - не использовать шифрование

Логин

Логин для авторизации на почтовом сервере.

Пароль

Пароль для авторизации на почтовом сервере.

От кого

Значение поля От кого / From

Кому

Значение поля Кому / To

Тема

Значение поля Тема / Subject

Текст

Аргумент с текстовым представлением письма. Добавляется как одна из частей MIME-содержимого письма.

HTML

Аргумент с HTML представлением письма. Добавляется как одна из частей MIME-содержимого письма.

Прикрепить файл 1~5

Вложение. Добавляется как одна из частей MIME-содержимого в бинарном формате. Может быть выбран в одном из режимов:

  • статический файл, приложенный к сценарию

  • сформированный путь к файлу

При добавлении первого файла, появляется возможность добавить второй и т.д. Ограничение - 5 файлов.

Режим

  • Синхронный - компонент передает управление после получения ответа от сервера

  • Асинхронный - компонент передает управление сразу по ветке Переход без ожидания ответа от сервера

Результат в переменную

Переменная для сохранения результата отправки письма.

Переход

Компонент, на который передается управление, если отправка письма выполнена успешно. Переход по-умолчанию

Переход, ошибка

Компонент, на который передается управление, если возникла ошибка отправки письма

Описание

Описание компонента

Взаимодействие сценариев

Осуществляет взаимодействие между различными экземплярами обработчиков сценариев. Может работать в одном из режимов:

  • Прием сообщения

  • Отправка сообщения

  • Проверка сценария

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

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

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

Название

Описание

Режим

  • Отправка сообщения – Отправляет сообщение другому обработчику сценариев.

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

  • Проверка доступности – Проверяет доступен/существует ли сценарий по данному ID

ИД сценария

(для режимов = Отправка и Проверка). Аргумент, содержащий идентификатор удаленного сценария

Сообщение

(для режима = Отправка) Аргумент, содержащий тело сообщения

Категория отправителя

(для режима = Отправка) Выбор категории отправителя сообщения

  • Script

  • B2B

Сообщение в переменную

(для режима = Прием) Переменная, куда сохраняется первое сообщение в очереди

ИД отправителя в переменную

(для режима = Прием) Переменная, куда сохраняется ID отправителя сообщения

Категория отправителя в переменную

(для режима = Прием) Переменная, куда сохраняется Категория отправителя сообщения (может быть B2B или Script)

Таймаут,с

(для режима = Прием) Аргумент, определяющий время ожидания (сек) если нет сообщения до срабатывания Переход, время

Переход, успех

Компонент, на который передается управление.

Переход, ошибка

Компонент, на который передается управление в случае ошибки

Переход, время

(для режима = Прием) Компонент, на который передается управление в случае если таймаут

Переход, сценарий не найден

(для режимов = Проверка)Компонент, на который передается управление в случае если сценарий не найден.

Описание

Описание компонента

Прием факса

Компонент позволяет получать факсимильное сообщение и сохранять его в локальную папку с возможностью дальнейшей отправки компонентом Отправка E-mail или перемещения компонентом Файловая операция. При приеме факса поддерживаются следующие протоколы:

  • t.30

  • t.38

Полученный файл сохраняется в формате tiff (бинарный многостраничный).

Прием факса

Название

Описание

Протокол

  • Авто – Сначала производится попытка переключиться в протокол T38, а при отказе удаленной стороны производится переключение в T30.

  • T30 – Переключение в T30 и ожидание переключения в T30 удаленной стороны.

  • T38 – Переключение в T38, а при отказе удаленной стороны, завершение работы с ошибкой.

Таймаут, с

Максимальное время отправки факс-сообщения. В случае если за это время обработка отправки факса не завершена, то переход по ветке “Переход, время”

Сохранить путь

  • Не сохранять

  • С ключом папки – Значение включает категорию папки, относительный путь и имя файла.

  • Только имя файла – Значение содержит только имя файла.

Путь в переменную

Переменная для сохранение пути полученного файла

Переход

на какой элемент будет переход действия в случае корректной отправки факса. Переход по-умолчанию

Переход, время

на какой элемент будет переход действия в случае, если за отведенное время компонент не завершил свою работу

Переход, ошибка

на какой элемент будет переход действия в случае, если возникла ошибка отправки факса

Описание

Описание компонента

Отправка факса

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

  • t.30

  • t.38

  • автоматический режим

Отправляемый файл должен быть в формате tiff (бинарный многостраничный).

Название

Описание

Протокол

  • Авто – Сначала производится попытка переключиться в протокол T38, а при отказе удаленной стороны производится переключение в T30.

  • T30 – Переключение в T30 и ожидание переключения в T30 удаленной стороны.

  • T38 – Переключение в T38, а при отказе удаленной стороны, завершение работы с ошибкой.

Таймаут, с

Максимальное время отправки факс-сообщения. В случае если за это время обработка отправки факса не завершена, то переход по ветке Переход, время

Файл

Файл для отправки факсимильным сообщением. Может быть выбран в одном из режимов:

  • статический файл, приложенный к сценарию

  • сформированный аргументами путь к файлу

Формат файла: tiff – одностраничное или многостраничное битовое изображение.Отправка сообщения осуществляется сервером с ролью MG, обслуживающим текущий звонок на сайте, где выполняется сценарий.

Переход

Компонент, которому передается управление при корректной отправки факса. Переход по-умолчанию.

Переход, время

Компонент, которому передается управление в случае, если за отведенное время компонент не завершил свою работу

Переход, ошибка

Компонет, которому передается управление в случае, если возникла ошибка отправки факса

Описание

Текст

Last updated