Slack & Asana
- Skip Ahead to
- More Actions
- Link Unfurling & Actions
- Task Creation
- Personal Notifications
- Project Notifications
The new and improved Asana for Slack integration will ensure that your team can work seamlessly between Asana and Slack, without having to constantly switch tools. It now supports Enterprise Grid plans.
To get started, download the Asana for Slack app. Log into Slack and follow prompts from the Asana Slackbot to authenticate your Asana account, allowing Asana to send information to Slack. If someone in your organization has already installed the integration you might have received a prompt to re-authorize your Asana in Slack. By doing this you’ll be able take advantage of all the new features.
If you receive a message indicating that you are not authorized to install Asana, please contact your admin and ask them to approve the app for your Workspace.
The Asana for Slack integration is different than the previous Asana app and we will be deprecating the older version in due course. We will import any configurations you had set up from the old app to the new Asana for Slack app. To learn how to set up linked project configurations, see Linked Project Configurations below.
The fastest way to onboard your team is to paste a link to an Asana task in Slack. Ask your teammates to click on More actions from the drop down menu and select Like this task. By interacting with the task, they’ll receive the re-authorization message. Once they re-authorize, the new Asana for Slack will replace the old version.
Migrating to the new integration
If your slash commands and message actions have stopped working, it means we have started the migration window, and you’ll need to migrate to the new version to start using them again. We will import your project channel configs from the old app to the new app and you will receive notifications in the same channels you have used previously.
Using the Asana for Slack integration
The Asana for Slack integration allows you to turn Slack messages into tasks, take action on tasks from within Slack, or create a new task without leaving Slack. Task specific actions are also available via notifications in your personal or project channels.
From Slack you can view a list of commands and bring up links to this guide by typing /asana help
Turn a Slack message into a task, or add a message to an existing task
Capture conversations in Slack and turn them into a task, or add the conversation to a task. In Slack, select the conversation. Click the more messages button and select either Create a task or Add to task. A link will be created in the Asana task so that you can re-access the Slack conversation for further context.
When you access a Slack channel:
- Click the three dot icon next to a Slack message
- Click either Add as task comment or Create a task
Link unfurling and actions
Paste a link to an Asana task, Milestone, Project, or Status in Slack to share information and it will become actionable from within Slack via a dialogue box and dropdown menu options.
The person or channel you’ve shared the task with will be able to:
- Mark the task complete
- Like the task
- Change or add an assignee
- Change or add a due date
- Add the task to a project
- Open the task in Asana
Please note that if you share a task that is in a private project with a user that is not a project Member, they will not be able to make edits and be told to request access from the project owner. You can control whether the description for private tasks or projects are unfurled via /asana settings.
Type /asana create to create a new task in Asana without leaving Slack.
A dialogue box will pop up and in drop down menus you’ll be able to:
- Add a task title
- Add an assignee
- Add the task to a project
- Add a due date
- Add a task description
When you first install the app, you’ll receive a message from Asana giving you the choice to turn on your Asana notifications. This is helpful because you’ll be able to take action upon these notifications without leaving Slack. You’ll receive notifications when:
- A task is assigned or unassigned from you
For tasks assigned to you, you'll receive a notification when:
- The task is completed
- The due date changed
- All dependencies are completed
- A dependency is uncompleted
- A dependency due date is changed
- You are added as a follower
- There is a comment on a task you are following
Personal notifications will be delivered to your personal Asana channel, found under the Apps section in the bottom left of your Slack Sidebar.
Please note that personal notifications are not sent when you are active in Asana
At any time you can manage your personal notifications by typing /asana settings in Slack. You’ll be able to turn notifications off or on, change your default domain, or deauthorize your account.
Linked Project Notifications
You can sync Asana projects to Slack channels. This is helpful because you and your team will be able to take action upon these notifications without leaving Slack. Notifications will be made in the channel when the following changes are made to the project:
- A task is added to the project
- A task is completed in project
- The due date is changed on any task in the project
- The assignee is changed on any task in the project
To set up notifications for a channel, first make sure you’re in the channel you’re setting up notifications for. Then type /asana link and you’ll see the option to choose and connect your project to the channel. You can also use /asana link to turn off channel notifications.