Luware Nimbus

Соединитель для Nimbus Contact Center и корпоративных лицензированных служб маршрутизации для быстрого подключения Nimbus к сторонним системам. Прослушивая и реагируя на события триггера, соединитель может выполнять действия потока, например получать данные из внешних систем и хранить их в параметрах Nimbus для последующего использования в рабочих процессах Nimbus.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя	Служба технической поддержки Luware
URL	https://helpdesk.luware.cloud/
Адрес электронной почты	nimbus.support@luware.com

Метаданные соединителя
Publisher	Luware
Веб-сайт	https://luware.com/
Privacy Policy (Политика конфиденциальности)	https://luware.com/en/privacy-policy/
Категории	Коммуникация; Сотрудничество

Соединитель Luware Nimbus позволяет интегрировать между Nimbus и сторонним программным обеспечением, например CRMs или системами билетов. Он позволяет прослушивать события записи задач и планировщика, происходящие в Luware Nimbus. Вы можете создавать задачи, дополнять существующие задачи данными вызывающего абонента, добавлять параметры маршрутизации или активировать событие в 3-сторонней системе. Кроме того, вы можете управлять адресными книгами, планировать исходящие вызовы или добавлять внешние задачи.

Ниже приведены некоторые варианты использования:

• Отображение контактных данных в Nimbus для входящего звонка.
• Сохранение выбора языка из IVR в Nimbus в CRM.
• Создайте рабочий элемент после вызова в CRM.
• Создайте задачу обратного вызова для пропущенного звонка в CRM.
• Создайте исходящий вызов Nimbus на основе кампании в CRM.
• Перенаправлять вызов в соответствии с предпочтениями клиента.
• Отображение настроек вызывающего объекта для входящего вызова.
• Создайте билеты в 3-й партийной системе.
• Создайте список пропущенных вызовов в 3-й партийной системе.
• Откройте запись клиента, когда агент принимает звонок.

Дополнительные сведения и много справки см. в базе знаний Luware: https://help.luware.com/nimbus-power-automate-connector

Предпосылки

