Giga Messenger Documentation

Author: Giga AI <hello@giga.ai>

Version: 2.3

Thanks for downloading Giga Messenger Bots. This is a Quick Start guide which shows you the easiest way to setup your messenger bot and make it works. For detailed and daily updated version, we highly recommended you check the Live Documentation

If you have any questions that are beyond the scope of this help file, please feel free to ask a question at Support Channel where we can provide highest priority support.

Installation

It's recommended that you read Messenger Platform's Overview before continuing this documentation.

Server Requirements

In order to run Giga Messenger Bots (Giga AI), your server should meet these minimum requirements:

PHP >= 5.4
WordPress >= 4.4
cURL should enabled
Your site (or webhook) should https

Most of server/hosting providers is already support PHP 5.4+ and cURL. You can also get a free SSL from LetsEncrypt.

Of course, it's highly recommended that you run latest stable PHP version.

Secure Tunnels to Localhost

Let's assume that you want to test your bots in your development machine before deploying. You'll need to let Facebook connect to your PC and it should have SSL enabled. To simply these steps, we'd recommend that you use ngrok, it will automatically creates a secure public URL to your local webserver with format: https://RANDOM.ngrok.io.

Installing Giga Messenger Bots

Like other WordPress plugin, just do some simple steps to install.

Download giga-messenger-bots.zip and unzip the package.
Copy giga-messenger-bots directory to /wp-content/plugins directory.
Activate plugin through wp-admin/plugins screen.
Done! Now navigate to Dashboard / Giga AI / Settings page and start configuring. You can see the webhook is https://domain.com/wp-json/giga-ai/webhook under the Basics tab.

Setup Messenger

Create Facebook App & Page

Create a new Facebook App and Page or simply use existing ones. Go to the App Dashboard and under Product Settings click "Add Product" and select "Messenger."

Setup Webhook

In your Facebook App. Navigate to Webhooks menu item, click New Subscription, then choose Page. A dialog will shows up:

New Page Subscription

In "Callback URL", enter your webhook URL (default is http://domain.com/wp-json/giga-ai/webhook)
In "Verify Token", enter GigaAI
In "Subscription Field", check all fields with prefix "message_", like message_deliveries, messages, messaging_optins, messaging_postbacks, message_echoes, message_reads, and messaging_account_linking.
Click Verify and Save

Setup Messenger

The next step is make a connection between Website <=> App <=> Page, so all messages come from page pass through app to website and vice versa.

In your Facebook App. Navigate Messenger, below Webhooks item.
In Token Generation section, select a your page, you'll need to confirm permission for that page. After that step, you'll got Page Access Token.
In Webhooks section, scroll down to Select a page to subscribe your webhook to the page events. Choose your page and click "Subscribe".
Copy your page access token and paste it to Dashboard/Giga AI/Settings/Page Access Token section.
(Optional) Copy your Page ID, and App ID paste it to related section.

If success, you'll see the connection status in Basics section is green "success". Otherwise, check your steps or environment one more time.

Test Your First Message

If you reached this step. Congratulation! All easy right? Now it's time to talk with your bot

Try to send hi to your page with your app's administrator account. If you get reply from your page. Congratulation! Otherwise, please check your server requirements or previous steps.

Greeting

What's Next?

Now, setup is completed, you'll want to know about Message Types, Bot Designer, and how to use our API to send and receive message!

After created your bot, you'll need to get an approved review from Facebook to public your Bot.

Please go to Giga AI regularly to get latest news & tips.