bots-fw
bots-fw copied to clipboard
Golang framework to build multilingual bots for messengers (Telegram, FB Messenger, Skype, Line, Kik, WeChat) hosted on AppEngine, Amazon, Azure, Heroku or standalone
Strongo Bots Framework
A Go language framework to develop bots for messengers.
Reasons to use:
- Same code can work across different messenger (Telegram, Facebook Messenger, Viber, Skype, Line, Kik, WeChat, etc.)
- You can tune your code to a specific messenger's APIs.
- i18n & l10n support (multilingual)
- Can be hosted in cloud or just as a standard Go HTTP server. Supports AppEngine standard environment.
- It's fast
Conitious Integration
Usage
func InitBot(httpRouter *httprouter.Router, botHost bots.BotHost, appContext common.DebtsTrackerAppContext) {
driver := bots.NewBotDriver( // Orchestrate requests to appropriate handlers
bots.AnalyticsSettings{GaTrackingID: common.GA_TRACKING_ID}, // TODO: Refactor to list of analytics providers
appContext, // Holds User entity kind name, translator, etc.
botHost, // Defines how to create context.Context, HttpClient, DB, etc...
"Please report any issues to @DebtsTrackerGroup", // Is it wrong place? Router has similar.
)
driver.RegisterWebhookHandlers(httpRouter, "/bot",
telegram.NewTelegramWebhookHandler(
telegramBotsWithRouter, // Maps of bots by code, language, token, etc...
newTranslator, // Creates translator that gets a context.Context (for logging purpose)
),
viber.NewViberWebhookHandler(
viber.Bots,
newTranslator,
),
fbm.NewFbmWebhookHandler(
fbm.Bots,
newTranslator,
),
)
}
Sample bots built with Strongo Bots Framework
The best way to learn is to see examples of usage. Here is few:
- Reversi game - open source game. (Telegram: @ReversiGameBot)
- Bidding Tic-Tac-Toe - open source game. (Telegram: @BiddingTicTacToeBot)
- Rock-Paper-Scissors - open source game. (Telegram: @playRockPaperScissorsBot)
- Debtus.app — a bot & a reminder service that helps to track your debts & credits. Sends automated reminders to you & your debtors (in messenger, email, SMS).
We would be happy to place a link to your example / bot that is implemented using this framework.
Go API libraries used by the framework to talk to messengers
You can use any Bot API library by implementing couple of simple interface but the framework comes with few buildins:
- strongo/bots-api-telegram - Go library for Telegram Bot API
- strongo/bots-api-fbm - Go library for Facebook Messenger Bot API
- strongo/bots-api-viber - Go library for Viber Bot API
Other Go libraries used by the bot framework
- strongo/db - Database abstraction layer (DAL) in Go language
- strongo/gamp - Golang buffered client for Google Analytics (GA) Measurement Protocol
- julienschmidt/httprouter - A high performance HTTP request router that scales well
- pkg/errors - Simple error handling primitives
Can I use — features cross-table for bot messenger APIs
We are building a cross-table of features supported by different bot APIs.
Contributors
Press
There are no articles about the Strongo Bots Framework just yet. Send us a link if you find such.
License
Licensed under Apache 2.0 license