CardPlatform Adaptive Cards (Preview)
CardPlatform allows you to send Adaptive Cards to users. Can be used for actional content, such as approvals, forms capture, and general messaging. It supports templating and custom cards.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
Contact | |
---|---|
Name | CardPlatform Support |
URL | https://cardplatform.app/support |
support@cardplatform.app |
Connector Metadata | |
---|---|
Publisher | CardPlatform |
Website | https://cardplatform.app/ |
Privacy policy | https://cardplatform.app/privacy/ |
Categories | Collaboration;Communication |
CardPlatform allows you to send Adaptive Cards and actionable content directly to your users.
Pre-requisites
To use CardPlatform, you will need to:
- Create a CardPlatform subscription, to start select the plan;
- There is a free trial subscriptions which is available to trial and experiment with.
How to get credentials
After signup has completed, you will receive your API Key in an email.
Once you have the API Key, create a new Connection, enter the API Key, and start sending cards.
Getting started with your connector
To get started, first send a message:
Choose the Send Message action
Fill in the three fields
Recipients - fill in your email address;
Heading - Write a heading, e.g. Hello World
Insert the adaptive card, this example will send Hello World in the card, e.g.
{ "$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" } ] }
Run the flow, and the card will appear in Outlook
Known issues and limitations
If your adaptive cards are not being shown in Outlook, there is an Outlook plugin called Actionnable Message Debugger that can assist in resolving the issue.
Install from Actionable Message Debugger site.
Extra support is available on the CardPlatform Support site.
FAQ
How do I send an approval?
Use the Send Approval action;
How do I send a message, without waiting for a reply?
Use the Send Message action;
How do I design my Adaptive Cards?
Use the Adaptive Card Designer to create your Adaptive Cards;
Where do I find the schema and samples for Adaptive Cards?
The schema and samples can be found on:
What are templates?
A template allows you to design the Adaptive Card, and then apply the data to it, seperating data from the layout of the Adaptive Card.
What are public templates?
Public templates are created by the community and available for all to use. All the public templates can be listed by using the List public templates action;
What are private templates?
Private templates are you own private collection of templates, that can be stored and reused.
Creating a connection
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Name | Type | Description | Required |
---|---|---|---|
API Key | securestring | API Key from CardPlatform | True |
Throttling Limits
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Actions
Create a private template |
Create a new private template. |
Delete private template |
Removes a private template from the set of private templates. |
Find a public template |
Find a public template by analyzing the structure of your data. |
Get a private template |
Retrieves a private template by name. |
Get a public template |
Retrieves the contents of a public template. |
List private templates |
Retrieves a list of all private templates. |
List public templates |
Retrieves a list of all public templates. |
Send Adaptive Card |
Sends an Adaptive Card, and returns the response with the choice and fields entered. |
Send Approval |
Sends an Approval Adaptive Card, and returns the response with the choice and fields entered. |
Send Message |
Sends an Adaptive Card as a message (no actions). |
Transform private template |
Populates a private template with the data and returnes a fully populated Adaptive Card. |
Transform public template |
Populates a public template with the data and returnes a fully populated Adaptive Card. |
Update a private template |
Updates the contents of a private template. |
Create a private template
Create a new private template.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Template Name
|
name | True | string |
Template Name |
|
object |
Returns
- response
- object
Delete private template
Removes a private template from the set of private templates.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Template Name
|
name | True | string |
Template Name |
Find a public template
Find a public template by analyzing the structure of your data.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
|
object |
Returns
- response
- object
Get a private template
Retrieves a private template by name.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Name of private template
|
name | True | string |
Name of private template |
Returns
- response
- object
Get a public template
Retrieves the contents of a public template.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Path of public template
|
path | True | string |
Path of public template |
Returns
Templates List
- Templates List
- TemplateListSchema
List private templates
Retrieves a list of all private templates.
Returns
Name | Path | Type | Description |
---|---|---|---|
|
array of string |
List public templates
Send Adaptive Card
Sends an Adaptive Card, and returns the response with the choice and fields entered.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Recipients
|
recipients | True | array of string |
Recipients email address |
Heading
|
heading | True | string |
Heading |
Adaptive Card
|
card | True | string |
Adaptive Card |
ID
|
id | string |
ID to identify the card |
|
Name of Card
|
cardname | string |
Name of Card |
Returns
Response from previous card
- Response
- ResponseSchema
Send Approval
Sends an Approval Adaptive Card, and returns the response with the choice and fields entered.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Recipients
|
recipients | True | array of string |
Recipients email |
Heading
|
heading | True | string |
Heading |
Instructions
|
instructions | True | string |
Instructions |
Actions
|
actions | True | array of string |
List of Actions |
Type of choice
|
choiceType | True | string |
Type of choice |
Default Choice for approve
|
approvalChoice | True | string |
Default Choice for approve |
Default Choice for reject
|
rejectionChoice | True | string |
Default Choice for reject |
Returns
Response from previous card
- Response
- ResponseSchema
Send Message
Sends an Adaptive Card as a message (no actions).
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Recipients
|
recipients | True | array of string |
Recipients email address |
Heading
|
heading | True | string |
Heading |
Adaptive Card
|
card | True | string |
Adaptive Card |
Returns
- response
- CardResponseSchema
Transform private template
Populates a private template with the data and returnes a fully populated Adaptive Card.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Template Name
|
name | True | string |
Template Name |
|
object |
Returns
- response
- object
Transform public template
Populates a public template with the data and returnes a fully populated Adaptive Card.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Public Template Path
|
path | True | string |
Path of public template |
|
object |
Returns
- response
- object
Update a private template
Updates the contents of a private template.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Template Name
|
name | True | string |
Template Name |
|
object |
Definitions
ResponseSchema
Response from previous card
Name | Path | Type | Description |
---|---|---|---|
respondent
|
respondent | string | |
respondentName
|
respondentName | string | |
respondentEmail
|
respondentEmail | string | |
choice
|
choice | string | |
comment
|
comment | string | |
responseDate
|
responseDate | string |
TemplateListSchema
Templates List
Name | Path | Type | Description |
---|---|---|---|
list
|
list | array of object | |
key
|
list.key | string | |
templates
|
list.templates | array of object | |
file
|
list.templates.file | string | |
fullPath
|
list.templates.fullPath | string |
CardResponseSchema
object
This is the type 'object'.