Chatlayer Documentation
Get in touchAbout Chatlayer
  • Welcome
  • What's new
  • Send feedback
  • start quickly
    • Leadzy tutorial
      • 0. Introduction
      • 1. New bot, new block
      • 2. Understand your users
      • 3. Collect and display user input
      • 4. Steer the conversation with Conditions
      • 5. Empower your bot with Actions
      • 6. Set up a channel and publish your bot
    • Templates
      • Banking
      • E-Commerce Returns
      • E-Bike Shop
      • E-Scooter Support
      • Feedback
      • Find Nearest Location
      • GPT
      • 🆕Gym
      • Job applications
      • Knowledge base AI template
      • Lead generation
      • 🆕NPS
      • Restaurant
      • Retail
  • navigation
    • Analytics
      • Dashboard
      • Customers
      • Conversations
      • User flow
      • Intents
      • 🆕Funnels [Beta]
    • Bot builder
      • Flows
        • Canvas functionalities
        • Collaborate with team members
        • Manage your flows
        • 🆕[Beta] Export and import flows
      • Bot dialogs view
      • Translations
      • Events
    • NLP
      • Dashboard
      • Intents
      • Expressions
      • Entities
      • Train
      • NLP settings
      • Improve
    • Knowledge base AI
      • Add content to your KBAI
      • Build your KBAI flow
      • Use your KBAI source URL in a button
      • Use tags to limit your KBAI content
      • 🆕Use Tables to store your KBAI questions
      • 🆕Manage handover where KBAI is unsatisfactory
    • History
      • Conversations
      • Execution logs
      • Versions
    • Channels
    • Tables
      • Create a table with records
      • Column types
      • Operate on your records
        • Insert record
        • Update record
        • Retrieve record
        • Delete record
      • API
    • Settings
      • Bot settings
      • Offloading
      • Variables
      • Voice
      • Import/Export
  • build your bot
    • Conversation design
      • Plan your bot
      • Conversation design workflow
    • Flow logic
      • Blocks
        • Message
        • Condition
        • Collect input
        • Action
      • Go-to connections
    • 🆕Emulator
    • Tips & best practices
      • Route your flow depending on the time
      • Improve the Not understood block
        • How to create better not understood messages
        • Not understood counter
        • Not understood Google search
      • Go to previous block
      • Recognizing a returning user
      • Skip introduction message
      • Route your flow depending on the channel
      • Reuse flows
      • Connect two bots to each other
  • understand users
    • Natural language processing (NLP)
      • Basic NLP concepts
      • Detect information with entities
        • Match entities
        • Contextual entities
        • System entities
        • Composite entities
      • NLP best practices
        • Word order and diversity of expressions
      • AI intent booster
      • Train your NLP
      • Context
      • NLP import & export
      • Sentiment analysis
    • Languages
      • Supported languages
      • Make your bot multilingual
      • Change language within the conversation
  • set up channels
    • Add a channel to your bot
    • All channels
      • 🚨Facebook Messenger [Deprecated soon]
        • Facebook Admin Removal
        • Facebook Webview Whitelisting
        • Facebook Messenger API updates for Europe
      • 🚨Google Assistant [Deprecated soon]
      • Webhook
      • Web
        • 🚨Web V1 [Deprecated]
          • Customize web widget
          • Live example web widget
        • 🆕Web V2
          • 🆕From Web V1 to V2
          • 🆕Web V2 methods and options
    • Sinch Conversation API
      • Configure your Sinch Conversation API
      • 🆕 Make the most of RCS with Carousels
      • WhatsApp Business API
  • integrate & code
    • API calls
      • Configure your API integration
      • Advanced API features
      • V1 API Reference
      • Custom integrations 101
    • Code editor
      • [Example] Sending data to Airtable (POST)
      • [Example] Retrieving data from Airtable (GET)
      • [Example] Making SOAP requests
    • App integrations
      • Airtable
      • Freshdesk
      • Freshdesk Messaging
      • 🆕Gmail
      • Intercom
      • Mailgun
      • OpenAI: GPT-3, ChatGPT and GPT-4
      • Salesforce
      • 🆕Slack
      • Topdesk
      • Zendesk Support
      • Zendesk Sunshine (beta)
    • 🆕Expression syntax
    • Human handover & live chat
      • Sinch Contact Pro
      • #Interact
      • Genesys Cloud
      • Offloading Webhook
      • Salesforce Service Cloud
      • Sparkcentral by Hootsuite
      • Zendesk Chat
    • Chatlayer messages specifications
  • Publish
    • Publish your bot
      • Publish a flow
  • Analyze & maintain
    • Analytics definitions
    • Data retention
    • Maintenance
    • Session
    • Track events for analytics
  • VOICE
    • 🆕Send bot response as audio
    • Voicebots
      • Create a voicebot
      • Voicebot-specific actions
      • Test your voicebot
      • From chat to voice
  • access & support
    • Identity & Access
      • Single Sign-On (SAML SSO)
    • Billing & subscription
    • Get in touch
    • Chatlayer glossary
    • SaaS Regions & IP Ranges
    • Status
    • Debug your bot
      • No correct response
      • Collect input not working
      • Video isn't working
Powered by GitBook
On this page
  • Character limits
  • Message steps
  • Text message
  • Buttons
  • Media
  • Quick replies
  • Carousel
  • List
  • File upload
  • Rich text

Was this helpful?

  1. build your bot
  2. Flow logic
  3. Blocks

Message

The Message block displays text in basic form or with special components like buttons or carousels.

PreviousBlocksNextCondition

Last updated 1 month ago

Was this helpful?

Add a Message block by to your flow.

