call-init.php
Beschreibung Script
Aufbauen einer abgehenden Verbindung für einen Benutzer, durch Übermitteln einer URL mit HTTP GET an den Webserver des TK-Systems.
Der Benutzer muss an einem Endgerät angemeldet sein. Für Nobody-Benutzer (95xxxx) können keine Verbindungen aufgebaut werden. Der Verbindungsaufbau wird über das API AMI eingeleitet. Das Endgerät des Benuzters (user) signalisiert einen Anruf mit der Zielrufnummer (to). Die abgehende Verbindung zum Ziel (to) wird aufgebaut, wenn der anstehende Anruf angenommen wird.
AUTO-ANSWER: durch Anpassung des Scripts und Modifikation einer Systemdatei kann der Verbindungsaufbau automatisiert werden, d.h. das Endgerät des Benutzers (user) wählt direkt die Zielrufnummer (to) an.
Benutzung
Usage: http://tkserver.my.lan/locaphone/prov/call-init.php?user=<user>&to=<number> [&from=<user>&cidnum=<number>&clir=1&prv=1]
Parameter
Parameter | Beschreibung | Erläuterungen |
---|---|---|
user | LocaPhone-Benutzer | (alphanumerisch) Der eindeutige Benutzername des Anrufers. |
to | Zielrufnummer | (numerisch) Anzurufende Durchwahl (intern) oder Telefonnummer (extern) |
from | Ausgangsnummer | (optional) Telefonnummer des anrufenden Teilnehmers, falls von dessen Standard-Nummer abweichend |
cidnum | Caller-ID-Nummer | (optional) Caller-ID-Nummer des anrufenden Teilnehmers. Ohne Angabe wird die mit from vorgegebene Nummer verwendet, bzw. die Default-Nummer, falls auch from nicht gesetzt ist. |
clir | Rufnummernunterdrückung | (optional) Wert 1 = an (unterdrückt), 0 = aus (Nummer sichtbar, Default) |
prv | Privatgespräch | (optional) Wert 1 = ja, 0 = nein (Default) |
Ausgabe
Bei Übergabe der URL mittels Webbrowser wird eine Status-Ausgabe erzeugt.
Erfolgreicher Verbindungsaufbau
OK. Calling 892 from 23 ...
Ungültiger Benutzer
Unknown user.
Falsche Formatierung URL
User must be alphanumeric.
HTTP Status Codes
Das Skript gibt einen der folgenden HTTP-Status-Codes zurück:
Status | Beschreibung |
---|---|
403 Forbidden | Kein Zugriffsrecht (bedingt durch IP-Adresse oder Benutzer). |
400 Bad Request | Das Skript wurde mit ungültigen/fehlenden Parametern aufgerufen. |
200 OK | Der Anruf wurde/wird aufgebaut. |
500 Internal Server Error | Bei der Ausführung ist ein Fehler aufgetreten. |
Abhängigkeiten
Von welchen IP-Adressen oder Teilnetzen der Aufruf dieser URL erlaubt ist, wird in der System-Konfigurationsdatei mit der Option CALL_INIT_FROM_NET eingestellt.
Zusätzliche Informationen
AUTO-ANSWER für automatischen Verbindungsaufbau am Endgerät des Benutzers.
/opt/locaphone/htdocs/prov/call-init.php
. "Setvar: __is_callfile_origin=1\n" # no forwards and no mailbox on origin side
. "Setvar: __saved_callerid=". $callerid ."\n"
. "Setvar: __callfile_from_user=". $user['ext'] ."\n"
+ . "Setvar: __SIPADDHEADER51=Call-Info:<sip:127.0.0.1>\\;answer-after=0\n"
;
/opt/locaphone/etc/asterisk/extensions.lua
["_."] = function(context,extension)
Channel["__is_callfile_origin"] = ""
+ Channel["__SIPADDHEADER51"] = ""
return app["goto"]("to-internal-users",extension,1)
end;
Eigenschaften
Version | 2.0.0 |
---|---|
Funktion | Verbindungsaufbau |
System | * |
cron | - |
ALE | * |
Legacy | - |