How to connect Slack to Asa.Team

Once Asa is in your Slack workspace, people can clock in, take breaks, check their hours and answer wellness check-ins from Slack, either in a direct message with Asa or with the /asa command. Clock-ins land on the same timesheets as clock-ins from the web, and check-ins feed wellness insights.

Slack is one of five integrations. See Chat apps and integrations for how it compares with Microsoft Teams, Telegram and WhatsApp.

Before you start

• You need to be an admin of your Asa.Team company. Asa only gives a setup code to admins.
• You need permission to add apps in your Slack workspace. If your workspace restricts app installs, ask a Slack admin to approve Asa.

A Slack workspace can belong to one Asa.Team company. The first company to connect a workspace owns it. If the workspace is already connected, Asa replies in Slack with “This Slack workspace is already connected to” and the company’s name.

Step 1: Add Asa to your Slack workspace

1. In Asa.Team, open the Add Asa to your team’s chat dialog. Either use the Add Asa to your team’s chat step in your Dashboard’s setup guide, or open Invite team member and select the Team chat tab.
2. Under Slack, select Add to Slack. Slack opens in a new tab.
3. Review what Asa is asking for and approve it.
4. You land on a Connect to Asa page that says “Asa has been added to your Slack workspace”.

Start from Asa.Team, as above. Asa gives your admin account a one-time setup code that ties the Slack workspace to your company. The Add to Slack button on Company settings > Integrations opens Slack’s app directory listing instead, and an install from there is not tied to your company.

Asa asks Slack for permission to:

• see messages that mention Asa and the direct messages people send to it,
• send messages, including replies, reminders and invites,
• use the /asa command,
• list the people in the workspace, so you can pick who to invite.

Asa does not ask for anyone’s email address.

Step 2: Link your account

The admin who installed Asa is linked automatically and receives a direct message from Asa in Slack.

Everyone else links their own account once:

1. In Slack, send Asa any message, or type /asa connect.
2. In Asa’s reply, select Connect my Slack.
3. Sign in to Asa.Team to finish linking.

The Slack tab under Company > Integrations repeats these steps and shows whether you are linked:

When the link works, the Slack tab shows “Slack is linked”, and Asa knows who you are when you message it from Slack.

Step 3: Invite your team

After Asa is installed, the setup dialog shows Invite from Slack. Pick the people to invite and Asa sends each of them a join link in Slack.

Invites use the seats on your plan. If you do not have enough seats, the picker tells you how many more members your plan allows.

What your team can do in Slack

Send Asa a plain message such as “clock in”, “clock out”, “break start” or “break end”, or use a command. In a direct message you can leave out the /asa, for example in or help. In a channel, mention Asa first, for example @Asa in.

Command	What it does
/asa in	Clock in
/asa out	Clock out
/asa breakstart	Start a break
/asa breakend	End a break
/asa status	Show who on your team is clocked in and who is clocked out
/asa hours	Show your hours for this week, day by day
/asa logs	Show your clock entries for today
/asa teams	Show your company’s teams and who is online in each
/asa companylogs	Show everyone’s clock entries for today (admins only)
/asa mood	Log how you are feeling
/asa notifications	Choose which notifications Asa sends you
/asa connect	Link your Slack account
/asa disconnect	Unlink your Slack account
/asa help	Show what Asa can do

You can also ask in your own words, for example “Who’s online right now?”, “How are my hours this week?” or “I need to take annual leave next Friday”. Before Asa changes anything for you, such as submitting a leave request, it asks you to confirm. See Ask Asa and Request and approve time off.

Breaks only work when your company or schedule tracks them. See Clock in, take breaks and clock out. /asa teams replies “Teams feature is not enabled for your company” until you turn on Teams, and /asa mood is explained in Mood check-ins.

On the Starter plan, plain-language messages are limited to 15 a day for the whole company. The commands in the table always work.

Choose which reminders Asa sends

Asa sends workday reminders, clock-in reminders, holiday reminders and mood check-ins as direct messages. Each person controls them:

• In Asa.Team, open the account menu, select Profile, then Notifications (see Notifications). Under Where we reach you, turn Slack on or off, and under What we send, choose which reminders you want.
• In Slack, type /asa notifications to open the same settings in a window.

Admins also see Admin alerts there, such as the morning briefing.

Use Slack channels for Project Intelligence

An admin can attach Slack channels to a project so Project Intelligence can read them. Asa reads only the channels it is a member of and never reads direct messages.

1. In Slack, invite Asa to the channel.
2. In Projects, open the project and select Connect a conversation (or Add source next to Listening to), then choose the channel.

If the list says “Slack is connected, but Asa has not detected any usable conversations yet. Add it to a channel and refresh.”, invite Asa to the channel and select Refresh list. See Projects.

Disconnect Slack

• Unlink yourself. Type /asa disconnect in Slack, or open Company settings, then Integrations, then the Slack tab, and choose Unlink Slack. Asa stops recognising you in Slack, and your company’s connected chats stay connected.
• Stop Asa reading a channel. Remove Asa from the channel in Slack. Under Connected chats on the Slack tab, Asa lists the channels it is in, but only Slack can remove it from one, so there is no Disconnect button there.
• Remove Asa from the workspace. Uninstall the Asa app from your Slack workspace’s app settings. Asa loses access to the workspace and the workspace is released, so another company could connect it.

Other chat apps

Microsoft Teams, Telegram and WhatsApp are on the same Integrations page, and Google Calendar is on its Calendar card. See Chat apps and integrations for a comparison.