In this tutorial we will be going over how to make a button module toggle your presence on slack from auto to away. Auto makes your active if your actively on slack while away will make you away in any scenario.
Figure 1
Requirements
Preparation
- Account at Wia
You will need to be registered and /or logged in to your Wia account at https://www.wia.io/.
- Set up your Dot One
You will need to have a set up Dot One and you can find the tutorial on how to do that Here.
- Set up your code project
Now you will need to create a space and then a code project on your Wia Dashboard
Writing Code
- Note: _This portion requires a decent background in coding, specifically in C++ in order to understand how the modules communicate.
- Below is the code for this project which you can follow by reading the comments attached to the side of the code.
- Feel free to try and rewrite this code yourself so you can better understand the device! Some advice if you are having trouble is to make a temporary Block Project and take note of what code is pasted into the preview window when you drag certain blocks over!
/* The following instructions and comments are based on the assumption that you are familiar with the
syntax of C++ and a few functions and tools that are commonly used in C++ and classes used with Wia.*/
//These are libraries stored by Wia which are necessary for Wia products
#include <WiFi.h>
#include <Wia.h>
const int button = 17; // This is the pinout for the button module
int status = 0; // This is the status that is toggled through
Wia wiaClient = Wia(); /// This is specific to Wia and necessary for Wia to function
void setup() {
WiFi.begin(); // this starts the connection
delay(2500); // delay is necessary for the WIFI to work properly
pinMode(button, INPUT_PULLDOWN); // this sets up the pin for the button
}
void loop() {
while (digitalRead(button) == HIGH) //this keeps looping through while the button is pressed
{
if (status == 0) { /* when the status was on away and the button is pressed toggle to auto and
switch status to 1*/
wiaClient.createEvent("toggle-auto"); /* this is the event which initiates the flow to toggle the
slack presence with an HTTP request (refer to flows code)*/
status = 1; // status 1 represents auto
while (digitalRead(button) == HIGH) // this loop ensures that one click toggles once
{
delay(10); // keep delaying for 10ms until the button is released
}
}
else if (status == 1) /* when the status was on auto and the button is pressed toggle to away and
switch status to 0*/
{
wiaClient.createEvent("toggle-away"); /* this is the event which initiates the flow to toggle the
slack presence with an HTTP request (refer to flows code)*/
status = 0; // status 0 represents away
while (digitalRead(button) == HIGH)
{
delay(10); // keep delaying for 10ms until the button is released
}
}
}
}
Connecting the Button Module to the Dot One
- To start off by plugging in your button module into the Dot One like how it is done in
Figure 2.
Figure 2
Setting up Flows
Now we can start setting up the flows to allow the events that the button creates to communicate with a Slack API which changes your presence on slack.
1. To start off you will need a slack account which you can make Here
2. Once you have made a slack account and you have a workspace and you have the starting channels go to this link to get a legacy token.
* Be very careful with this token because this token can give anyone essentially full access to your slack account and which could be a large breach of your security on slack. Treat a legacy token as if it were the password to your your account.
3. Once you have this token go to the slack API user.setPresence page and if you go to the tester tab you can see that where you can test this HTTP request through the Slack API website.
Figure 3
- Now you have the HTML request needed to make the button function. This request can be found as a URL in pink on this page just below where it says URL. Copy this URL and go back to the Wia dashboard and go to the flows tab and make a new flow.
- Within the your new flow we are going to create two events one of them for the toggle-away event that you can see in the code above and one for the toggle-auto event which you can also see in the code above. The settings of these two events are in Figure 4 and Figure 5 below.
Figure 4
Figure 5
- Now you need to create a function that based on which event is triggered the slack status will change. To do this we need to drag a run function into the work space. Run Function is found in the Logic tab under Wia. Here is the code which you need to put in the function.
var event = input.body.name;
if (event == "toggle-away" ) {
output.body = "slack.com/api/users.setPresence?token=xoxp-000000000000-000000000000-000000000000-000000000000000000000000&presence=away&pretty=1";
/* The link above is the link you copied from the Slack API (without the https://) test although you need to make sure that at the end of the HTTP request it says "presence= away" because this will make the presence set to away*/
} else {
output.body = "slack.com/api/users.setPresence?token=xoxp-000000000000-000000000000-000000000000-000000000000000000000000&presence=auto&pretty=1";
/* The link above is the link you copied from the Slack API test (without the https://) although you need to make sure that at the end of the HTTP request it says "presence= auto" because this will make the presence set to auto*/
}
Now that you have made the run function you need to drag an HTTP Services node into the workspace. These can be found in the Services tab under Wia.
In the settings for this node you should copy the settings from Figure 6.
Figure 6
As you can see in this figure we have our input coming from the output of the run function which outputs the HTTP request without the https:// , thus we add https:// to the front of the URL that this will post to. Then click update, turn on the node, connect the nodes as seen in figure 7, make sure your code is deployed to your Dot One and you're ready to go!
The whole flow connected is shown below in Figure 7.
Figure 7
