Botframework-sdk: Missing Doc - What cards are supported on each channel?

Created on 19 Sep 2019  Β·  9Comments  Β·  Source: microsoft/botframework-sdk

Version

All

Describe the bug

We have a great doc for activity support across channels - https://docs.microsoft.com/en-us/azure/bot-service/bot-service-channels-reference?view=azure-bot-service-4.0

We do not have a doc describing which cards are supported on which channel. Either append current doc or create a new one.

[bug]

R8

Most helpful comment

@Kaiqb

Card Support by Channel

| Channel | Adaptive Card | Animation Card | Audio Card | Hero Card | Receipt Card | Signin Card | Thumbnail Card | Video Card |
|:-------:|:-------------:|:--------------:|:----------:|:---------:|:------------:|:-----------:|:--------------:|:----------:|
|Cortana|βœ”|❌|❌|❌|βœ”|βœ”|βœ”|❌|
|Email|πŸ”Ά|🌐|🌐|βœ”|βœ”|βœ”|βœ”|🌐|
|Facebook|βš πŸ”Ά|βœ”|❌|βœ”|βœ”|βœ”|βœ”|❌|
|GroupMe|πŸ”Ά|🌐|🌐|🌐|🌐|🌐|🌐|🌐|
|Kik|πŸ”Ά|βœ”|βœ”|❌|🌐|❌|βœ”|🌐|
|Line|βš πŸ”Ά|βœ”|🌐|βœ”|βœ”|βœ”|βœ”|🌐|
|Microsoft Teams|βœ”|❌|❌|βœ”|βœ”|βœ”|βœ”|❌|
|Skype|❌|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|
|Slack|πŸ”Ά|βœ”|🌐|🌐|βœ”|βœ”|🌐|🌐|
|Telegram|βš πŸ”Ά|βœ”|🌐|βœ”|βœ”|βœ”|βœ”|βœ”|
|Twilio|πŸ”Ά|βœ”|❌|βœ”|βœ”|🌐|βœ”|❌|
|Web Chat|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|

Note: The Direct Line channel technically supports all cards, but it's up to the client to implement them

  • βœ”: Full Support
  • ⚠: Partial Support - Card May Not Send if it Contains Inputs/Buttons. Varies by Channel.
  • ❌: No Support
  • πŸ”Ά: Card is Converted to Image
  • 🌐: Card is Converted to Unformatted Text With Links and/or Images and/or Media Does Not Play in Client

All 9 comments

The channel inspector was a great tool:

https://web.archive.org/web/20170710051848/https://docs.botframework.com/en-us/channel-inspector/channels/Skype/

@yochay - we are going to start the investigation in R7, and will wrap up the work in R8.

@Kaiqb

Card Support by Channel

| Channel | Adaptive Card | Animation Card | Audio Card | Hero Card | Receipt Card | Signin Card | Thumbnail Card | Video Card |
|:-------:|:-------------:|:--------------:|:----------:|:---------:|:------------:|:-----------:|:--------------:|:----------:|
|Cortana|βœ”|❌|❌|❌|βœ”|βœ”|βœ”|❌|
|Email|πŸ”Ά|🌐|🌐|βœ”|βœ”|βœ”|βœ”|🌐|
|Facebook|βš πŸ”Ά|βœ”|❌|βœ”|βœ”|βœ”|βœ”|❌|
|GroupMe|πŸ”Ά|🌐|🌐|🌐|🌐|🌐|🌐|🌐|
|Kik|πŸ”Ά|βœ”|βœ”|❌|🌐|❌|βœ”|🌐|
|Line|βš πŸ”Ά|βœ”|🌐|βœ”|βœ”|βœ”|βœ”|🌐|
|Microsoft Teams|βœ”|❌|❌|βœ”|βœ”|βœ”|βœ”|❌|
|Skype|❌|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|
|Slack|πŸ”Ά|βœ”|🌐|🌐|βœ”|βœ”|🌐|🌐|
|Telegram|βš πŸ”Ά|βœ”|🌐|βœ”|βœ”|βœ”|βœ”|βœ”|
|Twilio|πŸ”Ά|βœ”|❌|βœ”|βœ”|🌐|βœ”|❌|
|Web Chat|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|βœ”|

Note: The Direct Line channel technically supports all cards, but it's up to the client to implement them

  • βœ”: Full Support
  • ⚠: Partial Support - Card May Not Send if it Contains Inputs/Buttons. Varies by Channel.
  • ❌: No Support
  • πŸ”Ά: Card is Converted to Image
  • 🌐: Card is Converted to Unformatted Text With Links and/or Images and/or Media Does Not Play in Client

Looks great!

@mdrichardson LINE channel does support herocard, audiocard and also can convert adaptercard to image. Have you encountered any issues?
image
image
image

@youyu16 I get an InternalServiceError when sending a fairly simple adaptive card with input (below) in both the mobile and desktop apps. I'll mark it as partially supported. Edit: After more testing, it seems some channels (Line, included) won't render cards as images if they contain either input boxes and/or buttons.

I only don't mark the audio card as fully supported because it won't play in-app, so it works more like a link. I'll adjust the description.

Good call on the Hero card, however. My mistake.


{
    "type": "AdaptiveCard",
    "body": [
        {
            "type": "TextBlock",
            "text": "Text Input - id: textInput"
        },
        {
            "type": "Input.Text",
            "placeholder": "Enter some text",
            "id": "textInput"
        },
        {
            "type": "TextBlock",
            "text": "Number Input - id: numberInput"
        },
        {
            "type": "Input.Number",
            "placeholder": "Enter a number",
            "id": "numberInput"
        }
    ],
    "actions": [
        {
            "type": "Action.Submit",
            "title": "Submit"
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.0"
}

Merged the changes into master branch. Live site should have the update in an hour.

@mdrichardson For LINE submit action is partially supported. it is because if card converted to an image, input can't be use, exception throw because get null data when convert submit action to the real channel message. Set a default data should fix the issue.

"actions": [
    {
      "type": "Action.Submit",
      "title": "Submit",
      "data": {
        "text": β€œsubmited text”
      }
    }
  ],

Is the video card still supported on Skype ? the video card works well on webchat but not on Skype. It gives me the service unavailable status but just on Skype

Was this page helpful?
0 / 5 - 0 ratings