3
0
mirror of https://github.com/42wim/matterbridge.git synced 2024-12-22 19:22:38 +01:00
matterbridge/vendor/github.com/go-telegram-bot-api/telegram-bot-api
2018-08-06 21:47:05 +02:00
..
.gitignore Use mod vendor for vendored directory (backwards compatible) 2018-08-06 21:47:05 +02:00
.travis.yml Use mod vendor for vendored directory (backwards compatible) 2018-08-06 21:47:05 +02:00
bot.go Update vendor go-telegram-bot-api/telegram-bot-api 2018-05-09 22:46:10 +02:00
configs.go Update vendor go-telegram-bot-api/telegram-bot-api 2018-05-09 22:46:10 +02:00
helpers.go Update vendor go-telegram-bot-api/telegram-bot-api 2018-05-09 22:46:10 +02:00
LICENSE.txt Add initial telegram support 2016-11-15 23:15:57 +01:00
README.md Use mod vendor for vendored directory (backwards compatible) 2018-08-06 21:47:05 +02:00
types.go Update vendor go-telegram-bot-api/telegram-bot-api 2018-05-09 22:46:10 +02:00

Golang bindings for the Telegram Bot API

GoDoc Travis

All methods have been added, and all features should be available. If you want a feature that hasnt been added yet or something is broken, open an issue and Ill see what I can do.

All methods are fairly self explanatory, and reading the godoc page should explain everything. If something isnt 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.

Use github.com/go-telegram-bot-api/telegram-bot-api for the latest version, or use gopkg.in/telegram-bot-api.v4 for the stable build.

Join the development group if you want to ask questions or discuss development.

Example

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

package main

import (
    "log"
    "gopkg.in/telegram-bot-api.v4"
)

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 {
            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)
    }
}

If you need to use webhooks (if you wish to run on Google App Engine), you may use a slightly different method.

package main

import (
    "gopkg.in/telegram-bot-api.v4"
    "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)
    }
    info, err := bot.GetWebhookInfo()
    if err != nil {
        log.Fatal(err)
    }
    if info.LastErrorDate != 0 {
        log.Printf("[Telegram callback failed]%s", info.LastErrorMessage)
    }
    updates := bot.ListenForWebhook("/" + bot.Token)
    go http.ListenAndServeTLS("0.0.0.0:8443", "cert.pem", "key.pem", nil)

    for update := range 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 "//O=Org\CN=Test" -nodes

Now that Lets Encrypt has entered public beta, you may wish to generate your free TLS certificate there.