CardPlatform 最適化卡片 (預覽版)
CardPlatform 可讓您將調適型卡片傳送給使用者。 可用於動作內容,例如核准、表單擷取和一般訊息傳遞。 它支援範本化和自訂卡片。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | CardPlatform 支援 |
| URL | https://cardplatform.app/support |
| support@cardplatform.app |
| 連接器中繼資料 | |
|---|---|
| Publisher | 卡片平台 |
| 網站 | https://cardplatform.app/ |
| 隱私策略 | https://cardplatform.app/privacy/ |
| 類別 | 通敵;傳達 |
CardPlatform 可讓您將調適型卡片和可操作的內容直接傳送給使用者。
Pre-requisites
要使用 CardPlatform,您需要:
- 建立 CardPlatform 訂閱,以開始選取 方案;
- 有一個免費試用訂閱,可供試用和試驗。
如何取得認證
註冊完成後,您將在電子郵件中收到您的 API 金鑰。
獲得 API 金鑰後,建立新的連接,輸入 API 金鑰,然後開始發送卡片。
開始使用連接器
若要開始使用,請先傳送訊息:
選擇 [傳送訊息] 動作
填寫三個欄位
收件人 - 填寫您的電子郵件地址;
標題 - 寫一個標題,例如 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" } ] }
執行流程,卡片將出現在 Outlook 中
已知問題與限制
如果您的調適型卡片未顯示在 Outlook 中,則有一個名為 Actionnable Message Debugger 的 Outlook 外掛程式,可協助解決問題。
從 可採取動作的訊息偵錯工具 網站安裝。
CardPlatform 支援 網站上提供額外支援。
FAQ
如何傳送核准?
使用 「傳送核准」 動作;
如何在不等待回覆的情況下發送訊息?
使用 「傳送訊息」 動作;
如何設計最適化卡片?
使用 最適化卡片設計工具 來建立最適化卡片;
哪裡可以找到最適化卡片的架構和範例?
結構描述和範例可在以下位置找到:
什麼是 模板?
範本可讓您設計最適化卡片,然後將資料套用至該卡片,將 資料 與最適化卡片的 版面配置 分開。
什麼是 公共模板?
公開範本是由社群建立,可供所有人使用。 可以使用 列出公用範本 動作來列出所有公用範本;
什麼是 私人範本?
私人範本是您擁有的範本私人集合,可以儲存和重複使用。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 來自 CardPlatform 的 API 金鑰 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 傳送最適化卡片 |
傳送最適化卡片,並傳回包含輸入選項和欄位的回應。 |
| 傳送核准 |
傳送核准最適化卡片,並傳回包含輸入選項和欄位的回應。 |
| 傳送訊息 |
將調適型卡片傳送為訊息 (無動作)。 |
| 列出公用範本 |
擷取所有公用範本的清單。 |
| 列出私人範本 |
擷取所有私人範本的清單。 |
| 刪除私人範本 |
從專用範本集中移除專用範本。 |
| 取得公開範本 |
擷取公用範本的內容。 |
| 取得私人範本 |
依名稱擷取私人範本。 |
| 尋找公開範本 |
透過分析資料的結構來尋找公用範本。 |
| 建立私人範本 |
建立新的私人範本。 |
| 更新私人範本 |
更新私人範本的內容。 |
| 轉換公用範本 |
使用資料填入公用範本,並傳回完全填入的最適化卡片。 |
| 轉換私人範本 |
使用資料填入私人範本,並傳回完全填入的調適型卡片。 |
傳送最適化卡片
傳送最適化卡片,並傳回包含輸入選項和欄位的回應。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
收件者
|
recipients | True | array of string |
收件者電子郵件地址 |
|
Heading
|
heading | True | string |
Heading |
|
最適化卡片
|
card | True | string |
最適化卡片 |
|
ID
|
id | string |
識別卡片的身分證件 |
|
|
卡片名稱
|
cardname | string |
卡片名稱 |
傳回
上一張卡片的回應
傳送核准
傳送核准最適化卡片,並傳回包含輸入選項和欄位的回應。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
收件者
|
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 |
拒絕的預設選擇 |
傳回
上一張卡片的回應
傳送訊息
將調適型卡片傳送為訊息 (無動作)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
收件者
|
recipients | True | array of string |
收件者電子郵件地址 |
|
Heading
|
heading | True | string |
Heading |
|
最適化卡片
|
card | True | string |
最適化卡片 |
傳回
- response
- CardResponseSchema
列出公用範本
列出私人範本
擷取所有私人範本的清單。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of string |
刪除私人範本
從專用範本集中移除專用範本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
範本名稱
|
name | True | string |
範本名稱 |
取得公開範本
擷取公用範本的內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
公共模板的路徑
|
path | True | string |
公共模板的路徑 |
傳回
範本清單
- 範本清單
- TemplateListSchema
取得私人範本
尋找公開範本
建立私人範本
更新私人範本
更新私人範本的內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
範本名稱
|
name | True | string |
範本名稱 |
|
|
object |
轉換公用範本
使用資料填入公用範本,並傳回完全填入的最適化卡片。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
公用範本路徑
|
path | True | string |
公共模板的路徑 |
|
|
object |
傳回
- response
- object
轉換私人範本
使用資料填入私人範本,並傳回完全填入的調適型卡片。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
範本名稱
|
name | True | string |
範本名稱 |
|
|
object |
傳回
- response
- object
定義
回應架構
上一張卡片的回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
答辯人
|
respondent | string | |
|
回應者名稱
|
respondentName | string | |
|
受訪者電子郵件
|
respondentEmail | string | |
|
choice
|
choice | string | |
|
留言
|
comment | string | |
|
回應日期
|
responseDate | string |
TemplateListSchema
範本清單
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
list
|
list | array of object | |
|
Key
|
list.key | string | |
|
templates
|
list.templates | array of object | |
|
檔案
|
list.templates.file | string | |
|
完整路徑
|
list.templates.fullPath | string |
CardResponseSchema
物件
這是類型 'object'。