Integrationen

HaloPSA verbinden — Schritt für Schritt

Was ein Agent mit HaloPSA kann

Sobald HaloPSA verbunden ist, kann ein Taabit-Agent:

Tickets suchen, lesen, erstellen, kommentieren und schliessen
Kunden, Sites, Assets, Users abfragen und ergänzen
Aufwand über Actions buchen
Reports über die SQL-Schnittstelle abfragen (Read-only)
Workflows und Runbooks triggern

Beispiel: „Schau Ticket #4271 an, fasse zusammen und buche 30 Minuten." — der Agent lädt das Ticket, durchsucht ähnliche Fälle, formuliert eine Antwort und legt eine Action mit Zeit-Buchung an.

API-Application in HaloPSA anlegen

Du brauchst Admin-Rechte in HaloPSA.

Öffne dein HaloPSA-Portal (z.B. `portal.firma.ch`).
Gehe zu Configuration → Integrations → HaloPSA API.
Klicke auf View Applications und dann Add Application.
Konfiguriere:

- Application Name: z.B. „Taabit-Agent"

- Authentication Method: Client ID and Secret (Services) — also Client-Credentials-Flow

- Login Type: Agent

- Agent: wähle einen Service-Agent mit den nötigen Berechtigungen (z.B. einen dedizierten „API-Agent" mit Permission-Profile passend zum geplanten Zugriff)

- Permissions: mindestens `all:standard` für Volllzugriff oder spezifischer

Speichern. Notiere dir Client ID und Client Secret — das Secret wird nur einmal angezeigt.

Daten in Taabit hinterlegen

Öffne Einstellungen → Integrationen in Taabit.
Wähle HaloPSA aus der Liste.
Fülle aus:

- Resource Server — die Basis-URL deines HaloPSA-Portals, z.B. `https://portal.firma.ch` (ohne abschliessenden Slash)

- Tenant-Name (optional) — nur wenn dein Hosting eine `tenant`-Subdomain nutzt

- Client ID — aus HaloPSA kopiert

- Client Secret — aus HaloPSA kopiert

Speichern. Taabit fordert sofort einen Test-Token an, um die Daten zu validieren.

Agenten Zugriff geben

Öffne Agenten → [dein Agent] → Zugriff.
Aktiviere HaloPSA in der Tool-Liste.
Optional: Wenn du nur SQL-Reports willst, deaktiviere `halopsa_api_call` und behalte nur `halopsa_execute_sql`. Damit kann der Agent nur lesen.

Häufige Stolperfallen

401 Unauthorized — die Client-Credentials sind falsch oder das Application ist deaktiviert. Prüfe das Application in HaloPSA und stelle sicher, dass „Active" gesetzt ist.
403 Forbidden auf bestimmte Endpoints — der Service-Agent hat nicht die nötigen Permissions. Passe das Permission-Profile in HaloPSA an.
Pagination-Fehler — der Parameter heisst `page_no` (mit Unterstrich), nicht `pageno`. Der Agent kennt das, falls eigene SQL-Queries Probleme machen, hier prüfen.
SQL-Read-only — `halopsa_execute_sql` erlaubt nur `SELECT`. Schreibzugriff geht ausschliesslich über die REST-API.

Tipp: Sandbox vs. Produktion

HaloPSA bietet meist eine Staging-Umgebung (`portal-staging.firma.ch`). Lege zuerst ein API-Application dort an und teste deinen Agent gegen Staging. Wenn alles läuft, wechselst du in Taabit den Resource-Server auf Prod.

Nächste Schritte

Nutze die Vorlage „HaloPSA Service-Desk-Assistent" unter Agenten → Vorlagen-Bibliothek als Startpunkt — sie enthält Instruktionen für Ticket-Triage, Action-Buchung und Eskalations-Patterns.