1. TaskRay
  2. TaskRay Guide
  3. Integrations

TaskRay Slack Bot

Note: TaskRay Slack bot is only available to Enterprise and Unlimited Editions. TaskRay Slack bot is not currently available for sandboxes.

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]

Important! The TaskRay bot operates with the rights of a single user. This means other users can use the bot to see TaskRay data they might not have the rights to see. If you would like to continue with the TaskRay for Slack app, please confirm by enabling the integration. 
  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.
    this_is_the_new_button_you_want__1___1_.png
  4. Check the Enable Slack Integration checkbox. 
  5. Click Save.

 

Install TaskRay for Slack App [Admin]

Install the Bot

  1. Go to https://slack.taskray.com/
  2. Click on the Add to Slack button. 
    add_to_slack.png
  3. Slack will ask you to Sign in to your workspace. Enter your workspace and click Authorize.
  4. If you are asked to sign in to your workspace, enter your credentials and click Sign In.
  5. On the next page, click Authorize.
  6. This will take you to the Salesforce log in page. Enter your Salesforce credentials and click Log In.

    Important! The user that is provided during configuration will be automatically assigned as the owner of all tasks created via the TaskRay Slack bot. The Integration User needs to have a TaskRay license and be either 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. 
  7. On the Allow Access? page, click Allow.
  8. Return to your Slack workspace. You should now see TaskRay in the left sidebar. It will have a notification to communicate that it has been installed.

slack_bot_notification__1_.png

 

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.

Note: Do not add nicknames to template projects.

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

nickname_field_on_project.png

 
 

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.

slackbot_notification2__1_.png

 

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

slackbotnotification3__1_.png

 

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.

slackbot_tasksdue__1___1_.png

 

View Nicknames

If you need a reminder of all of your project nicknames, you can ask @TaskRay to send you a list of project nicknames for your projects (based on the My Projects board filter).
  1. Type @TaskRay nicknames.
  2. In a private message TaskRay will list any of your projects that include a nickname.

 

Help

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

Type @TaskRay help.

taskray_help__1___1_.png