You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
Syfaro ffe77fb717 Updates for Bot API 4.3. 6 years ago
tests Added VideoNote support 8 years ago
.gitignore Passport Updates (#1) 7 years ago
.travis.yml Remove go1.4 from travis configuration 7 years ago
LICENSE.txt add license 10 years ago
README.md Fix bot_test.go, update README. 7 years ago
bot.go Add support for Polls and other API 4.2 updates. 6 years ago
bot_test.go Add support for Polls and other API 4.2 updates. 6 years ago
configs.go Add support for Polls and other API 4.2 updates. 6 years ago
go.mod Add go mod files. 7 years ago
go.sum Add go mod files. 7 years ago
helpers.go Add support for Polls and other API 4.2 updates. 6 years ago
helpers_test.go Move tests into tgbotapi package. 7 years ago
log.go A number of small improvements. 7 years ago
params.go Unify params and values, introduce helpers to deal with fields. 7 years ago
passport.go Unify params and values, introduce helpers to deal with fields. 7 years ago
types.go Updates for Bot API 4.3. 6 years ago
types_test.go Move tests into tgbotapi package. 7 years ago

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.