Платформа Bot (предварительная версия)
Подключение ботов Bot Platform к любому приложению, отправка сообщений пользователям бота, установка значений атрибутов с помощью существующих ботов на платформе Bot
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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) |
| Контакт | |
|---|---|
| Имя | Поддержка платформы Бота |
| URL | https://thebotplatform.com/contact/ |
| Адрес электронной почты | hello@thebotplatform.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Платформа Бота |
| Веб-сайт | https://thebotplatform.com |
| Политика конфиденциальности | https://thebotplatform.com/privacy-policy/ |
| Категории | Коммуникация; Сайт |
Соединитель Bot Platform позволяет использовать данные из потоков Power Automate для отправки сообщений пользователям в боте, создания новых атрибутов и задания значений для существующих атрибутов. Соединитель использует наш API для выполнения всех этих действий без необходимости настраивать вызовы API вручную, а просто использовать соединитель для выполнения действий API быстрее.
Предпосылки
Вам потребуется учетная запись на платформе Bot
Получение учетных данных
После входа в CMS платформы Бота перейдите к боту, который вы хотите подключить. Щелкните "Доступ к API" в боковом меню и создайте новое приложение интеграции. Вам будет предоставлен идентификатор клиента и секретный ключ, введите эти сведения в Power Automate, где вы используете соединитель для проверки подлинности бота с помощью Power Automate.
Начало работы с соединителем
После входа в учетную запись перейдите к боту, который вы хотите интегрировать, и щелкните "Доступ к API", чтобы получить идентификатор клиента и секретный ключ. После получения этих сведений создайте новый поток Power Automate, вам будет предложено ввести идентификатор клиента и секретный ключ там. После ввода этих сведений появится всплывающее окно с запросом разрешения на доступ к боту. Нажмите "Разрешить", и вы все заданы!
Известные проблемы и ограничения
- В настоящее время пользователи могут быть идентифицированы только по адресу электронной почты, чтобы иметь возможность обмениваться информацией с ботом.
- Невозможно отправить URL-адрес изображения с помощью простой операции текстового сообщения.
Распространенные ошибки и средства устранения неполадок
Для ботов, установленных в Microsoft Teams, невозможно отправить сообщение пользователю, который ранее не взаимодействовал с ботом. Обходной путь заключается в том, чтобы сначала отправить пользователю широковещательный канал пользователю из платформы перед отправкой сообщения с помощью соединителя.
Часто задаваемые вопросы
Дополнительные сведения о вариантах использования см. на странице документации разработчика
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Идентификатор клиента — идентификатор клиента Bot Platform | струна | Введите идентификатор клиента. | True |
| Секрет клиента платформы Бота | securestring | Введите секрет клиента. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка простого текстового сообщения пользователю бота |
Отправка сообщения пользователю бота с помощью текста |
| Создание атрибута пользователя |
Настройка нового атрибута в боте |
| Установка значения атрибута |
Установка значения атрибута с помощью адреса электронной почты пользователей |
Отправка простого текстового сообщения пользователю бота
Отправка сообщения пользователю бота с помощью текста
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
текст
|
text | string |
Введите текстовое сообщение здесь |
|
|
адрес электронной почты
|
recipient | string |
адрес электронной почты получателя |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Внешнее действие
|
data | ExternalActivity |
Создание атрибута пользователя
Настройка нового атрибута в боте
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя атрибута
|
name | string |
Укажите имя атрибута |
|
|
pii?
|
is_pii | string |
является ли это персональным идентифицируемым сведениями? |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
UserAttribute
|
data | UserAttribute |
Атрибут пользователя |
Установка значения атрибута
Установка значения атрибута с помощью адреса электронной почты пользователей
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
адрес электронной почты пользователя, который задается атрибутом
|
emailaddress | True | string |
адрес электронной почты |
|
Идентификатор атрибута
|
id | True | string |
Существующие атрибуты в боте |
|
value
|
value | string |
Значение атрибута |