Bottender Facebook

Facebook connector for Bottender.

Installation

npm install bottender-facebook

Requirement

Facebook App Graph API verion

Using the API version before v2.10 may cause unexpected behavior.
We highly recommend the API version after v2.11.

Subscribe to essential fields

You need to make sure the webhook of your page is subscribing to the feed field on API version after v2.11.

User Permissions Required

• manage_pages - for access token
• publish_pages - for public replies
• read_page_mailboxes - for private replies

Example

const { Bot } = require('bottender');
const { createServer } = require('bottender/express');
const { FacebookConnector } = require('bottender-facebook');

// We can get `story_fbid` in URL query string
const POST_ID =
  process.env.POST_ID || `${process.env.PAGE_ID}_${process.env.STORY_FBID}`;

const bot = new Bot({
  connector: new FacebookConnector({
    accessToken: process.env.ACCESS_TOKEN,
    appSecret: process.env.APP_SECRET,
  }),
});

bot.onEvent(async context => {
  if (context.event.isCommentAdd && context.event.comment.post_id === POST_ID) {
    await context.sendPrivateReply('OK!');
    await context.sendComment('Public comment!');
  }
});

const server = createServer(bot);

Custom Graph API version

The default Graph API version is v2.11 (recommended).
You can use other version by following this example:

const { Bot } = require('bottender');
const { FacebookConnector, FacebookClient } = require('bottender-fb');

const bot = new Bot({
  connector: new FacebookConnector({
    appSecret: APP_SECRET,
    client: FacebookClient.connect(ACCESS_TOKEN, '2.11'),
  }),
});

API Reference

Client

• client.sendComment
• client.sendPrivateReply

Context

• context.sendComment
• context.sendPrivateReply

Event

• event.isFeed
• event.isStatus
• event.isStatusAdd
• event.isStatusEdited
• event.status
• event.isPost
• event.isPostRemove
• event.post
• event.isComment
• event.isCommentAdd
• event.isCommentEdited
• event.isCommentRemove
• event.comment
• event.isLike
• event.isLikeAdd
• event.isLikeRemove
• event.like
• event.isReaction
• event.isReactionAdd
• event.isReactionEdit
• event.isReactionRemove
• event.reaction

Contributing

Pull Requests and issue reports are welcome. You can follow steps below to submit your pull requests:

Fork, then clone the repo:

git clone git@github.com:your-username/bottender-facebook.git

Install the dependencies:

cd bottender-facebook
yarn

Make sure the tests pass (including eslint, flow checks and jest tests):

yarn test

Make your changes and tests, and make sure the tests pass.

License

MIT © Yoctol