User Guide

Message Components

There are multiple different components that can be sent in KiboPush:



The text component allows you to send simple text messages. You can optionally add a button that can either redirect to a website or subscribe to a particular sequence. You also have the option of referring to the user’s name by clicking on the user icon on the bottom right corner.


Many components such as text can include one or more buttons. Each button can have one or more actions:

  • Open website action will open the given url in a separate window.
  • Open webview will open the given url in a webview within messenger.
  • Reply with a message allows you to send a new message. This message can be edited once the component is saved. It will be added to the message tabs and will have the title of the button by default:
  • Subscribe to sequence will subscribe the user to the selected sequence:
  • Unsubscribe from sequence will unsubscribe the user from any sequence:
  • Set custom field will assign a value to a custom field:
  • Google Sheets can allow you to save subscriber data to a google sheet
  • Hubspot can allow you to upload data to a Hubspot form or create a new contact.


This card component is for components that have an image, a title to accompany that image, and a subtitle to accompany the title, as well as a button that can redirect to any url. This is an ideal component for products/items.

A card must have an image, title, subtitle, and at least one button. Up to 3 buttons can be added. An optional action can be added. An action is triggered when a card is clicked. This can allow you to open a web page on a card click.

The image must be in the aspect ratio (ratio of width to height) of 1.91:1, otherwise the image may be cropped or scaled. Max size of the image can be 10 Mb.


Gallery can be accessed by clicking on the card component and adding more than one card. This component is essentially a collection of cards. Each card has the requirements of the card component. You can have a maximum of 10 cards, and they will be sent in the form of a carousel. You can navigate to a particular card by clicking on either the right or left arrows to the card preview.


The audio component is for uploading audio files that can be directly played inside Messenger. Max size of the audio file can be 10 Mb.


The file component allows you upload document files such as pdf, docx, xlsx, etc. The user then has an option to download the file within Messenger. Max size of the file can be 10 Mb.


This component allows you to upload an image or a video with up to 3 buttons. Max size of the image or video can be 25 Mb.

Video Link:

This is essentially a Media component, however instead of uploading a video from your local files, you can enter a public YouTube or Facebook video link.  For YouTube videos, it will download the video from that link and send it as a media component. Max size of the YouTube video can be 25 mb; if it’s greater than 25 Mb, it will be sent as a card.

There is no size limit for Facebook videos. Facebook links must be public video links, not post links (e.g.

Link Carousel:

This is essentially a Gallery/Card component, however instead of manually entering the individual fields such as title, subtitle, etc., you can enter any public webpage url and it will fetch the metadata from that page and accordingly populate card details based on the title, description, and default image of that page. The button will cause the link to open up.

User Input:

The User Input component is a way for the user to ask subscribers a question and have them answer it by typing something out. That answer can then be stored into a custom field, google sheet, or be used to create a hubspot contact.

You can add multiple questions by clicking on +Add Question.

Each question requires a reply type. This is used to validate the subscriber’s response. For example, if you’re asking for the subscriber’s email, you can use the email reply type to filter out any responses that aren’t an email. The following reply types are present:

With every reply type except for text, you can specify how many incorrect tries (by default, this is 3) the subscriber is allowed. You can also specify what message will be displayed if the user gives an incorrect response (this is set by default based on the reply type). The user also has a quick reply option to skip the question; by default that option says ‘Skip’, but can be modified to be anything else.

In order to save subscribers’ responses, you have to add an action. This is done by clicking on +Add Action. You can save answers into a custom field, Google sheet, or create a HubSpot contact.

For custom fields, you can save user responses into any custom field you have created, as long as the reply type of the question matches the custom field type (e.g. you can’t store an email reply to a number custom field). For more information on custom fields, click here.

For Google Sheets, you can insert or update a row based on user responses. For more information on google sheets here, click here.

For Hubspot, you can create a hubspot contact based on user responses. For more information on hubspot integration, click here.


*Considerations for User Input Component:

Since multiple components can be sent in a broadcast, it must be noted that all components placed after the user input component will not be sent until the user replies to the user input questions. Sending a new message via live chat or broadcast will override the broadcast containing the user input component(s) and send a new message in place of it.