> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/connectors/autotask.md).

# Autotask Connector

Der Autotask Connector für Provider: Kunden als Firmen, Tickets und Konfigurationselemente je Kunde, Kostenpositionen und Verträge zwischen Equipme Pro und deiner PSA abgleichen.

**Pfad:** „Automation“ → „Workflows“ → Flow-Designer → Connector **„Autotask“**

Mit dem **Autotask Connector** verbindest du Equipme Pro in [Workflows](https://hub.equipme.io/pro/dokumentation/automation/workflows.md) mit deiner PSA **Autotask**. Deine Kunden aus Pro werden zu Firmen in Autotask, Aufträge und Lieferungen zu Tickets mit Kostenpositionen, und Änderungen an Konfigurationselementen in Autotask fließen zurück zu den Serviceinstanzen in Pro.

## Wofür?

* **Kunden als Firmen führen:** Neue Kunden aus Pro als Firma in Autotask anlegen und die Autotask-ID in Pro speichern.
* **PSA-Tickets für Aufträge:** Für jede neue Fulfillment-Position ein Ticket mit Checkliste beim richtigen Kunden anlegen.
* **Material und Leistungen abrechnen:** Gelieferte Geräte als Kostenposition („Ticket charge“) am Ticket erfassen, damit sie in die Abrechnung über Autotask einfließen.
* **Konfigurationselemente je Kunde:** Geräte aus Autotask mit den Serviceinstanzen in den Kunden-Tenants abgleichen.
* **Verträge und Services prüfen:** Verträge und Services eines Kunden in Autotask lesen, um z. B. Tickets dem richtigen Vertrag zuzuordnen.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/pro/dokumentation/automation.md)
* Ein **API-Benutzer** in deiner Autotask-Instanz mit Benutzername, Secret und **API Tracking Identifier**
* Ausreichende Rechte des API-Benutzers für Firmen, Kontakte, Tickets, Konfigurationselemente, Verträge und Produkte
* Für die Trigger: Der API-Benutzer muss in Autotask Webhooks anlegen dürfen
* Für die Pro-Seite der Flows: eine Verbindung des [equipme Connectors](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) mit einem API-Key aus Pro

## Verbindung einrichten

1. In Autotask Benutzername, Secret und API Tracking Identifier des API-Benutzers bereithalten.
2. Im Flow-Designer eine Komponente des Autotask Connectors auf die Arbeitsfläche ziehen (z. B. *ListCompanies*).
3. **Connect account** klicken und eintragen:
   * **Username** – Benutzername des API-Benutzers
   * **Secret** – das Secret des API-Benutzers
   * **API Tracking Identifier** – der Tracking Identifier der Integration
4. Der Connector ermittelt automatisch das richtige Autotask-Rechenzentrum und prüft die Zugangsdaten. Die Verbindung erscheint danach unter **„Accounts“** und steht allen Autotask-Komponenten zur Verfügung.

{% hint style="info" %}
Die Komponenten tragen im Flow-Designer ihren technischen Namen (z. B. *AddTicket*). Auswahlfelder wie „Priority“, „Status“, „Queue“ oder „Company type“ laden ihre Werte direkt aus deiner Autotask-Instanz.
{% endhint %}

## Trigger

| Komponente       | Löst aus, wenn …                        |
| ---------------- | --------------------------------------- |
| WatchTickets     | ein Ticket geändert wird                |
| WatchTicketNotes | eine Ticketnotiz geändert wird          |
| WatchCompanies   | eine Firma (Kunde) geändert wird        |
| WatchContacts    | ein Kontakt geändert wird               |
| WatchAssets      | ein Konfigurationselement geändert wird |

Alle Trigger haben dieselben Einstellungen:

* **„Trigger fields“** – die Felder, deren Änderung den Flow auslöst (z. B. Status eines Tickets)
* **„User defined trigger fields“** – zusätzlich benutzerdefinierte Felder aus Autotask
* **„Notifications email address“** – Adresse, an die Autotask Hinweise zu dieser Benachrichtigung schickt

Autotask meldet die Änderung sofort an Pro; eine regelmäßige Abfrage findet nicht statt. Der Trigger liefert die Daten der Änderung, also die ID und die gewählten Felder.

## Aktionen

### Firmen und Kontakte

