err-backend-talk

Important

This errbot backend has been deprecated with 0.1.0 as the last release. But since Nextcloud Talk 17.1 native support for bots has been added. The repository will remain open and archived.

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

1. Run the oauth.py script:

   python oauth.py

2. Provide the following data:

   • Nextcloud installation base URL
   • OAUTH KEY (Client ID)
   • OAUTH SECERT (Secret Key)

3. It will open a page in your browser to authorize the OAuth client with the logged in user.

4. 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

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. Submit a pull request :D