Simple MQTT for Slack
Send messages from Slack to any MQTT server. Everyone in your Slack workspace can send messages to MQTT topics.
Usage
Use /smqtt [command] with the following commands:
-
target add [target] [serverUrl] [topic]
target is the name of the new target
serverUrl is any valid mqtt connection url ([mqtt|ws][s]://[username][:password]@host.domain[:port] )
topic is the topic where the messages should be send to (e.g. 'home/cmd')
- target list
list all available topics
- send [target] [message]
target is any available target created before
message is the string send to the mqtt topic
- target remove [target]
target is the name of the target which should be removed
- help
Get usage instructions
If you're in a hurry you can also use shortcuts for some commands: target add - ta, target list - tl, target remove - tr, send - s
Because this is a free service, all workspaces are limited to 100 MQTT messages per month. If you need more messages,
send an email.
Example
- /smqtt target add blindsKitchen mqtt://user:password@example.com /home/kitchen/blind
- /smqtt tl
- /smqtt send blindsKitchen open
- /smqtt s blindsKitchen close
Privacy
The following data is stored:
- Slack Workspace ID - Used to assign the right targets to your requests
- Target name and MQTT addresses/topic - Used to deliver the MQTT message to the right broker
- Number of messages sent - Used to limit the messages you send so that we don't get bankrupt
We do not store the messages you send to MQTT. If you want any of this data removed, contact us via email.
We will remove all your data when you uninstall Simple MQTT from your workspace.
We use Amazon Web Services as infrastructure provider with the server located in eu-central-1 (Germany).
Authors
Written by Dirk Heinke<https://github.com/DirkHeinke> & Jan Müller<https://github.com/EggiJan>