telegram-bot-api/README.md

49 lines
1.4 KiB
Markdown
Raw Normal View History

# Golang bindings for the Telegram Bot API
2015-06-25 07:40:42 +02:00
[![GoDoc](https://godoc.org/github.com/Syfaro/telegram-bot-api?status.svg)](http://godoc.org/github.com/Syfaro/telegram-bot-api)
2015-06-26 08:20:29 +02:00
2015-06-26 05:49:24 +02:00
All methods have been added, and all features should be available.
2015-06-26 08:22:36 +02:00
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.
2015-06-26 09:18:55 +02:00
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.
2015-06-26 09:18:55 +02:00
## Example
This is a very simple bot that just displays any gotten updates, then replies it to that chat.
```go
package main
import (
"log"
2015-06-27 04:46:06 +02:00
"github.com/Syfaro/telegram-bot-api"
2015-06-26 09:18:55 +02:00
)
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)
}
}
```