This article explains how to integrate Microsoft (MS) Teams with Personio. Once connected, you can:

• Receive Personio-related updates in MS Teams. Updates include time off, birthdays, company anniversaries, and new employees.

Before you start

Before integrating MS Teams, ensure the following is in place:

• You have an Administrator role or edit permissions for the Marketplace Integration in Personio.
• You have a Microsoft Global Administrator role. The MS Teams Administrator role is not enough.

Available functionalities

MS Teams is a Microsoft collaboration tool for companies and their employees. Integrate MS Teams with Personio to share information in Teams channels for departments, teams, and workplaces. With this integration, MS Teams publishes daily updates on:

• Employee time off and return dates
• Birthdays
• Company anniversaries
• New employees

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

Note:
This integration doesn't support hourly time off.  

Connect and authenticate MS Teams

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

1. Go to Marketplace in Personio and search for the MS Teams integration.
2. Click Connect to open the Configuration Wizard.
3. Click Authenticate MS Teams.
4. Return to the Configuration Wizard in Personio and continue to the next step.

Authenticate Personio

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

1. Review the permissions that MS Teams requires.
2. Click Next to continue.

Personio allows the MS Teams integration to read the following system attributes:

• First name
• Last name
• Email
• Termination date
• Hire date
• Position
• Status
• Workplace
• Department
• Team

Manage teams

Step three requires you to select which teams need channels mapped.

1. Select the teams you want to map channels for.
2. Optional: add a new attribute.
3. Continue to the next step.

Manage channel updates

The last step requires you to define the channel update settings. Follow these steps:

1. Under Language of updates, select the language of the channel updates.
2. Under Time of update, select the time of the channel updates.
3. Choose the events you want to include in your daily update message.
4. Under MS Teams channel, select the relevant channel in MS Teams. To add a new attribute, click Add new attribute.
5. Under Personio, select the relevant organizational unit (for example, the department or team). When mapping attributes, you can select either a public or a private team in MS Teams. Daily channel updates can only go to a public MS Teams channel.
6. To activate the MS Teams integration, click Finish.

Birthday and work anniversary notifications apply to all employees within the departments, teams, or workplaces mapped to your MS Teams channels. You cannot exclude individual employees from these notifications. If your organization requires consent before sharing employee birthday or work anniversary information, you can turn off these event types for a channel. This applies to the whole channel, not individual employees.

Tip:
You can edit mapped attributes or deactivate the integration from the Marketplace. To check for issues sending messages, use the monitoring tab.

Time off workflows with MS Teams

Daily update from Personio in MS Teams channel

Read the previously created automatic daily update from Personio in an MS Teams channel. Under each subject (for example, Out Today), you can read the summarized employee data at a glance.