README
¶
Microsoft Bot Framework SDK for Go
This repository is the Go version of the Microsoft Bot Framework SDK. It facilitates developers to build bot applications using the Go language.
Installing
$ go get -u dev.azure.com/fmonod/Bot-Builder/_git/msbotbuilder-go/...
Get started with example
The samples contains a sample bot created using this library which echoes any message received.
Before running this, two environment variables are needed viz. the Bot Framework application ID and the password. This can be received after registration of a new bot.
$ export APP_ID=MICROSOFT_APP_ID
$ export APP_PASSWORD=MICROSOFT_APP_PASSWORD
Then, from the root of this repository,
$ cd samples/echobot
$ go run main.go
This starts a webserver on port 3978 by default.
This is the endpoint which the connector service for the registered bot should point to. For a descriptive understanding of the example refer the sample.
Contributing
We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:
- Reporting a bug
- Discussing the current state of the code
- Submitting a fix
- Proposing new features
Credits
This project is highly inspired from the official Microsoft Bot Framework SDK - https://github.com/microsoft/botbuilder-python.
We have borrowed most of the design principles from the official Python SDKs.
Directories
¶
| Path | Synopsis |
|---|---|
|
connector
|
|
|
auth
Package auth provides authentication properties and functionalities for the connector service.
|
Package auth provides authentication properties and functionalities for the connector service. |
|
client
Package client provides a HTTP client for calls to the connector service.
|
Package client provides a HTTP client for calls to the connector service. |
|
Package core is the entry point and the main interface for a user program.
|
Package core is the entry point and the main interface for a user program. |
|
activity
Package activity acts as a handler for any received activity and the user defined operation on that activity.
|
Package activity acts as a handler for any received activity and the user defined operation on that activity. |
|
samples
|
|
|
echobot
Bot Framework echo bot sample.
|
Bot Framework echo bot sample. |
|
Package schema defines all the model classes used in the library
|
Package schema defines all the model classes used in the library |