{"id":20730164,"url":"https://github.com/maslick/telega","last_synced_at":"2026-04-13T14:32:28.149Z","repository":{"id":50499954,"uuid":"223435493","full_name":"maslick/telega","owner":"maslick","description":"HTTP proxy for sending messages to Telegram group chats","archived":false,"fork":false,"pushed_at":"2019-12-17T11:12:20.000Z","size":86,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T18:49:42.741Z","etag":null,"topics":["ci","docker","go","heroku","jenkins","k8s","proxy","roskomnadzor","telegram","telegram-api","tls"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maslick.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-22T15:46:55.000Z","updated_at":"2024-06-13T01:08:14.000Z","dependencies_parsed_at":"2022-09-13T07:02:06.680Z","dependency_job_id":null,"html_url":"https://github.com/maslick/telega","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maslick/telega","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maslick%2Ftelega","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maslick%2Ftelega/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maslick%2Ftelega/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maslick%2Ftelega/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maslick","download_url":"https://codeload.github.com/maslick/telega/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maslick%2Ftelega/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31757477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T13:27:56.013Z","status":"ssl_error","status_checked_at":"2026-04-13T13:21:23.512Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ci","docker","go","heroku","jenkins","k8s","proxy","roskomnadzor","telegram","telegram-api","tls"],"created_at":"2024-11-17T05:10:06.676Z","updated_at":"2026-04-13T14:32:28.122Z","avatar_url":"https://github.com/maslick.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# =telega=\nHTTP proxy for sending messages to Telegram group chats\n\n[![Build Status](https://api.travis-ci.org/maslick/telega.svg)](https://travis-ci.org/maslick/telega)\n[![Dockerhub](https://img.shields.io/badge/image%20size-2MB-blue.svg)](https://hub.docker.com/r/maslick/telega)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\n\n## Motivation\nAs you probably know, ``Telegram`` was blocked by Russian authorities a while ago, meaning one cannot access ``https://api.telegram.org`` from within Russia.\n\n\u003ca href=\"https://en.wikipedia.org/wiki/Telega\"\u003e\u003cimg src=\"logo.jpg\"\u003e\u003c/a\u003e\n\nThe solution is to run a proxy outside of Russia or use VPN. In fact, there are many proxies out [there](https://mtpro.xyz/api/?type=socks) (primarily SOCKS).\nTheir main disadvantage is these proxies come and go, and you simply don't have control over this process. If you need a stable connection, you would eventually run your own server.\n\nThis simple ``HTTP`` proxy can be run on any cloud provider e.g. Heroku (free 🍺). \nIts primary use-case is sending build ``success`` and ``failure`` notifications from CI (e.g. Jenkins) to a group chat. It can also send messages to individual users. Just that, no more no less 👌.\n\n## Features\n* Written in Go :heart:\n* Lightweight static binary: ~2.3 MB zipped\n* Cloud-native friendly: Docker + k8s\n* Secure: Basic authentication (optional)\n\n## How it works\nYou simply run ``telega`` server with two env. variables: ``$BOT_TOKEN`` and ``$CHAT_ID``. \n\nYou get the ``BOT_TOKEN`` while creating your bot via ``@BotFather``.\n``CHAT_ID`` is the id of the group (or user) you want to send messages to. \n\nAfter this, fire a ``POST`` request to ``/send`` and provide a simple json:\n```json\n{ \"text\":  \"Hello world!!!\" }\n```\n\n## Installation\n```zsh\n$ go test\n$ go build -ldflags=\"-s -w\"\n\n$ go build -ldflags=\"-s -w\" \u0026\u0026 upx telega\n```\n\n## Usage\n* Without authentication:\n```zsh\n$ export BOT_TOKEN=1234567890abcdef\n$ export CHAT_ID=-12345\n$ ./telega\nStarting server on port 8080 ...\n\n$ curl -s -X POST localhost:8080/send --data \"{\\\"text\\\": \\\"Hello world\\\"}\"\n$ http POST :8080/send \u003c\u003c\u003c '{\"text\": \"Hi folks!\"}'\n$ wget -q -O- --post-data=\"{\\\"text\\\":\\\"Yo, guys\\\"}\" localhost:8080/send\n```\n\n* With Basic authentication:\n```zsh\n$ export BOT_TOKEN=1234567890abcdef\n$ export CHAT_ID=-12345\n$ export USERNAME=maslick\n$ export PASSWORD=12345\n$ export PORT=4000\n$ ./telega\nStarting server on port 4000 ...\n\n$ curl -s -H \"Authorization: Basic bWFzbGljazoxMjM0NQ==\" -X POST localhost:4000/send --data \"{\\\"text\\\": \\\"Hello world\\\"}\"\n$ http -a maslick:12345 POST  :4000/send \u003c\u003c\u003c '{\"text\": \"Hi folks!\"}'\n$ wget --header=\"Authorization: Basic bWFzbGljazoxMjM0NQ==\" -q -O- --post-data=\"{\\\"text\\\":\\\"Yo, guys\\\"}\" localhost:4000/send\n```\n\n## Docker\n```zsh\n$ docker build -t maslick/telega .\n$ docker run -d \\\n   -e BOT_TOKEN=1234567890abcdef \\\n   -e CHAT_ID=-12345 \\\n   -p 8081:8080 \\\n   maslick/telega\n\n$ docker run -d \\\n   -e BOT_TOKEN=1234567890abcdef \\\n   -e CHAT_ID=-12345 \\\n   -e USERNAME=maslick \\\n   -e PASSWORD=12345 \\\n   -p 8082:8080 \\\n   maslick/telega\n\n$ http POST `docker-machine ip default`:8081/send \u003c\u003c\u003c '{\"text\": \"Hi folks!\"}'\n$ http -a maslick:12345 POST `docker-machine ip default`:8082/send \u003c\u003c\u003c '{\"text\": \"Hi folks!\"}'\n```\n\n## Kubernetes\n```zsh\n$ kubectl apply -f k8s\n$ kubectl set env deploy telega \\\n   BOT_TOKEN=1234567890abcdef \\\n   CHAT_ID=-12345 \\\n   USERNAME=maslick \\\n   PASSWORD=12345\n```\n\n## Heroku\n```zsh\n$ git clone https://github.com/maslick/telega.git\n$ cd telega\n\n$ export HEROKU_APP_NAME=hello-world-app\n$ heroku login\n$ heroku create $HEROKU_APP_NAME\n$ git push heroku master\n$ heroku config:set BOT_TOKEN=$BOT_TOKEN\n$ heroku config:set CHAT_ID=$CHAT_ID\n$ heroku config:set USERNAME=$USERNAME\n$ heroku config:set PASSWORD=$PASSWORD\n$ open https://$HEROKU_APP_NAME.herokuapp.com/health\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaslick%2Ftelega","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaslick%2Ftelega","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaslick%2Ftelega/lists"}