| Komponente                 | Zweck                                 | Wichtige Optionen                                                                                                                                                                            |
| -------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddCompany                 | Firma anlegen                         | Pflicht: „Company name“, „Company type“, „Account manager“, „Phone“; „Company number“, Adresse, „Company category“, „Parent company“, „Currency“, „Invoice template“, „Tax region“, „Active“ |
| UpdateCompany              | Firma ändern                          | „Company“ (ID) und die zu ändernden Felder                                                                                                                                                   |
| GetCompany / ListCompanies | Firmen lesen                          | „Company“ bzw. „Filters“                                                                                                                                                                     |
| ListCompanyLocations       | Standorte von Firmen auflisten        | „Filters“                                                                                                                                                                                    |
| GetContact / ListContacts  | Kontakte lesen                        | „Contact“ bzw. „Filters“                                                                                                                                                                     |
| UpdateContact              | Kontakt ändern                        | „Contact“ (ID); Name, E-Mail-Adressen, Telefon, Adresse, „Is active“, „External ID“                                                                                                          |
| UpdateCompanyContact       | Kontakt einer bestimmten Firma ändern | „Company“ und „Contact“ (IDs) sowie die Felder wie bei *UpdateContact*                                                                                                                       |

### Tickets

| Komponente             | Zweck                                          | Wichtige Optionen                                                                                                                                                                                                                                                                            |
| ---------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddTicket              | Ticket anlegen                                 | Pflicht: „Company“, „Title“, „Status“, „Priority“, „Due date time“; „Description“, „Queue“, „Ticket type“, „Issue type“, „Contact“, „Configuration item“, „Contract“, „Contract service“, „Billing code“, „Assigned resource“, „Purchase order number“, „External ID“, „User defined fields“ |
| GetTicket              | Ticket lesen                                   | „Ticket“ (ID)                                                                                                                                                                                                                                                                                |
| AddTicketChecklistItem | Checklisten-Eintrag zu einem Ticket hinzufügen | Pflicht: „Ticket ID“, „Item name“; „Position“, „Is important“, „Is completed“                                                                                                                                                                                                                |
| AddTicketCharge        | Kostenposition zu einem Ticket erfassen        | Pflicht: „Ticket ID“, „Name“, „Charge type“, „Cost type“, „Date purchased“, „Unit quantity“; „Product ID“, „Unit cost“, „Unit price“, „Billing code ID“, „Contract service ID“, „Is billable to company“, „Purchase order number“                                                            |

### Konfigurationselemente, Verträge, Produkte und Services

| Komponente                                | Zweck                                            | Wichtige Optionen                                                                                                             |
| ----------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| ListConfigurationItems                    | Konfigurationselemente auflisten, z. B. je Firma | „Filters“                                                                                                                     |
| ListContracts                             | Verträge auflisten                               | „Filters“                                                                                                                     |
| GetService / ListServices / UpdateService | Services lesen und ändern                        | „Service“ (ID); Name, Preise, „SKU“, „Invoice description“, „Is active“, „User defined fields“                                |
| GetProduct / ListProducts / UpdateProduct | Produkte lesen und ändern                        | „Product“ (ID); Name, Hersteller, „SKU“, „Vendor product number“, Preise, „Is serialized“, „Is active“, „User defined fields“ |
| ListOpportunities                         | Verkaufschancen auflisten                        | „Filters“                                                                                                                     |
| ListTaxRegions                            | Steuerregionen auflisten                         | „Filters“                                                                                                                     |

### Filter in Listen-Aktionen

Listen-Aktionen bieten **„Filters“** aus Bedingungen: „Field“ (Feld aus Autotask, per Auswahl), „Operator“ („equal to“, „not equal to“, „greater than“, „less than“, „begins with“, „ends with“, „contains“, „exist“, „not exist“, „in“, „not in“ u. a.) und „Value“. Bedingungen lassen sich mit UND und ODER kombinieren. Mit **„Use user defined field“** filterst du nach einem benutzerdefinierten Feld – das ist **einmal pro Filter** möglich. Ohne Filter liefert die Aktion alle Einträge.

## Beispiele

### Neue Kunden aus Pro als Firma anlegen

1. **Trigger:** *Equipme Pro › New Customer*.
2. **Autotask › ListCompanies** mit Filter „Company name“ „equal to“ Kundenname; nur weitermachen, wenn kein Treffer gefunden wurde.
3. **Autotask › AddCompany** mit Firmenname, „Company type“ (Kunde), Account Manager, Telefon und Adresse.
4. **Equipme Pro › Update Customer Metadata:** Autotask-ID am Kunden speichern.

