achterberg / slack-notify

Indigo plugin for Slack

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Summary

This plugin extends Indigo allowing it to send messages to Slack, optionally with attachments and file upload.

Requirements

  • Indigo 6 or later (pro version only)
  • A Slack Team is required. Register for an account at Slack and set up a team
  • Optional: Create a Slack channel to be used for Slack Notify (recommended), or use one of the defaults

Installation

  • Download the ZIP file (look over there --->)
  • Unzip the file if it doesn't automatically unzip
  • On the computer running Indigo, double-click the file "Slack.indigoPlugin"
  • Follow the Indigo dialog and enable the plugin
  • The plugin should be visible in the Plugins drop-down menu as "Slack Notify"
  • Trouble?: Indigo help for the installation process

Configuration

###Configure Plugin In the menu: Indigo 6/Plugins/Slack Notify/Configure...

####WebHook Token

  • Set up an incoming webhook integration by reading and following the link on: https://api.slack.com/incoming-webhooks
  • An URL should be generated and after services/ the series of numbers/letters is the token
  • Enter the above in the WebHook Token field

####Slack Token

  • Go here
  • Under Authentication there should be a team Token
  • Enter the above in the Slack Token field

####User ID

###Configure Notifications

  • The plugin will show under Type: Notification Actions under Actions as Slack Notify.
  • Once added to a TRIGGER, SCHEDULE or ACTION GROUPS, click on Edit Action Settings...
  • ... wait a second or two ... or three
  • The Channel drop down menu should be auto populated with channels in your team; select one.
  • Alternately send a Direct Message by entering text in the Direct Message field.
  • Enter the message text in the Text field, following the formatting hints listed below the field. Formatting for Indigo and Slack is outlined.
  • Optional: Enter a username to be posted as. If blank, the plugin will use your username and post as a bot.
  • Optional: Enter a name of an emoji to be posted with the message. Or use Custom Emoji. If nothing is entered the default is a Slack emoji.
  • Optional: Enter the URL to a publically sharable URL for an image file that will be displayed inside a message attachment. Slack currently supports the following formats: GIF, JPEG, PNG, and BMP.
  • Optional: Enter the file path to a local file to upload to Slack.

Back-end info

  • The plugin uses the Slack incoming webhook integration API.
  • The plugin will attempt to get your user information from Slack to fill in the channels available in your team and to retrieve your username. Turning on debugging mode will expose your Slack user credentials (including ID, username, user icon, user color, real name, status and email address) in the Indigo log.
  • The plugin will attempt to get your gravatar using your Slack email address if a Slack icon does not exist.

Dependencies

Indigo plugins (the IOM and SDK) use Python 2.5

Plugin ID

To programmatically restart the plugin, the Plugin ID is: com.bot.indigoplugin.slack

Uninstall

Remove “/Library/Application Support/Perceptive Automation/Indigo 6/Plugins/Slack.indigoPlugin” (or check in the Disabled Plugins folder if disabled) and restart the Indigo Server

GitHub Gist

For a simple python script version: indigotoslack

About

Indigo plugin for Slack

License:The Unlicense


Languages

Language:Python 100.0%