botsframework

README

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

• Alexander Trakhimenok

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