Connect Quriobot to external Chat services

Although we support native live chat mode, with the External Chat step, you enable your users to keep chatting with your Quriobot on external chat clients (like Facebook Messenger or WhatsApp).

To do so, you just have to add the External Chat step, type in the names of the different chat clients you want to be available (That is what will appear in the chat), and finally, add the applicable links under each name.

Facebook Messenger example:

  1. Add the External Chat type step to your Quriobot
  2. In this example we will use the break out to Facebook Messenger: which works with the link**https://m.me/<USERNAME>** - where needs to replaced with your Facebook page name.
  3. In the Frontend this will then automatically translate to a Facebook button which, when clicked will lead to your Facebook page where you can pick up the conversation!

Note: You can find the list for usage in the control room on the External Chat Step type and by clicking on the link icon next to each example you will find more details about each platform and the way these links work:

All the other services:

ChatExample usageE xtra information link
FB Messengerhttps://m.me/<USERNAME>Click here
WhatsApphttps://api.whatsapp.com/send?phone=<PHONE_NUMBER>Click here
Skypeskype:?chatClick here
Viberviber://add?number=<PHONE_NUMBER>Click here
Telegramhttps://telegram.me/<USERNAME>Click here
Snapchathttps://snapchat.com/add/<USERNAME>Click here
WeChatweixin://dl/chat?Click here (use translation ;) )
Slackslack://user?team=<TEAM_ID>&id= Click here
Lineline://oaMessage/LINE_ID/?MESSAGEClick here
Telephonetel:PHONE_NUMBER

Extra information per external chat connection:

  • Messenger:

The format of the link is http://m.me/<PAGE_NAME>, where PAGE_NAME is the handle of the Facebook page the bot is linked to. PAGE_NAME is your page ID, you will find it under your page’s profile picture or in your browser’s address bar. In the case of Quriobot, the page title is Quriobot, the page name is @quriobot. Therefore, the link in the external chat step would appear like this:

http://m.me/quriobot

Please note that you can connect your bot to your Facebook page, learn more here.

  • WhatsApp:

To create your link, use https://api.whatsapp.com/send?phone= followed by the full phone number in international format. Omit any zeroes, brackets or dashes when adding the phone number in international format. For a detailed explanation on international numbers, read this article. Please keep in mind that this phone number must have an active account on WhatsApp.

Use: https://api.whatsapp.com/send?phone=15551234567

Don’t use: https://api.whatsapp.com/send?phone=+001-(555)1234567

You can also create a link with a pre-filled message that will automatically appear in the text field of the chat, use https://api.whatsapp.com/send?phone=whatsappphonenumber&text=urlencodedtext where whatsappphonenumber is a full phone number in international format and urlencodedtext is the URL-encoded pre-filled message. This works with {{variables}} as well!

Example: https://api.whatsapp.com/send?phone=15551234567&text=I’m%20having%20an%20account%20issue

or https://api.whatsapp.com/send?phone=15551234567&text={{options}}

Please note that you can connect your bot to the WhatsApp business, learn more here.

  • Skype:

For the link to work, you have to add your skype username separated with dots instead of blank spaces if any (if you don’t know what your Skype username is, you can find help here ). The link to use should look like this: skype:skype.test.user.1?chat, “skype test user 1” being the username example here.

Note: iOS is not supported.

Example:

  1. Add the External Chat type step to your Quriobot

  2. In this example we will use the break out to Skype: which works with the link

    skype:?chat

  3. In the Frontend this will then automatically translate to a Skype button which, when clicked will lead to your Skype page where you can pick up the conversation!

  • Viber:

Unlike Skype or Facebook, Viber does not have a scheme to open a 1o1 conversation with a user. Nevertheless, there is a way to get very close to it with this URL scheme:

viber://add?number= <PHONE_NUMBER>

This URL will open the ‘Add to your contact list’ tab and users will be able to add the number and therefore send a direct message.

Example: The link to add in the Quriobot Control Room should look like this: viber://add?number=0123456789

In the frontend this will then automatically translate to a Viber button which, when clicked will lead to your Viber page where you can pick up the conversation!

  • Telegram:

This link will open a direct chat with your account:

https://telegram.me/

Example: You simply have to add your username to the link for it to be active. Something like: https://telegram.me/Quriobot

  • Snapchat:

Just like Viber, Snapchat doesn’t have a scheme to open a direct chat with a user, but this scheme will allow them to add your organization, and therefore sent a message.

URI Scheme: https://snapchat.com/add/

To get your unique URL, open Snapchat, drag down on the camera view, click ‘add friends’ then ‘share username.’

Example: https://www.snapchat.com/add/Quriobot

  • WeChat:

You simply have to replace with your WeChat ID. Your WeChat ID might be different from your WeChat nickname, that you can change whenever you want and will appear in conversations. Your WeChat ID is unique and is what users search for when they want to add someone as a contact.

The following URL scheme will open a direct conversation if clicked:

URI Scheme: weixin://dl/chat?

Example: weixin://dl/chat?quriobot

  • Slack:

To open a direct message with a user on slack, you have to add to the link your team ID, that you can see on the top left corner of your screen when you’re on Slack. You also have to add your user ID, that is not your Slack name, it is a unique ID made of numbers and letters.

To find that user ID, go to your profile when on slack, click the “More options” arrow and copy the ‘member id’

slack://user?team= <TEAM_ID> &id=

As an example, Quriobot’s external chat link for slack would be:

slack://user?team=quriobot&id=U8QUXRTGB

  • Line:

To create your link use line://oaMessage/LINE_ID/?MESSAGE

To find LINE_ID open your profile information:

Enter your text MESSAGE. Make sure that your parameters are URL encoded in UTF-8.

Example: line://oaMessage/12345678/?Welcome!

  • Telephone
  1. Add the External Chat step to your Quriobot,

  2.  Type the name of the chat (that is what will appear in the chat)

  3.  Add your phone number under this name.

We hope that helps you get this amazing Step type going!

Edit this page

Tags
See also