> For the complete documentation index, see [llms.txt](https://knowledge.out-smart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.out-smart.com/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/topdesk/topdesk-einrichten.md).

# TOPdesk einrichten

Verbinden **OutSmart** mit **TOPdesk** bevor Sie irgendwelche Import- oder Exportoptionen konfigurieren.

Sie benötigen einen Operator-Benutzernamen, ein Anwendungspasswort und Ihre TOPdesk-Domäne.

### Bevor Sie beginnen

Stellen Sie sicher, dass Sie Folgendes haben:

* aktivierte die Integration in der **Lizenz-Manager**
* Zugriff auf Ihr **TOPdesk-Operator-Konto**
* Berechtigung zum Generieren eines **TOPdesk-Anwendungspasswort**
* Zugriff auf **Einstellungen → Allgemein → Softwareintegrationen** in OutSmart

{% stepper %}
{% step %}

### Erstellen Sie ein Anwendungspasswort in TOPdesk

Melden Sie sich bei **TOPdesk**.

Öffnen Sie Ihre Benutzereinstellungen.

Erstellen Sie ein **Anwendungspasswort**.

Kopieren Sie das Passwort.
{% endstep %}

{% step %}

### Öffnen Sie die TOPdesk-Integration

Melden Sie sich bei der **OutSmart BackOffice**.

Gehen Sie zu **Einstellungen → Allgemein → Softwareintegrationen**.

Öffnen **TOPdesk**.
{% endstep %}

{% step %}

### Geben Sie die Anmeldedaten ein

Füllen Sie diese Felder aus:

* **Operator-Benutzername**
* **Anwendungspasswort**
* **Domäne**
  {% endstep %}

{% step %}

### Verbindung absenden

Klicken Sie auf **Senden**.

OutSmart überprüft die Angaben mit TOPdesk.
{% endstep %}

{% step %}

### Import- und Export-Einstellungen konfigurieren

Nach einer erfolgreichen Anmeldung wird die TOPdesk-Einstellungen-Seite geöffnet.

Wählen Sie aus, welche Daten Sie importieren und exportieren möchten.
{% endstep %}

{% step %}

### Die Einrichtung speichern

Klicken Sie auf **Speichern**.

Ihre Verbindungs- und Synchronisierungseinstellungen werden dann gespeichert.
{% endstep %}
{% endstepper %}

### Was OutSmart während der Einrichtung erstellt

Wenn Sie TOPdesk zum ersten Mal verbinden, erstellt OutSmart zwei Status für Arbeitsaufträge:

* **Zu TOPdesk**
* **Nicht zu TOPdesk**

Verwenden Sie **Zu TOPdesk** für Arbeitsaufträge, die mit einem TOPdesk-Vorgang verknüpft sind.

Verwenden Sie **Nicht zu TOPdesk** für Arbeitsaufträge, die außerhalb des TOPdesk-Ablaufs bleiben sollen.

### Wichtig zu wissen

* Die **Domäne** sollte Ihre TOPdesk-Adresse sein, zum Beispiel `yourcompany.topdesk.net`.
* OutSmart verwendet die **Anwendungspasswort** für die Verbindung.
* Ihr persönliches TOPdesk-Anmeldepasswort wird nicht gespeichert.
* Sie können die Integration über die Seite mit den Einstellungen trennen.

### Häufig gestellte Fragen

<details>

<summary>Wo finde ich das Anwendungspasswort in TOPdesk?</summary>

Öffnen Sie die Einstellungen Ihres TOPdesk-Benutzerprofils.

Suchen Sie nach der Option zum Generieren eines **Anwendungspasswort**.

Prüfen Sie bei Bedarf die TOPdesk-Dokumentation oder das auf der Seite mit den Einstellungen verlinkte PDF-Handbuch.

</details>

### Verwandte Themen

* [**TopDesk**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/topdesk.md)
* [**Was ist TOPdesk?**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/topdesk/was-ist-topdesk.md)
* [**TOPdesk-Importe konfigurieren**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/topdesk/topdesk-importe-konfigurieren.md)
* [**TOPdesk-Exporte konfigurieren**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/topdesk/topdesk-exporte-konfigurieren.md)
* [**Eine Softwareintegration einrichten**](/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/eine-software-integration-einrichten.md)

<details>

<summary>Was passiert, wenn die Anmeldedaten falsch sind?</summary>

OutSmart zeigt einen Fehler an.

Überprüfen Sie den Operator-Benutzernamen, das Anwendungspasswort und die Domäne.

Senden Sie die Verbindung dann erneut ab.

</details>

<details>

<summary>Was bedeutet eine Fehlermeldung über fehlende Status- oder Operatorgruppen-Berechtigungen?</summary>

Das TOPdesk-Konto kann Verarbeitungsstatus oder Operatorgruppen nicht über die API lesen.

Bitten Sie Ihren TOPdesk-Administrator, die erforderlichen API-Berechtigungen zu erteilen.

</details>

<details>

<summary>Wie trenne ich TOPdesk?</summary>

Verwenden Sie die Trennen-Schaltfläche mit dem Power-Symbol im Protokollbereich.

Sie finden sie auf der rechten Seite der Einstellungsseite.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://knowledge.out-smart.com/outsmart-knowledge-base/outsmart-knowledge-base-de/integrationen/integrationen/topdesk/topdesk-einrichten.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.