In this article, you will learn how to integrate Microsoft (MS) Teams with Personio. You will be provided with an overview of the requirements for the installation of the integration with the Personio employee data API, together with integration installation instructions. 

What can I do with the integration between MS Teams and Personio?

MS Teams is the Microsoft collaboration tool for companies and their employees. The integration of MS Teams with Personio enables relevant information that relates to predefined teams, departments, and offices to be provided to specific MS Teams channels.

With this integration, a daily update is published in MS Teams on today's:

• Employee absences and when the employees will be back at work
• Birthdays
• Anniversaries in a company
• New employees

An employee can also request absences directly in MS Teams, specifying the following:

• Type of absence
• Scope of the first and last day (full or half-day)
• Substitute during their absence
• Duration of the absence

What are the requirements for the integration?

For a successful integration, the following is required:

• An Administrator role or an editing right for Personio Marketplace in Personio. To assign an editing right for Personio Marketplace, go to Settings > People > Employee Roles > Access rights > Account configuration > Marketplace Integration.
• Microsoft Global Administrator role. The MS Teams Administrator role is not sufficient. 

How do I set up the integration?

Generate new API credentials

You first need to generate new API credentials for this integration in Personio via Settings > Integrations > API credentials.

For more information on generating API credentials, read our Help Center article on how to generate and manage API credentials.

Find MS Teams in Personio Marketplace

To find MS Teams in Personio Marketplace, follow these steps:

1. On the main navigation bar in Personio, click on Marketplace. 
2. Enter "MS Teams" into the Search box on the Marketplace page. 
3. You need to implement the MS Teams integration directly within Personio. Click on the Connect button to start the integration.
4. The Connect wizard, consisting of four steps, will display.

Note
If you can't find the integration in the Marketplace, make sure the Tray.io, Inc. checkbox is enabled under Settings > Support > Plan & Billing > Data Processing Agreement.

Personio uses Tray.io as a sub-processor to enable the inclusion of certain integrations. No data will be transmitted to Tray.io without using the mentioned integration.

You need to complete all four steps detailed below to set up the integration.

Step 1: Authenticate Microsoft Teams

Enable Personio to authenticate MS Teams and ask permission from the MS Teams administrator or owner.

Step 2: Authenticate Personio

Authenticate Personio by whitelisting the relevant attributes and entering the API credentials you generated for this integration. In the Access tab of the API section, you must allow the following attributes to be readable:

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

Enter the client ID and client secret previously generated in the API credentials section and save the settings.

Step 3: Manage teams in MS Teams

From the Select Teams drop-down menu, select the teams in MS teams for which you wish to map channels. To add a new attribute, click Add new attribute.

Step 4: Manage channel updates

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.
   

   Note
   If an event takes place on a weekend, it will not be transmitted to MS Teams.

3. Choose which events, for example employee absences or birthdays, you wish 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).
   

   Note
   When mapping attributes, you can select either a public or a private team in MS Teams. Daily channel updates must be sent to a public MS Teams channel.

6. To activate the MS Teams integration, click the Finish button.

Tip
From the Personio Marketplace, you can edit the mapped attributes at any time or deactivate the integration.

For more information on Personio Marketplace, read our Help Center article Personio Marketplace. 

Absence 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), the summarized employee data can be read at a glance.

Request an absence using the Personio app in MS Teams

An employee can easily request an absence using the Personio application in MS Teams by following these steps:

1. Click on the Personio application in MS Teams. 
2. Type request absence.
3. Fill in the form, adding the type of absence and duration.
4. Click Next step.
5. Choose substitute if required.

More information

To find out more about what absence request management is in Personio and how you can automate it with integrations, read our Help Center article Absence Request Workflow Management.