Skip to content
Integrate Telegram into your workflow – Trello, Gitlab, Bitbucket and other bots
Go Dockerfile
Branch: master
Clone or download

Latest commit


Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci fix circleci tests Jan 23, 2018
cmd add suffix to the example main.go to avoid mislead Jan 19, 2018
modules/feedback Docker, multi-instance approach, modules Dec 29, 2017
.dockerignore make the docker image tiny Jan 23, 2018
Dockerfile Push the dockerfile golang version to 1.11 Mar 29, 2019
Gopkg.lock new webhook ratelimiter Jan 14, 2020
Gopkg.toml new webhook ratelimiter Jan 14, 2020
LICENSE Initial commit Jul 2, 2016 Updated with more docker installation details Feb 23, 2018
bots.go new webhook ratelimiter Jan 14, 2020
bots_test.go mv to Jan 19, 2018
config.go new webhook ratelimiter Jan 14, 2020
context_test.go new webhook ratelimiter Jan 14, 2020
data.go rework OAuthTokenStore Nov 20, 2019
data_test.go fix broken test Feb 10, 2018
docker-compose.yml make the docker image tiny Jan 23, 2018
encode.go Go syntax fixes Jul 10, 2016
handlers.go new webhook ratelimiter Jan 14, 2020
helpers.go improved func name encoding for jobs & reply/callback actions Feb 28, 2018
migrations.go fix oauthstore migration Nov 21, 2019
oauth.go OAuth: do not reset AccessToken when got invalid_grant Nov 21, 2019
oauth_token_store.go oauthstore: return expiredate Nov 21, 2019
richtext.go TG HTML - do not escape & Dec 19, 2016
richtext_test.go some tests fixes Dec 19, 2016
services.go migration: add protected.oauthstore Nov 20, 2019
services_test.go Docker, multi-instance approach, modules Dec 29, 2017
stat.go imprv kicked/stopped flow Feb 10, 2018
templates.go move html templates inside the GO code Jan 25, 2018
tgupdates.go add ClearAllCacheKeys Sep 3, 2019
tgupdates_test.go fix tests Jan 18, 2018
types.go new webhook ratelimiter Jan 14, 2020

Integram 2.0

Framework and platform to integrate services with Telegram using the official Telegram Bot API

ℹ️ Individual integration repos are located at

CircleCI Docker Image GoDoc


How to use Integram in Telegram (using public bots)

Just use these links to add bots to your Telegram

Did not find your favorite service? 🤘 Vote for it

How to host Integram on your own server (using your private bots)

🐳 Docker way

   git clone && cd integram
  • Check the docker-compose.yml file for the required ENV vars for each service
    • E.g. in order to run the Trello integration you will need to export:

      • INTEGRAM_BASE_URL – the base URL where your Integram host will be accessible, e.g.

      • INTEGRAM_PORT – if set to 443 Integram will use ssl.key/ssl.cert at /go/.conf.

        This directory is mounted on your host machine. Just get the path and put these files inside

           ## Get the path of config directory on the host machine
           docker volume inspect -f '{{ .Mountpoint }}' integram_data-mainapp
      • TRELLO_BOT_TOKEN – your bot's token you got from @BotFather

      • You will need to get your own OAuth credentials from Trello

        • TRELLO_OAUTH_ID – API Key
        • TRELLO_OAUTH_SECRET – OAuth Secret
    • For more detailed info about other services you should check the corresponding repo at

  • Export the variables you identified in the previous step, for instance on linux this should be something like:
   export INTEGRAM_PORT=xxxx
   export ...
  • Now you can run the services (linux: careful if you need to sudo this, the exports you just did will not be available) :
   docker-compose -p integram up trello gitlab ## Here you specify the services you want to run
  • Or in background mode (add -d):
   docker-compose -p integram up -d trello gitlab
  • You should now see Integram's startup logs in your console
  • In Telegram, you can now start your bots (/start) and follow their directions, configure them using /settings
  • Some useful commands:
   ## Check the containers status
   docker ps
   ## Fetch logs for main container
   docker logs -f $(docker ps -aqf "name=integram_integram")   
  • To update Integram to the latest version:
    ## Fetch last version of images
    docker-compose pull integram trello gitlab
    ## Restart containers using the new images
    docker-compose -p integram up -d trello gitlab

🛠 Old-school way (No docker)

    ## set the GOPATH to the absolute path of directory containing 'src' directory that you have created before
    export GOPATH=/var/integram
    cd $GOPATH/src/integram
    ## install dependencies
    dep init
    go build integram && ./integram


Dependencies are specified in Gopkg.toml and fetched using Go dep


Feel free to send PRs. If you want to contribute new service integrations, please create an issue first. Just to make sure someone is not already working on it.

Libraries used in Integram


Code licensed under GPLV3 license


You can’t perform that action at this time.