Wie binde ich eigene AppleScripts in den NCTI standard Client für Mac ein ?

Stichwörter
NFON, NCTI standard, Mac, macOS, AppleScript, CTI, Automatisierung, Scripts-Ordner, Rufnummernformat, Masterskript, Administrator
Alternative Fragen zur gleichen Antwort
Wie starte ich bei NCTI automatisch ein AppleScript ?
Wo speichere ich eigene NCTI-AppleScripts auf dem Mac ?
Welche Dateiformate unterstützt NCTI für AppleScripts ?
Welches Rufnummernformat übergibt NCTI an mein Skript ?
Wie rufe ich mehrere AppleScripts mit NCTI auf ?
Kurzantwort
Erstelle Dein Skript mit dem macOS-Skripteditor, speichere es als .applescript- oder .scpt-Datei im Scripts-Ordner von NCTI standard und aktiviere es anschließend unter Einstellungen und Anrufbehandlung. Lege außerdem fest, in welchem Format NCTI die Rufnummer an das Skript übergibt. Da jeweils nur ein Skript ausgewählt werden kann, benötigst Du für mehrere Abläufe ein Masterskript.
Schritt-für-Schritt-Anleitung
1. Voraussetzungen prüfen
Der NCTI standard Client muss auf dem Mac installiert und mit dem Tischtelefon verbunden sein. Du benötigst Zugriff auf den Benutzerordner Library beziehungsweise – für systemweite Skripte – auf die entsprechende Library des Macs oder Netzwerks. Zum Erstellen und Bearbeiten nutzt Du den macOS-Skripteditor.
Teste neue Skripte zunächst mit einer Kopie und sichere funktionierende Versionen, bevor Du sie veränderst.
2. Eigenes AppleScript erstellen
Öffne auf dem Mac den Skripteditor.
Erstelle ein neues Skript.
Definiere die Aktion, die bei einem ein- oder ausgehenden Anruf ausgeführt werden soll.
Prüfe das Skript im Skripteditor auf Syntaxfehler.
Speichere die Datei in einem von NCTI unterstützten Format.
3. Scripts-Ordner anlegen
Das aktuelle NFON-Handbuch nennt folgende Ablageorte:
Nur für den angemeldeten Benutzer: ~/Library/Application Support/NCTI standard/Scripts
Für alle Benutzer des Macs: /Library/Application Support/NCTI standard/Scripts
Für Benutzer im Netzwerk: /Network/Library/Application Support/NCTI standard/Scripts
Der Ordner Scripts muss gegebenenfalls manuell angelegt werden. Das Zeichen ~ steht für den persönlichen Benutzerordner.
Bei älteren Installationen kann im Pfad zusätzlich der Ordner Nfon vorkommen, beispielsweise ~/Library/Application Support/Nfon/NCTI standard/Scripts. Prüfe deshalb bei einer bestehenden Installation die tatsächlich vorhandene Ordnerstruktur.
4. Unterstütztes Dateiformat verwenden
Speichere das eigene Skript mit einer der folgenden Dateiendungen:
.applescript für ein lesbares AppleScript-Dokument.
.scpt für ein kompiliertes Skript.
Nur Dateien im korrekten Scripts-Ordner und mit einer unterstützten Endung können in NCTI ausgewählt werden.
5. AppleScript in NCTI aktivieren
Öffne NCTI standard.
Gehe zu Einstellungen.
Öffne den Bereich Anrufbehandlung.
Aktiviere die Option, bei eingehenden und ausgehenden Anrufen ein AppleScript auszuführen.
Wähle das gewünschte Skript aus der Liste aus.
Falls das Skript nicht angeboten wird, prüfe Ordner, Dateiendung und Zugriffsrechte und starte NCTI bei Bedarf neu.
6. Rufnummernformat auswählen
NCTI kann die Rufnummer in unterschiedlichen Formaten an das Skript übergeben:
International: beispielsweise +4989123456789.
Telefonbuchformat: beispielsweise 089123456789.
Wählbares Format mit Amtskennziffer: beispielsweise 0089123456789.
Wähle das Format passend zur Zielanwendung und zu den in Deiner Telefonanlage verwendeten Wahlregeln. Eine falsche Auswahl kann dazu führen, dass Kontakte nicht gefunden oder Rufnummern nicht korrekt verarbeitet werden.
7. Eingehende und ausgehende Anrufe testen
Führe einen ausgehenden Testanruf durch.
Prüfe, ob das Skript startet und die Rufnummer korrekt übernimmt.
Rufe die Nebenstelle von einer Testnummer aus an.
Kontrolliere, ob das Skript auch beim eingehenden Anruf wie erwartet reagiert.
Prüfe bei Fehlern die macOS-Berechtigungen für Automatisierung und die vom Skript angesprochene Anwendung.
8. Mehrere Skripte über ein Masterskript aufrufen
In NCTI lässt sich jeweils nur ein AppleScript auswählen. Wenn mehrere Aktionen ausgeführt werden sollen, erstellst Du ein Masterskript. Dieses zentrale Skript ruft nacheinander oder abhängig von Bedingungen weitere Skripte und Funktionen auf.
Eine saubere Aufteilung erleichtert die Wartung: Das Masterskript entscheidet über den Ablauf, während einzelne Unterskripte jeweils eine klar abgegrenzte Aufgabe übernehmen.
9. Vorhandene Beispiele als Orientierung nutzen
Das NFON-Handbuch beschreibt verschiedene Beispielskripte, etwa für Outlook, Nachrichten oder weitere Mac-Anwendungen. Sie zeigen, wie NCTI Anrufereignisse an andere Programme übergeben kann. Ob ein Beispiel unverändert funktioniert, hängt von der eingesetzten macOS-, NCTI- und Programmversion ab.
Übernimm daher nicht ungeprüft alte Beispiele, sondern passe sie an die aktuelle Umgebung und die gewünschten Datenschutz- und Sicherheitsvorgaben an.
10. Fehler systematisch beheben
Skript wird nicht angezeigt: Prüfe Pfad, Ordnernamen, Dateiendung und Dateirechte.
Skript startet nicht: Prüfe die Aktivierung unter Anrufbehandlung und starte NCTI neu.
Falsche Rufnummer: Wähle ein anderes Rufnummernformat und kontrolliere Länder-, Orts- und Amtskennziffer.
Nur ein Skript auswählbar: Verwende ein Masterskript für mehrere Abläufe.
Zielanwendung reagiert nicht: Prüfe macOS-Automatisierungsrechte und die Skriptunterstützung der betreffenden App.
11. Sicherheit und Datenschutz beachten
AppleScripts können lokale Programme steuern, Dateien öffnen und Rufnummern oder Kontaktdaten verarbeiten. Prüfe deshalb jedes Skript vor dem Einsatz, beschränke Zugriffsrechte auf das erforderliche Maß und speichere keine Kennwörter oder Zugangsdaten unverschlüsselt im Quelltext.
Urheberhinweis
Originalbeitrag von Stephan Rasch.
Eine vollständige oder auszugsweise Übernahme ist nur mit deutlich sichtbarer Quellenangabe und Verlinkung des Originalartikels gestattet.
Artikelkennung: SR-FAQ-20260916-384
