Schnittstellen & APIs unserer Module
Viele unserer Module sind nicht nur Oberfläche. Sie lassen sich von außen aufrufen, sie schicken Ereignisse aktiv weiter, und sie legen Daten so ab, dass Ihre Systeme sie weiterverarbeiten können. Diese Seite zeigt, welches Modul welchen Weg anbietet — mit Endpunkt, Authentifizierung und Beispielaufruf.
Sie richtet sich an Entwickler und Systemhäuser, die eine STARFACE in eine Fachanwendung, ein ERP, ein Ticketsystem oder ein Monitoring einbinden.
Sie brauchen einen STARFACE-Benutzer mit den passenden Rechten, die Modulinstanz muss aktiv sein, und das Modul muss lizenziert sein. Der genaue Instanzname ist Teil des Methodennamens.
Bauen Sie selbst ein STARFACE-Modul?
Dann brauchen Sie keine Schnittstelle im klassischen Sinn. Sie können Ereignisse ("Events") aus unseren Modulen direkt abonnieren — mit drei Modulfunktionen, die Sie einfach in Ihr eigenes Modul als Ressource hochladen.
Vorbild sind die STARFACE-eigenen Funktionen register call events und unregister call events: Sie übergeben eine Modulfunktion, die bei jedem Ereignis aufgerufen wird. Genau so arbeiten diese drei — nur für unsere Ereignisse.
Bequemer: alle drei zusammen als ZIP, inklusive Kurzanleitung.
Laden Sie die Dateien als Ressource im Modul-Designer hoch. Nach dem Neuladen des Moduls erscheinen die Funktionen im ModulDesigner. Bitte alle drei Dateien kopieren, sie gehören zusammen.
Voraussetzung ist STARFACE 8 oder neuer.
Nach dem Hochladen stehen die drei Funktionen im Modul-Designer unter / Module bereit — genau wie die eingebauten STARFACE-Funktionen.
Fluxpunkt: FpEvent abonnieren
Verknüpft ein Ereignis mit einer Ihrer Modulfunktionen. Aufrufen im Einstiegspunkt
onActivate.
| Parameter | Bedeutung |
|---|---|
| Ereignis | Name des Ereignisses, z. B. TranscriptionEvent. Ein abschließendes * wirkt als Platzhalter: Ivr* abonniert alle Pro-IVR-Ereignisse, * alle Ereignisse überhaupt. |
| Modulfunktion | Name der Funktion in Ihrem Modul, die bei jedem Ereignis läuft. |
Ihre Funktion bekommt die Daten über gleichnamige Eingabevariablen. Alle drei sind optional — gefüllt wird nur, was Sie auch anlegen:
| Eingabevariable | Typ | Inhalt |
|---|---|---|
fpEvent | Map | Die Nutzlast als Map — der bequeme Weg im ModulDesigner. |
fpEventJson | Text | Dieselbe Nutzlast als JSON. Robuster, wenn sich Felder ändern oder verschachtelt sind. |
fpEventName | Text | Name des ausgelösten Ereignisses. Wichtig bei Platzhaltern. |
Fluxpunkt: FpEvent abbestellen
Beendet das Abonnement. Gehört in onDeactivate und onDelete, damit ein abgeschaltetes Modul
keine Ereignisse mehr verarbeitet.
| Parameter | Bedeutung |
|---|---|
| Ereignis | Genau der Wert, mit dem Sie abonniert haben (inklusive *). Leer lassen beendet alle Abonnements dieser Modulinstanz — das ist der übliche Fall. |
| Beendete Abonnements (Ausgabe) | Anzahl der tatsächlich beendeten Abonnements. |
Fluxpunkt: FpEvent senden
Sendet ein eigenes Ereignis. Damit hängt sich Ihr Modul in dieselbe Kette wie unsere: EventBridge kann Ihr Ereignis abgreifen und als Webhook, E-Mail, Syslog oder Datenbankeintrag weiterreichen — Sie müssen keine eigene Zustellung bauen.
| Parameter | Bedeutung |
|---|---|
| Ereignis | Frei wählbarer Name, z. B. MeinModulAuftragAngelegt. Platzhalter sind hier nicht erlaubt. |
| Nutzdaten (Map) | Die Nutzlast als Map. Hat Vorrang, wenn beides gesetzt ist. |
| Nutzdaten (JSON) | Die Nutzlast als JSON-Text. |
| Gesendete Nutzlast (Ausgabe) | Das JSON, das tatsächlich gesendet wurde. |
Ein Partner baut ein Modul für seine Branchensoftware. Er legt eine Funktion AufTranskription
an, gibt ihr die Eingabevariablen fpEvent und fpEventJson und abonniert in onActivate das
Ereignis TranscriptionEvent. Ab sofort landet jeder transkribierte Anruf direkt in seiner
Anwendung — ohne Middleware, ohne Datenbankzugriff, ohne zusätzliche Lizenz.
Welche Ereignisse es gibt, steht weiter unten unter Ereignisse zwischen den Modulen — die vollständige Liste mit Beispiel-Nutzlast finden Sie in der Ereignisliste der EventBridge-Dokumentation. Fehlt Ihnen eins? Schreiben Sie uns.
Die vier Wege im Überblick
| Weg | Wofür | Richtung | Beispielmodule |
|---|---|---|---|
| XML-RPC-Befehle | Eine Funktion gezielt auslösen oder Daten abfragen | Ihr System → STARFACE | Admin Power Pack, Monitoring, Notruf & Alarmierung |
| Webhooks & Events | Auf Anrufe und Ereignisse reagieren | STARFACE → Ihr System | EventBridge, Pro IVR, Call Recording, Presence Sync |
| Netzwerkdienste | Standardprotokolle statt eigener Anbindung | beide | Monitoring (SNMP, CheckMk), DirectoryHub (LDAP) |
| Datenschnittstellen | Größere Datenmengen auswerten oder archivieren | STARFACE → Ihr System | Insight Analytics, Zeiterfassung, Call Recording |
Am schnellsten sind Sie meist mit EventBridge am Ziel: Das Modul verschickt bei jedem Ereignis einen frei gestalteten HTTP-Aufruf an Ihre Anwendung — ganz ohne Programmierung auf der Anlage.
Weg 1: XML-RPC-Befehle — eine Funktion von außen auslösen
Einige Module melden eigene Befehle an der STARFACE-XML-RPC-Schnittstelle an. Sie rufen sie wie jede andere Anlagenfunktion auf.
Endpunkt: https://<Ihre-STARFACE>/xml-rpc
Methodenname: <Instanzname>.<Befehl> — also zum Beispiel Admin Power Pack.ProvisionDevices
Format: XML-RPC, ein einzelnes struct als Parameter
Ein Aufruf sieht so aus:
<?xml version="1.0"?>
<methodCall>
<methodName>Admin Power Pack.DeleteLogs</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>scope</name>
<value><string>old</string></value>
</member>
</struct>
</value>
</param>
</params>
</methodCall>
Ihr Monitoring stellt fest, dass die Festplatte der Anlage zu 90 % voll ist. Statt einen Techniker
zu wecken, ruft das Monitoring nachts um 3 Uhr Admin Power Pack.RunAutoCleanup auf. Am Morgen ist
die Platte aufgeräumt, das Ticket hat sich von selbst geschlossen.
Admin Power Pack — 12 Wartungsbefehle
Jede Funktion aus lässt sich auch per API auslösen. Den fertigen Aufruf bekommen Sie direkt im Modul: Öffnen Sie das Menü einer Funktion und wählen Sie API-Aufruf. Dort stehen Endpunkt, Methodenname und ein kopierbarer Beispiel-Body.
| Befehl | Wirkung | Parameter |
|---|---|---|
RunAutoCleanup | Führt die konfigurierte automatische Bereinigung aus | – |
DeleteSystemMessages | Löscht die Systemmeldungen | – |
DeleteLogs | Löscht Logdateien | scope: old | all |
DeleteTemporaryFiles | Löscht temporäre Dateien | – |
DeleteRecordings | Löscht Gesprächsaufzeichnungen | – |
DeleteFaxes | Löscht Faxe | – |
DeleteCallData | Löscht Ruflisteneinträge | startTime, endTime (Zeitstempel in ms), incoming, outgoing, missed, answered (bool), filter, confirmed |
DeleteFirmware | Löscht Firmware-Dateien | vendor: all | snom | yealink | gigaset | other |
DeleteBackups | Löscht Sicherungen | scope: all | allExceptLast |
ReRegisterTrunks | Meldet alle Leitungen neu an | – |
HangupAllCalls | Beendet alle aktiven Gespräche | – |
ProvisionDevices | Stößt die Provisionierung der Telefone an | type: check-sync | check-sync-reboot | reboot-snom | factory-reset-snom | factory-reset-yealink |
Authentifizierung: Anmeldung als STARFACE-Benutzer mit Administrationsrecht. Das Modul prüft das Recht zusätzlich selbst und lehnt Aufrufe ohne Administrationsrecht ab.
Antwort: {status: "ok"} bzw. {status: "error"}. Die Ausführung läuft danach im Hintergrund —
die Antwort bestätigt die Annahme, nicht das Ergebnis.
Lizenz: erforderlich.
Sie rollen abends neue Telefon-Firmware aus. Ihr Deployment-Skript ruft nach dem Upload
Admin Power Pack.ProvisionDevices mit type: check-sync-reboot auf. 120 Telefone holen sich die
neue Konfiguration, ohne dass jemand vor Ort ist.
Ab der nächsten Modulversion kommen zwei Systemaktionen hinzu: RestartStarface und
UpdateStarface starten bzw. aktualisieren die STARFACE — sofort oder zu einem geplanten
Zeitpunkt. Ebenfalls neu ist dann eine HTTP-API mit statischen API-Tokens: im Modul erzeugte
Bearer-Tokens, mit denen Drittsysteme dieselben Befehle ohne STARFACE-Benutzerkonto und ohne
ablaufende Zugangsdaten aufrufen — gedacht für dauerhafte Anbindungen wie ERP- oder RMM-Systeme.
Alle Befehle mit vollständigen Parametern, Antworten, Fehlercodes und Beispielen dokumentiert die API-Referenz von Admin Power Pack.
Monitoring — Anlagendaten abfragen
| Befehl | Rückgabe | Parameter | Authentifizierung |
|---|---|---|---|
GetMonitoringData | data: Anlagendaten im CheckMk-Local-Format | useLocalChecks (bool, Standard false) | angemeldeter Benutzer |
GetMonitoringDataXML | data: Anlagendaten als XML | – | angemeldeter Benutzer |
isActiveDirectoryEnabled | activeDirectoryEnabled: "true" | "false" | – | keine (bewusst, wie im Referenzmodul) |
Ihr PRTG fragt alle fünf Minuten Monitoring.GetMonitoringData ab und wertet Leitungsstatus,
Speicherplatz und Gesprächsqualität aus. Fällt ein SIP-Trunk aus, steht die Störung im selben
Dashboard wie Ihre Server — kein zweites Monitoring-Werkzeug nötig.
Details zu allen drei Abfragen inklusive Authentifizierung und Antwortformaten: API-Referenz von Monitoring.
Notruf & Alarmierung — Alarm auslösen und beenden
Für Fremdsysteme wie Brandmeldeanlagen, Gebäudeleittechnik oder Panikschalter bietet das Modul zwei Befehle:
| Befehl | Wirkung |
|---|---|
rpcStartEmergencyCall | Löst die hinterlegte Alarmkonfiguration aus |
rpcStopEmergencyCall | Beendet einen laufenden Alarm |
Beide Befehle nehmen keine Parameter. Welche Alarmkonfiguration ausgelöst wird, legen Sie im Modul fest.
Die XML-RPC-Schnittstelle ist standardmäßig ausgeschaltet. Sie aktivieren sie im Modul unter Auslöser. Wenn sie aktiv ist, kann jeder, der die Anlage erreicht, einen Alarm auslösen oder beenden — die Befehle verlangen keine Anmeldung. Aktivieren Sie sie nur, wenn der Zugriff auf die Anlage bereits netzseitig eingeschränkt ist.
Das Modul erzeugt Ihnen auf Wunsch eine fertige Postman-Sammlung mit dem kompletten Aufruf.
Ein Pflegeheim betreibt Notruftaster in den Zimmern über eine eigene Rufanlage. Diese ruft bei
Auslösung Notruf & Alarmierung.rpcStartEmergencyCall auf. Innerhalb von Sekunden klingeln alle
DECT-Geräte des Pflegeteams mit Ansage — ohne dass die Rufanlage SIP sprechen muss.
Endpunkt, Aktivierung, Sicherheitshinweise und fertige Beispiele: API-Referenz von Notruf & Alarmierung.
Weg 2: Der Modulkanal <Instanzname>.xmlrpc
Jedes Modul auf Basis unserer Bibliothek meldet zusätzlich eine allgemeine Methode
<Instanzname>.xmlrpc an. Darüber spricht die Modul-Oberfläche mit ihrem Backend. Der Kanal ist
technisch auch von außen nutzbar: Sie senden einen Base64-kodierten JSON-Auftrag mit Aktionsnamen und
Nutzdaten und benötigen dafür ein gültiges Zugriffstoken der STARFACE sowie in aller Regel
Administrationsrechte.
Die Aktionsnamen dieses Kanals gehören zur Oberfläche und können sich mit jedem Modul-Update ändern. Wir garantieren dafür keine Stabilität. Bauen Sie produktive Integrationen bitte nicht darauf auf.
Wenn Sie eine Funktion brauchen, die es als stabilen Befehl noch nicht gibt: Sprechen Sie uns an. Wir nehmen sie als dokumentierten Befehl auf — so wie beim Admin Power Pack geschehen.
Weg 3: Webhooks & Events — die Anlage meldet sich bei Ihnen
Der umgekehrte Weg ist für die meisten Integrationen der interessantere: Ihr System muss nicht pollen, die Anlage meldet sich von selbst.
EventBridge — der Universalanschluss
EventBridge ist unser Werkzeug für genau diese Aufgabe. Sie wählen ein Ereignis, gestalten die Nutzlast per Vorlage und legen das Ziel fest.
Ausgehend — was EventBridge auslösen kann:
- Webhook: freier HTTP-Aufruf mit wählbarer Methode, eigenen Kopfzeilen und frei gestaltetem
Body. Platzhalter
{{…}}füllen Anrufdaten ein. - Syslog (UDP, TCP oder TLS, RFC 5424 und RFC 3164)
- Ablage auf SFTP, SMB-Freigabe oder in eine SQL-Datenbank
- Modul-Logeintrag und internes Ereignis für andere Fluxpunkt-Module
Eingehend — Ihr System löst etwas in der Anlage aus:
EventBridge stellt eigene Webhook-Adressen bereit:
https://<Ihre-STARFACE>/fp/<Modulkennung>/hook/<UUID>
Die Adresse enthält eine zufällige 128-Bit-UUID, die das Modul erzeugt. Optional sichern Sie den
Aufruf zusätzlich mit einem gemeinsamen Geheimnis im Kopf X-Webhook-Secret ab. Unbekannte oder
abgeschaltete Adressen antworten mit 404, ein falsches Geheimnis mit 401. Der eingehende Aufruf
löst ein Ereignis aus, auf das Sie wiederum eine Aktion legen.
Ein Systemhaus nutzt TANSS als Ticketsystem. EventBridge ruft bei jedem beendeten Gespräch die TANSS-API auf und legt den Ruflisteneintrag direkt im Ticket an — Rufnummer, Richtung, Dauer und Ergebnis. Vorher lief das über eine Datenbankabfrage, die in der Cloud nicht mehr möglich war.
URL-Aufbau, Statuscodes, Nutzlast-Envelope und alle Aktionstypen mit vollständiger Platzhalter-Referenz: API-Referenz von EventBridge.
Ereignisse zwischen den Modulen
Unsere Module tauschen untereinander Ereignisse aus. Das ist für Sie aus zwei Gründen interessant: Jedes dieser Ereignisse lässt sich in EventBridge abgreifen und nach außen schicken — und einige Module werten die Ereignisse anderer Module direkt aus.
Module, die Ereignisse senden:
| Modul | Ereignis | Inhalt |
|---|---|---|
| Pro IVR | Auswahl im Sprachmenü, Auflegen im Sprachmenü | Anrufer, gewählte Nummer, Menüschritt, Grund des Abbruchs |
| Call Recording | Aufzeichnung gestartet, Transkription fertig | Gesprächsdaten, vollständiger Transkriptionstext |
| AI PowerDesk | Aktionsschaltfläche gedrückt, Zusammenfassung fertig | frei belegbare Schaltfläche (bis zu 255), KI-Zusammenfassung |
| DirectoryHub | Import gestartet, Import beendet | Quelle, Ergebnis, Anzahl der Einträge |
| Admin Power Pack | je Wartungsaktion ein Abschlussereignis | was gelöscht bzw. ausgeführt wurde |
| EventBridge | eingehender Webhook empfangen | die komplette Nutzlast Ihres Aufrufs |
Module, die Ereignisse empfangen:
| Modul | Reagiert auf | Ergebnis |
|---|---|---|
| Insight Analytics | Pro-IVR-Ereignisse | Auswertung der Sprachmenü-Abläufe: Welcher Punkt wird gewählt, wo brechen Anrufer ab |
| Admin Power Pack | Wartungsbefehle | dieselben 12 Aktionen wie per XML-RPC, nur ereignisgesteuert |
| DirectoryHub | Import-Anstoß | Import einer bestimmten Quelle sofort starten |
Mittelbar über STARFACE-Ereignisse: EventBridge greift nicht nur unsere eigenen Ereignisse ab, sondern auch die der STARFACE selbst — von Anrufzuständen über Warteschlangen bis zu Benutzeränderungen. Damit werden auch Module hakbar, die gar keine eigenen Ereignisse senden. Active Directory Sync zum Beispiel legt beim Abgleich Benutzer an und ändert Voicemailboxen; die STARFACE meldet das als Ereignis, und EventBridge kann darauf reagieren. Notruf & Alarmierung meldet jeden ausgelösten Alarm auf demselben Weg.
Ein Kunde will wissen, warum so viele Anrufer im Sprachmenü auflegen. Pro IVR meldet jede Auswahl und jeden Abbruch, Insight Analytics wertet das aus — nach zwei Wochen ist sichtbar, dass Punkt 3 zu spät angesagt wird. Die Ansage wird umgestellt, die Abbruchquote sinkt.
Ein Systemhaus möchte über jeden neu angelegten Benutzer informiert werden. Active Directory Sync legt ihn an, EventBridge fängt das STARFACE-Ereignis ab und meldet es an das Ticketsystem — die Rechnungsstellung nach Benutzerzahl stimmt wieder.
Presence Sync — Statuswechsel weitermelden
Zu jeder Synchronisationsregel hinterlegen Sie beliebig viele Webhooks. Bei jedem Präsenzwechsel ruft das Modul sie auf — mit frei wählbarer HTTP-Methode, freiem Body und Platzhaltern für Benutzerdaten und Zielstatus.
Wechselt ein Mitarbeiter in Teams auf „Beschäftigt", meldet Presence Sync das an Ihr Raumbuchungssystem. Das Schild an der Bürotür schaltet auf Rot — ohne dass jemand einen Knopf drückt.
Platzhalter, Auslösezeitpunkte und vollständige Beispiele: API-Referenz von Presence Sync.
Reverse Lookup PRO — Anrufer aus Ihrem System auflösen
Reverse Lookup PRO ersetzt die Nummernauflösung der STARFACE vollständig. Jeder Anruf wird gegen Ihre Quellen aufgelöst — auf dem Telefondisplay, im UCC-Client, in den Ruflisten.
Vorhandene Anbindungen: SQL/JDBC, Web/HTTP (GET und POST, Basic- und Digest-Anmeldung), Salesforce und Odoo (JSON-RPC). Über den Web-Resolver binden Sie jede Anwendung an, die eine HTTP-Abfrage beantworten kann.
Zusätzlich hinterlegen Sie eine Kontext-URL, die der UCC-Client beim Anruf öffnet — der Weg zum Deep-Link in Ihr ERP.
Eine Verwaltungslösung für den öffentlichen Dienst hält alle Bürgerdaten in einer eigenen Anwendung. Der Web-Resolver fragt bei jedem Anruf deren REST-Endpunkt ab. Der Sachbearbeiter sieht den Namen schon beim Klingeln — und ein Klick öffnet den passenden Vorgang.
Anfrageaufbau, Antwortauswertung, Feldzuordnung und Kontext-URL im Detail: API-Referenz von Reverse Lookup PRO.
Call Recording — Aufzeichnungen und Transkripte weiterreichen
Vier Wege stehen bereit:
- Upload-Ziel: Aufzeichnungen und Transkriptionsdateien landen automatisch in Azure Blob, OneDrive, SharePoint, auf einem SFTP-Server oder einer SMB-Freigabe.
- Externe Protokolltabelle: Metadaten jeder Aufzeichnung (Dateiname, Richtung, Zeit, Call-ID, Anrufer, Angerufener, Signatur) werden in eine SQL-Datenbank Ihrer Wahl geschrieben.
- Ereignis über EventBridge: Sobald eine Transkription fertig ist, steht der vollständige Text als Ereignisnutzlast bereit und lässt sich per Webhook an Ihr System schicken.
- Ereignis bei Aufzeichnungsstart für Anwesenheits- und Compliance-Prüfungen.
Eine Pflegedienst-Verwaltung möchte Gesprächsnotizen automatisch in der Patientenakte sehen. Call Recording transkribiert, EventBridge schickt den Text an die Fachanwendung — die Pflegekraft muss nach dem Telefonat nichts mehr abtippen.
Ereignis-Nutzlasten, das Schema der Protokolltabelle sowie Ablage- und Signaturformate: API-Referenz von Call Recording.
Weg 4: Netzwerkdienste — Standardprotokolle statt eigener Anbindung
Manchmal ist der beste Anschluss gar kein API-Aufruf, sondern ein Protokoll, das Ihr Werkzeug schon spricht.
Monitoring — SNMP und CheckMk
| Dienst | Standard-Port | Format |
|---|---|---|
| SNMP-Agent | UDP 161 | SNMPv1 und v2c, GET, GETNEXT, GETBULK und Traps. Nur lesend. Eigene MIB-Datei zum Download. |
| Datenendpunkt | TCP 6556 | GET /checkmk (CheckMk-Local-Format), GET /xml, GET /json |
Beide Dienste sind über IP-Filter abgesichert. Das Modul öffnet die Firewall der Anlage automatisch
nur für die eingetragenen Monitoring-Hosts. Die MIB-Datei und das fertige CheckMk-Paket
(starface_fluxpunkt.mkp) laden Sie direkt aus dem Modul herunter.
Ihr Rechenzentrum überwacht alles per SNMP. Sie tragen die IP Ihres Monitoring-Servers ein, laden die MIB und sehen Leitungen, Registrierungen und Systemwerte der STARFACE im selben Baum wie Switches und Server.
Der vollständige MIB-Baum und die Formate des Datenendpunkts: SNMP und Datenendpunkt in der API-Referenz von Monitoring.
DirectoryHub — ein LDAP-Verzeichnis für Ihr Haus
DirectoryHub führt Kontakte aus vielen Quellen zu einem Verzeichnis zusammen und stellt es als LDAP-Server bereit — für Telefone, Fremdanwendungen oder eine zweite Anlage.
| Dienst | Standard-Port |
|---|---|
| LDAP (mit StartTLS) | 389 |
| LDAPS | 636 |
Die Anmeldung erfolgt gegen lokale Konten, gegen Ihr Active Directory oder gegen die STARFACE-Benutzer. Zugriffsprofile und IP-Regeln steuern, wer welche Einträge sieht. Die TLS-Zertifikate zieht das Modul aus dem Zertifikatsspeicher der STARFACE.
Quellen, die DirectoryHub einliest: SQL/JDBC, LDAP und Active Directory, Microsoft Graph, CSV, XML, CardDAV, vCard, Odoo, HubSpot und Pipedrive.
Export: Das Verzeichnis lässt sich als JSON, CSV, LDIF oder SQL herunterladen.
Ein Unternehmen ersetzt sein estos MetaDirectory. DirectoryHub übernimmt die vorhandene LDAP-Anbindung automatisch, ergänzt Microsoft 365 und das CRM als weitere Quellen — und liefert das Ergebnis wieder als LDAP aus. Die Tischtelefone merken vom Wechsel nichts.
Verbindung, Verzeichnisbaum, Attribut-Schema und Exportformate: API-Referenz von DirectoryHub.
WebRTC Connect und TeamStar Connect
Beide Module bringen einen SIP-Anschluss mit, der von außen erreichbar ist: WebRTC Connect stellt Softphones per WebSocket-SIP bereit, TeamStar Connect nimmt das Direct Routing von Microsoft Teams entgegen. Beides ist SIP, kein HTTP-API — die Details stehen auf den jeweiligen Modulseiten.
Weg 5: Datenschnittstellen — größere Datenmengen auswerten
Insight Analytics — Auswertungsdaten in Ihrer Datenbank
Insight Analytics schreibt Gesprächs-, Status- und Stammdaten in eine PostgreSQL-Datenbank Ihrer Wahl. Dort greifen Power BI, Grafana, Excel oder jedes andere Werkzeug direkt zu.
Für stabile Auswertungen legt das Modul über die versionierten Tabellen zusätzlich Views ohne Versionsnummer an. Bauen Sie Ihre Berichte auf diese Views auf — dann überleben sie ein Modul-Update. Spalten und Tabellen werden grundsätzlich nicht gelöscht oder umbenannt.
Verfügbare Daten: Gesprächsdaten (Summary und Detail), Konten, Agenten- und Warteschlangenzustände, Benutzer- und Gruppenzustände, Gerätezustände, Dienste und Kennzahlen.
Ein Kunde arbeitet durchgehend mit Power BI. Statt einer eigenen Telefonie-Auswertung liest sein Berichtswesen die Views von Insight Analytics — Erreichbarkeit und Servicelevel stehen im selben Dashboard wie Umsatz und Auftragslage.
Alle Views mit vollständiger Spaltenreferenz und Beispielabfragen: API-Referenz von Insight Analytics.
Zeiterfassung — Stempeldaten weitergeben
- Externe SQL-Datenbank für alle Stempeldaten
- CSV- und JSON-Export
- DATEV-Export im Lohn-Importformat
- Automatischer Upload per SFTP, SMB, OneDrive oder SharePoint
Zum Monatsende legt die Zeiterfassung die DATEV-Datei automatisch auf der SFTP-Freigabe des Steuerbüros ab. Die Lohnbuchhaltung findet sie dort — niemand muss exportieren und versenden.
Datenbankschema und Exportformate im Detail: API-Referenz von Zeiterfassung.
Admin Power Pack — Ruflisten und Adressbücher
- Ruflisten-Export und -Import als ZIP mit
cdrsummary.csvundcdrdata.csv— der Weg, um Gesprächsdaten bei einem Anlagenwechsel mitzunehmen. - Adressbuch-Export und -Import als CSV im Spaltenformat der STARFACE-Importvorlage. Exporte lassen sich unverändert wieder einlesen.
Spaltenlisten und Import-Verhalten beider Formate: API-Referenz von Admin Power Pack.
Welches Modul kann was?
In der Spalte Ereignisse steht sendet, wenn das Modul eigene Ereignisse auslöst, und empfängt, wenn es auf Ereignisse anderer Module reagiert. Mittelbar heißt: Das Modul löst STARFACE-Ereignisse aus, die EventBridge abgreifen kann.
| Modul | XML-RPC-Befehle | Ereignisse | Webhooks | Netzwerkdienst | Datenschnittstelle |
|---|---|---|---|---|---|
| Admin Power Pack | Ja 12 Befehle | Ja sendet + empfängt | Nein | Nein | Ja Ruflisten-/Adressbuch-CSV |
| Monitoring | Ja 3 Befehle | Nein | Nein | Ja SNMP, TCP 6556 | Ja CheckMk, XML, JSON |
| Notruf & Alarmierung | Ja 2 Befehle | mittelbar | Nein | Nein | Nein |
| EventBridge | Nein | Ja sendet + empfängt alles | Ja ein und aus | Ja Syslog | Ja SFTP, SMB, SQL |
| Pro IVR | Nein | Ja sendet | Nein | Nein | Nein |
| Insight Analytics | Nein | Ja empfängt (Pro IVR) | Nein | Nein | Ja PostgreSQL-Views |
| Call Recording | Nein | Ja sendet (inkl. Transkript) | über EventBridge | Nein | Ja SQL, Azure, SFTP, SMB |
| AI PowerDesk | Nein | Ja sendet (Aktionstasten, KI-Zusammenfassung) | über EventBridge | Nein | Nein |
| DirectoryHub | Nein | Ja sendet + empfängt | Nein | Ja LDAP, LDAPS | Ja JSON, CSV, LDIF, SQL |
| Presence Sync | Nein | mittelbar | Ja je Regel | Nein | Nein |
| Reverse Lookup PRO | Nein | mittelbar | Ja Web-Resolver | Nein | Ja SQL, Salesforce, Odoo |
| Active Directory Sync | Nein | mittelbar (Benutzer, Voicemailboxen) | Nein | Ja LDAP, Microsoft Graph | Nein |
| Zeiterfassung | Nein | mittelbar | Nein | Nein | Ja SQL, CSV, DATEV, SFTP, SMB |
| FrontDesk | Nein | mittelbar | Nein | Nein | Nein |
| AntiFraud | Nein | mittelbar | Nein | Nein | Nein |
Module ohne eigene Schnittstelle lassen sich fast immer über EventBridge anbinden: Sobald ein Modul ein Ereignis auslöst, können Sie darauf einen Webhook legen.
Was noch nicht geht — und wie Sie es bekommen
Wir bauen Schnittstellen nach Bedarf. Wenn Ihnen ein Befehl oder ein Ereignis fehlt, sagen Sie uns, was Sie erreichen wollen — nicht, welchen Endpunkt Sie sich vorstellen. Oft gibt es bereits einen Weg, der weniger Aufwand macht.
Bitte nennen Sie uns:
- das Zielsystem und dessen Schnittstelle,
- den fachlichen Ablauf (was löst was aus?),
- ob Sie Daten holen oder geschickt bekommen wollen.
Nutzen Sie für Tests eine STARFACE NFR-Installation. Alle unsere Module können darauf kostenlos verwendet werden. Melden Sie sich unter support@fluxpunkt.de, wenn Sie Fragen haben.
Am schnellsten prüfen Sie eine Integration mit EventBridge. Installieren Sie das Modul, legen Sie einen Webhook auf das Ereignis „eingehender Anruf" und lassen Sie ihn auf einen Testempfänger zeigen. Innerhalb weniger Minuten sehen Sie, welche Daten Ihnen zur Verfügung stehen.