How to add Quriobot for your Facebook pages!


Important(!): please know that when storing (and using) User data you need to ask permission to the user. We therefore strongly advise to add a permission request in the form of the sentence that when a user starts the chat they have given the organization the permission to see their data. 




A quick start:

You can use this template for an easy start on Quriobot on Facebook. Just copy paste it all to the source code when creating a new bot (explained here).


Supported features for Quriobot for your Facebook pages

We support the following options:

  • All Step typeswe offer for our website solution as well. Please note that the more extensive Step types work via a breakout option in Messenger;
    • Please keep in mind that Facebook Messenger has far less flexibility than a website where your Quriobot can roam freely.
  • All the different languages you have created your bot in will be shown based on the selected language in Facebook;
  • Advanced conditions for intelligent answers and jumps;
  • Response Connections for integrated follow up after completing your bot (Email, Forms, Webhooks);
  • Using Facebook user Variables, as your are within the Facebook Ecosystem you can make use of the known variables of that user. The following variables are availables for use:
    Important(!): please know that when storing (and using) User data you need to ask permission to the user. We therefore strongly advise to add a permission request in the form of the sentence that when a user starts the chat they have given the organization the permission to use their data.
    • User first name {{userFirstName}}
    • User last name {{userLastName}}
    • User gender {{userGender}}
    • User timezone {{userTimezone}}
    • User language {{userLanguage}}
    • user Avatar {{userAvatar}}
    • referral ref value {{infoReferralRef}}
  • Step, Text and script Variables;
  • Custom Initialization OnSave() and OnValidate() events are supported;


Best practices for building your Quriobot for Facebook:

  • Don't add more than 4 answer options to a multiple choice question otherwise Messenger will automatically use that breakout option;
  • Don't use more than 20 characters per Answer options otherwise Facebook will shorten your answer;
  • Use the Accessibility mode title, the Show more button and Buttontexts;
    •  Accessibility mode title: this will be shown when a user inputs text which cannot be matched by the answer options of that Step when showing that Step again
    • Show more button: This will be shown when the advanced pop-up is needed (in case you have a Step with many options or a special Step type)
    • Button: This is shown within the advanced step pop-up (in case you have a Step with many options or a special Step type)
  • Change the default Invalid and Missing texts
    • As, unlike on the web a user can always answer a question (wrongly) by typing an answer there is always a need to answer that input. You can now add the default texts for this on the Advanced tab.


Results from your bot

All results from your Quriobot on Facebook can be found in the Control Room in the Results section of Quriobot Reporting


Live chat switch

Sometimes in the facebook bot flow you would want to switch into the live chat mode (inbox app) for the user.

This you can do using special response target:


this will effectively do the same as the persistent menu item for the user to switch to the live chat.


m.me links and the jump logic

Facebook m.me link which is provided for the bot Facebook channel supports passing the special referral parameter which can be used to pass the context to the bot for further use in for example the jump logic.

The format of the parameter is like:


http://m.me/<PAGE_NAME>?ref=<REF_PARAM>


The value of the referral parameter is passed into the bot via system (built-in) variable infoReferralRef, which you can use in the Goto step to have a different jump logic depending on the referral given:


Step 1. Create a goto step as an entry point of your bot (first step):

Step 2. Set the value of the step as {{infoReferralRef}}:



Step 3. Create a response which will switch to the live chat mode if the referral parameter equals 'live':



Now you can switch the user directly to the live chat by having m.me link like:

 

http://m.me/<PAGE_NAME>?ref=live


If you want to go to the different step instead of switching to live chat, the approach is the same, just then it's good idea to choose for the different referral parameter code. 



Configuring the channel without having the manager access to the Facebook page

If you don't have direct admin access to the Facebook page, you can make use of the shareable link to the bot channels:

using that link, the admin of the facebook page can add the channel and authorize via Facebook.

After that, you can finish the configuration with the authorized channel.


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

Quriobot
Friendly & Fun
Interact & Convert