User Manual


Server Configuration :

[Note: If you get "404 page not found" error then make AllowOverride in your virual host and check if .htaccess file is uploaded successfully in root or not]

Installation Manual :
  1. Download .zip package
  2. Upload it to your server
  3. Extract the package
  4. Make sure all files and folder have write permission after you extract (recommended 755 permission)
  5. Run the uploaded url via browser (http://yourdomain.com/projectFolder/) and you will find a interface to provide the settings for Bot Inboxer:
    • Hostname : database host name / IP
    • Database Name : create a mysql database on your host and write that name here
    • Database username  : username of the created database
    • Database password : password of the created database
    • Admin Panel Login Email: this will be used to login as admin
    • Admin Panel Login Password : password to log in as admin
    • Company Name and Company Address
    • Company Phone /  Mobile
  6. Click install button
  7. You are done. Log in with your admin username and password and start using.

This panel is for only admin users. As an admin user, you will find everything to control your application here.

Settings > General Settings [Only Admin]

 

Settings > Email Settings (System SMTP Email: Only Admin)

 

Settings > Advertisement Settings

 

Settings > Social Login Settings [Only Admin]

   




Settings > Facebook API Settings

Let me describe about the process for Facebook APP approval for BOT Inboxer. It's so easy. :) 

Approval Needed:  Page_messaging (Mandatory)
                               Manage_pages (Optional)

Page_messaging permission submitting procedure: Please follow the below instruction video for submitting Page_messaging approval.

FACEBOOK APP SETTINGS
SUBMIT FOR APP APPROVAL

Example Content :  

Hi Facebook Team,

My Messenger BOT works like this way.
If people says "Hi", my BOT will reply "Hi, How can we help you ?"
If people says "Info" my BOT will reply "We are a software firm. We develop web application." 
If anyone says "Support" my BOT Will reply "Please put your question here, one of my team member will help you".
Thanks for your kind review.

Have a nice day.
Konok



Manage_pages permission submiting procedure  (Optional)  :  Manage_pages permission is optional. Though we recommend to submit for it. If you don't want to get manage_pages permission, Just got General Settings from admin panel & set "I don't want manage_page permission approval. Keep user as tester of my app". 

Now let see how to submit for manage_pages permission. Have a look on below video. 
 

You will need to submit a screencast during submit. Here i am going to add a demo video sample. Don't copy it. Just create a same screencast by you with your app. 
 



Example Content :

Hi Facebook Team

  • 1. User Login to our system.
  • 2. User then Click the button "Login With Facebook" to import Facebook Account.
  • 3. Our system get the user information , Page List & Access Token.
  • 4. User can then Subscribe their Page to App's webhook for Messenger BOT by clicking "Enable BOT" Button.
  • 5. Then user can set up reply for Messnger BOT.

Here is the demo account if you want to check.
Login URL : https://yourdomain.com/fbinboxer/home/login_page
Email : review@yourdomain.com
Password : XXXXXXX

Thanks for your kind review 
Konok



 

 

User Management [Only Admin]

 

User List

user list

User Add Form

user list

User Edit Form [Package assign]

 

 

Send Notification (email to users) [Only Admin]

 

 

Payment > Dashboard [Only Admin]

This is place where you can see your collection report graphically.

 

Payment > Payment Settings [Only Admin]

This is the place where you set your PayPal account / Stripe account or both and your currency. Your end users will pay to this PayPal account/ Stripe account.

 

Payment > Package Settings [Only Admin]

Payment > Payment History [Admin will have all and users will have own report]

History of all payment made by end users. You can search be name or payment date.

 



 

In import account menu you will find your imported accounts and pages. First you need to enable bot for a particular page to create bot for that page.

You can add buttons and can put your link when bot replies your visitors. To put a link you need to whitelist the domain. Suppose you will use several website links in your bot xyz.com,123.com,abc,com etc. You can add these domains to page whitelist now. It's not mandatory because when you create a bot and put a link that is not whitelisted system will also whitelist it automatically.


Add Bot Settings


The landing page will show current bot settings for that page, you can edit/view them if you like.
In the top right you will see button to create a new bot.



There are fourn types of replies:
  1. Reply : Keyword based reply [requires comma seperated keywords]
  2. Post-back : Button click action [requires post-back ID]
  3. No-match : No keyword matched then send a generic reply
  4. Get Started : Reply when visitor clicks "Get Sratred" button [requires to enable get started button]


There are nine types of reply templates:

Text

Image

Audio

Video

File

Quick Reply

Text with Buttons

Generic Template

Carousel

Subscribers


After you setup bot and it starts replying people they will be your Messenger lead/subscriber. If you want to stop bot for any particular lead/subscriber and chat by yourself, simply click the "Stop Bot" button.


Email Collect


Quick reply now have have ability to collect email from your visistor, we have stored those emails so that you can use them later.


Enable Get Started


If you enable this, When someone come to your page first time chat box will pop up and a button called "Get Started" will appear. You can add the action reply for clicking the button in "Bot Settings" (described beow).


Persistent Menu [Requires "Get Started" Button]


The Persistent Menu is always available to the user. This menu should contain top-level actions that users can enact at any point. Having a persistent menu easily communicates the basic capabilities of your bot for first-time and returning users. The menu will automatically appear in a thread if the person has been away for a certain period of time and returns.

You can multi-level (nested) persistent menu and also can have different menu for different locale.

BOT SETTINGS
PERSISTENT MENU
COLLECT EMAIL
Disclaimer: We are glad to provide our product in 12 different languages. You can select your language while Installation or you can change your language from General Settings. All the translations are performed by google translator. Also there are possibilities of human error. If there are any errors then we can not take the responsibility because firstly, we have no control over or knowledge on google's translation algorithm and secondly, our first language is Bengali & second language is English. So we were unable to correct errors for other languages than Bengali or English. You can correct any error or change any word if you like to (described below).


Change Any Built-in Language's Words/Sentences:

If you want to change words/sentences any of our built-in languages, you will find them in three places. Let you want to change Bengali language, then you will find Bengali language files in:

1. application/language/bengali/

 

example: admin_lang.php

$lang["company name"]               = "Your Value 1";
$lang["company address"]            = "Your Value 2";

 

1. application/moadules/messenger_bot/language/bengali/

 

example: admin_lang.php

$lang["company name"]               = "Your Value 1";
$lang["company address"]            = "Your Value 2";

 

3. plugins/grid/locale/bengali.js

 example:

    $.fn.pagination.defaults.beforePageText  = 'Value 1';
    $.fn.pagination.defaults.afterPageText     = ' Value 2 {pages}';
    $.fn.pagination.defaults.displayMsg         = 'Value 3 {total} Value 4 {from} Value 5 {to} Value 6';

 

4. plugins/grocery_crud/laguages/bengali.php

example:

    $lang['list_add']                  = 'Value1';
    $lang['list_actions']             = 'Value2';
    $lang['list_page']                = 'Value3'; 

 

The files are php or js files. So, any syntax error during changing will affect the system. Please be careful when you change and backup original files before you change.

 

Add New Language
Update - v1.2.4 to v1.2.5

1. Download v1.2.5

2. Copy/Replace your following files and folders taking from v1.2.5

3. Open file application/config/my_config.php and change product version to 1.2.5

4. Run the database migration file via browser. Example link http://example.com/update

5. You are done.



Update - v1.1 to v1.2

1. Download v1.2

2. Copy/Replace your following files and folders taking from v1.2

3. Open file application/config/my_config.php and change product version to 1.2

4. You are done.



Thanks a lot to