Telegram plugin for Kanboard
Clone or download
Pull request Compare This branch is 36 commits ahead, 3 commits behind kanboard:master.

README.md

Telegram plugin for Kanboard

Receive Kanboard notifications on Telegram.

Author

  • Manu Varkey
  • License MIT

Requirements

  • Kanboard >= 1.0.37
  • Telegram bot

Installation

You have the choice between 2 methods:

  1. Download the zip file and decompress everything under the directory plugins/Telegram
  2. Clone this repository into the directory plugins/Telegram

Note: Plugin folder is case-sensitive.

Configuration

Create a Telegram bot by starting a conversation with BotFather

Start a conversation with BotFather and follow the guide to create a Telegram Bot.

Telegram Bot Settings

Go to Settings > Integrations > Telegram and fill the form:

  • Telegram bot username: Username of your Telegram Bot
  • Telegram bot API key: HTTP API token generated by BotFather after bot creation

Receive individual user notifications

  • Go to your user profile and choose Integrations > Telegram
  • Start a conversation with your Telegram Bot
  • Send the unique message as displayed on the page to the chat
  • Click on Get Chat ID and confirm
  • Enable Telegram notifications in your profile: Notifications > Select Telegram

Manual

  • Start a conversation with your Telegram Bot
  • Obtain the chat id of the conversation (Send a message to the bot and visit https://api.telegram.org/bot<YourBOTToken>/getUpdates)
  • Go to your user profile and choose Integrations > Telegram
  • Enter the chat id of the chat
  • Enable Telegram notifications in your profile: Notifications > Select Telegram

Receive project notifications to a chat

  • Go to the project settings and choose Integrations > Telegram
  • Add your Telegram Bot to the project group chat
  • Send the unique message as displayed on the page to the project group chat
  • Click on Get Chat ID and confirm
  • Enable Telegram notifications for your project: Notifications > Select Telegram

Manual

  • Add your Telegram Bot to the project group chat
  • Obtain the chat id of the conversation (Send a message to the group and visit https://api.telegram.org/bot<YourBOTToken>/getUpdates)
  • Go to the project settings and choose Integrations > Telegram
  • Enter the chat id of the group chat
  • Enable Telegram notifications for your project: Notifications > Select Telegram

Troubleshooting

I am getting curl error 60: SSL certificate problem: self signed certificate in certificate chain on Windows

  • Download this CAs database https://curl.haxx.se/ca/cacert.pem to c:/cacert.pem
  • Edit your php.ini and add curl.cainfo="c:/cacert.pem" (it should point to the file you downloaded)