How to Use Generic Channel

How to Use Generic Channel

Creating generic channel:

Generic channel can be used to integrate any messaging platform or channel to MindBehind. It supports three actions:

  • Receive endpoint: The MindBehind endpoint that will receive your messages, and its (
  • Send web-hook: Where you will define your receive message endpoint to receive messages from MindBehind
  • Handover web-hook: Where you will define your handover action endpoint in case you want to support handover in the new channel

You can find Generic Channel under Channels tab in Company Settings:

While creating your channel, you need to name your channel and you need to give a callback URL to receive MindBehind messages (Send web-hook) as next:

After creating channel and clicking on channel settings icon:

MindBehind will give you an authentication token. Please copy and store this token to use in sending message to MindBehind. Also, MindBehind will give you an example of the message format you should send, and the ability to update the handover web-hook URL as next:

Sending Message to MindBehind:

The MindBehind end point will accept the messages in JSON format, the HTTP request details as next:

  • Messaging URL:
    channelID=<Your channel id>
  • HTTP Method: POST
  • Required Header : “apiToken” that can be generated after creating the channel
  • Body: Should be in JSON format with the following schema:

NOTE: if your message is a selection of regarding CARD or QUICKREPLY messages button please send selection as TEXT message.

You can download from here our Postman collection to try that request right away.

Receiving Message from MindBehind:

MindBehind will try to send messages to the web-hook you chosen when you created the channel, the HTTP request details coming from MindBehind as next:

  • HTTP Method: POST
  • Body:

The content of the message can be normal string or can be a JSON string for some type of messages, next is a list of possible messages types with their content formats:

  • TEXT: A normal string data
  • IMAGE: A normal string data describing the public link of image
  • VIDEO: A normal string data describing the public link of video
  • FILE: A normal string data describing the public link of file
  • LOCATION: A JSON object for lat and lng.
  • HANDOVER: empty content cause its a command
  • END: empty content cause its a command
  • CARD: A JSON string with following format:

  • QUICKREPLY: A JSON string with following format:

NOTE: ButtonType can have the following values:

  • L: a link button
  • T: a text post back button
  • P: a post back button
  • C: a phone call action button
  • I: a link button (In Iframe if its supported)

    • Related Articles

    • How to Add a Line Channel

      Prerequisites: Before publishing the bot on your LINE channel, please follow the following steps. Note: To set up Line channel: 1. Please login onto the Line developers dashboard ...
    • How to Use CraftGate?

      Before Starting In order to receive payment through CraftGate, the integration setup in this link. How to Create Payment Link In order to create a payment link via an assistant, a "POST" request must be sent to the following endpoint using the ...
    • How to Use OTP Service

      What is OTP Service? OTP service is a password validation service which sends a password as sms to defined number and validate this password with its validator service. In MindBehind products, it can be used before user starts chatting with chatbot ...
    • How to use links

      What is IG.ME Links? It provides a way to create a link where users can directly access the instagram dm box. How to create IG.ME Links? Go to Your MindBehind Company Click on Channels and scroll to your INSTAGRAM Channel Click on the IG.ME Link icon ...
    • Parameters to use Shopify

      First of all, you need to add Shopify integration to your company. ‘Integration Name’ can be anything you want. And you can get ‘Store Url’ and ‘Access Token’ from Shopify. Now you can use Shopify integration on your own bot with e-commerce module. ...