SnatchBot Support

Welcome to the SnatchBot Support. You'll find comprehensive guides and documentation to help you start working with SnatchBot as quickly as possible, as well as support if you get stuck. Let's jump right in!

The community forum is not a helpdesk
Let’s put this in the front - the vast majority of people here do not work for SnatchBot.

Get Started    SNATCHBOT API

Adding Rich Cards

Adding Rich Card (Button) attachments to messages.



Rich Cards are not available on SMS.

Rich cards are a neat way of embedding images, gifs, videos and calls to action. Not only does using cards make the conversation look more user-friendly, they have several very useful features.

To create a rich card, select the relevant interaction and in the Cards bar, click on either Text card or Gallery.

Either type of Rich Card will have the same features, the difference is simply a matter of presentation. Choose Text if you want the card to feature text only above the button or choose Gallery if you want an image or the option of scrolling through several images, each with a button.


Some tips

  • You can delay sending a card by up to 100 seconds.
  • You cannot create a new card if there is an empty or half-filled card in the interaction.
  • You cannot add cards to the JSON interaction, but JSON messages can contain the cards.

Let’s suppose you choose Text Card.

Type a line of text, e.g. ‘Special Offers’. This text will appear directly above the button in the conversation. You may set a delay if you want the card to appear after a pause in the conversation.

You’ll see that the following features are available for your card: Interactions; URL; Phone call; Payment; Share; Email:

1. Interactions button.

This button redirects a user to another interaction. You have to enter a button name and choose an interaction. Give your button a short name e.g. ‘Tap for offers’. Then set the action that will occur upon clicking the button.

After selecting Blocks, you will be able to choose from a drop-down menu of all your existing interactions and the user will jump to that interaction upon pressing the button.


A new connection won’t be created in the Connections tab, when you add an “Interactions” button.

2. URL button.

After selecting URL you can then past any URL into the box and upon pressing the button the user will open that URL in another window.


The URL must begin with “https://”.

You can control the display height of the in-app browser window, enabling you to create experiences that look and feel like part of a Facebook Messenger conversation.

40%, 70%, 100%:

3. Phone call button.

The button is used to initiate phone calls. A “Button name” and “Phone” fields are required. After selecting Phone call and adding a number you will obtain a drop-down menu with the international codes of every country. Choose the relevant one. On pressing this button the bot will open the user’s associated app for phone calls and dial your number.


A phone number must not contain spaces for use in Slack.

4. Payment button.

The button opens PayPal’s checkout dialog and allows people to share their credentials with businesses to make purchases. This button can be used with a Text Card and Gallery Card.

To use this feature, you must fill out billing information in the Profile -> Payment system tab.
Also, you have to fill the 7 fields in the card:

  • Button name
  • Product name
  • Price
  • Successful payment - an interaction to show if the payment was processed successfully.
  • Error - an interaction to show if the payment failed.
  • Size in Facebook Messenger (100% 70% 40%)

Making payment. When users click the “Pay” button, they will be redirected to the PayPal system (it will ask the user to log in), where they can confirm the payment. After clicking the Continue button, you will see that the payment has been successfully accepted.

Web version:

Mobile version:

5. Email button.

After selecting Email and giving the button a name and adding in an email, this will create a button that opens the user’s email app with your email prepopulated (not available on Facebook Messenger).

These buttons, with their five types of possible actions, are extremely useful features for those who want the conversation to lead to an action by the user.

Watch this video tutorial "How to add a Rich card"

Updated about a month ago

Next Steps

The RSS plugin allows you to show content from RSS feeds in your bot as a Card Gallery.

RSS Feed Plugin

Adding Rich Cards

Adding Rich Card (Button) attachments to messages.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.