2021-02-09 11:14:42 +03:00
# Messenger
[](https://github.com/retailcrm/messenger/actions)
[](https://codecov.io/gh/retailcrm/messenger)
[](https://github.com/retailcrm/messenger/releases)
[](https://goreportcard.com/report/github.com/retailcrm/messenger)
[](https://golang.org/dl/)
[](https://pkg.go.dev/github.com/retailcrm/messenger)
2016-04-13 17:09:28 +10:00
2016-04-13 19:51:28 +10:00
This is a Go library for making bots to be used on Facebook messenger. It is built on the [Messenger Platform ](https://developers.facebook.com/docs/messenger-platform ). One of the main goals of the project is to implement it in an idiomatic and easy to use fashion.
2016-04-13 17:09:28 +10:00
2021-02-09 11:14:42 +03:00
You can find [examples for this library here ](https://github.com/retailcrm/messenger/blob/master/examples/ ).
2019-01-04 20:45:37 +11:00
2016-04-14 20:10:40 +10:00
## Tips
2016-04-15 10:33:50 +10:00
- Follow the [quickstart ](https://developers.facebook.com/docs/messenger-platform/quickstart ) guide for getting everything set up!
2016-04-14 20:10:40 +10:00
- You need a Facebook development app, and a Facebook page in order to build things.
2016-11-27 17:22:11 +08:00
- Use [ngrok ](https://ngrok.com ) to tunnel your locally running bot so that Facebook can reach the webhook.
2016-04-14 20:10:40 +10:00
2016-09-28 19:28:12 +10:00
## Projects
2016-09-28 17:23:56 +08:00
2021-02-09 11:14:42 +03:00
This is a list of projects use `messenger` . If you would like to add your own, submit a [Pull Request ](https://github.com/retailcrm/messenger/pulls/new ) adding it below.
2016-09-28 17:23:56 +08:00
2016-11-05 01:04:39 +01:00
- [meme-maker ](https://github.com/paked/meme-maker ) by @paked: A bot which, given a photo and a caption, will create a macro meme.
2016-09-28 19:28:12 +10:00
- [drone-facebook ](https://github.com/appleboy/drone-facebook ) by @appleboy: [Drone.io ](https://drone.io ) plugin which sends Facebook notifications
