TaskRay Slack Bot

TaskRay for Slack can help you get more done more efficiently. With the TaskRay bot, you can easily add tasks to projects, check project status, as well as view and complete your tasks - all while you are in Slack. 

Enable Slack Integration [Admin]

1. From Setup, navigate to:
• Lightning: Custom Code | Custom Settings.
• Classic: Develop | Custom Settings.
2. Click Manage next to TaskRay Global Settings. 
3. If setting for the first time, click New just above the line that reads Default Organization Level Value, otherwise, click Edit.
   
   
   Careful! There are two New buttons. One sets default limits at the organization level, the other sets limits by user or profile. We do not currently support user or profile based settings.
   
4. Check the Enable Slack Integration checkbox. 
5. Click Save.

Install TaskRay for Slack App [Admin]

Install the Bot

1. Click on the Add to Slack button below. 
   
2. Slack will ask you to Select your team.
3. Once you select a team, click Authorize.
4. Slack will ask for the Integration User Name, User Password, and User Security Token. The Integration User needs to have a TaskRay license and be a Salesforce API Integration User or a user with full TaskRay permissions such as a System Administrator. As a reminder, the TaskRay bot operates with the rights of a single user. This means other users can potentially use the bot to see TaskRay data they may not have the rights to see.
   
   
   Note: The user that is provided during configuration will be automatically assigned as the owner of all tasks created via the TaskRay Slack bot.
5. Click Launch Bot. You will receive a confirmation in Slack from @taskray.

Invite @taskray to Slack Channels

The @taskray bot will need an invitation to all applicable channels.

In Slack, within each desired channel, in the message box, type /invite @taskray. Once the bot is added to the channel, you will see a confirmation message.

Define Project Nicknames

The TaskRay bot uses the Nickname field on the TaskRay Project object to define which project you want to apply a command to, such as creating a task on a project. In order to use the bot to add tasks to projects, you will need to enter nicknames for desired projects in the Project Details in TaskRay.

1. In TaskRay, in the left sidebar, hover over the project that you want to add a nickname to and click on the More Actions icon that appears.
2. Select Edit Project. Alternatively, double click on the project.
3. This will open the Project Details. Click Edit.
4. Enter a nickname for the project in the Nickname field. Make the nickname easy to remember and relatable to the project name. The nickname will be used in Slack to add tasks to projects.
   
   
   Note: Project Nicknames must be unique (no two projects can have the same nickname) and may not include spaces.

Note: If you do not see the Nickname field in Project Details, that means that it has not been added to the Project Field Set. If you would like to add this field to the Project Details layout, your admin would need to modify the Project Field Set (Classic only; Admin instructions below). 

1. From Setup, navigate to Create | Objects.
2. Select TaskRay Project.
3. Scroll down to the Field Sets section and click Edit next to TaskRay Project Field Set.
4. Move the Nickname field into the In the Field Set container.
5. Click Save.

Using the TaskRay Bot in Slack

Add Task

Using the project nickname field, it is possible to quickly add a task from Slack and associate it to the correct project.

1. First, make sure the project that you want to add a task to has a nickname.
2. In Slack, type @taskray add <project nickname> <task name> (e.g @taskray add Onboarding Send welcome email).
3. If you would like to attach the conversation thread to your Chatter feed, click Attach Chat.

Check Status

Using the project nickname field, it is possible to quickly check project status in Slack.

For any project that has a nickname, type @taskray status <project nickname>.

View My Tasks

The TaskRay bot can send users their task list for the day in a private message. Results are limited to the first 20 tasks due today (or overdue).

1. In Slack, type @taskray my tasks.
2. In a private message, TaskRay will list your TaskRay Tasks Due, including tasks due today or overdue.
3. Click Mark complete, to finish your tasks directly from Slack.

View Nicknames

Help

If you need a refresher on possible TaskRay for Slack message options, just ask @taskray for help.

Type @taskray help.