messenger-bot

Ruby on Rails client!! for Facebook Messenger Platform

Requires Rails >= 4

Installation

Bundler in your Gemfile.

gem 'messenger-bot'

Getting Started

Before You Begin

Now sign in into the Facebook developer and create an application

1. Add messenger-bot-rails to your Gemfile

gem 'messenger-bot'

2. Set config in config/initializers/messenger_bot.rb

Messenger::Bot.config do |config|
  config.access_token = <PAGE_ACCESS_TOKEN>
  config.validation_token = <VERIFY_TOKEN>
  config.secret_token = <FB_APP_SECRET_TOKEN>
end

Subscribe the App to the Page

3. Add the following to your config/routes.rb

mount Messenger::Bot::Space => "/webhook"

4. create a controller in app/controllers/messenger_bot_controller.rb

class MessengerBotController < ActionController::Base
  def message(event, sender)
    # profile = sender.get_profile(field) # default field [:locale, :timezone, :gender, :first_name, :last_name, :profile_pic]
    sender.reply({ text: "Reply: #{event['message']['text']}" })
  end

  def delivery(event, sender)
  end

  def postback(event, sender)
    payload = event["postback"]["payload"]
    case payload
    when :something
      #ex) process sender.reply({text: "button click event!"})
    end
  end
end

wiki

Usage

message(event, sender)

• event - Hash containing the message event from Facebook format
• sender - Class to call the 'reply, get_profile' method.

delivery(event, sender)

• event - Hash containing the delivery event from Facebook format
• sender - Class to call the 'reply, get_profile' method.

postback(event, sender)

• event - Hash containing the postback event from Facebook format
• sender - Class to call the 'reply, get_profile' method.

optin(event, sender)

• event - Hash containing the optin event from Facebook format
• sender - Class to call the 'reply, get_profile' method.

license

MIT, see LICENSE.txt