Jenkins : Twilio Notifier Plugin

Plugin Information

View TwilioNotifier on the plugin site for more information.

The Twilio Notifier Plugin is a plugin that can send build status notifications as Text messages and phone calls using Twilio.

Features

  • Send text messages with build notifications
  • Call phones and have build notifications read to the callee
  • Customized messages
  • Send explicit messages to those whose check-ins resulted in build breakage

Installation and configuration of the plugin

  • Download and install the Twilio Notifier plugin from the Plugin Manager within Jenkins.
  • Go to www.twilio.com and sign up for an account AND purchase a phone number
  • Go to Jenkins->Manage Jenkins->Configure System and set the following attributes
    • Account SID - the SID for your Twilio Account can be found on your Twilio account page
    • Auth token - can be found on the same page
    • From phone number - set the phone number you just purchased as the From phone number

Per job configuration

Go to your job configuration page.

  • Select the TwilioNotifier checkbox
  • In the To field, add phonenumbers that always will receive messages
  • In the Message field write the message you want to send. Special variables you can use:
    • %PROJECT% - references the name of the current project
    • %STATUS% - the current status of the project
    • %CULPRITS% - lists the display names of the users who did the check-ins associated with the current build.
  • If you want to send text messages, check the Send Text (SMS) message? checkbox
  • If you want to receive a call and have the message read to you, check the Call? checkbox
  • If you only want to send messages on failures and recovery, check the Only send message on failure or recovery? checkbox
  • If you want to send to the culprits who made the build fail through a check-in, check this box
  • And you can also specify a special Culprit message for the culprits
    • %PROJECT% - references the name of the current project
    • %STATUS% - the current status of the project
    • %CULPRITS% - lists the display names of the users who did the check-ins associated with the current build.
    • %CULPRIT-NAME% - the display name of the culprit that the current message is being sent to.
  • For the text message, you can elect to add the build url by checking the Include the Build URL in the message? checkbox
  • The User list is used to map check-in identifiers (typically user names from a scm system) to phone numbers and display names. The format to use is the following: user-name:phone-number:display-name,user-name2:phone-number2:display-name2