Facebook

From Evo Voice
Jump to: navigation, search

Introduction

Like Skype, Slack, Email, and SMS, Evo Voice supports messaging for Facebook Pages (e.g. business pages).

Step by Step

This step by step guide assumes that you already have a Facebook account that you want to enable chat for.

Create Facebook Endpoint

First, let's create a new Facebook Endpoint by going to the Endpoints screen and clicking New Endpoint > Facebook.

ClipCapIt-190909-153120.PNG

You can assign this endpoint to whichever customer you want and give it a name. Note The name is for display purposes only.

Once you create the endpoint you will be taken to the details page. Keep this open and open a new tab.

ClipCapIt-190909-162016.PNG


Create Facebook Page

In a new browser tab, go to https://facebook.com and if you do not already have a Facebook Page created, click the Create button at the top of Facebook and select Page

ClipCapIt-190909-151902.PNG

Click the Get Started button under Business or Brand.

Give the Page a Name/Category and click Continue

ClipCapIt-190909-152005.PNG

Upload the photos for the page (or skip this step)

You should now have a beautiful new Facebook Page

ClipCapIt-190909-152137.PNG

Sign up for Developer Account

If you haven't done so already, you need to sign up for Facebook Developer account in order to enable integration with your Facebook Page. Go ahead and navigate to:

https://developers.facebook.com/

And click the Get Started link at the top right. Follow the instructions to register as a Facebook Developer (verify account etc.) and then click the "Create First App" button when you are done.

Create Facebook App

If you haven't done so already by clicking the "Create First App" you can create a new App by first going to

https://developers.facebook.com/

And then clicking the Create App link under My Apps

ClipCapIt-190909-152450.PNG


Display Name can be anything you want and enter your email address, e.g. then click Create App ID

ClipCapIt-190909-152532.PNG

You should now be at the App home screen

ClipCapIt-190909-152642.PNG

Add Facebook Messenger

You now need to add "Facebook Messenger" to your App, do this by clicking the "Set Up" button under "Messenger"

ClipCapIt-190909-152743.PNG

Add Access Token

On the Messenger Settings screen under Access Tokens, click the Add or Remove Pages button

ClipCapIt-190909-152925.PNG

Follow the Wizard through the steps to add any pages that you want to grant access

Add Webhook

On the Messenger Settings screen under Webhooks click the "Add Callback URL" button

Now, flip back to Evo Voice and copy the Outgoing Webhook URL value on the Facebook Endpoint

ClipCapIt-190909-154506.PNG

Back on Facebook, paste this value into the Callback URL field. For the Verify Token, you can enter whatever you want, e.g.

ClipCapIt-190909-153840.PNG

Click the Verify and Save button. The window should close and the callback should show up in the list

ClipCapIt-190909-154003.PNG

Now click the "Add Subscriptions" button and check the "messages" option and then click Save

ClipCapIt-190909-160317.PNG

Generate Page Token

On the Messenger Settings screen on Facebook, in the Access Tokens section, you should have a single Access Token listed.

Click the Generate Token button

Important On the page that shows up, the token will only be shown once, click the Copy button and then paste that into the Page Access Token on Evo Voice

ClipCapIt-190909-154631.PNG
ClipCapIt-190909-162156.PNG

In Evo Voice, you can now Save your endpoint.

Testing Facebook Integration

Let's go ahead and create a simple Flow and associate it with our Facebook endpoint, e.g.

ClipCapIt-190909-155727.PNG

And now navigate to your Facebook Page. You can use the link in the top right:

ClipCapIt-190909-155841.PNG

Go ahead and open up the Chat (bottom right) and click the New Chat button. Then type in the name of your Page and press Enter

ClipCapIt-190909-160450.PNG

Say Hello!

ClipCapIt-190909-161008.PNG

It's important to notes that Evo Voice's Facebook integration supports all of the same features that our other Chat Channels do

Publishing App

By default, Facebook Apps are only visible to the Page creators. In order for your App go be visible to the general public, you must submit the App for Review. This is beyond the scope of this documentation, but you can follow the process here to do this:

https://developers.facebook.com/docs/apps/review/