Dela via


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
Email 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:

  1. Choose the Send Message action

    Select the Send Message action

  2. Fill in the three fields

    Select the Send Message action

    • 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"
              }
          ]
      }
      
  3. Run the flow, and the card will appear in Outlook

    Adaptive Card 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

  1. How do I send an approval?

    Use the Send Approval action;

  2. How do I send a message, without waiting for a reply?

    Use the Send Message action;

  3. How do I design my Adaptive Cards?

    Use the Adaptive Card Designer to create your Adaptive Cards;

  4. Where do I find the schema and samples for Adaptive Cards?

    The schema and samples can be found on:

  5. 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.

    1. 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;

    2. 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

Retrieves a list of all public templates.

Returns

response
object

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

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'.