Skip to content

Slack integration

mcarlosro edited this page May 24, 2015 · 3 revisions

Slack is a wonderful team collaboration tool. One of the best things about Slack is the integrations with other systems that are possible. Below are instructions for adding a plugin to Slack which enables you to send commands and updates to openHAB items, as well as querying current state.

Follow the instructions here to install the Slack RTM bot. You will need to create a new Real-Time Messaging integration in your Slack account and copy the generated API token into the python-rtmbot config file.

Then copy the slackhab.py script to the python-rtmbot/plugins folder and update the values at the top of the script;

openhab_url      = 'http://127.0.0.1:8080'
slackhab_user_id = "UXXXXXXXX"

Where slackhab_user_id is the internal user ID for the slackhab bot. The easiest way to get this user_id is to add some debugging to the slackhab plugin. Although there may be a way to find it via the Slack UI.

Once everything is configured and you start the python-rtmbot script you should see the slackhab bot turn green in your Slack UI. You can then either send direct messages (DMs) to the bot or mention the bot in any Slack channel, e.g. @slackhab send CoffeeMachine ON.

The following commands are supported;

* send <item> <command>
* update <item> <state>
* items [<filter>]

Examples;

@slackhab items temp

GroupItem      SensorTemperature       Undefined
NumberItem     Sensor_Temperature1     18.6
NumberItem     Sensor_Temperature2     19.6
NumberItem     Sensor_HallwayTemp      20.1
NumberItem     Sensor_EnsuiteTemp      20.2
NumberItem     Weather_TempOut         11
NumberItem     Sensor_GarageTemp       14.12
NumberItem     Heating_DaikinTemp      23

@slackhab send CoffeeMachine ON

Sent ON command to CoffeeMachine

@slackhab send NonExistingItem TEST

404: Not Found

feature overview

Installation

Setup intro

Linux and OS X

Windows

FreeBSD


Configuration

Automation*

User Interfaces

Persistence


Community

(link to openHAB forum)

Development


Bindings


Application Integration

Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules

Scripts

Syntax highlighting for external editors


Release Notes

Clone this wiki locally
You can’t perform that action at this time.