API für Office SI Fritz!Box TAPI Treiber. Integration in Fremdanwendungen.
Diese Beschreibung ist nur für Programmierer relevant.


Hinweis: Das Programm ist kein klassischer TAPI-Treiber, es werden u.a. spezielle Funktionen der FritzBox genutzt.

Aktivieren Sie auf jeden Fall den HTTP-Server unter:
Einstellen --> Vom Handy wählen


A: Ausgehende Anrufe

Es gibt 2 Möglichkeiten, die Nummer zu übergeben:

1.  Einfach über die Commandozeile C:\Office-SI\adressplugin\fbdial.exe [Telefonnummer]
2.  Per Http: http://[ComputerName]:[Port]/JSONACTION.THttpCallAPI/?=[Telefonnummer]
    Den Port finden Sie unter Einstellen --> Vom Handy wählen


B: Eingehende Anrufe

Professionelle Variante:

Dazu müssen Sie einen asynchronen TCP/IP-Client bauen.
Den Port finden Sie unter Einstellen --> Vom Handy wählen. Zu diesem Port einfach eine 1 addieren.
URL: http://[ComputerName]
Ankommende Rufe werden als einfaches JSON signalisiert.
Wobei jeder Anruf ein abschliessendes #13#10 enthält.
Falls mehrere Anrufe kurz hintereinander reinkommen, erhalten Sie meistens mehrere Zeilen durch #13#10 getrennt.
Das JSON wird hier nicht weiter beschrieben, ist aber einfach und selbsterklärend.
Der Client sollte ab und zu (z.b. jede Minute) etwas zum Server senden, um die Verbindung zu halten.
Der Inhalt ist egal, empfohlen wird ein einfaches kurzes JSON.


Pollen auf neue Anrufe:
Prüfen der Datei
C:\Users\Public\Documents\SI-ClientRoot\default\fritz.box.tapi\DocRoot\index.csv
auf Änderungen
Die Datei enthält die letzten 20 Anrufe im CSV Format
Beispiel 1. Zeile, enthält den letzten Anruf:
"2022-03-15T08:42:19.706Z","03607XXXX","XXX","MSN"
Es genügt den 1. Eintrag, Spalte 1 zu prüfen, dort steht die neueste Anrufzeit im ISO 8601 Format.
Das Prüfen sollte sehr schnell erfolgen. Am besten Sie benutzen hier ein MMF.
Wenn ein neuer Anruf reinkommt, ist die Datei kurzzeitig für einige ms gesperrt.



C: Eigenes Telefonbuch bauen

Im Verzeichnis

C:\Users\Public\Documents\SI-ClientRoot\default\fritz.box.tapi

finden Sie 2 Dateien, die Sie bearbeiten/erzeugen können.
Die Anzahl der Einträge sollte 5000 nicht überschreiten.

specialbook.txt Signalisieren von Anrufen
spambook.txt  Ausblenden von Anrufen


Erzeugen Sie die Einträge in der Form

Telefonnummer=Name

Telefonnummer müssen Sie im echten Format des Telefonnetzes angegeben werden.
Also volle Vorwahl bei deutschen Nummern, ausländische Nummern mit 00 Landesvorwahl Nummer

Es wird auch das Wildcardzeichen * am Ende der Nummer unterstützt.
Also z.B. 0800*=XXXXX

Bei den Namen kann man auch eine einfache(!) HTML-Formatierung einbauen.
Beispiel:  
03607181204=</b>Es ruft <b>SE-CS</b> an, <font color="clred" /font><B>ganz schnell dran gehen


In den Einstellfenstern ist dazu eine Hilfe enthalten.