| Версия 5.2
Введение
Установка
Администрирование
Сеть
Объекты
Почта
Сигналы
Доступ
Услуги
Справочник
Кластеры
Программы
Разное
Лицензирование
Веб Почта
Pronto!
PBX
Обзор | Правила | SIP | XMPP | ТФОП | NAT | Media | Parlay
# Интерфейс Parlay X Управление Звонками Третьей Стороны Уведомления о Звонках Платежи Управление Пользователем Обработка Звонков В Сервере CommuniGate Pro реализован Интерфейс Parlay X для работы с Сигналами Реального Времени, Автоматическими Правилами, Тарификакацией и другими функциями. Parlay X является HTTP/XML протоколом. Он используется при обращении через HTTP User модуль CommuniGate Pro к области `/ParlayX/`. Все HTTP запросы Parlay X должны быть актентифицированы. Поддерживается интерфейс Parlay X версии 2 и версии 3.

## Управление Звонками Третьей Стороны

Управление Звонками Третьей Стороны через Интерфейс ParlayX позволяет клиентскому приложению:

- инициировать звонок между двумя сторонами
- читать статус инициированного звонка
- прервать инициированный звонок
- закончить инициированный звонок

При получении запроса на "установление звонка", CommuniGate Pro запускает от имени аутентифицированного пользователя приложение `parlayMakeCall` в Реальном Времени.

Параметры приложения являются параметрами запроса: адреса вызывающей и вызываемой стороны и, опционально, параметр `charging`.

Возвращаемый `callIdentifier` является Идентификатором Задачи запущенного приложения.

Запросы "прервать звонок" и "закончить звонок" отправляются в запущенное приложение как события `cancelCall` и `endCall`.

Запрос "прочитать статус" возвращает содержимое словаря "статус приложения", установливаемого запущенным приложением.

Запросы "добавить участника" и "удалить участника" отправляются в запущенное приложение как события `addCallPeer` и `delCallPeer`; в параметрах события содержится URI участника, указываемое в запросе.

Запросы "преключить участника" отправляются в запущенное приложения как два события.
Первым отправляется событие `transferTarget`. Его параметры содержат Идентификатор Задачи для сессии, в которую должен быть передан участник.
Затем отправляется событие `transferCallPeer`. Его параметры содежрат URI участрника, указываемые в запросе.

Приложение не завершает свою работу немедленно в случае аварийного завершения или прекращения звонка. Приложение продолжат работать еще некоторое время (по умолчанию около 30 секунд), обрабатывая запроса "прочитать статус" для завершения звонка/сессии.

## Уведомления о Звонках

Интерфес ParlayX для Обработки Звонков позволяет клиентским приложениям задавать Правила Сигналов для Пользователя. Эти Правила включают в себя специальные Действия Parlay, в которых реализованы команды "Направление Звонка" ("CallDirection") и "Уведомление о Звонке" (""CallNotification"") Интерфейса Parlay.

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

Обратите внимание: запросы `stopCallNotification` и `stopCallDirectionNotification` должны содержать части `addresses` и `criteria`, а значение части `correlator` игнорируется.
Это необходимо по причине того, что Правила задаются индивидуально для каждого Пользователя, а данные `correlator` не позволяют серверу направить запрос на удаление правила для нужного Пользователя.

Обратите внимание: сообщения `handleXxxxResponse` могут задавать действия `Подключить` вместо действия `Перенаправить к`. Адрес(а), указанный в части `routingAddress` добавляются в набор AOR Сигнала, но активным остаётся текущий набор AOR.

## Платежи

Интерфейс для Платежей ParlayX позволяет клиентскому приложению взаимодействовать с Менеджером Тарификации CommuniGate Pro.

Обратите внимание: Пользователь CommuniGate Pro может иметь несколько Остатков. Все запросы на Платежи ParlayX должны включать элемент типа `xsd:string` `balanceType`, задающий имя Остатка Пользователя.

## Управление Пользователем

Интерфейс для Управления Пользователем ParlayX позволяет клиентскому приложению взаимодействовать с Менеджером Тарификации CommuniGate Pro.

## Обработка Звонков

Интерфес ParlayX для Обработки Звонков позволяет клиентским приложениям:

- задавать Правила Сигналов для Пользователя
- прочитать Правила Сигналов, заданные для Пользователя

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

Все элементы `acceptList` Parlay X преобразовываются в одно Правило Сигналов.
Все элементы `blockList` Parlay X преобразовываются в одно Правило Сигналов.
Элемент `forward` и каждый элемент `forwardList` Parlay X преобразовываются в три Правила Сигналов.

Руководство CommuniGate® Pro. Copyright © 1998-2009, Stalker Software, Inc.