Golang bindings for the Telegram Bot API
Go to file
Syfaro 6b9324ca39 helper method to generate a link for a file 2015-09-19 10:53:32 -05:00
tgutils fix docs in encodeaudio, remove log 2015-08-10 15:58:15 -05:00
LICENSE.txt add license 2015-06-26 21:53:55 -05:00
README.md Merge pull request #23 from gobwas/patch-1 2015-09-14 07:45:18 -05:00
bot.go allow passing a []byte or io.Reader to upload functions, closes #20 2015-09-07 11:20:43 -05:00
bot_test.go remove unneeded line in test 2015-07-29 05:42:45 -04:00
helpers.go fixed setting webhooks with a certificate 2015-09-07 12:47:31 -05:00
methods.go new getFile and File types from Telegram Bot API update 2015-09-19 10:46:20 -05:00
types.go helper method to generate a link for a file 2015-09-19 10:53:32 -05:00
updates.go don't panic for failed updates, even in debug (fixes #14) 2015-08-09 21:12:15 -05:00
webhook.go Move to simple pattern 2015-09-14 12:50:41 +03:00

README.md

Golang bindings for the Telegram Bot API

GoDoc

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.

Example

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

package main

import (
	"log"
	"github.com/Syfaro/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

	err = bot.UpdatesChan(u)
	if err != nil {
		log.Panic(err)
	}

	for update := range bot.Updates {
		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.SendMessage(msg)
	}
}

If you need to use webhooks for some reason (such as running on Google App Engine), you may use a slightly different method.

package main

import (
	"github.com/Syfaro/telegram-bot-api"
	"log"
	"net/http"
)

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

	bot.Debug = true

	log.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 {
		log.Fatal(err)
	}

	bot.ListenForWebhook("/"+bot.Token)
	go http.ListenAndServeTLS("0.0.0.0:8443", "cert.pem", "key.pem", nil)

	for update := range bot.Updates {
		log.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 -nodes