Einrichtung¶

Die Seite Support Einrichtung enthält alle grundlegenden Einstellungen für die AD Support App. Hier konfigurieren Sie Nummernserien, E-Mail-Vorlagen, Standardwerte, die Azure-Anbindung und Hintergrundaufträge.

Seite öffnen¶

Suchen Sie in Business Central nach Support Setup
Oder navigieren Sie über das Support-Rollencenter → Einrichtung

Allgemein¶

Grundlegende Einstellungen für das Support-Modul.

Feld	Beschreibung
Support-Nummernserien	Die Nummernserie, die für neue Support-Tickets verwendet wird. Muss vor dem Erstellen des ersten Tickets eingerichtet sein.
System-BCC-E-Mail	Alle vom System generierten E-Mails werden als BCC an diese Adresse gesendet. Nützlich zur Archivierung oder Kontrolle. Leer lassen, um die Funktion zu deaktivieren.
Support-E-Mail	Die Support-E-Mail-Adresse, die in der Fußzeile aller ausgehenden E-Mails angezeigt wird.
Nicht-abrechenbare Ressourcen	Pipe-getrennte Liste von Ressourcencodes, die von der Abrechnung ausgeschlossen werden. Beispiel: `RS0110\\|RS0040\\|RS0170`. Zeiteinträge dieser Ressourcen werden nicht in Rechnungen übernommen.
Firmenlogo-URL	URL zum Firmenlogo für E-Mails. Muss eine öffentlich erreichbare URL sein (z. B. `https://www.altenbrand.de/logo.png`). Das Logo wird in E-Mail-Kopfzeilen angezeigt.

Standardwerte¶

Vorbelegungen, die automatisch bei der Erstellung neuer Tickets und Zeiteinträge verwendet werden.

Feld	Beschreibung
Standard-Arbeitstyp	Der Arbeitstyp, der standardmäßig für neue Support-Zeilen verwendet wird. Bestimmt den Stundensatz.
Standard-Sprachcode	Sprachcode für E-Mail-Vorlagen (z. B. `DEU` für Deutsch, `ENU` für Englisch).
Standard-Abrechnungsintervall	Mindest-Abrechnungseinheit in Stunden. Beispiel: `2` bedeutet, dass ein Ticket mindestens 2 Stunden abgerechnet wird.
Standard-Arbeitsintervall	Rundungsintervall für Arbeitszeiten in Stunden. Beispiel: `0.25` bedeutet Rundung auf 15-Minuten-Schritte.
Standard-Kontingent-Warnstunden	Schwellenwert für verbleibende Kontingent-Stunden, ab dem eine Warnung ausgelöst wird. Wird verwendet, wenn kein kontingentspezifischer Schwellenwert definiert ist.
Kontingent-Benachrichtigungsempfänger	Semikolon-getrennte E-Mail-Adressen, die bei Kontingent-Warnungen und -Erschöpfungen benachrichtigt werden.
Monatliche Paketabrechnung aktivieren	Aktiviert die automatische monatliche Rechnungserstellung für Kunden mit Postpaid-Support-Paketen.
Paketrechnungstag	Tag im Monat, an dem die monatlichen Paketrechnungen erstellt werden. Nur sichtbar, wenn die monatliche Paketabrechnung aktiviert ist.

E-Mail-Vorlagen¶

Einstellungen für den E-Mail-Versand und den Testmodus.

Feld	Beschreibung
Test-E-Mail-Empfänger	Wenn ausgefüllt, werden alle E-Mails an diese Adresse gesendet statt an die tatsächlichen Empfänger. Verwenden Sie dieses Feld ausschließlich zu Testzwecken. Im Produktivbetrieb muss das Feld leer sein.
Testmodus-Vorschau	Zeigt das aktuelle E-Mail-Routing-Verhalten an. Warnt visuell, wenn der Testmodus aktiv ist (orangefarbene Hervorhebung).
Bestätigungs-E-Mail senden	Wenn aktiviert, wird automatisch eine Bestätigungs-E-Mail an den Kunden gesendet, sobald ein neues Ticket erstellt wird.