Character limits

Chatlayer indicates how many characters are still allowed on the bottom-right corner of any text field.

For all other channels, the character limit is based on best practices. We recommend using less characters than the limit, but it's not mandatory.

Message steps

Text message

Text messages are the most simple components. Most channels will show them as speech bubbles.

Buttons

Button types

There are 4 different types of buttons:

  • Go to: When this button is clicked, the conversation goes to a new block. Optionally, you can add key-value combinations to a button. These will set variables depending on which button the user has clicked. These variables can then later be used to route blocks, do an API call or render specific text.

  • URL: you can link a button to an external URL.

  • Call: this button will initiate a call if the user is using a mobile device.

  • Webview: this button will open a webview (or a new browser window depending on the channel) with the configured URL as target. The parameters you configure for this button will be JSON stringified and appended to the URL as a Base64 encoded string. It is possible to decode this string using the atob JavaScript function.

Media

With the Media step, you can enable the bot to send files to your users.

Media types
  • Images: all typical image types, such as jpg, png and gif are supported on our platform.

    • mp4

    • ogv

    • webm

Ensure that you remove space from media files that are uploaded, this could cause it not to be displayed correctly.

We recommend media files shared on Facebook Messenger to be below 5 MB in size, as Facebook seems to have trouble in handling files larges with acceptable performance.

Quick replies

Quick replies behave similarly to buttons. They are shown horizontally next to each other in a scrollable container. This means that you can add as many quick replies as you think necessary.

Quick replies settings
  • Icon: optionally, you can add an icon to a quick reply by specifying its URL.

Carousel

Carousels are a way to visualize options, with or without images and buttons.

Share button

The share button opens a sharing block in Facebook Messenger, enabling people to share message bubbles (aka carousel cards) with their friends.

When a new user receives a message bubble, he can share it with his friends by tapping the same share button. When tapping the postback button, the user is send to the start page of the bot.

You can only use share button in generic templates items (previously called carousels) and only items with maximum one url can be shared by Facebook. It is not possible to change the button title: Facebook Messenger will translate the button to the user's preferred language profile setting.

List

The List step is a step that allows you to present a list of items, shown vertically.

Each item may shown a button that can be used as a call-to-action (postback). You can also provide a URL that opens when an item is tapped.

Each list template message can also have up to one global button that will show below the item list.

List styles

Lists can be shown in 2 different syles:

  • Large lists show the first item with a cover image and text overlay. This is useful if you want to make the first item stand out over the other items.

  • Compact lists show each item in the same way. This is useful for presenting a list of items where no item is shown more prominently.

File upload

Use the file upload template to let users upload a file directly from their device to your bot.

Configuring the File Upload as shown above will show an Upload button in the conversation:

Notes on File upload
  • If the upload failed because there was a problem with the connection, or the file the user chose was bigger than 10 MB, the bot will go to the "failed upload" block.

  • Uploaded files are kept on Chatlayer servers for 30 days, after which they will automatically become unaccessible.

Rich text

Rich text allows you to go beyond text messages and style your text the way you want it. You can also add web links using the rich text editor.

Rich text styles

The rich text editor allows you to use the following styles:

  • Paragraph

  • Heading 1

  • Heading 2

  • Heading 3

  • Heading 4

  • Bulleted list

  • Ordered list (= numbered list)

And format the text in the following ways:

  • Bold

  • Italic

  • Underline

You can also add hyperlinks (weblinks) that either go to an external page or to a specific place in your conversation.

To hyperlink a word or sentence, select it and then click the chain icon on the right below. A popup will appear where you can put in the link address. Then click 'save'.

The only exception is for , which show the number of characters that you already enter and not the character limit.

Please note that for Facebook Messenger, limits are strict to 20 characters for a label. If your button label is bigger, it will be cut off and displayed with three dots. Learn more about our .

Buttons are a useful way to guide the conversation by giving the user a limited set of options. You can add a maximum of three buttons to a message, with different .

Video: videos are available in the , and Facebook channel. Check to add videos to your bot. The following video formats are supported:

Audio: the audio media is available in the , the channel and . Currently we only support MP3 as an audio format.

Files: file attachments are available in . Currently, only PDF is supported. If you upload the file directly in the platform, there is a file size limit of 10 MB. If you use a direct URL to the file, there is no file size limit.

Are you having trouble adding an external video to your bot? Check out article.

Go to: for each Quick reply, you need to define a next block to visit in the flow. In other words, you'll create a .

Variables: optionally, can be set depending on which button the user has clicked. These variables can then later be used to route blocks, make an API call or render specific text.

Note that Quick replies only link to another block. To link your button to anything else, use .

Buttons in Carousels are the same as regular and use the same properties like payloads and URL, with the addition of an extra share button.

You're using Carousels for your RCS channel? See how you can .

This template only works on the web widget V1 channel. For any other channel, you can use the 'image' format type in the block.

The URL where the uploaded file is stored can be found under the {uploadedFileUrl} variable in the . You can reuse this variable to show the file that the user uploaded by using the step. Alternatively, you can retrieve the URL with an to store the files on your servers.

Rich text is only visible in the channel. The other channels do not support this type of text.

Emulator
W
eb
this article
Emulator
Web
Facebook Messenger
Facebook Messenger
this
Go-to connection
variables
make the most of them
Collect input
Web
Carousels
channels limitations
button
button types
Buttons
Buttons
user's session
API plugin
Media
dragging and dropping it
The Message block.
Write Message block by respecting the character limits indicaetd.
Text message step.
Buttons step.
Media step.
Carousel step.
File upload Message step.
Rich text Message step.
Button types on Chatlayer