Channels Integration

Channels integration page is the place you can use to connect your messaging client with Qismo. We call each messaging client as a channel. We have provided five pre-supported channels to be used, namely: Qiscus Channel, FB Messenger Channel, Line Channel, WhatsApp Channel and Telegram. To connect to any channel you want, you can simply follow the instruction provided in each channel tab.

Qiscus Channel

As the name suggests, this channel is the Qiscus official channel. Since Qiscus SDK is capable of enabling conversations in multiplatform, Qismo - as one of many apps that runs on top of Qiscus SDK - also provides a way to integrate your customer engagement in a web widget form. For the example on how to use it, you can head over to the Quick Start section to see how easy it is to embed the widget into your developed website.

image of widget builder

In order to match the appearance of the widget with your site, Qismo has provided a GUI to customise widget appearance, which we call it a widget builder. It helps you in changing several things, such as: welcome message, widget name, widget avatar, button text, and many more.

By default, it only provides a snippet to be embedded in website. However, it is not limited to website only. You can embed the widget in your Android app or even iOS app. For more information on how to embed this widget in Android, please hop on to the Android customisation section.

Facebook Messenger

This channel integration allows you to connect with people across devices and platforms through Facebook Messenger application. In order to connect to the Qismo, first thing you need to ensure is that you already have a Facebook Account and a Facebook Business Page.

facebook integration

After that, just follow this simple steps.

  1. Connect to your Facebook page by simply clicking on the Continue with Facebook button,
  2. Select a Facebook business page that you want to connect,
  3. Finally, confirm the integration by clicking on the connect button

That's all! we got you covered. Easy, isn't?

Line

For Line integration, Qismo only support Messaging API that has Developer plan for now. So please make sure you have selected the plan correctly.

image of Line plan

To connect the service, first we need to go to the Line console. There, you need to configure several things:

  1. First, issue a Channel Secret and save it for further usage on Qismo settings,
  2. Scroll to the messaging settings and issue your Line app Channel access token, and save this token,
  3. make sure to enable "Use webhooks" field,
  4. make sure to also enable "Allow bot to join group chats" field,
  5. you may also want to disable auto-reply and greeting messages features.

image of line console

Now that you have done with the Line console part, let's go to the Qismo integration page for Line and fill in these two basic info we've got from Line console:

  1. Channel access token, and
  2. Channel secret

Line tab integration

Finally, copy the Qismo webhook URL and go back to the Line console. Then paste the copied webhook URL to the Webhooks URL in the Messaging Settings section. Then verify it by clicking the Connect button. That should connect your Line account with Qismo and you should now be able to receive messages from Line.

WhatsApp

WABox integration

At this moment, Qismo supports WhatsApp integration through WA Box App API. So you will need to sign up to the WA Box Website before you make an integration.

To connect with WA Box, just follow through

  1. Sign up to the WA Box App website and install WA Box Chrome extension

  2. Open up WA Box extension and validate your account by providing your WA Box API key. You can get the API key from the My phones settings

    WA Box Extension

  3. In the same browser you installed the WA Box Chrome extention, open up WhatsApp Web. When you open it up, it will automatically add your WhatsApp number to WA Box My phones settings. Just verify it by going to the My phone settings page in the WA Box dashboard.

    WA Box Dashboard

  4. Go to the Qismo WhatsApp integration setting page, and fill in WA Box API key and phone number you are going to use

  5. Still in the Qismo WhatsApp integration setting page, copy Qismo webhook URL, and go to the WA Box My phones setting and paste the URL to the Hooks URL and click the Save button

  6. Finally, click the Connect button in Qismo the WhatsApp integration setting page

If everything is set up correctly, you will be able to see messages that come through your WhatsApp number.

To be note here, WhatsApp web should always be online since the way WA Box works is by intercepting messages that come over your WhatsApp web. This also means that, your WhatsApp phone should always be online to make sure you will get the messages.

Telegram

Telegram integration

To connect your Telegram messaging client with Qismo is quite straightforward. You just have to fill in your Telegram access token in Telegram channel integration page in Qismo.

  1. Create a bot in Telegram by asking it to BotFather. Just follow through the questions he asks you for and you will get the token
  2. Copy the token, and paste it in the field of Bot token in Telegram integration page in Qismo. Qismo will auto generate your Telegram bot username and bot name.

Custom Channel

Beside those five channels, you can also integrate any services you want as long as it is related to text exchange, we call it custom channel. For example, if you want to allow interaction through SMS, you could do it by providing your own webhook url in custom channel.

The idea behind this custom channel is that you provide your own server to be hooked by Qismo whenever you want to send any messages via Qismo to your custom channel or other way around. For more information about this custom channel, you can follow up at Custom channel section.

custom channel

Bot Integration

In addition to those channels above, you are also able to connect Qismo to any bot services to help you automate in replying messages. By saying any bot services, it means literally any. So for example if you build your bot using DialogFlow, you can connect it by providing your bot webhook URL in the bot tab.

More about this can be found at the Bot-human collaboration section.