• План Microsoft PowerApps или PowerAutomate с уровнем "Премиум"
• Клиент Azure
• По крайней мере одна подготовленная служба Luware Nimbus
• Роль в Luware Nimbus, которая позволяет использовать соединитель Luware Nimbus (https://help.luware.com/power-automate-roles)

Как установить безопасное подключение

API Nimbus защищены с помощью Azure Active Directory (AAD) или идентификатора Microsoft Entra с помощью делегированных разрешений. Администратор клиента должен предоставить эти разрешения для приложения Luware Nimbus Login, чтобы соединитель смог безопасно получить доступ к Luware Nimbus. В большинстве случаев эти разрешения были предоставлены во время подключения Nimbus и не должны быть подтверждены.

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

Начало работы с соединителем

1. Выберите триггер "При изменении состояния задачи" в триггерах Luware Nimbus.
2. Настройте службу Nimbus, в которой требуется прослушивать входящие вызовы.
3. Выберите событие "Система принято" (активируется при достижении действия "Принять беседу" в рабочем процессе).
4. Реализуйте поиск сведений абонента на основе номера телефона вызывающего абонента, например в CRM или для тестирования в листе Excel, размещенном в Sharepoint.
5. Используйте действие "Обновить задачу", чтобы задать сведения о клиенте, такие как Firstname/Lastname, Address, City, Country и т. д. для задачи.

Ознакомьтесь с разделом вариантов использования базы знаний: https://help.luware.com/power-automate-use-cases

Известные проблемы и ограничения

• Потеря разрешений (RBAC) в Luware Nimbus отключает триггеры в power automate без прозрачной информации для конечного пользователя. Потоки больше не будут активированы.
• Luware не влияет на время выполнения потоков, поэтому результаты могут возвращаться в Nimbus с задержкой. Рабочие процессы в зависимости от завершения потока следует создавать, учитывая это ограничение.

Распространенные ошибки и средства устранения неполадок

Код ошибки HTTP:

• 400. Запрос, отправленный в API Luware Nimbus, содержит недопустимые параметры или их нельзя применить. Примеры. Все переданные предпочтительные пользователи недопустимы, поэтому предпочитаемые пользователи не заданы или вы пытаетесь удалить внешнюю задачу, когда она уже назначена пользователю.
• 401. Предоставленный маркер проверки подлинности не может быть проанализирован или недопустим. Проверьте правильную настройку регистрации приложения Azure AD / Entra ID и укажите правильные учетные данные для учетной записи O365.
• 403. У вашей учетной записи отсутствуют необходимые разрешения в Nimbus для выполнения действия, настроенного в потоке. Обратитесь к базе знаний и обратитесь к администратору, если вам нужны дополнительные роли и права.
• 404. Переданные идентификаторы нельзя сопоставить с любой сущностью в серверной части.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

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

Имя	Тип	Description	Обязательно
Местоположение	струна	Расположение, в который находится ваш клиент.	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Добавление контакта в адресную книгу	Добавляет новый контакт в определенную адресную книгу. ExternalId используется в качестве ссылки в дальнейших запросах.
Добавление новой внешней задачи	Добавление новой внешней задачи
Обновление задачи	Обновите сведения о клиенте, параметр контекста и /или предпочитаемые параметры пользователей для выполнения задачи.
Обновление записи планировщика	Изменение параметров для уже созданной записи планировщика.
Обновление исходящего вызова с помощью записи планировщика рабочих процессов	Изменение параметров для уже созданного исходящего вызова с записью планировщика рабочих процессов.
Обновление контакта в адресной книге	Обновляет один контакт в указанной адресной книге.
Планирование нового исходящего вызова	Запланируйте новый исходящий вызов (запись планировщика).
Планирование нового исходящего вызова с помощью рабочего процесса	Запланируйте новый исходящий вызов с помощью рабочего процесса (запись планировщика).
Получение всех записей планировщика	Возвращает все записи планировщика для указанной службы.
Получение данных помощника по виртуальному пользователю	Возвращает данные виртуального помощника пользователя для выбранного сеанса службы.
Получение контактов из адресной книги	Возвращает контакты из адресной книги.
Получение часов открытия	Получение часов работы службы: оно возвращает состояние службы (Open, Closed, Holiday и т. д.) в определенное время.
Пустая адресная книга	Удалите все контакты в указанной адресной книге.
Удаление внешней задачи	Удаление внешней задачи
Удаление записи планировщика	Удалите запись планировщика из системы. Только возможно, в то время как запись планировщика еще не выполняется.
Удаление контактов из адресных книг	Удалите один или несколько контактов из адресной книги.

Добавление контакта в адресную книгу

Идентификатор операции:

AddContact

Добавляет новый контакт в определенную адресную книгу. ExternalId используется в качестве ссылки в дальнейших запросах.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адресная книга	AddressBook	True	string	Адресная книга, в которую нужно добавить контакт.
Внешний идентификатор контакта	externalId	True	string	Идентификатор контакта, заданного внешней системой.
Имя контакта	firstName		string	Имя контакта.
Фамилия контакта	lastName		string	Фамилия контакта.
Отображаемое имя контакта	displayName		string	Отображаемое имя контакта.
Инициалы контактов	initials		string	Инициалы контакта.
Контактная компания	company		string	Компания контакта.
Контактный отдел	department		string	Отдел контакта.
Название задания контакта	jobTitle		string	Название задания контакта.
Контактное имя участника-пользователя	userPrincipalName		string	Имя участника-пользователя контакта.
Контактные адреса обмена мгновенными сообщениями	imAddresses		array of string	Список адресов мгновенных сообщений.
Контактные адреса электронной почты	emailAddresses		array of string	Список адресов электронной почты.
Контактные телефоны для бизнеса	businessPhones		array of string	Список бизнес-телефонов.
Связаться с мобильными телефонами	mobilePhones		array of string	Список мобильных телефонов.
Контакт на домашних телефонах	homePhones		array of string	Список домашних телефонов.
Адресная улица	street		string	Улица и номер адреса.
Адрес города	city		string	Город адреса.
Адресная страна	country		string	Страна адреса.
Состояние адреса	state		string	Состояние адреса.
Почтовый код адреса	postalCode		string	Почтовый индекс адреса.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.

Возвращаемое значение

Тело

ContactReadDto

Добавление новой внешней задачи

Идентификатор операции:

AddExternalTask

Добавление новой внешней задачи

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя участника-службы	serviceUpn	True	string	Имя участника-участника службы.
Идентификатор клиента	customerIdentifier		string	Необязательный уникальный идентификатор отчетов, анонимный при пустом состоянии.
Имя клиента	firstName		string	Имя клиента.
Фамилия клиента	lastName		string	Фамилия клиента.
Отображаемое имя клиента	displayName		string	Отображаемое имя клиента.
Клиентская компания	company		string	Компания клиента.
Название задания клиента	jobTitle		string	Название задания клиента.
Отдел клиентов	department		string	Отдел клиента.
Адрес улицы клиента	streetAddress		string	Адрес улицы клиента.
Почтовый код клиента	postCode		string	Почтовый код клиента.
Город клиента	city		string	Город клиента.
Состояние клиента	state		string	Состояние клиента.
Страна/регион клиента	country		string	Страна клиента.
Основной номер телефона клиента	primaryTelNumber		string	Основной номер телефона клиента.
Имя	name	True	string	Присвоение номера телефона.
Ценность	value		string	Значение номера телефона.
Имя участника-пользователя клиента	UPN		string	Имя участника-пользователя клиента.
Адрес обмена мгновенными сообщениями клиента	imAddress		string	Мгновенный адрес клиента.
Электронная почта клиента	email		string	Электронная почта клиента.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.
Имя	name	True	string	Имя настраиваемого параметра контекста.
Ценность	value		string	Значение настраиваемого параметра контекста.
Приоритет распределения	distributionPriority		string	Приоритет, с которым задача должна обрабатываться в Nimbus после его выполнения.
UPN	upn	True	string	Имя участника-пользователя, предпочитаемого пользователя.
Priority	priority		integer	Приоритет. 1 высокий до 99 низких.

Возвращаемое значение

Тело

ExternalTaskWriteResult

Обновление задачи

Идентификатор операции:

UpdateTask

Обновите сведения о клиенте, параметр контекста и /или предпочитаемые параметры пользователей для выполнения задачи.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор задачи	taskId	True	string	Идентификатор конкретной задачи Nimbus.
Имя клиента	firstName		string	Имя клиента.
Фамилия клиента	lastName		string	Фамилия клиента.
Отображаемое имя клиента	displayName		string	Отображаемое имя клиента.
Клиентская компания	company		string	Компания клиента.
Название задания клиента	jobTitle		string	Название задания клиента.
Отдел клиентов	department		string	Отдел клиента.
Адрес улицы клиента	streetAddress		string	Адрес улицы клиента.
Почтовый код клиента	postCode		string	Почтовый код клиента.
Город клиента	city		string	Город клиента.
Состояние клиента	state		string	Состояние клиента.
Страна/регион клиента	country		string	Страна клиента.
Основной номер телефона клиента	primaryTelNumber		string	Основной номер телефона клиента.
Имя	name	True	string	Присвоение номера телефона.
Ценность	value		string	Значение номера телефона.
Имя участника-пользователя клиента	UPN		string	Имя участника-пользователя клиента.
Адрес обмена мгновенными сообщениями клиента	imAddress		string	Мгновенный адрес клиента.
Электронная почта клиента	email		string	Электронная почта клиента.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.
Имя	name	True	string	Имя настраиваемого параметра контекста.
Ценность	value		string	Значение настраиваемого параметра контекста.
UPN	upn	True	string	Имя участника-пользователя, предпочитаемого пользователя.
Priority	priority		integer	Приоритет. 1 высокий до 99 низких.
Идентификатор сеанса службы	serviceSessionId		string	Идентификатор сеанса службы.
Идентификатор сеанса пользователя	userSessionId		string	Идентификатор сеанса пользователя.

Обновление записи планировщика

Идентификатор операции:

UpdateSchedulerEntry

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор записи планировщика	SchedulerEntryID	True	string	Идентификатор обновляемой записи планировщика.
Идентификатор ссылки	ReferenceId		string	Идентификатор ссылки, переданный сторонней системой.
Место назначения	destination	True	string	Назначение записей планировщика с направлением "Исходящий".
Приоритет распределения	distributionPriority		string	Приоритет, с которым должна обрабатываться задача в Nimbus.
Время выполнения (UTC)	dueDateTimeUtc	True	date-time	Дата и время выполнения в формате UTC: "2020-03-23T11:00:00Z".
Имя участника-службы	serviceUpn	True	string	Имя участника-участника службы.
Максимальные попытки	maxAttempts		integer	Максимальные попытки достичь назначения.
Время ожидания попытки в секундах	attemptTimeoutInSeconds		integer	Время ожидания (интервалы) между повторными попытками подключения до достижения максимального числа попыток.
Максимальное время очереди в секундах	maxQueueTimeInSeconds		integer	Определяет, сколько времени Nimbus пытается решить задачу до тех пор, пока задача не будет признана достигнутой ограничением.
Время ожидания RONA в секундах	ronaTimeoutInSeconds		integer	Определяет, сколько времени Nimbus пытается связаться с пользователем, пока задача не будет считаться RONA, и новый пользователь будет выбран.
Имя	name	True	string	Имя настраиваемого параметра контекста.
Ценность	value		string	Значение настраиваемого параметра контекста.
Имя клиента	firstName		string	Имя клиента.
Фамилия клиента	lastName		string	Фамилия клиента.
Отображаемое имя клиента	displayName		string	Отображаемое имя клиента.
Клиентская компания	company		string	Компания клиента.
Название задания клиента	jobTitle		string	Название задания клиента.
Отдел клиентов	department		string	Отдел клиента.
Адрес улицы клиента	streetAddress		string	Адрес улицы клиента.
Почтовый код клиента	postCode		string	Почтовый код клиента.
Город клиента	city		string	Город клиента.
Состояние клиента	state		string	Состояние клиента.
Страна/регион клиента	country		string	Страна клиента.
Основной номер телефона клиента	primaryTelNumber		string	Основной номер телефона клиента.
Имя	name	True	string	Присвоение номера телефона.
Ценность	value		string	Значение номера телефона.
Имя участника-пользователя клиента	UPN		string	Имя участника-пользователя клиента.
Адрес обмена мгновенными сообщениями клиента	imAddress		string	Мгновенный адрес клиента.
Электронная почта клиента	email		string	Электронная почта клиента.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.

Возвращаемое значение

Тело

SchedulerEntryEventData

Обновление исходящего вызова с помощью записи планировщика рабочих процессов

Идентификатор операции:

UpdateOutboundCallWithWorkflowSchedulerEntry

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор записи планировщика	SchedulerEntryID	True	string	Идентификатор обновляемой записи планировщика.
Идентификатор ссылки	ReferenceId		string	Идентификатор ссылки, переданный сторонней системой.
Место назначения	destination	True	string	Назначение исходящего вызова с рабочим процессом.
Время выполнения (UTC)	dueDateTimeUtc	True	date-time	Дата и время выполнения в формате UTC: "2020-03-23T11:00:00Z".
Имя участника-службы	serviceUpn	True	string	Имя участника-участника службы.
Максимальные попытки	maxAttempts		integer	Максимальные попытки достичь назначения.
Время ожидания попытки в секундах	attemptTimeoutInSeconds		integer	Определяет, сколько времени Nimbus пытается достичь назначения до остановки попытки.
Имя	name	True	string	Имя настраиваемого параметра контекста.
Ценность	value		string	Значение настраиваемого параметра контекста.
Имя клиента	firstName		string	Имя клиента.
Фамилия клиента	lastName		string	Фамилия клиента.
Отображаемое имя клиента	displayName		string	Отображаемое имя клиента.
Клиентская компания	company		string	Компания клиента.
Название задания клиента	jobTitle		string	Название задания клиента.
Отдел клиентов	department		string	Отдел клиента.
Адрес улицы клиента	streetAddress		string	Адрес улицы клиента.
Почтовый код клиента	postCode		string	Почтовый код клиента.
Город клиента	city		string	Город клиента.
Состояние клиента	state		string	Состояние клиента.
Страна/регион клиента	country		string	Страна клиента.
Основной номер телефона клиента	primaryTelNumber		string	Основной номер телефона клиента.
Имя	name	True	string	Присвоение номера телефона.
Ценность	value		string	Значение номера телефона.
Имя участника-пользователя клиента	UPN		string	Имя участника-пользователя клиента.
Адрес обмена мгновенными сообщениями клиента	imAddress		string	Мгновенный адрес клиента.
Электронная почта клиента	email		string	Электронная почта клиента.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.

Возвращаемое значение

Тело

OutboundCallWithWorkflowSchedulerEntryEventData

Обновление контакта в адресной книге

Идентификатор операции:

UpdateContact

Обновляет один контакт в указанной адресной книге.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адресная книга	AddressBook	True	string	Адресная книга для обновления контакта.
Внешний идентификатор контакта	externalId	True	string	Идентификатор контакта, заданного внешней системой.
Имя контакта	firstName		string	Имя контакта.
Фамилия контакта	lastName		string	Фамилия контакта.
Отображаемое имя контакта	displayName		string	Отображаемое имя контакта.
Инициалы контактов	initials		string	Инициалы контакта.
Контактная компания	company		string	Компания контакта.
Контактный отдел	department		string	Отдел контакта.
Название задания контакта	jobTitle		string	Название задания контакта.
Контактное имя участника-пользователя	userPrincipalName		string	Имя участника-пользователя контакта.
Контактные адреса обмена мгновенными сообщениями	imAddresses		array of string	Список адресов мгновенных сообщений.
Контактные адреса электронной почты	emailAddresses		array of string	Список адресов электронной почты.
Контактные телефоны для бизнеса	businessPhones		array of string	Список бизнес-телефонов.
Связаться с мобильными телефонами	mobilePhones		array of string	Список мобильных телефонов.
Контакт на домашних телефонах	homePhones		array of string	Список домашних телефонов.
Адресная улица	street		string	Улица и номер адреса.
Адрес города	city		string	Город адреса.
Адресная страна	country		string	Страна адреса.
Состояние адреса	state		string	Состояние адреса.
Почтовый код адреса	postalCode		string	Почтовый индекс адреса.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.

Возвращаемое значение

Тело

ContactReadDto

Планирование нового исходящего вызова

Идентификатор операции:

CreateSchedulerEntry

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор ссылки	ReferenceId		string	Идентификатор ссылки, переданный сторонней системой.
Место назначения	destination	True	string	Назначение записей планировщика с направлением "Исходящий".
Приоритет распределения	distributionPriority		string	Приоритет, с которым должна обрабатываться задача в Nimbus.
Время выполнения (UTC)	dueDateTimeUtc	True	date-time	Дата и время выполнения в формате UTC: "2020-03-23T11:00:00Z".
Имя участника-службы	serviceUpn	True	string	Имя участника-участника службы.
Максимальные попытки	maxAttempts		integer	Максимальные попытки достичь назначения.
Время ожидания попытки в секундах	attemptTimeoutInSeconds		integer	Время ожидания (интервалы) между повторными попытками подключения до достижения максимального числа попыток.
Максимальное время очереди в секундах	maxQueueTimeInSeconds		integer	Определяет, сколько времени Nimbus пытается решить задачу до тех пор, пока задача не будет признана достигнутой ограничением.
Время ожидания RONA в секундах	ronaTimeoutInSeconds		integer	Определяет, сколько времени Nimbus пытается связаться с пользователем, пока задача не будет считаться RONA, и новый пользователь будет выбран.
Имя	name	True	string	Имя настраиваемого параметра контекста.
Ценность	value		string	Значение настраиваемого параметра контекста.
Имя клиента	firstName		string	Имя клиента.
Фамилия клиента	lastName		string	Фамилия клиента.
Отображаемое имя клиента	displayName		string	Отображаемое имя клиента.
Клиентская компания	company		string	Компания клиента.
Название задания клиента	jobTitle		string	Название задания клиента.
Отдел клиентов	department		string	Отдел клиента.
Адрес улицы клиента	streetAddress		string	Адрес улицы клиента.
Почтовый код клиента	postCode		string	Почтовый код клиента.
Город клиента	city		string	Город клиента.
Состояние клиента	state		string	Состояние клиента.
Страна/регион клиента	country		string	Страна клиента.
Основной номер телефона клиента	primaryTelNumber		string	Основной номер телефона клиента.
Имя	name	True	string	Присвоение номера телефона.
Ценность	value		string	Значение номера телефона.
Имя участника-пользователя клиента	UPN		string	Имя участника-пользователя клиента.
Адрес обмена мгновенными сообщениями клиента	imAddress		string	Мгновенный адрес клиента.
Электронная почта клиента	email		string	Электронная почта клиента.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.

Возвращаемое значение

Тело

SchedulerEntryEventData

Планирование нового исходящего вызова с помощью рабочего процесса

Идентификатор операции:

CreateOutboundCallWithWorkflowSchedulerEntry

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор ссылки	ReferenceId		string	Идентификатор ссылки, переданный сторонней системой.
Место назначения	destination	True	string	Назначение исходящего вызова с рабочим процессом.
Время выполнения (UTC)	dueDateTimeUtc	True	date-time	Дата и время выполнения в формате UTC: "2020-03-23T11:00:00Z".
Имя участника-службы	serviceUpn	True	string	Имя участника-участника службы.
Максимальные попытки	maxAttempts		integer	Максимальные попытки достичь назначения.
Время ожидания попытки в секундах	attemptTimeoutInSeconds		integer	Определяет, сколько времени Nimbus пытается достичь назначения до остановки попытки.
Имя	name	True	string	Имя настраиваемого параметра контекста.
Ценность	value		string	Значение настраиваемого параметра контекста.
Имя клиента	firstName		string	Имя клиента.
Фамилия клиента	lastName		string	Фамилия клиента.
Отображаемое имя клиента	displayName		string	Отображаемое имя клиента.
Клиентская компания	company		string	Компания клиента.
Название задания клиента	jobTitle		string	Название задания клиента.
Отдел клиентов	department		string	Отдел клиента.
Адрес улицы клиента	streetAddress		string	Адрес улицы клиента.
Почтовый код клиента	postCode		string	Почтовый код клиента.
Город клиента	city		string	Город клиента.
Состояние клиента	state		string	Состояние клиента.
Страна/регион клиента	country		string	Страна клиента.
Основной номер телефона клиента	primaryTelNumber		string	Основной номер телефона клиента.
Имя	name	True	string	Присвоение номера телефона.
Ценность	value		string	Значение номера телефона.
Имя участника-пользователя клиента	UPN		string	Имя участника-пользователя клиента.
Адрес обмена мгновенными сообщениями клиента	imAddress		string	Мгновенный адрес клиента.
Электронная почта клиента	email		string	Электронная почта клиента.
Имя	name	True	string	Назначение настраиваемого поля.
Ценность	value		string	Значение настраиваемого поля.

Возвращаемое значение

Тело

OutboundCallWithWorkflowSchedulerEntryEventData

Получение всех записей планировщика

Идентификатор операции:

GetSchedulerEntries

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя участника-службы	serviceUpn	True	string	Имя участника-участника службы, для которой должны быть возвращены записи планировщика.

Возвращаемое значение

Список всех запланированных задач для указанной службы

Запланированные задачи

array of SchedulerEntryEventData

Получение данных помощника по виртуальному пользователю

Идентификатор операции:

GetVirtualUserAssistantData

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор сеанса службы	serviceSessionId	True	string	Идентификатор сеанса службы, для которого должны быть возвращены данные виртуального помощника пользователя.
Идентификатор сеанса пользователя	userSessionId		string	Идентификатор сеанса пользователя, для которого должны быть возвращены данные виртуального помощника пользователя.
Тип данных	dataType	True	string	Тип данных, которые должны быть возвращены для сеанса службы.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение контактов из адресной книги

Идентификатор операции:

GetContacts

Возвращает контакты из адресной книги.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адресная книга	AddressBook	True	string	Адресная книга для получения контактов.
ExternalId	externalIds		array	Внешние идентификаторы контактов для получения. Необязательный: если не указано, будут возвращены все контакты.

Возвращаемое значение

Возвращенные контакты.

Контакты

array of ContactReadDto

Получение часов открытия

Идентификатор операции:

GetOpeningHours

Получение часов работы службы: оно возвращает состояние службы (Open, Closed, Holiday и т. д.) в определенное время.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя участника-службы	serviceUpn	True	string	Имя участника-участника службы, для которой будет проверено состояние.
Время выполнения (UTC)	time		date-time	Дата и время выполнения в формате UTC: "2020-03-23T11:00:00Z".

Возвращаемое значение

Состояние службы (Open, Closed и т. д.).

response

CalendarStatus

Пустая адресная книга

Идентификатор операции:

ClearContacts

Удалите все контакты в указанной адресной книге.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адресная книга	AddressBook	True	string	Адресная книга, пустая

Удаление внешней задачи

Идентификатор операции:

RemoveExternalTask

Удаление внешней задачи

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор внешней задачи	externalTaskId	True	string	Идентификатор удаленной внешней задачи

Удаление записи планировщика

Идентификатор операции:

DeleteSchedulerEntry

Удалите запись планировщика из системы. Только возможно, в то время как запись планировщика еще не выполняется.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор записи планировщика	SchedulerEntryID	True	string	Идентификатор записи планировщика, который необходимо удалить.

Удаление контактов из адресных книг

Идентификатор операции:

RemoveContacts

Удалите один или несколько контактов из адресной книги.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Адресная книга	AddressBook	True	string	Адресная книга для удаления контакта.
externalIds	externalIds	True	array of string

Триггеры

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

Когда помощник виртуального пользователя имеет обновление

Идентификатор операции:

RegisterVirtualUserAssistantTrigger

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Services	services	True	array of string	Имена участника-службы, для которых следует получить события для задач.
События помощника по виртуальным пользователям	virtualUserAssistantEvents	True	array of string	События помощника виртуального пользователя, для которого должен вызываться этот триггер.

Возвращаемое значение

Тело

VirtualUserAssistantEventData

При изменении состояния задачи

Идентификатор операции:

RegisterTaskWebHook

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Services	services	True	array of string	Имена участника-службы, для которых следует получить события для задач.
События задачи	taskEvents	True	array of string	События задач, для которых должен вызываться этот триггер.
Условия	modalities		array of string	Укажите начальные модальности задач.
Маршруты	directions		array of string	Укажите направления задач.

Возвращаемое значение

Тело

TaskEventData

При изменении состояния записи планировщика

Идентификатор операции:

RegisterSchedulerEntryTrigger

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Services	services	True	array of string	Имена участника-службы, для которых следует получить события для задач.
События записи планировщика	schedulerEntryEvents	True	array of string	События записи планировщика, для которой должен вызываться этот триггер.

Возвращаемое значение

Тело

SchedulerEntryEventData

Определения

TaskEventData

Имя	Путь	Тип	Описание
Идентификатор задачи	taskId	string	Идентификатор конкретной задачи Nimbus.
Идентификатор сеанса службы	serviceSessionId	string	Идентификатор сеанса службы
Идентификатор сеанса пользователя	userSessionId	string	Идентификатор сеанса пользователя
Сеанс пользователя, запущенный с передачи	userSessionStartedWithTransfer	boolean	Указывает, был ли сеанс пользователя запущен в результате передачи.
Идентификатор цепочки вызовов	callChainId	string	Идентификатор цепочки вызовов от Корпорации Майкрософт задачи.
Event	event	string	Событие, которое произошло в Nimbus для задачи.
Направление	direction	string	Направление задачи, выполняемой в Nimbus (входящий и исходящий трафик/нет).
Modality	modality	string	Начальная модальность задачи в Nimbus.
Создано	created	string	Метка времени при создании задачи.
Прервано	terminated	string	Метка времени, когда задача была завершена.
Причина	reason	string	Причина прекращения работы.
Идентификатор последнего подключенного пользователя	lastConnectedUserId	string	Идентификатор объекта (AAD) последнего подключенного пользователя задачи.
Имя участника-пользователя последнего подключенного пользователя	LastConnectedUserUPN	string	Имя участника-пользователя последнего подключенного пользователя задачи.
Электронная почта последнего подключенного пользователя	LastConnectedUserEmail	string	Электронная почта последнего подключенного пользователя задачи.
Идентификатор вызывающего пользователя Майкрософт	microsoftCallerId	string	Идентификатор объекта (AAD) вызывающего объекта.
Идентификатор ссылки	referenceId	string	Идентификатор ссылки, переданный сторонней системой.
Идентификатор звонящего	callerId	string	Внутренний идентификатор вызывающего объекта в Nimbus. Идентификатор объекта (AAD), если вызывающий объект известен.
Телефонный номер абонента	callerTelNumber	string	Номер телефона (E.164) абонента. Задайте только для задач с модальность=Audio.
Имя участника-участника-абонента	callerUPN	string	Имя участника-пользователя клиента.
Идентификатор назначения Майкрософт	microsoftDestinationId	string	Идентификатор объекта (AAD) вызываемого объекта в исходящей задаче.
Идентификатор назначения	destinationId	string	Внутренний идентификатор назначения (исходящий) в Nimbus. Идентификатор объекта (AAD), если вызывающий объект известен.
Номер телефона назначения	destinationTelNumber	string	Номер телефона (E.164) назначения (исходящий).
Целевое имя участника-участника	destinationUPN	string	Имя участника-участника назначения (исходящий трафик).
Идентификатор ACS	acsId	string	Идентификатор связи Azure вызывающего объекта.
Анонимный	isAnonymous	boolean	Флаг имеет значение true, если вызывающий объект является анонимным.
Идентификатор клиента	customerIdentifier	string	Идентификатор клиента во всех типах задач.
Начальное сообщение	initialMessage	string	Первое сообщение клиенту обмена мгновенными сообщениями.
Идентификатор службы	serviceId	string	Внутренний идентификатор службы Nimbus.
Имя службы	serviceName	string	Имя службы Nimbus.
Описание службы	serviceDescription	string	Описание службы Nimbus (наследуется от Microsoft Teams).
Отображаемое имя службы	serviceDisplayName	string	Отображаемое имя службы Nimbus.
Имя участника-службы	serviceUPN	string	Имя участника-участника службы Nimbus.
Номер телефона службы	serviceTelNumber	string	Номер телефона (E.164) службы Nimbus.
Тема электронной почты	emailSubject	string	Тема сообщения электронной почты.
Текст сообщения электронной почты с уникальным форматированным текстом	emailBodyUniqueRichText	string	Текст сообщения электронной почты, форматированный текст.
Текст электронной почты, уникальный обычный текст	emailBodyUniquePlainText	string	Текст сообщения электронной почты, обычный текст.
Имя участника-пользователя почтового ящика службы электронной почты	emailServiceMailboxUPN	string	Имя участника-пользователя почтового ящика, назначенного службе.
Исходящие попытки	outboundAttempt	integer	Количество попыток связаться с исходящим назначением.
Обновленное имя параметра	updatedParameterName	string	Имя последнего параметра, который был обновлен.
Обновленное значение параметра	updatedParameterValue	string	Значение последнего параметра, который был обновлен.
Сведения о задаче	taskInformation	TaskInformation	Содержит сведения о клиенте, пользовательском параметре контекста и предпочитаемых пользователях.

TaskInformation

Содержит сведения о клиенте, пользовательском параметре контекста и предпочитаемых пользователях.

Имя	Путь	Тип	Описание
клиент	customer	Customer	Объект, содержащий всю информацию клиента.
Настраиваемые параметры контекста	customContextParameters	array of CustomContextParameter	Список пользовательских параметров контекста (Key-Value).
Предпочитаемые пользователи	preferredUsers	array of PreferredUser	Список предпочтительных пользователей для задач (UPN-Priority).

Клиент

Объект, содержащий всю информацию клиента.

Имя	Путь	Тип	Описание
Имя клиента	firstName	string	Имя клиента.
Фамилия клиента	lastName	string	Фамилия клиента.
Отображаемое имя клиента	displayName	string	Отображаемое имя клиента.
Клиентская компания	company	string	Компания клиента.
Название задания клиента	jobTitle	string	Название задания клиента.
Отдел клиентов	department	string	Отдел клиента.
Адрес улицы клиента	streetAddress	string	Адрес улицы клиента.
Почтовый код клиента	postCode	string	Почтовый код клиента.
Город клиента	city	string	Город клиента.
Состояние клиента	state	string	Состояние клиента.
Страна/регион клиента	country	string	Страна клиента.
Основной номер телефона клиента	primaryTelNumber	string	Основной номер телефона клиента.
Номера телефонов	telNumbers	array of TelNumber	Список дополнительных номеров телефонов клиента.
Имя участника-пользователя клиента	UPN	string	Имя участника-пользователя клиента.
Адрес обмена мгновенными сообщениями клиента	imAddress	string	Мгновенный адрес клиента.
Электронная почта клиента	email	string	Электронная почта клиента.
Настраиваемые поля	customFields	array of CustomField	Список настраиваемых полей клиента.

TelNumber

Имя	Путь	Тип	Описание
Имя	name	string	Присвоение номера телефона.
Ценность	value	string	Значение номера телефона.

CustomField

Имя	Путь	Тип	Описание
Имя	name	string	Назначение настраиваемого поля.
Ценность	value	string	Значение настраиваемого поля.

CustomContextParameter

Имя	Путь	Тип	Описание
Имя	name	string	Имя настраиваемого параметра контекста.
Ценность	value	string	Значение настраиваемого параметра контекста.

PreferredUser

Имя	Путь	Тип	Описание
UPN	upn	string	Имя участника-пользователя, предпочитаемого пользователя.
Priority	priority	integer	Приоритет. 1 высокий до 99 низких.

ContactReadDto

Имя	Путь	Тип	Описание
Внешний идентификатор контакта	externalId	string	Идентификатор контакта, заданного внешней системой.
Имя контакта	firstName	string	Имя контакта.
Фамилия контакта	lastName	string	Фамилия контакта.
Отображаемое имя контакта	displayName	string	Отображаемое имя контакта.
Инициалы контактов	initials	string	Инициалы контакта.
Контактная компания	company	string	Компания контакта.
Контактный отдел	department	string	Отдел контакта.
Название задания контакта	jobTitle	string	Название задания контакта.
Контактное имя участника-пользователя	userPrincipalName	string	Имя участника-пользователя контакта.
Контактные адреса обмена мгновенными сообщениями	imAddresses	array of string	Список адресов мгновенных сообщений.
Контактные адреса электронной почты	emailAddresses	array of string	Список адресов электронной почты.
Контактные телефоны для бизнеса	businessPhones	array of string	Список бизнес-телефонов.
Связаться с мобильными телефонами	mobilePhones	array of string	Список мобильных телефонов.
Контакт на домашних телефонах	homePhones	array of string	Список домашних телефонов.
addresses	addresses	array of Address	Список адресов.
customFields	customFields	array of CustomField	Список настраиваемых полей контакта.

Address

Имя	Путь	Тип	Описание
Адресная улица	street	string	Улица и номер адреса.
Адрес города	city	string	Город адреса.
Адресная страна	country	string	Страна адреса.
Состояние адреса	state	string	Состояние адреса.
Почтовый код адреса	postalCode	string	Почтовый индекс адреса.

SchedulerEntryEventData

Имя	Путь	Тип	Описание
Идентификатор записи планировщика	schedulerEntryId	string	Конкретный идентификатор Nimbus записи планировщика.
ConversationType	conversationType	string	Тип беседы записи планировщика.
Event	event	string	Событие, которое произошло в Nimbus для запланированной задачи.
Направление	direction	string	Направление задачи, выполняемой в Nimbus (входящий и исходящий трафик/нет).
Modality	modality	string	Начальная модальность задачи в Nimbus.
Идентификатор ссылки	ReferenceId	string	Идентификатор ссылки, переданный сторонней системой.
Унифицированный идентификатор беседы	unifiedConversationId	string	Унифицированный идентификатор беседы.
Причина завершения	completionReason	string	Результат записи планировщика при завершении.
Место назначения	destination	string	Назначение записей планировщика с направлением "Исходящий".
Приоритет распределения	distributionPriority	string	Приоритет, с которым должна обрабатываться задача в Nimbus.
Время выполнения (UTC)	dueDateTimeUtc	date-time	Дата и время выполнения в формате UTC: "2020-03-23T11:00:00Z".
Имя участника-службы	serviceUpn	string	Имя участника-участника службы, для которой запланирована запись.
Максимальные попытки	maxAttempts	integer	Максимальные попытки достичь назначения.
Время ожидания попытки в секундах	attemptTimeoutInSeconds	integer	Время ожидания (интервалы) между повторными попытками подключения до достижения максимального числа попыток.
Максимальное время очереди в секундах	maxQueueTimeInSeconds	integer	Определяет, сколько времени Nimbus пытается решить задачу до тех пор, пока задача не будет признана достигнутой ограничением.
Время ожидания RONA в секундах	ronaTimeoutInSeconds	integer	Определяет, сколько времени Nimbus пытается связаться с пользователем, пока задача не будет считаться RONA, и новый пользователь будет выбран.
Настраиваемые параметры контекста	customCallContextParameters	array of CustomContextParameter	Список настраиваемых параметров контекста (Key-Value).
клиент	customer	Customer	Объект, содержащий всю информацию клиента.

OutboundCallWithWorkflowSchedulerEntryEventData

Имя	Путь	Тип	Описание
Идентификатор записи планировщика	schedulerEntryId	string	Конкретный идентификатор Nimbus записи планировщика.
ConversationType	conversationType	string	Тип беседы записи планировщика.
Event	event	string	Событие, которое произошло в Nimbus для запланированной задачи.
Направление	direction	string	Направление задачи, выполняемой в Nimbus (входящий и исходящий трафик/нет).
Modality	modality	string	Начальная модальность задачи в Nimbus.
Идентификатор ссылки	ReferenceId	string	Идентификатор ссылки, переданный сторонней системой.
Унифицированный идентификатор беседы	unifiedConversationId	string	Унифицированный идентификатор беседы.
Причина завершения	completionReason	string	Результат записи планировщика при завершении.
Место назначения	destination	string	Назначение записей планировщика с направлением "Исходящий".
Приоритет распределения	distributionPriority	string	Приоритет, с которым должна обрабатываться задача в Nimbus.
Время выполнения (UTC)	dueDateTimeUtc	date-time	Дата и время выполнения в формате UTC: "2020-03-23T11:00:00Z".
Имя участника-службы	serviceUpn	string	Имя участника-участника службы, для которой запланирована запись.
Максимальные попытки	maxAttempts	integer	Максимальные попытки достичь назначения.
Время ожидания попытки в секундах	attemptTimeoutInSeconds	integer	Определяет, сколько времени Nimbus пытается достичь назначения до остановки попытки.
Настраиваемые параметры контекста	customCallContextParameters	array of CustomContextParameter	Список настраиваемых параметров контекста (Key-Value).
клиент	customer	Customer	Объект, содержащий всю информацию клиента.

VirtualUserAssistantEventData

Имя	Путь	Тип	Описание
Идентификатор единого сеанса	unifiedSessionId	string	Идентификатор связанного единого сеанса Nimbus.
Идентификатор сеанса службы	serviceSessionId	string	Идентификатор связанного сеанса службы Nimbus.
Идентификатор сеанса пользователя	userSessionId	string	Идентификатор связанного сеанса пользователя Nimbus.
Имя участника-службы	serviceUpn	string	Имя участника-участника службы, для которой произошло событие.
Идентификатор службы	serviceId	string	Идентификатор службы, для которой произошло событие.
Имя службы	serviceName	string	Имя службы, для которой произошло событие.
Event	event	string	Событие виртуального помощника пользователя, которое произошло в Nimbus.
Сеанс пользователя, запущенный с передачи	userSessionStartedWithTransfer	boolean	Указывает, был ли сеанс пользователя запущен в результате передачи.

ExternalTaskWriteResult

Имя	Путь	Тип	Описание
Идентификатор внешней задачи	id	string	Идентификатор добавленной внешней задачи.
Modality	modality	Modality	Модальность задачи.
Создано	created	string	Метка времени при создании внешней задачи.
Тип	type	string	Тип внешней задачи.
Анонимный	isAnonymous	boolean	Флаг имеет значение true, если вызывающий объект является анонимным.
Идентификатор службы	serviceId	string	Внутренний идентификатор службы Nimbus.
Имя службы	serviceName	string	Имя службы Nimbus.
Описание службы	serviceDescription	string	Описание службы Nimbus (наследуется от Microsoft Teams).
Отображаемое имя службы	serviceDisplayName	string	Отображаемое имя службы.
Имя участника-службы	serviceUPN	string	Имя участника-участника службы.
Номер телефона службы	serviceTelNumber	string	Номер телефона службы.
Предпочитаемые пользователи	preferredUsers	array of PreferredUser	Список предпочтительных пользователей для задач (UPN-Priority).

Modality

Модальность задачи.

Модальность задачи.

Modality

string

CalendarStatus

Состояние службы (Open, Closed и т. д.).

Состояние службы (Open, Closed и т. д.).

Состояние времени открытия

string