Show Card

Send information cards to a web client chat stream

Written By Support Channel

Last updated 8 months ago

Overview of the Show Card action

The Show Card action allows you to display an Adaptive Card directly to a specific user within a web chat.

Purpose

Shows an Adaptive Card based on Card template and data provided

Parameters

1 Web Chat Instance
1 User Email
1 Card Template
Card Data Values

Outputs

Adaptive Card

Understand the Show Card action

To successfully use the Show Card action, several settings must be configured. These settings determine who will receive the card, which card will be displayed, and how its content will be populated.

Parameters

Web Chat Instance - Select the Web chat instance where the card will be sent

User Email - Enter the email address of the user who should receive the card. This must be a valid user within the selected chat instance.

Card Template - Choose the Adaptive Card template to be used. See Card Editor for information on card templates.

Card Data - Provide the data needed to populate dynamic elements of the card. These values map to the placeholders or data fields defined in your chosen card template. For example:

  • Title: "Approval #1234"

  • Status: "Pending"

Outputs

None

Working with the Show Card action

Note

Using the Show Card action with a card that has inputs/buttons will halt the workflow until the card is complete.

A Show Card action can be used as a reference in other actions, like the Update Card action, once it has been introduced and set up in your workflow.

Create and manage Show Card actions

Add a Show Card action

Add the action

Use the following steps to add the action to a workflow.

Configure the action

Use the following steps to configure the action.

  1. Set values for the fields: Web Chat Instance; User Email; Card Template

  2. Set Card Data values for fields generated from the card template, if present. Required fields must have values entered.

  3. Click back in the main view to hide the slide-over.

Delete a Show Card action

Use the following steps to remove the action from your workflow:

Take care when deleting an action to also remove any logic using its outputs: workflow steps may function incorrectly or break if they attempt to evaluate an output of a deleted action.

When a Show Card action is removed, any Update Card actions that reference it in their Card To Update field will lose that connection. As a result, the Card To Update field in those Update Card actions will be automatically cleared, since the referenced Show Card no longer exist.