Plans and permissions:
- Plan: Pro or Enterprise plan
- Set up schedule change and real-time notifications: Admin role, or a custom role with Configure notifications set to Can configure all notifications or Can configure certain notifications on the Configure tab
- Get emails about new time off requests: Admin or Manager role, or a custom role with Time off requests set to Can approve, deny, edit, and cancel all agents’ time off requests on the Schedule tab
- Post time off notifications to a Slack channel, or fix someone’s Slack ID: Admin or Manager role, or a custom role with Manage team set to Create, edit, or delete any person or Create, edit, or delete certain people
- Connect Microsoft Teams: Admin role, or a custom role with Configure third-party integrations set to Can configure third-party integrations on the Data & integrations tab
- Change the notification account’s role: Admin role, or a custom role with Roles and permissions set to Can manage roles and permissions
- With Can configure certain notifications, a role can set up only the types you choose: Realtime overview and analysis, Schedule changes, or Extra time.
- The notification account’s role must be based on Team Lead or higher to turn on time off notifications.
Use notifications to keep your team informed without anyone having to check Assembled: tell team members when their schedule changes, alert managers when a real-time threshold is crossed, and email approvers about new time off requests. Notifications go out by email, Slack, or Microsoft Teams, depending on the type.
Most notifications are set up in Configure > Notifications, which has a Staffing tab and a Realtime tab. Time off request emails are turned on by each approver in their own My settings.
Notification types
| Notification | Who gets it | How it’s sent | Where to set it up |
|---|---|---|---|
| Time off requests | The request’s recipients, always including approvers who turn it on | Configure > My settings > Profile | |
| Schedule changes | Team members whose schedule changes soon | Slack, Microsoft Teams, or email direct message | Configure > Notifications, Staffing tab |
| Shift swaps | The team member who asked for the swap and the reviewers | Slack, Microsoft Teams, or email direct message | Configure > Notifications, Staffing tab |
| Extra time | Team members, when extra time off becomes available | Slack, Microsoft Teams, or email direct message | Configure > Notifications, Staffing tab |
| Real-time alerts | A Slack or Microsoft Teams channel, team members who cross a threshold, or email recipients | Slack, Microsoft Teams, or email | Configure > Notifications, Realtime tab |
The Shift swaps and Extra time cards appear if your company uses shift swaps or voluntary time. Slack and Microsoft Teams options appear once the integration is connected. See Slack integration and Send notifications to Microsoft Teams.
Get emails about new time off requests
Each time off request is emailed to its recipients. People whose role has Time off requests set to Can approve, deny, edit, and cancel all agents’ time off requests and who turn on time off notifications are always included, for requests from the people they choose. Team members can add anyone else in Send request to. People with time off notifications turned on also get an email when an approved request is canceled.
Approvers turn notifications on for themselves:
- Go to Configure > My settings.
- On the Profile tab, under Notifications, select Notify me when an agent submits a time off request.
- Under Notify me about requests from, choose All agents or Agents on my teams.
- Select Save changes.
To stop the emails, clear the checkbox and save. For details on the options, see My settings.
Post time off notifications to a Slack channel
Time off request notifications are sent by email only. To see them in a Slack channel too, send the emails to the channel’s email address: add a person in Assembled whose email address is the channel’s, and turn on time off notifications for that person.
Keep in mind:
- The Slack post is a copy of the email. Approvers still open the request in Assembled to approve or deny it.
- The extra person needs a password and a role that can approve time off. Anyone with its sign-in details can approve requests, so keep them secure.
- Slack can create email addresses for channels on paid plans only.
- In Slack, create an email address for the channel, and copy it.
- In Assembled, go to Manage team > People management, select Add people, then Add manually.
- Enter the channel’s email address in Email, and give the person a name your team will recognize, such as
Time off requests channel. - In Role, choose a role based on Team Lead or higher that has Time off requests set to Can approve, deny, edit, and cancel all agents’ time off requests. The default Manager role has it. To give this account no other access, create a custom role for it. See Roles and permissions.
- Clear Allow this person to be scheduled, select Send this person an invitation email to sign up, and select Add person.
- In Slack, open the invitation email in the channel, select the link, and create a password.
- Sign in to Assembled as this person, and turn on time off notifications for it, as described in Get emails about new time off requests.
New time off requests now appear in the Slack channel. Team members don’t need to choose this person in Send request to, because it gets every request automatically. Approvers select the link in the post to open the request in Assembled.
Notify team members when their schedule changes
Schedule change notifications message each team member when their schedule changes in your primary schedule soon, so last-minute changes don’t go unnoticed. Changes to test schedules don’t send them.
- Go to Configure > Notifications and select the Staffing tab.
- In Schedule changes, turn on Enable schedule change notifications.
- Under Notification action, select how to notify team members: Send Slack direct message to agent, Send Microsoft Teams direct message to agent, Send email to agent, or more than one.
- In Time window, choose how soon a change has to be for team members to hear about it: 1 hour, 12 hours, or 24 hours.
- To see what team members get, select Preview notification.
- Select Save changes.
Team members whose schedules change within the time window now get a message. To stop the notifications, turn off Enable schedule change notifications and save.
Slack and Microsoft Teams direct messages need each team member’s Slack or Microsoft Teams ID on their profile. If people don’t get them, see Notifications don’t arrive.
The Shift swaps and Extra time cards on the same tab work the same way: turn on Enable shift swap notifications or Enable extra time notifications, choose a Notification action, and select Save changes.
Get real-time alerts
Real-time alerts tell you when something needs attention right now, such as more than a set number of new cases in a chat queue, a team member out of adherence for more than a few minutes, or first response time over your target. Alerts can take up to one minute to arrive.
Each alert is based on a threshold, so set up your thresholds first:
- Go to Monitor > Real-time overview for overview thresholds, or Monitor > Real-time agent analysis for agent analysis thresholds, and select the Threshold settings tab.
- Select Create threshold, set it up, and save it. See Real-time overview.
Then create the notification:
- Go to Configure > Notifications and select the Realtime tab.
- Select Create notification.
- Under Status, choose Active to start sending alerts right away, or Inactive to save it for later.
- Enter a Notification name. Choose a name others will understand, because it can appear in the alert.
- Choose the Threshold source, Agent analysis or Realtime overview, then the Threshold name.
- Under Do this, choose where to send it. See the table below.
- Check the Notification preview, then select Save notification.
| Option | What it does |
|---|---|
| Send message to Slack channel | Posts to the Channel you choose. For overview thresholds, the message lists everyone who meets the threshold. |
| Send Slack direct message to agents who breach this threshold | Messages each team member directly. For out of adherence and state duration thresholds. |
| Send Microsoft Teams direct message to agents who breach this threshold | The same, in Microsoft Teams. |
| Send message to Microsoft Teams channel | Posts to the team and channel you choose. |
| Send email notification | Emails the recipients you enter. For agent analysis thresholds, you can also select Email agents who breach this threshold. |
Keep in mind: Alerts about team members include their names. Consider sending them to a private channel.
Send notifications to Slack channels
To send notifications to Slack, first connect Slack. In Slack, you need permission to install apps in your workspace. See Slack integration.
Add a public channel
- In Slack, open the channel, and select the channel’s name to open its details.
- At the bottom of the details, copy the Channel ID.
- In Assembled, go to Configure > Notifications, select the Realtime tab, and open the notification.
- Select Send message to Slack channel, then open the Channel list and select Add a Slack channel.
- Enter the ID in Channel id, and select Add channel.
- Select Save notification.
The Channel list shows the channel by its ID, not its name.
Add a private channel
- In Slack, open the private channel’s details, select Integrations, and add the Assembled app if it isn’t there already.
- Follow the steps in Add a public channel.
Add a channel from another Slack workspace
Assembled connects to one Slack workspace. If your company has more than one, you can’t message people in the others directly, but you can post to a channel there:
- In the other workspace, open the channel and share it with your connected workspace.
- Add the shared channel in Assembled, following the steps in Add a public channel.
Send notifications to Microsoft Teams
To send notifications to Microsoft Teams, add the Assembled app to your Teams organization, then connect it in Assembled. A Microsoft 365 admin needs to approve the app’s permissions for your organization.
- In the Microsoft 365 Marketplace, search for Assembled, and add the app to your Microsoft Teams organization.
- In Assembled, go to Configure > Third-party integrations, find Microsoft Teams, and select Connect.
- Sign in with your Microsoft account and approve the requested permissions. If you aren’t a Microsoft 365 admin, ask one to approve them.
- Go to Configure > Notifications and open the notification you want to send to Teams.
- Select a Microsoft Teams option, and choose the team and channel if you’re posting to a channel.
- To check how the message will look, use the preview, then save the notification.
Examples
Alert managers when team members stay in After Call Work too long
If your contact platform sends After Call Work (ACW) to Assembled as an agent state, you can alert managers when a team member stays in ACW longer than you’d like, such as more than 5 minutes.
- Go to Monitor > Real-time agent analysis, select the Threshold settings tab, and create a state duration threshold for the ACW agent state with your limit, such as more than 5 minutes.
- Go to Configure > Notifications, select the Realtime tab, and select Create notification.
- Set Status to Active, and enter a Notification name.
- Choose Agent analysis as the Threshold source, and your ACW threshold as the Threshold name.
- Select Send message to Slack channel, and choose your managers’ channel.
- Select Save notification.
To remind team members directly as well, also select Send Slack direct message to agents who breach this threshold.
Troubleshooting
Notifications don’t arrive
| Cause | How to tell | What to do |
|---|---|---|
| The person’s Slack ID is missing or wrong | Slack direct messages don’t arrive, and the Slack ID on the person’s profile doesn’t match their member ID in Slack. Slack IDs sync automatically within 24 hours of connecting Slack. | Correct the Slack ID. See Check or fix someone’s Slack ID. |
| Microsoft Teams needs permissions, or the app was removed | Microsoft Teams messages don’t arrive, and the Microsoft Teams card in Configure > Third-party integrations asks for permissions, or the Assembled app is no longer added to your Teams organization. | A Microsoft 365 admin needs to approve the permissions, or select Reconnect Microsoft Teams. If the app isn’t added, add it as in Send notifications to Microsoft Teams. |
| The person’s email address is wrong | Emails don’t arrive, and the person’s email address in Manage team > People management, which is where Assembled sends emails, isn’t right. | Correct the email address. |
| The emails are filtered | The email address is right, but the emails don’t reach the person’s inbox. | Check their spam folder, and any company email rules that block automatic messages. |
Check or fix someone’s Slack ID
- In Slack, open the person’s profile, select the three-dot menu, and select Copy member ID.
- In Assembled, go to Manage team > People management, and select the person’s name.
- Under Optional IDs, which appears for people who can be scheduled, check that Slack ID matches the ID you copied. If it doesn’t, paste in the correct ID.
- Select Save changes.
To update many Slack IDs at once, or to set one for someone who can’t be scheduled, upload a CSV file with a Slack ID column. See People management.
Time off requests don’t appear in the Slack channel
If new time off requests don’t appear in the channel after you post time off notifications to a Slack channel, the notification account is usually missing a permission or a setting. The integration itself is rarely the cause.
| Cause | How to tell | What to do |
|---|---|---|
| The account’s role can’t approve time off requests | In Manage team > Roles and permissions, the account’s role has Time off requests set to a view option, such as View only their own time off requests, which the default Team Lead role has. | Give the account a role that can approve, such as the default Manager or Admin role, or a dedicated role that gives it only what it needs. See Can the account’s role approve time off requests? |
| The account’s role is below Team Lead | In Manage team > People management, select the account and check its Role: it’s Standard or Basic, or a custom role based on them. | Use a role based on Team Lead or higher. Only these roles can turn on time off notifications. |
| Notifications aren’t turned on for the account | Sign in as the account and go to Configure > My settings. On the Profile tab, Notify me when an agent submits a time off request is cleared. | Sign in as the account and turn it on. See Get emails about new time off requests. |
| Notifications are limited to the account’s teams | Notify me about requests from is set to Agents on my teams, so the account only hears about requests from people on its teams, and the account isn’t assigned to any teams. | Set Notify me about requests from to All agents. |
| The Slack channel’s email address doesn’t work | Send an email to the address from your own email. It doesn’t appear in the channel. | Check the address in the channel’s settings in Slack. Channel email addresses need a paid Slack plan. |
After a fix, submit a test time off request and check the Slack channel after a few minutes. If it doesn’t appear, check the account’s role and notification settings again, and send a test email to the channel’s address from your own email. If it still doesn’t work, chat with our team and include the notification account’s name and role, the date, time, and time zone of your test request, whether a test email sent directly to the channel’s address appeared, and what you’ve already tried.
Can the account’s role approve time off requests?
If the notification account’s role can only view time off requests, it gets an email only when a team member chooses it in Send request to, even if its notifications are on. The default Manager and Admin roles can approve time off requests. To give the account only what it needs, use a dedicated role instead of changing an existing one.
To change the account’s existing role so it can approve:
Important: A role’s permissions apply to everyone with that role. If you change the Team Lead role, every Team Lead can approve, deny, edit, and cancel time off requests.
- Go to Manage team > Roles and permissions.
- Select the account’s role.
- Under Time off requests, choose Can approve, deny, edit, and cancel all agents’ time off requests.
- Save the role.
Use a dedicated role for the notification account
To leave your existing roles unchanged, create a custom role for the notification account, such as Time off notifications. Base it on Team Lead, set Time off requests to Can approve, deny, edit, and cancel all agents’ time off requests, and assign the role only to the notification account. For how to create a custom role, see Roles and permissions.
Assembled says the email address is already in use
Each email address can belong to only one person in Assembled. If you see that the channel’s email address is already associated with a person, it may belong to someone who was deactivated rather than deleted.
- Go to Manage team > People management.
- Filter the list to Inactive people.
- Search for the email address.
Inactive people don’t appear in a default search, so this shows an address that’s still in use.