https://github.com/rancoud/rfacebookbot
Bot For Facebook
https://github.com/rancoud/rfacebookbot
Last synced: 11 months ago
JSON representation
Bot For Facebook
- Host: GitHub
- URL: https://github.com/rancoud/rfacebookbot
- Owner: rancoud
- License: mit
- Created: 2015-12-05T21:40:31.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2022-03-08T08:33:58.000Z (almost 4 years ago)
- Last Synced: 2025-02-26T19:44:31.636Z (11 months ago)
- Language: JavaScript
- Size: 16.6 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# RFacebookBot
Bot for Facebook
## Setup
1. Create Facebook application
2. Rename conf.facebook.app.sample.js to conf.facebook.app.js
3. Fill the file with **name** , **app_id** , **app_secret** (**callback_url** is for user authentification)
4. Create your job in folder jobs
## Example
Once your facebook application created you can run job.
```
node job example
```
## How to write job
1. Create a file in jobs folder, the filename is the job name
2. In job get a Facebook app by using ```getFacebookApp(name, endpoints)```
* if you provide no arguments the first Facebook app is returned
* name (string or undefined - optionnal) : using a specific Facebook app
* endpoints (array - optionnal) : return an available Facebook app which can use thoses endpoints (rate limit)
## PID watcher and killer
Jobs'list running (pid + job + options)
```
node pid
```
Kill a job
```
node pid kill {pidId}
```
Kill all jobs
```
node pid kill all
```
## JOBS
* example -> do nothing
## Facebook User Authentification
Getting access token for external user with an app.
```
node save_oauth "myapp"
```
*(if app name argument is not provided the first one in conf is picked)*
A server will be up at 127.0.0.1 on port 3000.
When callback is done a file is created in oauth_access_cache like this: screen_name.tok
It will contain the app name, access token and access token secret.
## Optionnal arguments
```
// user to use (require getting access token)
-u OR --user "myuser"
// facebook app to use
-a OR --app "myapp"
// file to upload
-f OR --file "/path/to/file"
```
**for user argument use in lower case the screen name of the account**
## Documentation Facebook API
List of endpoints (GET and POST)
```
node doc
```
List of endpoints (GET only)
```
node doc get
```
List of endpoints (POST only)
```
node doc post
```
Endpoint details
```
node doc "statuses/home_timeline"
```
List of parameters
```
node doc parameters
```
Test endpoint (GET and POST)
```
node doc test "statuses/home_timeline"
```
## TODO
* complete
## Nota Bene