Golang bindings for the Telegram Bot API
Go to file
Syfaro 6b71d4dd94
Merge pull request #202 from go-telegram-bot-api/develop
Deduplicate code, improve response accuracy.
2021-11-08 14:29:42 -05:00
.github/workflows Update Go version, fix duplicate runs. 2020-11-05 13:48:39 -05:00
docs Update more docs. 2021-08-20 16:23:38 -04:00
tests Added VideoNote support 2017-05-22 02:34:12 +04:30
.gitignore Initial work on improving docs. 2020-07-26 17:22:16 -05:00
LICENSE.txt add license 2015-06-26 21:53:55 -05:00
README.md Merge branch 'master' into develop 2020-11-05 23:29:48 -05:00
book.toml Initial work on improving docs. 2020-07-26 17:22:16 -05:00
bot.go Merge branch 'develop' into files 2021-08-20 16:11:25 -04:00
bot_test.go Merge branch 'develop' into files 2021-08-20 16:11:25 -04:00
configs.go Merge pull request #469 from go-telegram-bot-api/files 2021-11-08 14:26:17 -05:00
go.mod Add support for uploading multiple files. 2020-07-25 19:29:40 -05:00
go.sum Add support for uploading multiple files. 2020-07-25 19:29:40 -05:00
helpers.go Create interface for file data. 2021-08-20 15:31:52 -04:00
helpers_test.go Create interface for file data. 2021-08-20 15:31:52 -04:00
log.go A number of small improvements. 2018-10-08 02:25:09 -05:00
params.go Updates for Bot API 4.4 and 4.5. 2020-01-06 01:44:13 -06:00
params_test.go Updates for Bot API 4.4 and 4.5. 2020-01-06 01:44:13 -06:00
passport.go Updates for Bot API 4.4 and 4.5. 2020-01-06 01:44:13 -06:00
types.go Merge pull request #469 from go-telegram-bot-api/files 2021-11-08 14:26:17 -05:00
types_test.go Create interface for file data. 2021-08-20 15:31:52 -04:00

README.md

Golang bindings for the Telegram Bot API

GoDoc Travis

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.

Join the development group if you want to ask questions or discuss development.

Example

First, ensure the library is installed and up to date by running go get -u github.com/go-telegram-bot-api/telegram-bot-api.

This is a very simple bot that just displays any gotten updates, then replies it to that chat.

package main

import (
	"log"

	"github.com/go-telegram-bot-api/telegram-bot-api"
)

func main() {
	bot, err := tgbotapi.NewBotAPI("MyAwesomeBotToken")
	if err != nil {
		log.Panic(err)
	}

	bot.Debug = true

	log.Printf("Authorized on account %s", bot.Self.UserName)

	u := tgbotapi.NewUpdate(0)
	u.Timeout = 60

	updates, err := bot.GetUpdatesChan(u)

	for update := range updates {
		if update.Message == nil { // ignore any non-Message Updates
			continue
		}

		log.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)
	}
}

There are more examples on the site with detailed information on how to do many different kinds of things. It's a great place to get started on using keyboards, commands, or other kinds of reply markup.