Awesome Open Source
Awesome Open Source
notify logo

GitHub tag (latest SemVer) Go Report Card Codacy Badge Maintainability FOSSA Status go.dev reference

A dead simple Go library for sending notifications to various messaging services.

About

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.

Disclaimer

Any misuse of this library is your own liability and responsibility and cannot be attributed to the authors of this library. See license for more.

Spamming through the use of this library may get you permanently banned on most supported platforms.

Install

go get -u github.com/nikoksr/notify

Example usage

// Create a telegram service. Ignoring error for demo simplicity.
telegramService, _ := telegram.New("your_telegram_api_token")

// Passing a telegram chat id as receiver for our messages.
// Basically where should our message be sent?
telegramService.AddReceivers(-1234567890)

// Create our notifications distributor.
notifier := notify.New()

// 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.
// Inspired by http middlewares used in higher level libraries.
notifier.UseServices(telegramService)

// Send a test message.
_ = notifier.Send(
	context.Background(),
	"Subject/Title",
	"The actual message - Hello, you awesome gophers! :)",
)

Supported services

Please create feature requests for missing services (see #3 for example)

  • Amazon SES
  • Discord
  • Email
  • Line
  • Mailgun
  • Microsoft Teams
  • Plivo
  • Pushbullet
  • RocketChat
  • SendGrid
  • Slack
  • Telegram
  • TextMagic
  • Twitter
  • WeChat
  • WhatsApp

Credits

Author

Niko Kser

Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. You can also take a look at the contributing guide.

Show your support

Give a if you like this project!

License

FOSSA Status


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Go (195,642
Golang (32,616
Discord (10,262
Telegram (4,540
Twitter (3,905
Slack (2,941
Notifications (2,672
Email (2,575
Wechat (1,890
Messaging (1,218
Whatsapp (999
Line (521
Sendgrid (335
Mailgun (186
Microsoft Teams (174
Rocketchat (162
Aws Ses (127
Related Projects