This article explains how to set up the Slack integration with Personio. Once connected, you can:

• Receive Personio-related updates in Slack channels.
• Set up automatic updates to your Slack status for time off.

Before you start

Permissions

• To set up the Slack integration, you need an Administrator role or Edit permissions for the Integrations > Marketplace Integration section.
• You need administrator or owner rights for your Slack workspace.

Other considerations

• Only internal employees can use channel updates and automated status updates.
• The Slack integration does not support status updates or channel updates for hourly absences.
• You can only connect one Slack workspace to your Personio account

Channel updates notifications

You can send channel updates to public Slack channels based on teams, departments, or workplaces. The updates include the following:

• Who is absent today, and until when?
• Who has a birthday today?
• Which employees have their first day in our company today?
• Which employees have a work anniversary today?

You can send these updates with an automatic Slack message to the selected channel. You can also choose the group of employees who receive them. If you don't use teams in Personio, you can select groups of employees per department. If you don't use departments, differentiate employees by their workplaces. Then, assign them to Slack channels.

Note:
Channel updates don't include the absence reason or time off type, even if you turn on automated status updates below.

Automated status update

This feature updates your status automatically based on your time off. You can decide if the time off type, like paid or sick leave, appears in the status or not. The feature only supports daily time off. Hourly time off requests are unavailable.

The integration calculates time off return dates by considering working schedules and public holidays. This helps Slack show accurate return dates.

The following emojis appear, linked to their respective status:

🌴 : Paid vacation.
🤒 : Sick leave.
❌ : All other time off types, apart from remote work.
🏡: Remote work. The emoji only shows if you tick yes to view the reason for the time off in the status message. This option appears when you set up the status update functionality. If you don't enable this, the remote work time off type doesn't show any emoji.

Note:
▶ The automated status update feature is only available if you use a paid Slack account.
▶ Due to a system limitation, the Slack integration does not update leave statuses (e.g., sick leave, paid absences) for Administrators or Workspace Owners.

Connect and authenticate Slack

Set up the Slack integration in Personio's Marketplace with the Configuration Wizard. This requires you to grant Personio permission to access your Slack workspace. Follow these steps:

1. Go to Marketplace in Personio and search for the Slack integration.
2. Click Connect to open the Configuration Wizard.
3. Click Authenticate Slack.
4. A new Slack window opens. Sign in to your workspace. Then, grant Personio access and continue the installation. 
5. Return to the Configuration Wizard in Personio and continue to the next step.

Authenticate Personio

Step two requires you to grant Slack access to the necessary Personio data. Follow these steps:

1. Review the permissions that Slack requires.
2. Continue to the next step.

Personio allows the Slack integration to read the following system attributes:

• First Name
• Last Name
• Preferred Name
• Birthday
• Email
• Hire Date
• Termination Date
• Workplace
• Department
• Team
• Status

To identify each user, each employee's email address in Personio has to be the same as that used in Slack.

Manage channel updates

Define the channel update settings in step three. Follow these steps:

1. Choose the language for updates.
2. Select the time of the updates. Slack updates always use Central European Time (UTC+1). If you select the UTC timezone in Personio and set the time of the update to 08:00 am, it sends the update at 07:00 am your time. 
3. Choose the elements to include in the daily update message. The available options are time off, birthdays, company anniversaries, and new employees. Currently, you can't exclude the transfer of certain time off types, like parental leaves. 
4. Select the channels for the update. You can only send the daily channel updates to public Slack channels. You can assign employees of specific teams, departments, and workplaces to the channels. If you want to keep certain employees out of an update — for example, to avoid announcing one employee's work anniversary or to leave a specific team's absences out of a channel — assign that channel update to a narrower group instead of the whole company. To add more channels and groups, click Add new attribute.
5. Optional: if you want updates to appear in a read-only channel, ensure the Personio app has posting permissions. Learn how to manage channel posting permission in Slack.
6. Continue to the next step. 

Tip:
You can check for issues sending messages with the monitoring tab in the Marketplace.
 

Slack status updates

Define Slack status update settings in step four. Time off requested for the same day transmit as soon as someone accepts them. This ensures that colleagues can view time off that have come up at short notice, like sick leave. Follow these steps:

1. Choose to activate automatic Slack status updates. 
2. Choose if the status should contain the time off type. 
3. Finish the integration process.

You can edit the settings or deactivate the integration at any time.

Manage performance notifications

Enable performance and development notifications in Slack to keep your employees informed. You can include notifications about cycle management, reviews, feedback, and public praise.

Learn more about performance notifications.