Yoctol/hubot-messenger-bot

Name: hubot-messenger-bot

Owner: YOCTOL INFO INC.

Description: :electric_plug: A Hubot adapter for Facebook Messenger Platform (Bots) with zero external dependencies.

Forked from: ClaudeBot/hubot-messenger-bot

Created: 2016-10-19 08:16:03.0

Updated: 2016-11-04 08:22:08.0

Pushed: 2017-05-18 20:16:05.0

Homepage:

Size: 32

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

hubot-messenger-bot

A Hubot adapter for Facebook Messenger Platform (Bots) with zero external dependencies.

The most simple, and elegant Facebook Messenger Platform adapter for Hubot.

This is built for the latest Facebook Messenger Platform (Beta) with bots announced at F8 2016 (Code to Connect). It leverages on the platform's Send / Receive API. It is tested, and ready-to-use. This repository is NOT affiliated with Facebook.

This adapter currently supports:

• [x] Token validation
• [x] Basic sending / receiving
• [x] Resolving user IDs to their full names
• [x] Tracking user ID, message ID, recipient ID (page)
• [x] Auto-truncating long messages

320 characters limit

At the time of writing, the Send API only allows up to 320 characters. We strongly recommend using a plugin like hubot-longtext to gracefully handle long messages.

See src/messenger.coffee for full documentation.

Getting Started

Refer to Getting Started - Messenger Platform, and Complete Guide - Messenger Platform for more information.

The callback URL is http://your-bot-address:8080/webhook/.

You can test your bot locally using ngrok. Run ./ngrok http 8080, and it should return a HTTPS forwarding URL (be sure to append /webhook/ to it).

The adapter requires your verification token, and access token to function. You can set them via environment variables. Refer to Configuration for more information.

Installation via NPM

install --save hubot-messenger-bot

Now, run Hubot with the messenger-bot adapter:

G=hubot-messenger-bot ./bin/hubot -a messenger-bot

Configuration

Variable | Default | Description — | — | — MESSENGER_VERIFY_TOKEN | N/A | Your bot's verification token. You can obtain one when you create a web hook to receive events for a specific page. MESSENGER_ACCESS_TOKEN | N/A | Your page access token (it is based on an app, page, and user). You can find it in the “Token Generation” section of your app dashboard.