FacebookChat

FacebookChat is a gem which send a chat message to any facebook friends using Facebook Chat API. It makes you to handle a facebook chat message more easy. If you'd like to know about Facebook Chat API, please check Facebook Developer's page.

Installation

Add this line to your application's Gemfile:

gem 'facebook_chat'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install facebook_chat

Usage

Preparation

Your facebook application should have xmpp_login permission to send a chat message. Please set xmpp_login permission in your application before go to next step.

Configuration

First, you have to configure to Facebook Chat API Client.

If you are developing on Rails, you might want to place following code to config/initializers/facebook_chat.rb.

require 'facebook_chat'

FacebookChat::Client.configure do |config|
  config.api_key = '****' # your facebook application's api key
  config.host = 'chat.facebook.com' # you can omit this line. Default host value is 'chat.facebook.com'
end

Send a message

And then, create FacebookChat::Client instance and call send method.

access_token = '****' # message sender's facebook access token
client = FacebookChat::Client.new(access_token)

to = '1000000000' # facebook user id you want to send a message
client.send(to, "hey, what's up?")

you can notice that a message is sent to the user who have id 1000000000.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request