Eingehende E-Mails¶

Einstellungen für die automatische Verarbeitung eingehender Support-E-Mails.

Feld	Beschreibung
Standardressource	Die Ressource (Mitarbeiter), die automatisch erstellten Tickets aus eingehenden E-Mails zugewiesen wird.
Eingangs-Postfach	Die E-Mail-Adresse, die von der Azure Function auf neue E-Mails überwacht wird (z. B. `support@altenbrand.de`).
Tickets automatisch erstellen	Wenn aktiviert, werden für E-Mails, die keinem bestehenden Ticket zugeordnet werden können, automatisch neue Tickets angelegt.
Inaktivitäts-Erinnerung (Tage)	Anzahl der Tage ohne Aktivität, nach denen eine Erinnerung an die zuständige Ressource gesendet wird. `0` deaktiviert die Funktion.

Azure Function Konfiguration¶

Hier konfigurieren Sie die Anbindung an die Azure Function, die den E-Mail-Empfang über Microsoft Graph steuert. Die Azure Function pollt regelmäßig ein Postfach und leitet neue E-Mails über die BC-API an das Support-Modul weiter.

Architekturübersicht¶

E-Mail-Postfach (Exchange Online)
        ↓ (Microsoft Graph API)
Azure Function (Email Poller)
        ↓ (BC REST API)
Business Central → Support-Ticket

Microsoft Graph Authentifizierung¶

Diese Felder konfigurieren die OAuth2-Authentifizierung für den Zugriff auf das E-Mail-Postfach über die Microsoft Graph API.

Feld	Beschreibung
Graph Client ID	Die Client-ID der Entra ID (Azure AD) App-Registrierung, die für die Microsoft Graph-Authentifizierung verwendet wird. Sie finden diese im Azure Portal unter Entra ID → App-Registrierungen → Ihre App → Übersicht.
Graph Secret Name	Der Name des Secrets im Azure Key Vault, das den Client Secret für Microsoft Graph enthält. Beispiel: `GraphClientSecret`.
Graph Scope	Der OAuth-Bereich für die Graph-Token-Anfragen. Standardwert: `https://graph.microsoft.com/.default`.
Graph Client Secret	Der Client Secret für die Microsoft Graph API. Wird bei der Synchronisierung sicher im Azure Key Vault gespeichert. Eingabe als maskiertes Feld.

Business Central API Authentifizierung¶

Diese Felder konfigurieren die Verbindung der Azure Function zurück zu Business Central, um empfangene E-Mails als Tickets einzuspeisen.

Feld	Beschreibung
BC API Basis-URL	Die Basis-URL der Business Central API, die der Email Poller verwendet. Format: `https://api.businesscentral.dynamics.com/v2.0/{TenantID}/{Environment}/api/altenbrand/support/v1.0`.
BC Client ID	Die Client-ID der Entra ID App-Registrierung für die BC-OAuth-Authentifizierung. Diese muss Berechtigungen für die BC-API haben.
BC Secret Name	Der Name des Secrets im Azure Key Vault für den BC Client Secret. Beispiel: `BcClientSecret`.
BC Scope	Der OAuth-Bereich für BC-Token-Anfragen. Format: `https://api.businesscentral.dynamics.com/.default`.
BC Client Secret	Der Client Secret für die Business Central API. Wird bei der Synchronisierung im Azure Key Vault gespeichert.

Polling & Speicherung¶

Feld	Beschreibung
Poll-Intervall (Minuten)	Wie oft die Azure Function das Postfach auf neue E-Mails prüft. Empfehlung: `5` Minuten.
Processed Emails Table	Name der Azure Table Storage-Tabelle für die Deduplizierung verarbeiteter E-Mails. Standard: `ProcessedEmails`. Verhindert die doppelte Verarbeitung bereits importierter E-Mails.

Endpunkte & Schlüssel¶

