Integrationen

Die Seite Integrations (/admin/integrations) verbindet nara mit externen Systemen. Anbieter sind nach Domänen gruppiert: Communication, Knowledge base, Productivity und Ticketing. Pro Domäne ist nur eine Integration erlaubt — sobald ein Anbieter verbunden ist, sind die übrigen derselben Domäne blockiert, bis er getrennt wird.

Anbieter verbinden

1. Wählen Sie eine Anbieterkarte und klicken Sie auf Connect.
2. Geben Sie die Zugangsdaten für die Authentifizierungsmethode des Anbieters ein:
   • OAuth — melden Sie sich an und erteilen Sie die Freigabe im Consent-Flow des Anbieters.
   • Client Credentials — geben Sie Client ID, Client Secret und Tenant ID ein.
   • API Token — geben Sie das Token sowie Base URL und Username/Email ein.
3. Speichern Sie. Die Integration wechselt auf Active, und die erste Synchronisierung startet.

Eine Integration hat einen von drei Status: Active, Disabled oder Error. Mit Re-sync stoßen Sie eine neue Synchronisierung an, mit Disconnect entfernen Sie die Integration.

Webhooks

Anbieter, die Änderungen an nara übermitteln, registrieren beim Einrichten einen Webhook. In der Integration können Sie mit Rotate secret das aktuelle Webhook-Secret ungültig machen und mit Retry setup eine fehlgeschlagene Webhook-Registrierung wiederholen. Confluence Cloud unterstützt die erforderlichen Webhooks nicht; nara nutzt dort ersatzweise Polling.

Lokales Hosting

Ist ein Anbieter nur innerhalb Ihres Netzwerks erreichbar, aktivieren Sie den Schalter Local hosting, um den gesamten Anbieterverkehr über ein Online-Edge-Deployment zu leiten. Das Deployment muss online sein, damit Synchronisierungen laufen.

Ausgehende Synchronisierung

Der Schalter Outbound sync steuert, ob Änderungen aus nara (zum Beispiel Ticket-Updates) zurück in das Anbietersystem geschrieben werden. Deaktivieren Sie ihn, um die Integration nur lesend zu betreiben.

Hinweise zu einzelnen Anbietern

ServiceNow

Synchronisiert Incidents, Requests und Catalog Tasks. Die Integration zeigt den Sync-Zustand pro Tabelle, unterstützt einen Dry run zur Vorschau ohne Schreibzugriff und bietet einen Backfill zum Import historischer Datensätze.

Zammad

Ticketing-Integration, verbunden per API-Token; Tickets synchronisieren in beide Richtungen, wenn die ausgehende Synchronisierung aktiv ist.

Confluence

Wissensdatenbank-Integration; Seiten werden in den Memory-Bestand aufgenommen. Confluence Cloud nutzt Polling statt Webhooks (siehe oben).

Microsoft Teams

1. Package download — laden Sie das nara-Teams-App-Paket herunter.
2. Authorize — erteilen Sie den Admin-Consent für die erforderlichen Microsoft-Berechtigungen.
3. Publish to catalog — laden Sie das Paket in den Teams-App-Katalog Ihrer Organisation hoch.
4. Wählen Sie den Default Teams agent, der Konversationen aus Teams beantwortet.

Microsoft Graph / SharePoint / Kalender

Verbindet Microsoft 365 für SharePoint-Wissenssynchronisierung, Kalenderzugriff und Directory sync. Die Availability preview führt eine Free/Busy-Prüfung eines Postfachs durch, damit Sie den Kalenderzugriff verifizieren können, bevor Agenten sich darauf verlassen.

Jira

Ticketing-Integration für Jira-Issues.

Zendesk

Ticketing-Integration für Zendesk-Tickets.

Hinweis

Tools, die von einer Integration abhängen, erscheinen im Panel Available Integrations des Tool-Editors; sie funktionieren nur, solange die Integration Active ist.