Forge Home


Custom report handler to send notifications to Skype, Slack and Telegram


9,745 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.0.0 (latest)
released Dec 18th 2017
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • , , , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'slenky-notifier', '1.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add slenky-notifier
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install slenky-notifier --version 1.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



slenky/notifier — version 1.0.0 Dec 18th 2017

Puppet-Notifier module

Table of Contents

  1. Description
  2. Setup - The basics of getting started with notifier
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module


This module allows you to send managed Puppet reports into Skype, Slack and Telegram about status changes on your infrastructure on every Puppet run. Reports would be sent for you if the status equals changed or failed. Integration with PuppetBoard included!



It is vital to install this module into core modules folder of your Puppetserver (i.e /etc/puppetlabs/code/modules)!


  1. Create the Skype bot at BotFramework. Catch the Application ID and Application secret values.
  2. Create conversation in Skype, add bot and write '/get name' in IM to gather chat ID.


You just need to add new webhook for your team here. No additional modifications required. Webhook would be in format


  1. Find the @BotFather contact
  2. Write /newbot and pass through multiple questions.
  3. Get the access token from the answer.
  4. Add your new bot into channel and write something like @YOURBOT hello
  5. Open<ACCESS_TOKEN>/getUpdates and find the chat id variable.


Simply add the class of the service you want to use into your manifest within Puppetserver node:

node 'puppetserver' {

  $puppetboard_link = ''
  class { 'notifier::skyper':
    chat_id => '',
    client_id => 'someclientid',
    puppetboard => $puppetboard_link,
    client_secret => 'someclientsecret'
  class { 'notifier::slacker':
    hook_url => '',
    username => 'Puppet Notifier',
    channel  => '#puppet-test',
    puppetboard => $puppetboard_link,
    icon_url => ''
  class { 'notifier::telegramer':
    token => 'your_bot_token',
    chat_id => 'chat_id_from_api',
    send_stickers  => 'true',
    puppetboard => $puppetboard_link




chat_id - your conversation ID from '/get name' command client_id - Application ID from BotFramework client_secret - Application Secret puppetboard - Link to your Puppetboard


hook_url - your Incoming Webhook URL channel - where to send reports username - bot name which send reports icon_url - small image which stands for bot avatar


token - access key from BotFather chat_id - conversation ID from API send_stickers - should your bot send telegram stickers with report based on his status or not. Remove this attribute to disable.


This module was tested on Puppet 5.2.0 with latest Puppetserver 5.1.4.


Feel free to create issues, PR and so on :)