Skip to content

manuvarkey/kanboard-plugin-telegram

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code
This branch is 48 commits ahead, 4 commits behind kanboard:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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)

About

Telegram plugin for Kanboard

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 99.7%
  • Makefile 0.3%