# Integration with QGenda

### Overview

The QGenda integration allows organizations to securely sync on-call schedules into MangoApps. Using built-in integrations, automated tracker imports, and enhanced date/time handling, admins can ensure real-time visibility of on-call assignments across teams and workflows.

***

### Prerequisites

Before setting up the QGenda integration, ensure:

* You have **Admin access** in MangoApps.
* Valid **QGenda credentials** (Auth URL, Email, and Password) are available.
* Trackers are created (or planned) to store on-call schedule data.

***

### Setting Up the Integration

MangoApps provides a native QGenda integration for secure authentication and centralized management.

First, navigate to **Admin Portal → Integrations → Built-In Integrations** and locate **QGenda** under the **Workforce Management Apps** category.

<figure><img src="/files/DQyGk77AhZs6S7wpkjc8" alt="" width="563"><figcaption></figcaption></figure>

Click the "Setup" button. On the next screen, enter the following details:

* **Auth URL**
* **Email**
* **Password**

<figure><img src="/files/FYCe2fj8GQqk4vt01NmV" alt="" width="563"><figcaption></figcaption></figure>

Click **Test Connection** to validate credentials and make sure to save.

Credentials are **securely stored and masked**.

Integration settings can be **edited or deleted at any time**. <mark style="color:$danger;">Deletion is</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**blocked if the integration is in use by trackers**</mark><mark style="color:$danger;">, protecting data integrity.</mark>

***

### Sync On-Call Schedules Using Tracker Data Importer

QGenda schedules are imported into MangoApps using the Tracker Data Importer with automated scheduling.

To get started open the target **Tracker** and navigate to the **Data Importer** settings.

<figure><img src="/files/Sy5yR62jclHIYEqmgbgC" alt="" width="563"><figcaption></figcaption></figure>

Select **Source = QGenda** and configure the following options:

* **Service:** On-Call Schedule
* **Company Key:** Identifier used to scope schedule entries
* **Time Period:**
  * This week
  * This & next week
  * This & next 2 weeks

Map **QGenda API fields to Tracker columns** and select the preferred **sync frequency**.

**Run logs** show rows added per sync and include masked request/response details for auditing.

{% hint style="info" %}
Multiple QGenda importers can be created using **different company keys**, supporting multiple schedules or departments.
{% endhint %}

***

### Best Practices

* Use **separate company keys** for different teams or departments.
* Set shorter sync intervals (e.g., every 4 hours) for high-traffic on-call schedules.
* Standardize tracker Date/Time columns to a single timezone for consistent reporting.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/integrations-guide/shifts-and-schedules/integration-with-qgenda.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.