Блок Обмен сообщениями
Last updated
Last updated
Уведомление предназначено для
информирования о текущем состоянии выполнения сценария
записи важной информации в лог-файлы
отправки специальных SIP пакетов на устройства
Используется при откладке сценария, а также для поиска и устранения ошибок выполнения.
В зависимости от режима, компонент Уведомление записывает информацию в лог-файл на сервере, где он выполняется или выводит её на экран.
Существуют следующие режимы:
Лог-журнал
Уведомление API
Сообщение SIP
Уведомление
Название | Описание |
Режим |
|
Дополнительные поля | Определены в зависимых от Режима разделах |
Переход | Следующий компонент сценария. Переход по-умолчанию |
Описание | Описание компонента |
В данном режиме информация записывается в лог-журнал на сервере, где он выполняется. Используется при отладке сценария и отслеживания его работы.
Запись в лог-файл на сервере:
• для служебных сценариев - файл scr_*.log в директории /usr/lib/rostell/_workdir/[роль svc]/log/script
• для IVR сценариев - файл scr_*.log в директории /usr/lib/rostell/_workdir/[роль ivr]/log/script
Можно получить в Web-интерфейсе Мониторинг - Трассировка звонков и сценариев
Свойства специализированных полей
Название | Описание |
Текст | Аргумент, содержащий текст уведомления, записываемый в лог журнал |
В данном режиме информация отображается на экране. Используется при откладке сценария и отслеживания его работы. Два режима отображения
HTML отображаются только на данной вкладке браузера
Webkit отображается по всему браузеру как вслывающее окно, но должно быть https соединение и дано разрешение в настройках браузера на показ уведомлений.
Свойства специализированных полей режима Уведомление API
Название | Описание |
Текст | Аргумент, содержащий текст уведомления, отображаемый на экране |
Пользователь | Аргумент, содержащий логин пользователю, которому необходимо отобразить уведомление. Через запятую возможно указать несколько пользователей. |
Тип отображения |
|
Тип уведомления |
|
Цвет фона | (только для HTML) Цвет фона в формате HEX |
Цвет текста | (только для HTML) Цвет текста в формате HEX |
Группа | Уведомления объединенные в группу. Предыдущее уведомление будет скрыто новым, если группы совпадают. |
Автоскрытие,с | Время через,которое пропадет уведомление. По умолчанию равно бесконечности (значение 0) |
Дублировать в лог | Выключатель дополнительного логирования сообщения в лог (аналогично режиму Лог-журнал). |
Причины ошибки в переменную | Переменная в которую будет записана причина ошибки |
Переход,ошибка | Компонент, на который передается управление, если возникла ошибка |
SIP-уведомление используется для отправки сообщения на SIP-устройство. Запись в лог-файл на сервере
файл sip в директории /usr/lib/rostell/_workdir/sg/log/sip/
файл trn в директории /usr/lib/rostell/_workdir/sg/log/sip/
При необходимости дополнительного логирования рекомендуется использовать Уведомление в режиме Лог журнал
Свойства режима Сообщение SIP
Название | Описание |
Сообщение | SIP Method при отправке сообщения
|
Пользователь | Получатель события в формате tel:username или username, где в качестве username могут подставляться логин и номер учетной записи SIP-пользователя. |
Дополнительные заголовки | Подставляемые в SIP-запрос дополнительные заголовки. Аргумент содержит мультистрочное значение, формат каждой из строк: HeaderName: HeaderValue |
From | Подставляемое в отправляемый SIP-запрос значение для заголовка From. |
Event | Подставляемое в отправляемый SIP-запрос значение для заголовка Event. |
Content-Type | Подставляемое в отправляемый SIP-запрос значение для заголовка Content-Type. |
Content | Текст сообщения, подставляемый в тело отправляемого SIP-запроса. |
Ожидать подтверждения | Выключатель режима ожидания SIP-ответа на отправленный SIP-запрос. |
Отчет в переменную | (Ожидать подтверждения = да) Переменная в которую будет сохранен отчет. |
Время,с | (Ожидать подтверждения = да) Время ожидания подтверждения. |
Причины ошибки в переменную | Переменная в которую будет записана причина ошибки |
Переход,ошибка | Компонент, на который передается управление, если возникла ошибка |
Переход,время | (Ожидать подтверждения = да) Компонент, на который передается управление, если истекло время ожидания подтверждения |
Компонент управляет получением одного письма. Получается самое старое непрочитанное.
Поддерживается протокол POP3 с возможностью работать поверх SSL.
При обработке письма необходимо выбрать какие части письма необходимо парсить и выбрать в какие переменные необходимо сохранить эту информацию
Название | Описание |
Протокол | POP3 |
Адрес сервера | Адрес почтового сервера (IP или FQDN). |
Порт сервера | Порт сервера для отправки письма. |
SSL |
|
Логин | Логин для авторизации. |
Пароль | Пароль для авторизации. |
Отправитель в переменную | Переменная для поля “Отправитель” |
Получатель в переменную | Переменная для поля “Получатель” |
Тема в переменную | Переменная для поля “Тема” |
ID сообщения в переменную | Переменная для ID сообщения |
Кодировка |
|
Сохранять заголовки |
|
Сохранять текст |
|
Сохранять HTML |
|
HTML в переменную | Сохраненит HTML в переменную |
Сохранять первое тело |
|
Сохранять исходный текст |
|
Сохранять прикрепленные файлы |
|
Удалять с сервера |
|
Переход | Компонент, на который передается управление, если прием письма выполнен успешно. Переход по-умолчанию |
Переход, пусто | Компонент, на который передается управление, если писем нет |
Переход, ошибка | Компонент, на который передается управление, если возникла ошибка при приеме письма |
Описание | Описание компонента |
Осуществляет отправку email-сообщения на указанный ящик электронной почты.
Для зашифрованного соединения (свойство "SSL-авторизация") компонент использует протокол StartTLS. Это означает, что соединение изначально идет по незащищенному порту 25, а затем шифруется, в отличии от протокола SSL, где соединение изначально происходит по защищенным портам. Именно поэтому, в большинстве случаев в свойстве "Порт почтового сервера" следует указывать незащищенный порт 25, вместо 465.
Свойства:
Название | Описание |
Протокол | SMTP |
Адрес сервера | Адрес почтового сервера (IP или FQDN). |
Порт сервера | Порт сервера для отправки письма. |
SSL |
|
Логин | Логин для авторизации на почтовом сервере. |
Пароль | Пароль для авторизации на почтовом сервере. |
От кого | Значение поля От кого / From |
Кому | Значение поля Кому / To |
Тема | Значение поля Тема / Subject |
Текст | Аргумент с текстовым представлением письма. Добавляется как одна из частей MIME-содержимого письма. |
HTML | Аргумент с HTML представлением письма. Добавляется как одна из частей MIME-содержимого письма. |
Прикрепить файл 1~5 | Вложение. Добавляется как одна из частей MIME-содержимого в бинарном формате. Может быть выбран в одном из режимов:
При добавлении первого файла, появляется возможность добавить второй и т.д. Ограничение - 5 файлов. |
Режим |
|
Результат в переменную | Переменная для сохранения результата отправки письма. |
Переход | Компонент, на который передается управление, если отправка письма выполнена успешно. Переход по-умолчанию |
Переход, ошибка | Компонент, на который передается управление, если возникла ошибка отправки письма |
Описание | Описание компонента |
Осуществляет взаимодействие между различными экземплярами обработчиков сценариев. Может работать в одном из режимов:
Прием сообщения
Отправка сообщения
Проверка сценария
В режиме получения сообщения возможна организация длительного ожидания поступления сообщений.
Адрес текущего обработчика сценариев можно получить через функцию выражений getscriptref(). При запуске асинхронного служебного сценария компонентом Запуск сценария адрес (идентификатор) нового обработчика возвращается в переменную. Имея адрес вложенного сценария, ему можно передать собственный адрес для двустороннего взаимодействия посредством отправки в сообщении.
Используя данный компонент можно настроить взаимодействие между IVR сценарием, предоставляющим одну из голосовых услуг, и асинхронным служебным сценарием, задачей которого является обработка результата выполнения IVR сценария.Существуют следующие режимы работы:
Название | Описание |
Режим |
|
ИД сценария | (для режимов = Отправка и Проверка). Аргумент, содержащий идентификатор удаленного сценария |
Сообщение | (для режима = Отправка) Аргумент, содержащий тело сообщения |
Категория отправителя | (для режима = Отправка) Выбор категории отправителя сообщения
|
Сообщение в переменную | (для режима = Прием) Переменная, куда сохраняется первое сообщение в очереди |
ИД отправителя в переменную | (для режима = Прием) Переменная, куда сохраняется ID отправителя сообщения |
Категория отправителя в переменную | (для режима = Прием) Переменная, куда сохраняется Категория отправителя сообщения (может быть B2B или Script) |
Таймаут,с | (для режима = Прием) Аргумент, определяющий время ожидания (сек) если нет сообщения до срабатывания Переход, время |
Переход, успех | Компонент, на который передается управление. |
Переход, ошибка | Компонент, на который передается управление в случае ошибки |
Переход, время | (для режима = Прием) Компонент, на который передается управление в случае если таймаут |
Переход, сценарий не найден | (для режимов = Проверка)Компонент, на который передается управление в случае если сценарий не найден. |
Описание | Описание компонента |
Компонент позволяет получать факсимильное сообщение и сохранять его в локальную папку с возможностью дальнейшей отправки компонентом Отправка E-mail или перемещения компонентом Файловая операция. При приеме факса поддерживаются следующие протоколы:
t.30
t.38
Полученный файл сохраняется в формате tiff (бинарный многостраничный).
Прием факса
Название | Описание |
Протокол |
|
Таймаут, с | Максимальное время отправки факс-сообщения. В случае если за это время обработка отправки факса не завершена, то переход по ветке “Переход, время” |
Сохранить путь |
|
Путь в переменную | Переменная для сохранение пути полученного файла |
Переход | на какой элемент будет переход действия в случае корректной отправки факса. Переход по-умолчанию |
Переход, время | на какой элемент будет переход действия в случае, если за отведенное время компонент не завершил свою работу |
Переход, ошибка | на какой элемент будет переход действия в случае, если возникла ошибка отправки факса |
Описание | Описание компонента |
Компонент позволяет отправлять факсимильное сообщение из указанного файла. Поддерживаются протоколы отправки:
t.30
t.38
автоматический режим
Отправляемый файл должен быть в формате tiff (бинарный многостраничный).
Название | Описание |
Протокол |
|
Таймаут, с | Максимальное время отправки факс-сообщения. В случае если за это время обработка отправки факса не завершена, то переход по ветке Переход, время |
Файл | Файл для отправки факсимильным сообщением. Может быть выбран в одном из режимов:
Формат файла: tiff – одностраничное или многостраничное битовое изображение.Отправка сообщения осуществляется сервером с ролью MG, обслуживающим текущий звонок на сайте, где выполняется сценарий. |
Переход | Компонент, которому передается управление при корректной отправки факса. Переход по-умолчанию. |
Переход, время | Компонент, которому передается управление в случае, если за отведенное время компонент не завершил свою работу |
Переход, ошибка | Компонет, которому передается управление в случае, если возникла ошибка отправки факса |
Описание | Текст |