An open API service indexing awesome lists of open source software.

https://github.com/mudassir0909/fbwish

Ruby Gem to automate facebook like & comment on the birthday wishes using Graph API.
https://github.com/mudassir0909/fbwish

birthday-wishes facebook facebook-bot ruby rubygems

Last synced: 6 months ago
JSON representation

Ruby Gem to automate facebook like & comment on the birthday wishes using Graph API.

Awesome Lists containing this project

README

          

# Fbwish [![fbwish API Documentation](https://www.omniref.com/ruby/gems/fbwish.png)](https://www.omniref.com/ruby/gems/fbwish)
[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/mudassir0909/fbwish?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Ruby Gem to automate facebook like & comment on the birthday wishes using Graph API.

If you have alot of friends in your facebook network & when they wish you on your birthday, it's pretty cumbersome to reply to each one of them. This gem helps you in automating your replies by liking & commenting on those wishes using facebook's graph API (powered by ruby gem [koala](https://github.com/arsduo/koala)).

## Installation (Make sure you have [Ruby](https://www.ruby-lang.org/en/installation/) installed)

Add this line to your application's Gemfile:

gem 'fbwish'

And then execute:

$ bundle

Or install it yourself as:

$ gem install fbwish

## Usage

#### Getting your facebook access token

1. Goto [Graph API Explorer](https://developers.facebook.com/tools/explorer)
2. Click `Get Access Token`
3. Make sure only `publish_actions` & `read_stream` is checked under **Extended Permissions** tab. Also nothing should be checked under **User Data Permissions** tab.
4. Click `Get Access Token` button.
5. Allow access when a popup is displayed.
6. Copy the generated access token.

#### Final step
Open ruby's interactive terminal using the following command

$ irb

Once you are into the terminal run the following commands, with appropriate configuration
```ruby
require('fbwish')
wisher = Fbwish::Wisher.new({
# A valid ruby regular expression based on the wishes you've received.
matcher: /(happy)|(birthday)|(b[\']?day)|(B[\']?DAY)|(hbd)/i,
# Set of replies that you'd like to wish
replies: ["Thank you :D", "Thanks :D", "Thx a lot :-)", "Hey, thx !!! :-)","Thnk U !!!", "Hey Thanks ! :D "],
access_token: "PASTE YOUR ACCESS TOKEN HERE",
# Number of people who wished you on your birthday, you'll know this
# on your timeline when facebook says "foo, bar & 254 others wished you"
wish_count: 256,
# Optional attribute, false by default.
# If true, it logs the replies
verbose: true
})
wisher.wish_em_all! # Sit back & relax ;-)
```

### Advanced stuff
Sometimes people wish you in multiple languages & you might want to reply back in the same language. In that case you might want to namespace corresponding `matcher` & `replies` as follows:
```ruby
require('fbwish')
wisher = Fbwish::Wisher.new({
matcher: {
# regex to match english wishes
en: /(happy)|(birthday)|(b[\']?day)|(B[\']?DAY)|(hbd)/i,
# regex to match tamil wishes (or your own language )
tam: /(iniya)|(inya)|(இனிய)|(பிறந்தநாள்)|(வாழ்த்துக்கள்)/i
},
replies: {
# namespace with the same key i.e. "en"
en: ["Thank you :D", "Thanks :D", "Thx a lot :-)"],
tam: ["நன்றி !!! :D"]
},
access_token: "PASTE YOUR ACCESS TOKEN HERE",
wish_count: 256,
verbose: true
})
wisher.wish_em_all!
```

## Contributing

1. Fork it ( https://github.com/mudassir0909/fbwish/fork )
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 a new Pull Request
=======
fbwish
======