Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

PingRoll

Software to notify user on duty (through google calendar) the messages it receives from webhooks. It uses the Twilio API to send SMS.

Configuration

  • PINGROLL_ICAL_URL (required): Google Calendar iCal URL
  • PINGROLL_RETHINK_URL (required): RethinkDB URL
  • PINGROLL_TWILIO_ACCOUNT_SID (required): Twilio Account SID
  • PINGROLL_TWILIO_AUTH_TOKEN (required): Twilio Auth Token
  • PINGROLL_TWILIO_FROM_NUMBER (required): Twilio From Number
  • PINGROLL_API_KEY (required): PingRoll API key

Usage

Check pingroll.apib for the API blueprint. You register the users who may be on duty with the /api/users API. Then you register the webhook templates with the /api/webhooks API. You create events on your calendar with summary reflecting the name property of the users and pingroll updates its internal database with this calendar every hour. For each webhook you setup, the name is used to generate a unique friendly URL like /webhook/:name.

Every times a webhook receives a request, PingRoll transforms the request content into a map[string]interface{}. Then it applies the related template to this object. For more information about the templating engine see text/template.

Then PingRoll looks in the database who's on duty and who should always receive notification. Finally for each recipient it makes a call to the Twilio API with the executed template as the body.

TODO

  • Protect webhook
  • Multiple notification backend (such as mail and so on)

About

πŸ›Ž PingRoll route notification based on duty

Topics

Resources

License

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.