### PSA-Ticket für jede Fulfillment-Position

1. **Trigger:** *Equipme Pro › New Fulfillment Order*, gefiltert auf die gewünschten Transaktionsarten (z. B. „Order“, „Return“).
2. **Equipme Pro › Get Customer Metadata:** Autotask-ID des Kunden lesen.
3. **Autotask › AddTicket** mit „Company“ (Autotask-ID), Titel aus Service und Auftragsnummer, Queue, Status, Priorität und Fälligkeit.
4. **Autotask › AddTicketChecklistItem** für die Arbeitsschritte, z. B. „Gerät vorbereiten“, „Versand“, „Übergabe bestätigen“.
5. Nach Abschluss: **Autotask › AddTicketCharge** mit Produkt, Menge und Preis, damit das Gerät über Autotask abgerechnet wird.

### Konfigurationselemente den Serviceinstanzen zuordnen

1. **Trigger:** *Autotask › WatchAssets* mit „Trigger fields“ z. B. auf Seriennummer oder Status.
2. **Equipme Pro › List Service Instances** mit dem Kunden, um die passende Serviceinstanz zu finden (siehe [Serviceinstanzen](https://hub.equipme.io/pro/dokumentation/operations/service-instances.md)).
3. **Equipme Pro › Set Service Instance Metadata Entry:** Autotask-ID und Seriennummer an der Serviceinstanz speichern.

## Hinweise und Grenzen

* Die Trigger reagieren auf **Änderungen** an den gewählten Feldern. Wähle mindestens ein „Trigger field“, sonst meldet Autotask nichts.
* Beim Stoppen des Flows wird die Benachrichtigung in Autotask wieder entfernt.
* Update-Aktionen übernehmen nur **ausgefüllte** Felder. Ein Feld lässt sich damit nicht leeren.
* Neue Kontakte, Konfigurationselemente oder Ticketnotizen lassen sich mit dem Connector nicht anlegen.
* Autotask begrenzt die Zahl der Anfragen pro Stunde für die gesamte Instanz. Der Connector hält höchstens 10.000 Anfragen pro Stunde je Verbindung ein und stellt weitere Anfragen in eine Warteschlange. Plane große Abgleiche über alle Kunden zeitlich verteilt.
* Die Zuordnung Kunde in Pro ↔ Firma in Autotask musst du selbst pflegen, am besten als Metadatum am Kunden.

## Fehlersuche

| Problem                              | Ursache / Lösung                                                                                            |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| „Connect account“ schlägt fehl       | Benutzername, Secret und API Tracking Identifier prüfen. Der Benutzer muss ein API-Benutzer sein.           |
| Auswahlfeld bleibt leer              | Verbindung fehlt oder der API-Benutzer darf den Bereich nicht lesen.                                        |
| Trigger löst nicht aus               | Ist der Flow gestartet? Ist mindestens ein „Trigger field“ gewählt? Darf der API-Benutzer Webhooks anlegen? |
| Ticket landet bei der falschen Firma | Autotask-ID am Kunden in Pro prüfen (Metadatum).                                                            |
| Kostenposition wird abgelehnt        | Pflichtfelder prüfen, insbesondere „Charge type“, „Cost type“ und „Date purchased“, sowie die „Ticket ID“.  |
| Abgleich bricht ab oder wird langsam | Anfragelimit von Autotask erreicht. Filter setzen und Flows zeitlich entzerren.                             |

Bei Fehlern helfen die Protokolle unter **„Insights“**. Für Unterstützung an den [Support](https://hub.equipme.io/pro/dokumentation/help/support.md) wenden und dabei Flow-Name, Komponente und Fehlermeldung angeben.

## Häufige Fragen

**Brauche ich je Kunde eine eigene Autotask-Verbindung?**

Nein. Eine Verbindung zu deiner Autotask-Instanz reicht; den Kunden wählst du in jeder Aktion über die Firmen-ID.

**Ersetzt Autotask die Tickets in Equipme Pro?**

Nein, beide können nebeneinander laufen. Die [Tickets](https://hub.equipme.io/pro/dokumentation/operations/tickets.md) in Pro bleiben unverändert; der Connector überträgt nur, was du im Flow festlegst.

**Kann ich Tickets aus Autotask auflisten?**

Ein einzelnes Ticket liest du mit *GetTicket*. Auf Änderungen reagierst du mit *WatchTickets*.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/pro/dokumentation/automation/connectors/autotask.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
