CardPlatform 自适应卡片 （预览版）

CardPlatform 允许向用户发送自适应卡片。 可用于作性内容，例如审批、表单捕获和常规消息。 它支持模板化和自定义卡。

此连接器在以下产品和区域中可用：

服务	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	CardPlatform 支持
URL	https://cardplatform.app/support
Email	support@cardplatform.app

连接器元数据
发布者	CardPlatform
网站	https://cardplatform.app/
隐私策略	https://cardplatform.app/privacy/
类别	协作;通信

CardPlatform 允许你直接向用户发送自适应卡片和可作内容。

先决条件

若要使用 CardPlatform，需要：

• 创建 CardPlatform 订阅，开始选择 计划;
• 有一个免费试用订阅，可供试用和试验。

如何获取凭据

注册完成后，你将在电子邮件中收到 API 密钥。

获得 API 密钥后，创建新的连接，输入 API 密钥并开始发送卡片。

连接器入门

若要开始，请先发送消息：

1. 选择 “发送邮件 ”作

2. 填写三个字段

   • 收件人 - 填写电子邮件地址;

   • 标题 - 编写标题，例如 Hello World

   • 插入自适应卡片，本示例将在卡片中发送 Hello World ，例如

     {
         "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
         "type": "AdaptiveCard",
         "version": "1.0",
         "body": [
             {
                 "type": "TextBlock",
                 "size": "Large",
                 "isSubtle": true,
                 "wrap": true,
                 "text": "Hello World"
             }
         ]
     }
     

3. 运行流，卡片将显示在 Outlook 中

已知问题和限制

如果你的自适应卡片未显示在 Outlook 中，则有一个名为 Actionnable Message Debugger 的 Outlook 插件，可帮助解决问题。

从 可作消息调试器 站点安装。

CardPlatform 支持站点上提供了额外的 支持 。

FAQ

1. 如何发送审批？

   使用 发送审批 作;

2. 如何发送消息，而无需等待答复？

   使用 “发送消息 ”作;

3. 如何设计自适应卡片？

   使用 自适应卡片设计器 创建自适应卡片;

4. 在哪里可以找到自适应卡片的架构和示例？

   可以在以下方面找到架构和示例：

   • adaptivecards.io
   • madewithcards.io

5. 什么是 模板？

   模板允许你设计自适应卡片，然后将数据应用到该自适应卡片，并从自适应卡片的布局中分离数据。

   1. 什么是 公共模板？

      公共模板由社区创建，可供所有人使用。 可以使用 列表公共模板 作列出所有公共模板;

   2. 什么是 专用模板？

      专用模板是你拥有的模板的专用集合，可以存储和重复使用这些模板。

正在创建连接

连接器支持以下身份验证类型：

默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
API 密钥	securestring	CardPlatform 中的 API 密钥	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

列出专用模板	检索所有专用模板的列表。
列出公共模板	检索所有公共模板的列表。
创建专用模板	创建新的专用模板。
删除专用模板	从一组专用模板中删除专用模板。
发送审批	发送审批自适应卡片，并返回已输入选项和字段的响应。
发送消息	以消息的形式发送自适应卡片（无作）。
发送自适应卡片	发送自适应卡片，并返回已输入选项和字段的响应。
更新专用模板	更新专用模板的内容。
查找公共模板	通过分析数据的结构查找公共模板。
获取专用模板	按名称检索专用模板。
获取公共模板	检索公共模板的内容。
转换专用模板	使用数据填充专用模板，并返回完全填充的自适应卡片。
转换公共模板	使用数据填充公共模板，并返回完全填充的自适应卡片。

列出专用模板

操作 ID:

PrivateTemplate_GetAll

检索所有专用模板的列表。

返回

名称	路径	类型	说明
		array of string

列出公共模板

操作 ID:

PublicTemplate_GetAll

检索所有公共模板的列表。

返回

response

object

创建专用模板

操作 ID:

PrivateTemplates_Create

创建新的专用模板。

参数

名称	密钥	必需	类型	说明
模板名称	name	True	string	模板名称
			object

返回

response

object

删除专用模板

操作 ID:

PrivateTemplates_Delete

从一组专用模板中删除专用模板。

参数

名称	密钥	必需	类型	说明
模板名称	name	True	string	模板名称

发送审批

操作 ID:

SendApproval

发送审批自适应卡片，并返回已输入选项和字段的响应。

参数

名称	密钥	必需	类型	说明
收件人	recipients	True	array of string	收件人电子邮件
Heading	heading	True	string	Heading
说明书	instructions	True	string	说明书
行动	actions	True	array of string	作列表
所选类型	choiceType	True	string	所选类型
用于批准的默认选择	approvalChoice	True	string	用于批准的默认选择
拒绝的默认选项	rejectionChoice	True	string	拒绝的默认选项

返回

上一张卡片的响应

响应

ResponseSchema

发送消息

操作 ID:

SendMessage

以消息的形式发送自适应卡片（无作）。

参数

名称	密钥	必需	类型	说明
收件人	recipients	True	array of string	收件人电子邮件地址
Heading	heading	True	string	Heading
自适应卡片	card	True	string	自适应卡片

返回

response

CardResponseSchema

发送自适应卡片

操作 ID:

SendCard

发送自适应卡片，并返回已输入选项和字段的响应。

参数

名称	密钥	必需	类型	说明
收件人	recipients	True	array of string	收件人电子邮件地址
Heading	heading	True	string	Heading
自适应卡片	card	True	string	自适应卡片
ID	id		string	用于标识卡的 ID
卡片名称	cardname		string	卡片名称

返回

上一张卡片的响应

响应

ResponseSchema

更新专用模板

操作 ID:

PrivateTemplates_Update

更新专用模板的内容。

参数

名称	密钥	必需	类型	说明
模板名称	name	True	string	模板名称
			object

查找公共模板

操作 ID:

PublicTemplate_Find

通过分析数据的结构查找公共模板。

参数

名称	密钥	必需	类型	说明
			object

返回

response

object

获取专用模板

操作 ID:

PrivateTemplate_Get

按名称检索专用模板。

参数

名称	密钥	必需	类型	说明
专用模板的名称	name	True	string	专用模板的名称

返回

response

object

获取公共模板

操作 ID:

PublicTemplate_Get

检索公共模板的内容。

参数

名称	密钥	必需	类型	说明
公共模板的路径	path	True	string	公共模板的路径

返回

模板列表

模板列表

TemplateListSchema

转换专用模板

操作 ID:

PrivateTemplate_Transform

使用数据填充专用模板，并返回完全填充的自适应卡片。

参数

名称	密钥	必需	类型	说明
模板名称	name	True	string	模板名称
			object

返回

response

object

转换公共模板

操作 ID:

PublicTemplate_Transform

使用数据填充公共模板，并返回完全填充的自适应卡片。

参数

名称	密钥	必需	类型	说明
公共模板路径	path	True	string	公共模板的路径
			object

返回

response

object

定义

ResponseSchema

上一张卡片的响应

名称	路径	类型	说明
被告	respondent	string
respondentName	respondentName	string
respondentEmail	respondentEmail	string
选择	choice	string
注释	comment	string
responseDate	responseDate	string

TemplateListSchema

模板列表

名称	路径	类型	说明
列表	list	array of object
关键值	list.key	string
templates	list.templates	array of object
文件	list.templates.file	string
fullPath	list.templates.fullPath	string

CardResponseSchema

string

对象

这是类型“object”。