Skip to content

06.using-cards

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

06.using-cards

README.md

This sample shows how to create a bot that uses Rich Cards. This bot example uses restify and dotenv.

To try this sample

  • Clone the repository 
    git clone https://github.com/microsoft/botbuilder-samples.git
  • In a terminal, 
    cd samples/javascript_nodejs/06.using-cards
  • [Optional] Update the .env file under samples/javascript_nodejs/06.using-cards with your botFileSecret For Azure Bot Service bots, you can find the botFileSecret under application settings.
  • Install modules and start the bot 
    npm i && npm start
    Alternatively you can also use nodemon via 
    npm i && npm run watch

Testing the bot using Bot Framework Emulator

Microsoft Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel.

  • Install the Bot Framework Emulator from here

Connect to bot using Bot Framework Emulator V4

  • Launch Bot Framework Emulator
  • File -> Open Bot Configuration and navigate to samples/javascript_nodejs/06.using-cards folder
  • Select using-cards.bot file

Rich Cards

A key to good bot design is to send interactive media, such as Rich Cards. There are several different types of Rich Cards, which are as follows:

  • Animation Card
  • Audio Card
  • Hero Card
  • Receipt Card
  • Sign In Card
  • Thumbnail Card
  • Video Card

When designing the user experience developers should consider adding visual elements such as Rich Cards.

Deploy this bot to Azure

You can use the MSBot Bot Builder CLI tool to clone and configure any services this sample depends on. In order to install this and other tools, you can read Installing CLI Tools.

To clone this bot, run

msbot clone services -f deploymentScripts/msbotClone -n <BOT-NAME> -l <Azure-location> --subscriptionId <Azure-subscription-id> --appId <YOUR APP ID> --appSecret <YOUR APP SECRET PASSWORD>

NOTE: You can obtain your appId and appSecret at the Microsoft's Application Registration Portal

Further reading