# TOPdesk

### What is TOPdesk integration in ZigiOps?

TOPdesk is an IT service management platform used by organizations to manage incidents, requests, changes, and assets. It supports both cloud and on-premises deployments and is widely used in enterprise and mid-market ITSM environments.

ZigiOps enables integration between TOPdesk and other ITSM, DevOps, and monitoring platforms. Using username and password authentication, ZigiOps connects TOPdesk to external systems to support automated ticket synchronization, incident management, and cross-team workflows.

With ZigiOps, TOPdesk can:

* Sync incidents and service requests with platforms such as Jira or ServiceNow
* Receive alerts from monitoring tools as TOPdesk tickets
* Participate in bi-directional workflows between ITSM and DevOps systems
* Support automated escalation and routing of service desk cases

### Which TOPdesk versions are supported?

Please note that using a supported version is mandatory.

| Product | Supported Deployment Types | Supported Versions |
| ------- | -------------------------- | ------------------ |
| TOPdesk | All                        | All                |

### Are there any environmental prerequisites for TOPdesk?

There are no environmental prerequisites for this product.

### How do I connect TOPdesk to ZigiOps?

#### TOPdesk - Connected System Configuration

Follow the steps below to add your TOPdesk instance as a connected system.

1. Log in to your **ZigiOps** instance.
2. Navigate to **Connected Systems > Add New System > TOPdesk**.
3. Configure the following parameters:

   **Server URL**\
   Input the URL of your instance.\
   Example: `https://example.topdesk.net`

   **Username**\
   Input your integration user username.

   **Password**\
   Input the password of your integration user.

   **Proxy Settings (optional)**\
   Enables the usage of a proxy server.
4. Examine the settings and, if they are correct, click **Save** to store the system.

Once saved, TOPdesk becomes available for use in ZigiOps integration templates.

### What are the most common TOPdesk integration use cases?

#### Use case 1: Incident synchronization between TOPdesk and Jira

Incidents created in TOPdesk can be automatically mirrored as Jira issues for development or operations teams. Updates made in Jira are synchronized back to TOPdesk, keeping service desk records current.

#### Use case 2: Monitoring alert escalation to TOPdesk

Infrastructure alerts from monitoring platforms can be forwarded through ZigiOps to create or update TOPdesk tickets, enabling automated incident creation without manual intervention.

### What integration templates are available for TOPdesk?

ZigiOps provides integration templates for TOPdesk. Contact the ZigiWave support team at <support@zigiwave.com> for more information regarding available templates for this system.

Templates are documented individually in the **Integration Catalog**.

### Summary

The TOPdesk integration in ZigiOps enables:

* Username and password-based connectivity for all TOPdesk deployment types
* Support for all TOPdesk versions
* No environmental prerequisites required
* Integration with Jira, ServiceNow, monitoring tools, and other platforms
* Incident and service request synchronization workflows
* Optional proxy configuration
* Fully customizable synchronization workflows without custom scripting

ZigiOps allows TOPdesk to participate in enterprise-grade ITSM and automation ecosystems without requiring custom development.


---

# 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://docs.zigiwave.com/available-systems/topdesk.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.
