Asterisk und der Call Data Record

Normalerweise geht man als Benutzer einer Telefonsoftware davon aus, dass nach dem Auflegen gewisse Daten eines Anrufs verfügbar sind: Woher der Anrufer kam, wer den Anruf entgegennahm und wie lange der Anruf dauerte. Vor allem die Anrufdauer ab dem Antworten ist besonders interessant, da es die abzurechnende Telefonzeit ist und oft mit Kosten verbunden.

Asterisk schreibt den CDR, wenn richtig konfiguriert, in eine Datenbank. Das ist sehr schön, und man kann die Daten auch sehr gut am Ende des Tages oder Monats abrechnen. Möchte man allerdings die Daten bereits am Ende eines Gesprächs benutzen, so sitzt man in der Tinte: Erst nach kompletter Abarbeitung aller Kontexte erstellt Asterisk die CDR-Daten wie Dauer ab klingen in CDR(duration), Dauer des Telefonats CDR(billsec) et cetera.

Es gab Versuche, den internen Asterisk-Code für diese Abrechnungszwecke umzuschachteln, also den CDR nach Abbau der Bridge zu schreiben, und dann erst in den h-Kontext (die Abarbeitung “after hangup”) zu wechseln. Dazu gab es bereits die Option

endbeforehexten=yes

in der Datei /etc/asterisk/cdr.conf. Allerdings führte das zum kompletten Crash der Software, also wurde dies wieder verworfen.

So gehts: CDR(duration) im hangup-Kontext selbst gemacht

Mit ein bisschen Bastelei lassen sich aber die benötigten Daten weitgehend selbst erstellen. Dazu muss man wissen, dass zwar CDR(billsec) und CDR(duration) stets auf 0 stehen, aber der derzeitige Zeitstempel immer per ${EPOCH} zur Verfügung steht. Ebenso steht die Abnehm-Zeit in CDR(answer) zur Verfügung. Ob CDR(start) da ist, kann ich gerade nicht genau beantworten, aber dies lässt sich ebenso ableiten. Man nutze einfach lokale Variablen:

[Mein-Kontext]
exten => s,1,Set(Start=${EPOCH})
exten => s,n,Dial(SIP/100,30,rtT)
exten => h,1,Set(Ende=${EPOCH})
exten => h,n,NoOp(Dauer: $[${Ende} - ${Start}])
exten => h,n,Hangup()

Wer die Syntax von Asterisk nicht kennt, wird jetzt wahrscheinlich die Hände über den Kopf zusammenschlagen, aber so ist Asterisk nun einmal: Friss oder Stirb Also bevorgen die Herrschaften folgendermaßen zu speisen: Vor dem Aufbau der SIP-Verbindung per  Dial() -Funktion wird der aktuelle Zeitstempel in die Variable Start gegossen. Und nach dem Auflegen wird als erstes der aktuelle Zeitstempel in die Variable Ende gelegt. Mithilfe der NoOp()-Funktion wird eine Ausgabe auf der Asterisk-Console durchgeführt, in der eine Berechnung $[...] stattfindet, worin Ende – Start, also die Dauer ab dem Klingeln ausgegeben wird: Fertig ist CDR(duration), verfügbar im hangup-Kontext.

So gehts: CDR(billsec) im hangup-Kontext selbst gemacht

Auf gleiche Weise lösen wir nun das Problem mit der fehlenden Gesprächsdauer. Dazu muss man wissen, dass der Zeitpunkt des Abhebens schon zur Laufzeit in CDR(answer) anliegt. Allerdings nicht als Unix-Timestamp (ein Ganzzahliger Sekundenwert seit dem 01.01.1970) wie oben in ${EPOCH}, sondern als Zeitangabe im Stil “Jahr-Monat-Tag Stunde:Minute:Sekunde”, also für Kenner von date()-Funktionen die Syntax “Y-m-d H:i:s”. Sehr schön zu lesen, leider innerhalb von Asterisk nicht so schön brauchbar. Allerdings lässt sich immerhin mit Hilfe der Asterisk-Funktion LEN() sagen, ob überhaupt abgenommen wurde oder nicht:

exten => h,1,GotoIf($[${LEN(0${CDR(answer)})} > 1]?Angenommen,Nichtangenommen)
exten => h,n(Angenommen),NoOp(Juhu, Angenommen!)
exten => h,n,Hangup()
exten => h,n(Nichtangenommen),NoOp(Noe, nicht angenommen!)
exten => h,n,Hangup()

Diese Syntax schon wieder! Hier muss man folgendes bemerken: Ein Vergleich in $[...] benutzt einen variablen Wert ${…}, der aus der Funktion CDR(answer) kommt, allerdings schreiben wir noch eine 0 davor. Dies hat folgende Bewandnis: Sollte nicht abgenommen worden sein, so ist CDR(answer) nicht gesetzt. Asterisk hat dann das Problem, eine ungesetzte Variable zu benutzen und meckert herum. Um dieses Hinderniss zu umschiffen, nehmen wir einfach vorn eine Null hinzu und schauen, ob die Variablenlänge größer als 1 ist.

