Make sure curl is enbaled , mbstring is enabled, set_time_out is enabled , safe_mode is off, open_base_dir has no value, allow_url_fopen=1 and mysqli support is on.
[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 :
Download .zip package
Upload it to your server
Extract the package
Make sure all files and folder have write permission after you extract (recommended 755 permission)
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
Click install button
You are done. Log in with your admin username and password and start using.
Administration
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]
This is the place where you can change company information, logo,favicon, language time zone.
You can allow your users to use their own facebook app from this settings also.
There are 12 color scheme available now, you can choose your theme from here. You can hide/show the landing page from here also.
If you want your user to have your brand in their page's persistent menu then set persistent menu copyright text & URL here, also you have to edit user's package to enable persistent menu copyright module to enable this feature.
Settings > Email Settings (System SMTP Email: Only Admin)
This is the place to configure system email.
You can add any SMTP email provider here.
These settings will be used to send system emails like forget password, contact, send notification etc.
Settings > Advertisement Settings
The front end contains diffrent advertisement sections: 970x90 px ( large screen) / 320x100 px (small screen), 300x250 px (all screen), 300x250 px (all screen)
Landing page contains all sections while health report page and comparitive health report page contains only 970x90 px ( large screen) / 320x100 px (small screen)
You can change the advertise here. You can also choose weather you want to show advertise or not.
If you choose to show advertise then write html code for each section. You can add simply a html <img/> tag or can add google adsense html code for each section.
Settings > Social Login Settings [Only Admin]
Admin has to config "Social Login Settings" with Facebook APP ID, Facebook APP Secret, Google Client ID , Google Client Secret to make facebook & google login to work. FOllow the video below to create your APIs.
Settings > Facebook API Settings
Let me describe about the process for Facebook APP approval for BOT Inboxer. It's so easy. :)
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]
It is a muti-user application with the SaaS (Software as a Service) functionality.
It consists of two types of user : admin level & user level (end user)
Both will have similar features except only admin users will have access to "Administrative" menu.
Admin will configure the system through general settings, email settings, connectivity settings, proxy settings, payment settings etc while end users will use the system & will pay monthly service charge for using the system. It has feature to recieve payment via PayPal & Stripe will be discussed later in this documentation.
In user management admin users will have access to add, view, disable, enable, edit, reset password, delete users.
Note: if you add an user manually, then after addition edit the user to assign subscription package and expiry date manually.
User List
User Add Form
User Edit Form [Package assign]
Send Notification (email to users) [Only Admin]
You can send email (festival greetings or maintenance notification) manually to any users.
This system also has feature to send automatic alert to users who are going to be expired soon or notification to users who are expired recently. Automatic alert/notification procedure is described in Scheduler/Cron Job section.
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]
You can create subscription plans or packages here. The system will automatically create a package named "Trial" with 7 days validity, so that, your users can try it and remeber that you can not delete this default package.
Suppose you want to create a package named "basic" which validity will be 30days, price will be EUR 10 and you want to assign specific modules (i.e. email template, attention bar, website template) for this package. In this case you are lucky!! You can add unlimited packages you want including price,validity and modules. You can also put monthly analysis limit each module when you create a package. While you assign limits, 0 (zero) means unlimited.
If you do not want a trial then edit deafult package's validity to 0 (zero).
If you do not want to take money from users then edit the default package's price to "Free".
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.
Dashboard
Import Account
This is the place where you connect your facebook accounts to this app. First you have to find your facebook numeric id. To find your facebook numeric id go to http://findmyfbid.com/
Copy the numeric id and paste here then click "Send App Request" button
Now go to your facebook account and you will get a app request in your notification bar. Click on the notification.
You will get a page to confirm app request. Click "Confirm" button.
Go back to "Bot Inboxer" app and click "I've Confirmed App Request in Facebook" and this screen will appear. Now click "Login with Facebook" button and it will take you to facebook and you have to log in as the user account you want to import in Bot Inboxer
Allow the permission as the snapshots below :
You can choose privary friends or public. It privacy is set to "Friends" the posts will be only visible to your friends. If you set it to "Public" then the posts will be visible to everyone. You should use "Public" for marketing purposes.
You must click "OK", otherwise nothing will work !!!
Finally your account is imported now !!! You will see your pages, groups. You can add another account (if your package is multi-account) same way.
Enable/Disables Bot
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.
Domain Whitelist
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.
Bot Settings
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:
Reply : Keyword based reply [requires comma seperated keywords]
No-match : No keyword matched then send a generic reply
Get Started : Reply when visitor clicks "Get Sratred" button [requires to enable get started button]
There are nine types of reply templates:
Text : A simple text reply
Image : Reply with an image
Audio : Reply with an audio that will play on messenger
Video : Reply with a video that will play on messenger
File : Reply with an attachemnt
Buick Reply : Reply with text and buttons [every button requires a post-back ID for identification and you need to add another bot settings to handle that post-back button]
Text with Buttons : Reply with text and buttons [either button can be a post-back button or can open a website URL]
Generic : Single image,image action URL,title,subtitle and buttons [either button can be a post-back button or can open a website URL]
Carousel : Array of generic templates - multiple generic templates display as slider
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.
Demo Video
BOT SETTINGS
PERSISTENT MENU
COLLECT EMAIL
Multilingual Support
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";
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
Suppose your language name is "my_lang"
Copy application/language/english folder and paste & rename folder to "my_lang". Then translate all files in that folder.
Copy application/modules/messenger_bot/language/english folder and paste & rename folder to "my_lang". Then translate all files in that folder.
Translate coping plugins/grid/locale/english.js as plugins/grid/locale/my_lang.js
Translate coping plugins/grocery_crud/languages/english.php as plugins/grocery_crud/languages/my_lang.php
How to Update
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