2021-01-26 11:45:14 +02:00
< div align = "center" >
< img
width=40%
src="assets/gopher-letter.svg"
alt="notify logo"
/>
[](https://goreportcard.com/report/github.com/nikoksr/notify)
2021-01-26 11:54:06 +02:00
[](https://www.codacy.com/gh/nikoksr/notify/dashboard?utm_source=github.com& utm_medium=referral& utm_content=nikoksr/notify& utm_campaign=Badge_Grade)
2021-01-26 11:45:14 +02:00
[](https://codeclimate.com/github/nikoksr/notify/maintainability)
[](https://pkg.go.dev/github.com/nikoksr/notify)
< / div >
2021-01-26 12:39:02 +02:00
> <p align="center">A dead simple Go library for sending notifications to various messaging services.</p>
2021-01-26 11:45:14 +02:00
< h1 > < / h1 >
## About <a id="about"></a>
2021-02-12 20:20:07 +02:00
*Notify* was born out of my own need to have my API servers running in production be able to notify me when critical errors occur. Of course, _Notify_ can be used for any other purpose as well. The library is kept as simple as possible for quick integration and ease of use.
2021-01-26 11:45:14 +02:00
## Disclaimer <a id="disclaimer"></a>
Any misuse of this library is your own liability and responsibility and cannot be attributed to the authors of this library. See [license ](LICENSE ) for more.
Spamming through the use of this library **may get you permanently banned** on most supported platforms.
2022-02-13 19:18:03 +02:00
Since Notify is highly dependent on the consistency of the supported external services and the corresponding latest client libraries, we cannot guarantee its reliability nor its consistency, and therefore you should probably not use or rely on Notify in critical scenarios.
2021-01-26 11:45:14 +02:00
## Install <a id="install"></a>
2021-01-25 06:05:59 +02:00
```sh
go get -u github.com/nikoksr/notify
```
2021-01-26 11:45:14 +02:00
## Example usage <a id="usage"></a>
2021-01-25 06:05:59 +02:00
```go
2021-02-12 20:20:07 +02:00
// Create a telegram service. Ignoring error for demo simplicity.
2021-01-25 06:05:59 +02:00
telegramService, _ := telegram.New("your_telegram_api_token")
// Passing a telegram chat id as receiver for our messages.
2021-02-12 20:20:07 +02:00
// Basically where should our message be sent?
telegramService.AddReceivers(-1234567890)
2021-01-25 06:05:59 +02:00
// Tell our notifier to use the telegram service. You can repeat the above process
// for as many services as you like and just tell the notifier to use them.
2021-02-12 20:20:07 +02:00
// Inspired by http middlewares used in higher level libraries.
2022-02-09 15:10:08 +02:00
notify.UseServices(telegramService)
2021-01-25 06:05:59 +02:00
2021-02-12 20:20:07 +02:00
// Send a test message.
2022-02-09 15:10:08 +02:00
_ = notify.Send(
2021-02-18 04:33:30 +02:00
context.Background(),
2021-02-12 20:20:07 +02:00
"Subject/Title",
2021-02-18 04:33:30 +02:00
"The actual message - Hello, you awesome gophers! :)",
2021-01-25 06:05:59 +02:00
)
```
2022-04-22 21:24:34 +02:00
## Contributing <a id="contributing"></a>
Contributions, issues and feature requests are very welcome! Feel free to check [issues page ](https://github.com/nikoksr/notify/issues ). Please also take a look at the [contribution guidelines ](https://github.com/nikoksr/notify/blob/main/CONTRIBUTING.md ).
2021-01-26 12:31:14 +02:00
## Supported services <a id="supported_services"></a>
2022-02-13 19:18:03 +02:00
> Please create feature requests for missing services (see [#3](https://github.com/nikoksr/notify/issues/3) for example)
2022-04-23 16:13:38 +02:00
| Service | Path | Credits |
|--------------------------------------------------------------------------------|------------------------------------------|-------------------------------------------------------------------------------------------------|
| [Amazon SES ](https://aws.amazon.com/ses ) | [service/amazonses ](service/amazonses ) | [aws/aws-sdk-go-v2 ](https://github.com/aws/aws-sdk-go-v2 ) |
| [Amazon SNS ](https://aws.amazon.com/sns ) | [service/amazonsns ](service/amazonsns ) | [aws/aws-sdk-go-v2 ](https://github.com/aws/aws-sdk-go-v2 ) |
| [Bark ](https://apps.apple.com/us/app/bark-customed-notifications/id1403753865 ) | [service/bark ](service/bark ) | - |
| [DingTalk ](https://www.dingtalk.com ) | [service/dinding ](service/dingding ) | [blinkbean/dingtalk ](https://github.com/blinkbean/dingtalk ) |
| [Discord ](https://discord.com ) | [service/discord ](service/discord ) | [bwmarrin/discordgo ](https://github.com/bwmarrin/discordgo ) |
| [Email ](https://wikipedia.org/wiki/Email ) | [service/mail ](service/mail ) | [jordan-wright/email ](https://github.com/jordan-wright/email ) |
| [Line ](https://line.me ) | [service/line ](service/line ) | [line/line-bot-sdk-go ](https://github.com/line/line-bot-sdk-go ) |
| [Line Notify ](https://notify-bot.line.me ) | [service/line ](service/line ) | [utahta/go-linenotify ](https://github.com/utahta/go-linenotify ) |
| [Mailgun ](https://www.mailgun.com ) | [service/mailgun ](service/mailgun ) | [mailgun/mailgun-go ](https://github.com/mailgun/mailgun-go ) |
| [Microsoft Teams ](https://www.microsoft.com/microsoft-teams ) | [service/msteams ](service/msteams ) | [atc0005/go-teams-notify ](https://github.com/atc0005/go-teams-notify ) |
| [Plivo ](https://www.plivo.com ) | [service/plivo ](service/plivo ) | [plivo/plivo-go ](https://github.com/plivo/plivo-go ) |
| [Pushbullet ](https://www.pushbullet.com ) | [service/pushbullet ](service/pushbullet ) | [cschomburg/go-pushbullet ](https://github.com/cschomburg/go-pushbullet ) |
| [RocketChat ](https://rocket.chat ) | [service/rocketchat ](service/rocketchat ) | [RocketChat/Rocket.Chat.Go.SDK ](https://github.com/RocketChat/Rocket.Chat.Go.SDK ) |
| [SendGrid ](https://sendgrid.com ) | [service/sendgrid ](service/sendgrid ) | [sendgrid/sendgrid-go ](https://github.com/sendgrid/sendgrid-go ) |
| [Slack ](https://slack.com ) | [service/slack ](service/slack ) | [slack-go/slack ](https://github.com/slack-go/slack ) |
| [Syslog ](https://wikipedia.org/wiki/Syslog ) | [service/syslog ](service/syslog ) | [log/syslog ](https://pkg.go.dev/log/syslog ) |
| [Telegram ](https://telegram.org ) | [service/telegram ](service/telegram ) | [go-telegram-bot-api/telegram-bot-api ](https://github.com/go-telegram-bot-api/telegram-bot-api ) |
| [TextMagic ](https://www.textmagic.com ) | [service/textmagic ](service/textmagic ) | [textmagic/textmagic-rest-go-v2 ](https://github.com/textmagic/textmagic-rest-go-v2 ) |
| [Twitter ](https://twitter.com ) | [service/twitter ](service/twitter ) | [dghubble/go-twitter ](https://github.com/dghubble/go-twitter ) |
| [WeChat ](https://www.wechat.com ) | [service/wechat ](service/wechat ) | [silenceper/wechat ](https://github.com/silenceper/wechat ) |
| [WhatsApp ](https://www.whatsapp.com ) | [service/whatsapp ](service/whatsapp ) | [Rhymen/go-whatsapp ](https://github.com/Rhymen/go-whatsapp ) |
2022-02-13 19:18:03 +02:00
## Logo <a id="logo"></a>
The [logo ](https://github.com/MariaLetta/free-gophers-pack ) was made by the amazing [MariaLetta ](https://github.com/MariaLetta ).
2021-01-25 06:05:59 +02:00
2022-04-22 21:24:34 +02:00
## Similar projects <a id="similar_projects"></a>
2021-01-25 06:05:59 +02:00
2022-04-22 21:24:34 +02:00
> Just to clarify, Notify was not inspired by any other project. I created it as a tiny subpackage of a larger project and only later decided to make it a standalone project. In this section I just want to mention other great projects.
- [containrrr/shoutrrr ](https://github.com/containrrr/shoutrrr )
- [caronc/apprise ](https://github.com/caronc/apprise )
2021-01-25 06:05:59 +02:00
2021-01-26 11:45:14 +02:00
## Show your support <a id="support"></a>
2021-01-25 06:05:59 +02:00
2021-02-12 20:20:07 +02:00
Give a ⭐️ if you like this project!