Die Extension-Einträge 2 und 4 benutzen Labels, die per GotoIf() angesprungen werden können: Nach der Bedingung kommt ein Fragezeichen, dann das Label, falls alles geklappt hat, nach einem Komma dann der else-Zweig. Der else-Zweig ist hier nach dem If-Zweig notiert und würde eigentlich beim Zutreffen der Bedingung mit ausgeführt. Hier wirkt die Hangup()-Funktion also wie eine Art break-Anweisung innerhalb einer switch-Verzweigung.

Wie kommen wir jetzt an die Dauer? Nun, wir müssen den Wert CDR(answer) in einen Zeitstempel umrechnen. Aber das überlassen wir einfach einem externen Abrechnungstool. Denn intern brauchen wir es eigentlich nicht mehr:

exten => h,1,GotoIf($[${LEN(${0CDR(answer)})} > 1]?Angenommen,Nichtangenommen)
exten => h,n(Angenommen),NoOp(Juhu, Angenommen!)
exten => h,n,System('php -f /mein/pfad/cdr_abrechnung.php \
                        ${CallerID(num)} ${EXTEN} "${CDR(answer)}" ${EPOCH}');
exten => h,n,Hangup()
exten => h,n(Nichtangenommen),NoOp(Noe, nicht angenommen!)
exten => h,n,Hangup()

Damit rufen wir das Skript zum Beispiel mit folgenden Variablen auf:

$argv = array (
   [0] ...
   [1] => 0123456789
   [2] => 100
   [3] => 2009-02-06 20:07:00
   [4] => 12392827161
);

mit strtotime() lässt sich $argv[3] direkt in einen Zeitstempel umrechnen. Von $argv[4] subtrahiert, ergibt sich CDR(billsec). Geschafft – Das Logging-Skript hat nun alle Daten, die es braucht!

Daran hängen 13 SIP-Phones (snom 320er), 4 Softphones, 2 Analog-Telefone, 1 EC-Cash-Gerät, 1 analoges Fax und 1 Softfax mit PDF-Verteilung für alle Mitarbeiter und zwei Gruppen-Faxnummern, die in die öffentlichen Ordner des Exchange-Servers gestellt werden.

Vermittelt wird das Ganze zu einem Telekom-Anlagenanschluss, bei uns zur Zeit eine Bündelung über 3 S0-Leitungen. Hier können also gleichzeitig maximal 6 Gespräche von oder nach draußen geführt werden. Ebenso sind Anrufbeantworter für jeden Mitarbeiter, aber auch Gruppenboxen eingerichtet. Die Messages werden zudem per Email zugestellt, die Gruppen-ABs wieder in die öffentlichen Ordner.

Neben einem IVR-Menü (“Drücken Sie bitte die 1 für …”) haben wir zur Zeit 4 verschiedene “Callcenter”-Queues laufen, in die sich die Mitarbeiter als Agenten an- bzw. abmelden können – für Bestellungen, Beratung, Zahlungsfragen und Feedbacks. Die Queues werden rundenbasiert linear abgefragt, und bei freien Mitarbeitern klingt es für etwa 12-13 Sekunden, was dazu führt, dass Anrufer recht schnell durch die gesamte Firma gereicht werden, so dass jeder Anruf recht schnell beantwortet werden sollte. Die erste Runde beachtet dazu eine Wrapuptime von 60 Sekunden (eine Nachbearbeitungszeit pro Kundengespräch, in der man zB Belege fertig schreiben kann), ab der zweiten Runde muss man dann trotzdem ran.

Daneben kann jeder Mitarbeiter seine Rufumleitung pflegen, zB für Mittagspausen, Urlaube, Heimarbeitstage etc. Für den Anrufer ist das alles transparent. Selbst in den Queues könnten die Mitarbeiter also alle zuhause sitzen (naja, so cyberspacig möchte ich unsere Firma eigentlich nicht sehen). Später sollen sich die Mitarbeiter, falls unterwegs, auch mit einer Servicenummer als Rufumleitung anmelden können (à la: “Ich bin ab jetzt in diesem Hotel zu erreichen”).

Durch die sehr transparente Technologie (Asterisk erlaubt die Ausführung von PHP- oder Systembefehlen im Dialplan) können nicht nur die CDR-Daten per Intranet sichtbar gemacht werden, sondern auch ganz telefonfremde Anwendungen über Tastendruck gesteuert werden (ich denke da an Notfall-Shutdowns o.ä.). Einen Screenshot dieser totalen Kontrolle seht ihr hier unten. Big brother is listening to you!

Das ging wirklich wie beim Brezelbacken: Debian-CD rein, Testrechner plattgemacht. Frisches Etch installiert, und nach “fax” recherchiert. Hylafax war mir schon irgendwie als Name untergekommen, also habe ich es mal damit probiert. Volltreffer. Ein kleines apt-cache search mit Begriffen wie fax (oder ähnlich) brachte mich dann auf iaxmodem – eine Art Softmodem, welches sich per IAX2-Protokoll an Asterisk hängt. Und hylafax kann darüber wiederum Faxe senden wie auch empfangen. Klingt doch ganz nett, dachte ich mir.