Feld	Beschreibung
Azure Config Sync URL	Die URL des ConfigSync-Endpunkts der Azure Function. Wird verwendet, um die Konfiguration von BC an die Azure Function zu übertragen. Format: `https://{FunctionAppName}.azurewebsites.net/api/ConfigSync`.
Azure Function Key	Der Function Key für die Authentifizierung gegen den ConfigSync-Endpunkt. Wird sicher in der Isolated Storage gespeichert. Zu finden im Azure Portal unter Function App → Functions → ConfigSync → Function Keys.
ProcessEmailManual Key	Der Function Key für den manuellen E-Mail-Abruf. Ermöglicht es, den E-Mail-Import über einen HTTP-Trigger auszulösen. Zu finden unter Function App → Functions → ProcessEmailManual → Function Keys.

Ersteinrichtung der Azure-Anbindung¶

So richten Sie die Azure-Konnektivität ein:

Entra ID App-Registrierungen erstellen (zwei Stück: eine für Graph, eine für BC)
Graph-App: Berechtigungen Mail.Read und Mail.ReadWrite (Application-Typ) erteilen
BC-App: Berechtigungen für die BC-API erteilen
Azure Function deployen (siehe Ordner AzureFunction/SupportEmailPoller)
Felder oben ausfüllen – alle Client-IDs, Scopes und Secrets eintragen
Aktion "Test Graph Connection" ausführen, um die Verbindung zu prüfen
Konfiguration synchronisieren – die Aktion überträgt alle Einstellungen sicher an die Azure Function

Copilot-Konfiguration¶

Status der KI-Integration für Support-Ticket-Klassifizierung.

Feld	Beschreibung
Konfigurationsstatus	Zeigt an, ob die KI korrekt in der zentralen AI-Einrichtung konfiguriert ist. Grün = bereit.
Support-Klassifizierung	Zeigt an, ob die automatische Ticket-Klassifizierung über Copilot aktiviert ist. Wird in der zentralen AI-Einrichtung gesteuert.

Über die Aktion AI Setup öffnen gelangen Sie zur zentralen KI-Konfiguration.

Aufgabenwarteschlange¶

Übersicht über alle automatisierten Hintergrundaufträge des Support-Moduls. Die Status werden farblich hervorgehoben: Grün = aktiv, Rot = Fehler, Grau = nicht eingerichtet.

Auftrag	Intervall	Beschreibung
Bestätigungs-E-Mails	1 Minute	Verarbeitet ausstehende Bestätigungs-E-Mails. Läuft häufig, da der API-Benutzer keine E-Mails direkt über Graph versenden kann.
SLA-Report	Täglich	Sendet den SLA-Report an alle Kunden mit aktiviertem automatischem Report.
Erinnerung	Täglich	Sendet Erinnerungs-E-Mails an zuständige Mitarbeiter.
Kontingentprüfung	Täglich	Prüft erschöpfte Kontingente und deaktiviert diese automatisch.
Inaktivitäts-Erinnerung	Täglich	Erinnert bei inaktiven Tickets basierend auf der konfigurierten Anzahl Tage.
Paketabrechnung	Täglich	Erstellt monatliche Rechnungen für Postpaid-Paketkunden am konfigurierten Rechnungstag.
Support-Report	Monatlich	Sendet monatliche Support-Reports an alle aktiven Kunden. Enthält Tickets des Vormonats plus alle offenen Tickets. Läuft täglich, sendet aber nur am 1. des Monats.

Aktionen¶

Aktion	Beschreibung
Alle Jobs registrieren	Erstellt alle erforderlichen Aufgabenwarteschlangeneinträge auf einmal.
Graph-Verbindung testen	Testet die Microsoft Graph-Verbindung mit den konfigurierten OAuth2-Einstellungen. Zeigt detaillierte Diagnoseinformationen an.
AI Setup öffnen	Öffnet die zentrale KI-Einrichtungsseite für Azure OpenAI-Einstellungen.