---
title: Connecting Xima
description: Connect Xima to Teamlead for a forecast from your call data and adherence based on employees' live status.
---

[Skip to content](https://kennisbank.teamlead.io/en/connecting-xima#main-content)

- [English](https://kennisbank.teamlead.io/en/connecting-xima)
- [Nederlands](https://kennisbank.teamlead.io/nl/xima-koppelen)

English

Show submenu for translations

![Teamlead](https://kennisbank.teamlead.io/hs-fs/hubfs/main-logo-horizontal-png-dark.png?width=176&height=32&name=main-logo-horizontal-png-dark.png)

Open main navigation

Close main navigation

- - [English](https://kennisbank.teamlead.io/en/connecting-xima)
    - [Nederlands](https://kennisbank.teamlead.io/nl/xima-koppelen)

  English
  
  Show submenu for translations
- [Tickets](https://servicedesk.teamlead.nl/tickets)

[Tickets](https://servicedesk.teamlead.nl/tickets?hsLang=en)

 Hi. How can we help you?

- There are no suggestions because the search field is empty.

1. [Teamlead Knowledge Base](https://kennisbank.teamlead.io/en?hsLang=en)
2. [Connections](https://kennisbank.teamlead.io/en/connections?hsLang=en)

# Connecting Xima

## Connect Xima to Teamlead for a forecast from your call data and adherence based on employees' live status.

With the Xima connection, Teamlead fetches skills, call volumes and agent states from Xima. Teamlead helps you set it up.

### First: get the details from Xima

Ask Xima or your Xima administrator for:

- a **Service User token**;
- the **Report ID** of the historic-data report that lists calls per skill per interval (for the forecast);
- the **Realtime metric ID** of the metric that reports agent states (for adherence).

Without these details you cannot save the connection.

### How to connect Xima

1. Go to **Settings** \> **Connections** and click **Xima**.
2. Under **Technical settings**, fill in the **Tenant address**, for example yourcompany.xima.cloud, and the **Service User token**.
3. Switch on **Forecasting** and/or **Adherence**.
4. For **Forecasting**, fill in the **Report ID**. For **Adherence**, also fill in the **Realtime metric ID**.
5. Click **Create**. Teamlead fetches the skills and agents from Xima in the background. You can keep working.
6. Check the **Skills**, **Employees** and **Status mappings** tables.
7. Link the Xima skills to skills in a staffing template.

![The Xima connection page with Technical settings, Forecasting and Adherence](https://kennisbank.teamlead.io/hubfs/kennisbank/xima-en.png?v=20261020f)

### Good to know

- Employees are matched by email address. Is a match wrong? Change it in the **Employees** table.
- A Xima status that Teamlead does not know yet appears in the **Status mappings** table by itself. Map it to a status in Teamlead; until then it counts as unknown.
- Below the card you can see when Teamlead last received a live status.
- Teamlead fetches the call history in batches. This can take a while.
- You cannot see the Service User token again after saving. Leave the field empty to keep the saved token.

### Not working?

Does it say **This connection is not working**? Check which message appears with it.

| Message | What to do |
| --- | --- |
| **Xima rejected the Service User token.** | Check the token and save again. |
| **The Xima Service User may not read this data.** | Ask your Xima administrator to check the Service User's permissions. |
| **Xima does not know this report ID.** | Check the **Report ID**. |
| **Xima has no data recorded yet.** | Wait until Xima has recorded calls. |
| **Xima is limiting requests. The next sync will continue.** | You do not need to do anything. |
| **Xima could not be reached.** | Check the **Tenant address** or try again later. |

### See also

- [Overview: which connections are available?](https://kennisbank.teamlead.io/en/overview-which-connections-are-available?hsLang=en)
- [Setting up staffing templates](https://kennisbank.teamlead.io/en/setting-up-staffing-templates?hsLang=en)
- [Forecast: required staffing from telephony data](https://kennisbank.teamlead.io/en/forecast-required-staffing-from-telephony-data?hsLang=en)
- [Tracking adherence](https://kennisbank.teamlead.io/en/tracking-adherence?hsLang=en)

- [Get started](https://kennisbank.teamlead.io/en/get-started?hsLang=en)
- [For employees](https://kennisbank.teamlead.io/en/for-employees?hsLang=en)
- [For planners and team leads](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#main-content)

    - [Schedule](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#schedule)
    - [Shift templates and automatic scheduling](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#shift-templates-and-automatic-scheduling)
    - [Leave](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#leave)
    - [Staffing and forecast](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#staffing-and-forecast)
    - [Adherence and statistics](https://kennisbank.teamlead.io/en/for-planners-and-team-leads?hsLang=en#adherence-and-statistics)
- [For administrators](https://kennisbank.teamlead.io/en/for-administrators?hsLang=en)
- [Connections](https://kennisbank.teamlead.io/en/connections?hsLang=en)
- [Frequently asked questions](https://kennisbank.teamlead.io/en/frequently-asked-questions?hsLang=en)

[![](https://kennisbank.teamlead.io/hs-fs/hubfs/Teamlead-logo.png?width=500&height=105&name=Teamlead-logo.png)](http://teamlead.io)

[Website](https://teamlead.io)[Create a ticket](https://servicedesk.teamlead.nl/tickets?hsLang=en)© 2026 Teamlead