Project Conversations To Slack
This feature is available via Workamajig Labs, so make sure its enabled there before proceeding.
If you have any suggestions or feedback when using this feature, please email your account manager via support@workamajig.com.
Pre-Setup | Slack Setup | Workamajig Setup | User Setup | Project Setup | Send Project Conversation to Slack | Slack Commands | Troubleshooting | Resources
This feature is designed to extend Workamajig's Conversations into the Slack app. From there, you can have a Slack Channel for each project and use some various /slash commands to see what's been happening on the project, with links to take you back to the project.
NOTES:
- You can now edit the Channel Name in Slack as desired.
- If you use multiple instances/servers of Workamajig, you will need to create a Slack Workspace for each one.
- Attachments do not send at this time.
- Replies from Slack do not go to Workamajig at this time.
Pre-Setup
- For ease of setup, log into Workamajig and Slack within the same browser (not an App).
- To enable the extended functions of Workamajig to be used with Slack, you will first need to make sure you have your own Slack workspace setup where you have Owner or Admin access.
- You will also need access in Workamajig to Menu > Admin/Manager > System Setup > Connections.
- You will also need access to Menu > Admin/Manager > Employees in order to populate the Slack member ID per user.
Slack Setup
1. In Slack, verify you are either a Primary Owner or Workspace Admin of your Slack Workspace.
- Click on the drop-down next to your Workspace name in the upper left.
- Then click on Settings & administration.
- And finally click on Manage members.
- Verify the Account type next to Name (you), this needs to show as Primary Owner or Workspace Admin.
2. Create a new Slack channel, call it #workamajig.
- This will be used as the initial default channel later in the setup.
Workamajig Setup
1. In Workamajig, navigate to Menu > Admin/Manager > System Setup > Connections > Slack API.
- Click on Add to Slack.
- A new tab will open to verify access.
- At the bottom of this screen will be a lookup box of your existing slack channels.
- Search for #workamajig and select it.
- Click Allow.
- A generic screen will open saying it was successful.
- You can close this browser tab.
2. Verify there is an OAuth Token by navigating back to Menu > Admin/Manager > System Setup > Connections > Slack API.
- From here, look and see if there is a long token key made up of random alphanumeric characters.
User Setup
To interact with this feature, you will need to populate your Slack Member ID into your Workamajig Employee record.
NOTE: This will need to be done for each user who wants to participate.
1. In Slack, navigate to your Profile.
- Click on your avatar in the upper right to access your Profile.
- Then click on More.
- Finally click on Copy member ID.
2. In Workamajig, navigate to Menu > Admin/Manager > Employees.
- Search for the Employee to update.
- Open their employee record which opens to the Employee Details.
- In the Slack Member ID field, paste or type the Member ID found in the Slack profile.
- Save.
Project Setup
You should see Slack Channel under the Project Details of the Projects dashboard.
- Click on Add Slack Channel.
- When successful, you should now see a Slack Channel matching the Project Number. Clicking on this link will take you to the Slack app and open this Channel.
- You can edit the Channel Name in Slack afterwards if so desired.
- Additionally there is an option to Add Myself to Channel. Anyone with a Slack User Name populated in their employee record can click on this. You can also mass-add users from the Projects Team.
From the Projects Team, you should see a Slack icon with the hover-over text that reads "Add entire team to Slack Channel".
- Click on Team from the Projects Dashboard, under Setup.
- Next, click the Slack icon to add ALL listed users who have a valid Slack User Name populated in their Employee record.
- If users are setup properly, there should now be a Slack symbol next to those who are part of this channel.
- In Slack, users will be notified of the new Slack Channel.
- You can see the new Channel designated by the Project Number.
- There will also be a Workamajig Slack APP post to kick off the new Channel.
Send Project Conversation to Slack
You can send any Conversation post to Slack. Included existing Conversations by simply editing them.
- For example, with a new Post started, check the box for Send To Slack.
- Finish your Post and then click Save.
- From the Projects Dashboard, you can see a Slack icon that tells us the message was sent to Slack.
- Here is the result in Slack.
NOTES:
- You can reply to a Conversation in WMJ that has already been sent to Slack and choose to send that reply to Slack as well. Which will appear as a reply to that post in Slack.
- However, if you reply to a post in Slack, this will only appear in the Slack side of replies and not go back to Workamajig at this time. To send a message to Workamajig from Slack, you must use the /postconversation command.
Slack Commands
Get Assignments | Get Daily Feed This Week | Post Conversation
You can use a few / commands in Slack to pull info from the project into the Slack Channel.
- In the Message field, simply type the forward slash "/" to open the commands window.
- Then, continue to type "get" or "post" and then available commands will appear to choose from.
Get Assignments
- After selecting get assignments, you should then see this text in the message.
- Click Send.
- This will result in a list of Tasks you are Assigned to, within the corresponding Project, and what is visible based on your Today Creatives settings.
- This info is only visible to the user who runs the command.
Open the Project
- You can click on the Project Number/Name/Client to open the Project in a new Workamajig tab.
- Here, a new tab has opened to the Project.
Open the Assignment
- You can click on the Task Name to open the Assignment Details in a new Workamajig tab.
- Here, a new tab has opened to the Assignment Details.
- From here, you can perform actions such as updating the Assignments Percent Complete, New Time Entry, and view the Project and Task Descriptions, along with interacting on the Deliverables, To Dos, and Conversations for this Task.
Get Daily Feed This Week
- After selecting /getdailyfeedthisweek, you should then see this text in the message.
- Click Send.
- This will result in a list of Daily Feed entries that have occurred this week for the corresponding Project
- This info is only visible to the user who runs the command.
Post Conversation
You can use /postconversation command to send a new message from Slack to create a new Conversation in the Workamajig Project. To separate the Subject and Body, you can use the tilde key in the middle.
Subject~Body
If you do not parse it out, then just the Subject of the Conversation will be populated.
You will see a confirmation after sending.
Note how the Conversation has a red icon indicating the message came from slack.
Troubleshooting
If for some reason, the project and slack channel are no longer communicating, check the following.
In the Project Settings, there is a field for Slack Channel ID.
Be sure this matches the Channel ID in Slack.
And if they don't match, then Copy the Channel ID from Slack and Paste it in the Project Settings.
Resources