err-backend-talk

This is a backend for Nexcloud Talk for Errbot.

Installation

# Clone the repository in the errbot backend directory (BOT_EXTRA_BACKEND_DIR)
git clone https://github.com/lsgalves/err-backend-talk.git
cd err-backend-talk
pip install -r requirements.txt

Add to Errbot config.py:

BACKEND = 'Talk'

Authentication

Add OAuth 2.0 Client

Access Nextcloud at /settings/admin/security and create an OAuth 2.0 Client with the following data:

Name: Errbot
Redirect URL: http://localhost:8081/

The redirect URL must point to the host running Errbot (localhost in this example). Save the Client ID and Secret Key.

OAuth Authentication

Run the oauth.py script:
```
python oauth.py
```
Provide the following data:
- Nextcloud installation base URL
- OAUTH KEY (Client ID)
- OAUTH SECERT (Secret Key)
It will open a page in your browser to authorize the OAuth client with the logged in user.

After granting access to the OAuth client, you will be redirected to a screen with the data you must add in your BOT_IDENTITY section of your config.py:

BOT_IDENTITY = {
    'domain': 'http://localhost:8080',
    'oauth_token': 'YOUR-TOKEN',
    'oauth_key': 'YOUR-KEY',
    'oauth_secret': 'YOUR-SECRET',
}

Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request :D