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.

GLPI

Ticketing-Integration, verbunden per GLPI-Benutzer-API-Token plus optionalem App-Token. Die GLPI-REST-API muss aktiviert und die Zeitzone des API-Kontos auf UTC gestellt sein. Tickets, Followups, Aufgaben, Lösungen und Dokument-Anhänge synchronisieren per Polling nach nara; die ausgehende Synchronisierung schreibt Ticketänderungen zurück nach GLPI.

GLPI Knowledge Base

Wissensdatenbank-Integration mit denselben GLPI-Zugangsdaten wie der Ticketing-Provider. Artikel, Kategorien und Dokument-Anhänge werden per Polling ins Wissen importiert; Artikel außerhalb ihres Sichtbarkeitsfensters werden entfernt. Die ausgehende Synchronisierung schreibt Artikeländerungen zurück nach GLPI.

Confluence

Wissensdatenbank-Integration; Seiten werden ins Wissen importiert. Confluence Cloud nutzt Polling statt Webhooks (siehe oben).

Microsoft Teams

1. Adminzustimmung — melden Sie sich mit einem Microsoft-Konto an, und erteilen Sie die erforderlichen Berechtigungen.
2. Teams-App — reichen Sie nara mit nara zur Freigabe einreichen beim Teams-App-Katalog Ihrer Organisation ein, und prüfen Sie mit Teams-Status prüfen, bis ein Teams-Admin die App genehmigt hat. Ist nara im Teams Store verfügbar, öffnen Sie die App stattdessen dort.
3. Assistent für Teams — wählen Sie den Assistenten, der Teams-Chats und Teams-Anrufe beantwortet. Ohne Auswahl antwortet der Standard-Assistent.
4. Telefonnummern — verbinden Sie Teams-Phone-Nummern Ihrer Ressourcenkonten, und wählen Sie auf der Seite Telefonnummern für jede einen Assistenten.

Nutzer im verbundenen Microsoft-Tenant werden beim ersten Teams-Chat automatisch angelegt, ohne Dashboard-Login. Sie erhalten die Mitgliedsrolle und benötigen eine aktive Lizenz mit einem freien Sitz. Entferne Zugriff über die Mitgliederverwaltung in nara; entfernte Nutzer werden nicht erneut automatisch angelegt.

Teams-Telefonnummern

nara beantwortet eine Teams-Telefonnummer nur, wenn die Nummer zu einem Ressourcenkonto gehört, das mit der Anwendungs-ID von nara verknüpft ist. Der Abschnitt Teams Phone der Microsoft-Teams-Integration zeigt diese ID.

Das Teams Admin Center erstellt nur Ressourcenkonten für automatische Telefonzentralen und Anrufwarteschlangen. Anrufe an ein solches Konto erreichen nara nie und werden sofort beendet. Erstellen Sie das Ressourcenkonto stattdessen in Teams PowerShell:

Connect-MicrosoftTeams
New-CsOnlineApplicationInstance -UserPrincipalName <konto@ihre-domain> -ApplicationId <nara-anwendungs-id> -DisplayName "nara phone assistant"
Set-CsPhoneNumberAssignment -Identity <konto@ihre-domain> -PhoneNumber <+E.164-nummer> -PhoneNumberType <CallingPlan|OperatorConnect|DirectRouting>

Weisen Sie dem Konto eine Lizenz Microsoft Teams Phone Resource Account zu, bevor Sie die Nummer zuweisen.

nara kann nicht sehen, mit welcher Anwendung ein Ressourcenkonto verknüpft ist. Der Abschnitt Teams Phone listet eine Nummer deshalb erst, wenn ihr erster Anruf nara erreicht:

1. Rufen Sie die neue Nummer einmal an. Der Anruf endet, weil noch kein Assistent antwortet.
2. Wählen Sie im Abschnitt Teams Phone die Option Nummer verbinden.
3. Weisen Sie der Nummer auf der Seite Telefonnummern einen Assistenten zu.

Erscheint die Nummer nach einem Anruf nicht, hat der Anruf nara nicht erreicht.

Anrufe werden sofort beendet

Prüfen Sie die Verknüpfung des Kontos in Teams PowerShell:

Get-CsOnlineApplicationInstance -Identity <konto@ihre-domain> | Format-List ApplicationId,PhoneNumber

Ist ApplicationId nicht die Anwendungs-ID von nara, entfernen Sie das Konto aus seiner automatischen Telefonzentrale oder Anrufwarteschlange und verknüpfen Sie es mit nara. Telefonnummer und Lizenz bleiben am Konto. Microsoft kann mehrere Stunden brauchen, bis die Änderung wirkt.

Set-CsOnlineApplicationInstance -Identity <konto@ihre-domain> -ApplicationId <nara-anwendungs-id>
Sync-CsOnlineApplicationInstance -ObjectId <objekt-id-des-kontos> -ApplicationId <nara-anwendungs-id>

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 nara sich darauf verlässt.

Agenten können freie Zeiten finden und Teams-Besprechungen für den angemeldeten Benutzer anlegen. Freie Zeiten benötigen die Anwendungsberechtigung Calendars.Read, die Personensuche User.Read.All und das Anlegen von Besprechungen User.Read.All und Calendars.ReadWrite. Eine Calendars.ReadWrite-Berechtigung in Microsoft Entra ID gilt für alle Postfächer. Um sie auf die Personen zu beschränken, die Besprechungen organisieren, weisen Sie stattdessen die Exchange-Online-Rolle Application Calendars.ReadWrite mit einem Management Scope zu. Siehe RBAC für Anwendungen in Exchange Online.

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.