https://github.com/bots-go-framework/bots-api-telegram
Go library for Telegram Messenger Bot API used by https://github.com/bots-go-framework
https://github.com/bots-go-framework/bots-api-telegram
bot bot-api go golang telegram telegram-bot telegram-bot-api
Last synced: 6 days ago
JSON representation
Go library for Telegram Messenger Bot API used by https://github.com/bots-go-framework
- Host: GitHub
- URL: https://github.com/bots-go-framework/bots-api-telegram
- Owner: bots-go-framework
- License: apache-2.0
- Created: 2016-04-30T17:18:32.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2025-12-26T21:47:35.000Z (about 2 months ago)
- Last Synced: 2025-12-28T11:57:42.548Z (about 2 months ago)
- Topics: bot, bot-api, go, golang, telegram, telegram-bot, telegram-bot-api
- Language: Go
- Homepage: https://debtstracker.io/
- Size: 2.14 MB
- Stars: 7
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Golang bindings for the Telegram Bot API
[](https://github.com/bots-go-framework/bots-api-telegram/actions/workflows/ci.yml)
[](https://goreportcard.com/report/github.com/bots-go-framework/bots-api-telegram)
[](http://godoc.org/github.com/bots-go-framework/bots-api-telegram)
All methods have been added, and all features should be available.
If you want a feature that hasn't been added yet or something is broken,
open an issue and I'll see what I can do.
All methods are fairly self explanatory, and reading the godoc page should
explain everything. If something isn't clear, open an issue or submit
a pull request.
The scope of this project is just to provide a wrapper around the API
without any additional features. There are other projects for creating
something with plugins and command handlers without having to design
all that yourself.
Use `github.com/go-telegram-bot-api/telegram-bot-api` for the latest
version, or use `gopkg.in/telegram-bot-api.v1` for the stable build.
## Example
This is a very simple bot that just displays any gotten updates,
then replies it to that chat.
```go
package main
import (
"log"
"gopkg.in/telegram-bot-api.v1"
)
func main() {
bot, err := tgbotapi.NewBotAPI("MyAwesomeBotToken")
if err != nil {
logus.Panic(err)
}
bot.Debug = true
logus.Printf("Authorized on account %s", bot.Self.UserName)
u := tgbotapi.NewUpdate(0)
u.Timeout = 60
updates, err := bot.GetUpdatesChan(u)
for update := range updates {
logus.Printf("[%s] %s", update.Message.From.UserName, update.Message.Text)
msg := tgbotapi.NewMessage(update.Message.Chat.ID, update.Message.Text)
msg.ReplyToMessageID = update.Message.MessageID
bot.Send(msg)
}
}
```
If you need to use webhooks (if you wish to run on Google App Engine),
you may use a slightly different method.
```go
package main
import (
"gopkg.in/telegram-bot-api.v1"
"log"
"net/http"
)
func main() {
bot, err := tgbotapi.NewBotAPI("MyAwesomeBotToken")
if err != nil {
logus.Fatal(err)
}
bot.Debug = true
logus.Printf("Authorized on account %s", bot.Self.UserName)
_, err = bot.SetWebhook(tgbotapi.NewWebhookWithCert("https://www.google.com:8443/"+bot.Token, "cert.pem"))
if err != nil {
logus.Fatal(err)
}
updates, _ := bot.ListenForWebhook("/" + bot.Token)
go http.ListenAndServeTLS("0.0.0.0:8443", "cert.pem", "key.pem", nil)
for update := range updates {
logus.Printf("%+v\n", update)
}
}
```
If you need, you may generate a self signed certficate, as this requires
HTTPS / TLS. The above example tells Telegram that this is your
certificate and that it should be trusted, even though it is not
properly signed.
openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 3560 -subj "//O=Org\CN=Test" -nodes
Now that [Let's Encrypt](https://letsencrypt.org) has entered public beta,
you may wish to generate your free TLS certificate there.
## Used by
This package is used in production by:
* https://debtstracker.io/ - an app and [Telegram bot](https://t.me/DebtsTrackerBot) to track your personal debts
## Frameworks that utilise this `strongo/db` package
* [`bots-go-framework`](https://github.com/bots-go-framework) - a framework to build chat bots in Go language.