Skip to main content

Integration for Microsoft Teams

Post awork project updates to Microsoft Teams channels and create tasks, comments, and time entries in awork—without leaving Teams.

Written by Max Raschke

The Microsoft Teams integration lets you keep your project communication where it happens and still stay connected to awork.


Key benefits and use cases

  • Post project updates to Teams channels

  • Create tasks in awork from Teams using @-commands

  • Add comments to tasks from inside Teams

  • Start and stop time tracking on a task or project


How to set up the Microsoft Teams integration

You’ll install the awork app in Teams, connect your tenant to your awork workspace, and then link a project to a channel.

Install awork in Microsoft Teams

  1. In Microsoft Teams, go to Apps (left menu)

  2. Search for awork

  3. Click Add

  4. In the pop-up, click Add to a team

  5. Select your team, then click Set up bot

MS Teams Integration Set Up

MS Teams Integration Set Up

MS Teams Integration Set Up

After setup, you’ll receive a welcome message from the awork bot in the team you selected.

Welcome Message from awork Bot after successfully integrated MS Teams

Connect your Teams tenant to your awork workspace

To connect your Microsoft Teams tenant to your awork workspace, run any awork bot command in Teams.

When the awork bot receives a command from a tenant that isn’t linked yet, it replies with a link to connect your workspace.

  1. Run any awork bot command in Teams

  2. Open the link from the bot reply

  3. Log in on the login screen

  4. After successful login, close the tab and return to Microsoft Teams


Link an awork project to a Teams channel

To receive notifications from a project—or to create tasks/time entries directly for a project—you need to link a project to the channel.

  1. In the Teams channel, run @awork link

  2. Open the link from the bot reply

  3. Select an awork project from your workspace

  4. Click Save

  5. Close the tab and return to Teams

After saving, you should receive a notification in Teams that the connection was successful.


How to create tasks and track time from Microsoft Teams

Once your channel is linked to a project, you can use awork directly in Teams with @-commands.

awork bot @-commands for Microsoft Teams

  • Create a task with @awork add [task]

  • Add a comment to a task with @awork comment [task]:[text]

  • Start time tracking with @awork start [task/project]

  • Stop time tracking with @awork stop

  • See all options with @awork help

  • Link a project to the channel with @awork link

  • Get a link to project settings with @awork settings

Example: Type @awork add Create design for logo in Teams to create the task Create design for logo in the linked project—or as a private task if no project is linked.

Tip: To remove the link between an awork project and a Teams channel, use @awork unlink.


Best practices and settings

Adjust project notification settings

You can adjust notification settings directly in the awork project under Settings > Integrations.

To get a link to the project settings for the linked project of a channel, run @awork settings in Teams.


FAQ

What can the Microsoft Teams integration do?

It can post updates from your awork projects to Microsoft Teams channels, and lets you create tasks, comments, and time entries in awork from within Teams.

How do I install awork in Microsoft Teams?

Go to Apps in Teams, search for awork, click Add, then choose Add to a team and click Set up bot.

How do I connect my Teams tenant to my awork workspace?

Run any awork bot command. If your tenant isn’t linked yet, the bot replies with a link. Log in, then close the tab and return to Teams.

Run @awork link in the channel, open the link from the bot reply, select the project in the new tab, and click Save.

What happens if I create a task when no project is linked?

The task is created as a private task if no project is linked.

Did this answer your question?