Die Installation von iaxmodem ist ein echter Klax. Hylafax an iaxmodem zu gewöhnen dauerte bei mir jedodch gegenüber anderen Berichten im Netz ungewöhnlich lange (ganze 20 Minuten), denn das Installationsproggi faxsetup fand das Softmodem nicht. Die Beispielkonfig ließ sich aber später drüberkopieren und anpassen, dann gings. Ein Testanruf brachte den gewohnten Modem/Fax-Verbindungsklang – ein cooles Gefühl. Endlich mal etwas, was (fast) aus dem Hut heraus läuft.

Ein dpkg-reconfigure exim4-config, schon hatte ich die erste Email mit einem Fax-Anhang im Briefkasten des lokalen root-Kontos. Schnell noch die /var/spool/hylafax/etc/FaxDispatch angepasst, dann konnten auch die Faxe pro Faxnummer an die verschiedenen Email-Adressen mit einem PDF-Anhang des Fax versendet werden.

Heute habe ich unsere Telefonanlage noch einmal kräftig durchschütteln müssen. Zusammen mit dem Geschäftsführer des Herstellers fanden wir heraus, dass ein Hardwarefehler im Rack Connectivity Kit die ISDN-Kanäle nicht richtig verteilte. Nebenbei fiel mir bei einem ps ax doch die Zeile hfaxd -i 4559 auf!!! Juhu! Auf dem Telefonserver waren schon alle wichtigen Pakete für den Faxbetrieb installiert, nur die Konfiguration und Verzeichnisberechtigungen klemmten, aber nach einigem Suchen und Finden war der Faxserver auf den Telefonserver migriert. So kann ich mir etwas Netzwerktraffic, aber vor allem einen weiteren Fön im Serverschrank sparen.

Dort wirds nämlich schon furchtbar eng. Neben der Hitzewelle, die einen beim Öffnen erwartet, ist auch kaum noch Platz für Erweiterungen. Es ist an der Zeit, die alte Telefonanlage endlich rauszuschmeißen und die Brater gegen moderne, stromsparendere Hardware auszutauschen. Am Freitag wird es also zunächst für die TK-Anlage soweit sein. Mehr und mehr, so stelle ich fest, kommt dabei Linux mit seinen Stärken in den entscheidenden Positionen zum Einsatz – ganz von allein.

Zugegeben, ich bin schon etwas nervös. Ist mein Dialplan wasserdicht? Spielt die Hardware mit? Wird die Sprachqualität den Erwartungen gerecht werden? Wie oft werde ich haareraufend vorm Serverschrank stehen? Ob dat man jutjeet…

Connected to Asterisk 1.2.14-BRIstuffed-0.3.0-PRE-1y-a currently running on moby
Verbosity is at least 3
1 received TEI check request for TEI = 76
-- Executing Set("SIP/mlieber-081fc378", "CALLERID(num)=034202309020") in ne
-- Executing Dial("SIP/mlieber-081fc378", "Zap/g1/012345678") in new
-- Requested transfer capability: 0x00 - SPEECH
-- Called g1/012345678
-- Channel 0/1, span 1 got hangup, cause 28
-- Channel 0/1, span 1 received AOC-E charging 0 units
-- Hungup 'Zap/1-1'
== Everyone is busy/congested at this time (1:0/0/1)
-- Executing Hangup("SIP/mlieber-081fc378", "") in new stack
== Spawn extension (internal, 012345678, 3) exited non-zero on 'SIP/mlieber
mobydick*CLI>>

Der Gag war, dass Asterisk automatisch 0 bzw. 00 an die Nummer anhing, weil halt Orts-bzw. Internationale Nummern dies ja brauchen. In der zapata.conf musste deswegen predialplan=dynamic auf predialplan=local umgestellt werden. Und schon hats funktioniert. Dieselbe Fehlermeldung bekam ich übrigens bei einer Diva-Server-Karte, wenn ich bei Dial nicht meine eigene MSN voranstellt. D.h. man muss statt ${EXTEN}zB die 109:${EXTEN} wählen.

Schönes schwarzes 3-HE-Rackgerät namens Mobydick mit einem Hauch von Edel. Darin werkeln zwei PCI OctoBRI’s, wir haben dann insgesamt 16 ISDN-Kanäle zur Verfügung.Dazu kamen auch ein paar 320er Snoms (SIP-Telefone).

Die Installation wurde per VPN vom Lieferanten betreut, der Service war echt gut – nämlich so lange,bis der erste Anruf über’s Gerät klappte, was in unserem Fall aber aufgrund der z.Z. nicht vorhandenen Integration in die echte Telefoninfrastruktur eher Spielerei war.

Das System machte einen gut konfigurierten, die Weboberfläche einen aufgeräumten und umfassenden Eindruck. Wahrscheinlich werden wir fast alle unsere Anforderungen direkt umsetzen können. Wäre nur schade, wenn ich meine erlangten Kenntnisse aus der Asterisk-Schulung nicht einsetzen könnte.

In den nächsten Wochen werde ich herumkonfigurieren und testen, da gibts sicherlich ab und zu einen Erfahrungshappen zu lesen.