机器人平台 （预览版）
将 Bot Platform 的机器人连接到任何应用程序，将消息发送到机器人用户，使用机器人平台中的现有机器人设置属性值
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Bot Platform 支持 |
| URL | https://thebotplatform.com/contact/ |
| hello@thebotplatform.com |
| 连接器元数据 | |
|---|---|
| 发布者 | 机器人平台 |
| 网站 | https://thebotplatform.com |
| 隐私策略 | https://thebotplatform.com/privacy-policy/ |
| 类别 | 通信;网站 |
使用 Bot Platform 连接器，可以使用 Power Automate 流中的数据向机器人中的用户发送消息，为现有属性创建新属性并设置值。 连接器利用我们的 API 来执行所有这些作，而无需手动设置 API 调用，而只需使用连接器更快地执行 API作。
先决条件
需要在 Bot Platform 上拥有一个帐户
如何获取凭据
登录到 Bot Platform CMS 后，转到要连接的机器人。 单击边栏菜单中的“API 访问”，并创建新的集成应用。 你将使用客户端 ID 和密钥提供，在 Power Automate 中输入此信息，使用连接器通过 Power Automate 对机器人进行身份验证。
连接器入门
登录到帐户后，转到要集成的机器人，并单击“API 访问”获取客户端 ID 和密钥。 获取此信息后，创建新的 Power Automate Flow，系统会提示你输入客户端 ID 和密钥。 输入此信息后，将显示一个弹出窗口，要求访问机器人的权限。 点击“允许”，你已全部设置！
已知问题和限制
- 目前，用户只能通过电子邮件地址进行标识，才能将信息传达回机器人。
- 不能使用简单的文本消息作发送图像 URL。
常见错误和补救措施
对于安装在 Microsoft Teams 上的机器人，无法向以前未与机器人交互的用户发送消息。 解决方法是先从平台内部向用户发送广播，然后再使用连接器发送消息。
FAQ
有关用例的详细信息，请访问 我们的开发文档页面
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| 客户端 ID - 机器人平台 clientId | 字符串 | 请输入客户端 ID。 | True |
| 机器人平台客户端密码 | securestring | 请输入客户端密码。 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 创建用户属性 |
在机器人中设置新属性 |
| 向机器人用户发送简单的短信 |
使用文本向机器人用户发送消息 |
| 设置属性值 |
通过用户电子邮件地址设置属性值 |
创建用户属性
在机器人中设置新属性
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
属性名称
|
name | string |
提供属性的名称 |
|
|
pii 是吗？
|
is_pii | string |
是否是个人身份信息？ |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
UserAttribute
|
data | UserAttribute |
用户属性 |
向机器人用户发送简单的短信
使用文本向机器人用户发送消息
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文本消息
|
text | string |
在此处输入短信 |
|
|
电子邮件地址
|
recipient | string |
收件人的电子邮件地址 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
外部活动
|
data | ExternalActivity |
设置属性值
通过用户电子邮件地址设置属性值
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
正在设置其属性的用户的电子邮件地址
|
emailaddress | True | string |
电子邮件地址 |
|
属性 ID
|
id | True | string |
机器人中的现有属性 |
|
value
|
value | string |
属性值 |