Placetel Schnittstelle

Achtung!! Placetel stellt die API-Version im Januar 2022 um. Es ändert sich nur die URL. Die Änderung bitte beachten.

Um einen Placetel-Anschluss in infra-struktur zu integrieren müssen sie folgendes tun.

• Für die Einrichtung der Wählhilfe

In der Administration Wählhilfe verwenden sie die Option cURL /w POST
Die in das Feld einzutragende URL sieht in dem Fall dann so aus:
https://api.placetel.de/v2/calls?api_key=APIKEY_den_sie_von_Placetel_bekommen&target=#NUM#&sipuid=#MSN#
Als MSN trägt der Benutzer dann seine SipUID eine. Diese sieht z.B. so aus: 123456789@fpbx.de

• APIKEY erstellen

Auf der Placetel-Seite unter AppStore zur Web API gehen (oder https://web.placetel.de/integrations/web_api).
Dort auf die Schaltfläche "Neuen API-Token erstellen" klicken. Links der Schaltfläche wird der API Token dann dargestellt.
Wenn man mir dem Mauszeiger darauf fährt kann man den Token mit Klick der linken Maustaste kopieren.

Achtung!

Dieser Schlüssel ist nur einmalig sichtbar und muss von Ihnen sicher verwahrt werden. Es ist nicht möglich, diesen Schlüssel erneut anzuzeigen.
Falls dieser Schlüssel verloren geht, so muss er neu generiert werden.

• Für die Einrichtung der eingehende Signale

Hierzu wird folgendes Script benötigt daß sie auf einem Server der SSL-Verschlüsselung unterstützt ablegen und erreichbar machen müssen.
Sollten sie über keinen Server mit Zertifikat verfügen, sprechen sie uns an.
placetel.zip
1.Das Script sollten sie auf einem Server mit gültigem Zertifikat hosten. Bei bedarf wenden sie sich an NETZkultur bezüglich der Bereitstellung
2.Das Script wird aufgerufen mit den Parametern instanz,isdnkey und standort als GET-Parameter.
Also: https://ihredomain.de/pfadzumscript/placetel.php?instanz=demo&isdnkey=12345&standort=placetel
Den Parameter "isdnkey" Finden Sie in der infra-struktur unter "Administration" - "Anrufliste" im Reiter "Anrufliste" im Punkt
"Allgemein" im Feld "API-Call-Key".
3.Im Placetel auf den Bereich AppStore gehen und dort die kostenlose Notify API buchen / auswählen.


4.Dort den Bereich "API" auswählen oder über die Suche nach "Notify API" suchen
5.Piktogramm der "Notify API" anklicken.
6.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren.
7.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen.
8.Die Telefonnummern aktivieren, für die die API zugreifen soll.
9.Mit "Eigenen API-Endpoint speichern" bestätigen.