You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
llya Kowalewski ab25fcf6fa Merge pull request #22 from shoonoise/master
Fix README example (send options)
9 years ago
.gitignore Initial commit 9 years ago
.travis.yml Merging #20 into tucnak:master from aladine:patch-3 9 years ago
LICENSE Initial commit 9 years ago
README.md Fix README example 9 years ago
api.go Getting rid of excessive error types, switching to fmt.Errorf 9 years ago
bot.go Fixing #21 issue, introducing Recipient interface 9 years ago
file.go Getting rid of excessive error types, switching to fmt.Errorf 9 years ago
message.go Fixing #21 issue, introducing Recipient interface 9 years ago
options.go Typo fix in ReplyMarkup structure 9 years ago
telebot.go Chat actions implemented 9 years ago
telebot_test.go Fixing #21 issue, introducing Recipient interface 9 years ago
types.go Fixing #21 issue, introducing Recipient interface 9 years ago

README.md

Telebot

Telebot is a convenient wrapper to Telegram Bots API, written in Golang.

GoDoc Travis

Bots are special Telegram accounts designed to handle messages automatically. Users can interact with bots by sending them command messages in private or group chats. These accounts serve as an interface for code running somewhere on your server.

Telebot offers a convenient wrapper to Bots API, so you shouldn't even care about networking at all. Here is an example "helloworld" bot, written with telebot:

import (
    "time"
    "github.com/tucnak/telebot"
)

func main() {
    bot, err := telebot.NewBot("SECRET TOKEN")
    if err != nil {
        return
    }

    messages := make(chan telebot.Message)
    bot.Listen(messages, 1*time.Second)

    for message := range messages {
        if message.Text == "/hi" {
            bot.SendMessage(message.Chat,
                "Hello, "+message.Sender.FirstName+"!", nil)
        }
    }
}

You can also send any kind of resources from file system easily:

boom, err := telebot.NewFile("boom.ogg")
if err != nil {
    return err
}

audio := telebot.Audio{File: boom}

// Next time you send &audio, telebot won't issue
// an upload, but would re-use existing file.
err = bot.SendAudio(recipient, &audio, nil)

Sometimes you might want to send a little bit complicated messages, with some optional parameters:

// Send a selective force reply message.
bot.SendMessage(user, "pong", &telebot.SendOptions{
        ReplyMarkup: telebot.ReplyMarkup{
            ForceReply: true,
            Selective: true,
        },
    },
)