Top
Top
  1. Workamajig
  2. Roles
  3. ...
  4. In-Depth Guides for Admin/Manager
  5. System Setup
  6. Account Information
  7. Workamajig Labs

Articles in this section

Project Conversations To Slack

This feature is available via Workamajig Labs.

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 | 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 basic /Get commands to see whats been happening on the project, with links to take you back to the project.

NOTES:

  • 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.
  • 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.
  • And 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.
blobid4.png
  • Verify the Account type next to Name (you), this needs to show as Primary Owner or Workspace Admin.
blobid5.png

2. Create a new Slack channel, call it #workamajig.

  • This will be used as the initial default channel later in the setup.
blobid0.png

Workamajig Setup

1. In Workamajig, navigate to Menu > Admin/Manager > System Setup > Connections > Slack API.

  • Click on Add to Slack.
blobid6.png
  • 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.
blobid7.png
  • A generic screen will open saying it was successful.
  • You can close this browser tab.
blobid10.png

2. Verify there is an OAuth Token by navigating back to Menu > Admin/Manager > System Setup > Connections > Slack API.

  • From here look and see of there is a long token key made up of random alphanumeric characters.
blobid9.png

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.
blobid0.png

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.
blobid1.png

Project Setup

You should see Slack Channel under the Project Details of the Projects dashboard.

  • Click on Add Slack Channel.
blobid12.png
  • 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.
  • Additionally there is an option to Add Myself to Channel. Anyone with Slack User Name populated in their employee record can click on this. You can also mass add users from the Projects Team.
blobid14.png

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 form the Projects Dashboard, under Setup.
  • Next, click the Slack icon to add ALL listed users who a valid Slack User Name populated in their Employee record.
blobid15.png
  • If users are setup properly, there should now be a Slack symbol next to those who are part of this channel.
blobid2.png
  • In Slack, users will be notified of the new Slack Channel.
blobid16.png
  • 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.
blobid17.png

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.
blobid18.png
  • From the Projects Dashboard, you can see a Slack icon that tells us the message was sent to Slack.
blobid19.png
  • Here is the result in Slack.
blobid20.png

NOTE: Users in Slack can respond to each other in Slack, but this is currently a one-way communication to Slack of designated posts.

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.
blobid21.png

Get Assignments

  • After selecting /getassignments, you should then see this text in the message.
  • Click Send.
blobid22.png
  • 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.
blobid23.png

Open the Project

  • You can click on the Project Number/Name/Client to open the Project in a new Workamajig tab.
blobid25.png
  • Here a new tab has opened to the Project.
blobid24.png

Open the Assignment

  • You can click on the Task Name to open the Assignment Details in a new Workamajig tab.
blobid27.png
  • 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, view the Project and Task Descriptions. Along with interacting on the Deliverables, To Dos and Conversations for this Task.
blobid28.png

Get Daily Feed This Week

  • After selecting /getdailyfeedthisweek, you should then see this text in the message.
  • Click Send.
blobid29.png
  • 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.
blobid30.png

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.

blobid0.png

You will see a confirmation after sending.

blobid1.png

Note how the Conversation has a red icon indicating the message came from slack.

blobid2.png

Resources

Conversations Overview

Project Manager: Projects

Creatives: Today Creatives

 

 

 

Related articles