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 <USERNAME> 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:

Chat
Example usage
Extra information link
FB Messenger
WhatsApp
Skype
skype:<USERNAME>?chat
Viber
viber://add?number=<PHONE_NUMBER>
Telegram
Snapchat
WeChat
weixin://dl/chat?<USERNAME>
Click here (use translation ;) )
Slack
slack://user?team=<TEAM_ID>&id=<USERNAME>




















Line

line://oaMessage/LINE_ID/?MESSAGE

Click here




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




  • 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}}



  • 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:<USERNAME>?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/<USERNAME>




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/<USERNAME>


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 <USERNAME> 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?<USERNAME>


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=<USERNAME>


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!


Hope that helps you get this amazing Step type going!




Need more help or looking for inspiration? Join the Quriobot community!

Quriobot
Friendly & Fun
Interact & Convert