Golang bindings for the Telegram Bot API
Go to file
Raul Santos 2483f04397 Separate NewBotAPI from NewBotAPIwithClient 2015-07-28 13:00:31 +02:00
LICENSE.txt add license 2015-06-26 21:53:55 -05:00
README.md clarify scope of project in readme, update godoc link 2015-06-29 22:55:58 -05:00
bot.go Separate NewBotAPI from NewBotAPIwithClient 2015-07-28 13:00:31 +02:00
helpers.go fix all golint errors, add info about audio uploads 2015-06-26 01:53:20 -05:00
methods.go Few bug fixes 2015-07-27 00:22:10 +02:00
types.go Fix parameter name 2015-07-22 19:10:27 +03:00
updates.go slight code improvments, better language 2015-06-29 22:44:12 -05:00

README.md

Golang Telegram bindings for the 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 (including one I am developing myself) 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

	updates, err := bot.UpdatesChan(u)

	for update := range 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)
	}
}