Inhaltsverzeichnis. Vorwort Howto zu diesem Buch Was überhaupt ist Asterisk?... 27

Transkript

1

2 Vorwort Howto zu diesem Buch Was überhaupt ist Asterisk? Unterschied zwischen klassischer Telefonanlage und Asterisk Welche Kapitel soll ich lesen und womit anfangen? Absoluter Asterisk-Anfänger Leser mit etwas Asterisk-Erfahrung Der Asterisk-Profi Updates und Versionen des Buches Mitwirken und Feedback FAQ für freiwillige Helfer Fragen zur Technik Allgemeine Fragen Hilfe, ich habe immer noch ein Problem mit Asterisk! Installation und»hello World« Einleitung Eine Minimal-Telefonanlage Die Aufgabe Voraussetzungen Welche Asterisk-Version ist empfehlenswert? Welche Linux-Distribution ist die richtige für einen Asterisk-Server? Warum keine fertigen Asterisk-Pakete mit rpm oder apt-get installieren? Asterisk Asterisk Weitere Sprachprompts Den Asterisk-Server konfigurieren Die SIP-Telefone konfigurieren Und jetzt mit einem Anrufbeantworter Was haben wir gerade gemacht? Ins öffentliche Telefonnetz telefonieren Gespräche vom öffentlichen Netz entgegennehmen Die große Telefonanlage Einleitung Die Apfelmus GmbH Der Rufnummernplan

3 3.4 Auswahl der Infrastruktur Netzwerk Server-Hardware Die Grundkonfiguration sip.conf für fast 100 Teilnehmer Der Wählplan (Dialplan) Wie geht es weiter? FAQ Programmieren im Dialplan Context Syntax Extension Syntax Priorität Regular Expressions Grundlegende Applikationen Includes im Dialplan Syntax Beispiel Includes zeitgesteuert Reihenfolge beim Include Variablen Variablen in einer Extension auslesen Allgemeines Globale Variablen in der extensions.conf definieren Variablen mit Set() definieren Vererbung von Channel-Variablen Variablenmanipulation Besondere Extensions Die h-extension Die i-extension Die o- und a-extension Die t- und T-Extension Die s-extension Macro Macro Basics

4 4.8 Kleines Programmierer-Howto Programmstruktur Variablen Labels und Goto() While()-Schleifen GotoIf()-Bedingung Gosub()-Unterprogramme Priority Jumping ist deprecated Asterisk Extension Language (AEL) Applikationen im Dialplan AddQueueMember() ADSIProg() AgentCallbackLogin() AgentLogin() AgentMonitorOutgoing() AGI() AlarmReceiver() AMD() Answer() AppendCDRUserField() Authenticate() Background() BackgroundDetect() Busy() CallingPres() ChangeMonitor() ChanIsAvail() ChannelRedirect() ChanSpy() Congestion() ContinueWhile() ControlPlayback() DateTime() DBdel() DBdeltree() DeadAGI() Dial() Dictate() Directory() DISA() DumpChan() EAGI() Echo()

5 EndWhile() Exec() ExecIf() ExecIfTime() ExitWhile() ExtenSpy() ExternalIVR() FastAGI() Festival() Flash() FollowMe() ForkCDR() GetCPEID() Gosub() GosubIf() Goto() GotoIf() GotoIfTime() Hangup() IAX2Provision() ImportVar() Log() LookupBlacklist() LookupCIDName() Macro() MacroExclusive() MacroExit() MacroIf() MailboxExists() MeetMe() MeetMeAdmin() MeetMeCount() Milliwatt() MixMonitor() Monitor() Morsecode() MP3Player() MusicOnHold() NBScat() NoCDR() NoOp() Page() Park() ParkAndAnnounce() ParkedCall()

6 PauseMonitor() PauseQueueMember() Perl() PHP() Pickup() Playback() Playtones() PrivacyManager() Progress() Queue() QueueLog() Random() Read() ReadFile() RealTime() RealTimeUpdate() Record() RemoveQueueMember() ResetCDR() RetryDial() Return() Ringing() SayAlpha() SayDigits() SayNumber() SayPhonetic() SayUnixTime() SendDTMF() SendImage() SendText() SendURL() Set() SetAMAFlags() SetCallerPres() SetCDRUserField() SetGlobalVar() SetMusicOnHold() SetTransferCapability() SIPAddHeader() SIPdtmfMode() SMS() SoftHangup() StopMonitor() StopPlaytones() System()

7 Transfer() TryExec() TrySystem() UnpauseMonitor() UnpauseQueueMember() UserEvent() Verbose() VMAuthenticate() Voic () Voic Main() Wait() WaitExten() WaitForRing() WaitForSilence() WaitMusicOnHold() While() Zapateller() ZapBarge() ZapRAS() ZapScan() Funktionen im Dialplan AGENT() ARRAY() BASE64_DECODE() BASE64_ENCODE() CALLERID() CDR() CHANNEL() CHECKSIPDOMAIN() CURL() CUT() DB() DB_DELETE() DB_EXISTS() DUNDILOOKUP() ENUMLOOKUP() ENV() EVAL() EXISTS() FIELDQTY() FILTER() GLOBAL() GROUP() GROUP_COUNT()

8 GROUP_LIST() GROUP_MATCH_COUNT() IAXPEER() IF() IFTIME() ISNULL() KEYPADHASH() LANGUAGE() LEN() MATH() MD5() MUSICCLASS() ODBC_SQL() ODBC_USER_DATABASE() QUEUEAGENTCOUNT() QUEUE_MEMBER_COUNT() QUEUE_MEMBER_LIST() QUOTE() RAND() REGEX() SET() SHA1() SIPCHANINFO() SIPPEER() SIP_HEADER() SORT() STAT() STRFTIME() STRPTIME() TIMEOUT() TXTCIDNAME() URIDECODE() URIENCODE() VMCOUNT() Protokolle Einleitung Netzwerkprotokolle Transmission Control Protocol (TCP) User Datagram Protocol (UDP) Channels Peers, Users und Friends

9 5.5 IAX versus SIP SIP Das SIP-NAT-Problem SIP-Geräte in der extensions.conf Globale Einstellungen Channel-Einstellungen IAX Warum IAX? Beispiel für eine IAX-Konfiguration Globale Einstellungen Channel-Einstellungen Codecs Einleitung Was macht ein Codec? Performance Konfiguration des Codecs Die wichtigsten Codecs Bandbreite und Trunking Voic system Einleitung Beispielanwendungen Voic box der Familie Meier Die Apfelmus GmbH Applikationen Voic () Voic Main() voic .conf [general] [zonemessages] Freie Contexte Mailbox-Definition Telefonbuch (Dial-by-Name) Syntax Funktionsweise voic .conf als Passwortspeicher

10 8 ISDN Einleitung Minimalgrundlagen von ISDN ISDN Basis-Anschluss ISDN Multiplex-Anschluss Welche ISDN-Karte soll ich nehmen? Installation und Konfiguration Junghanns (»BRIstuffed«) misdn Analoge Telefonie Einleitung ATA (Analog-Telefon-Adapter) Analoge Karten von Digium Installation s-extension Asterisk-Datenbank (AstDB) Einleitung Performance Asterisk-Datenbank Werte in die Datenbank schreiben Werte aus der Datenbank lesen Werte aus der Datenbank löschen Datenbankzugriff vom CLI Werte in die Datenbank schreiben Werte aus der Datenbank lesen Werte aus der Datenbank löschen Datenbankinhalt anzeigen Datenbankzugriff von der Shell Backup der Datenbank Anwendungsbeispiel CallForwarding Einfaches CallForwarding Komplexes CallForwarding Anwendungsbeispiel CallingCard

11 11 Interactive Voice Response- Systeme (IVR) Eine einfache IVR Unterschied zwischen Playback() und Background() Unterschied zwischen 10 und Falscheingaben (die i-extension) Pausen Mehrstufige IVR-Systeme Text2Speech (TTS) Installation Cepstral Text-to-Speech Beispiele und Tests Pausen in Texten Telefonkonferenzen Einleitung Installation und das Timing-Device Definition von Konferenzräumen Zugang im Dialplan Anzahl der Teilnehmer ansagen Warteschleifen für Call-Center Extension zum Musiktest musiconhold.conf queues.conf musiconhold announce strategy servicelevel context timeout retry weight wrapuptime maxlen announce-frequency announce-holdtime announce-round-seconds Sprachbausteine periodic-announce-frequency monitor-format monitor-join joinempty leavewhenempty

12 eventwhencalled eventmemberstatus reportholdtime memberdelay timeoutrestart autopause ringinuse member agents.conf autologoff ackcall endcall wrapuptime musiconhold updatecdr recordagentcalls recordformat createlink urlprefix savecallsin agent extensions.conf Aufgabe Log-Datei Deutsche Anpassungen Töne und Signale Deutsche Sprachbausteine Verzeichnisstruktur der Sprachbausteine Sprachbausteine der Stadt Pforzheim installieren Sprachbausteine der amooma GmbH installieren Sprachbausteine von Digium installieren Asterisk als Faxserver Installation IAXmodem Installation Hylafax Faxe empfangen Faxe versenden Fax FAQ Asterisk fernsteuern asterisk -rx "Befehl" Beispiel

13 16.2 CallFiles Parameter CallFiles in der Zukunft aufrufen Beispiel Weckruf Das Manager-Interface (AMI) Beispiel: Anzahl der Mailbox-Nachrichten mit Expect abfragen StarAstAPI für PHP Beispiel: Anzahl der Mailbox-Nachrichten mit PHP abfragen Der Aynchronous Javascript Asterisk Manager (AJAM) Beispiel: Anzahl der Mailbox-Nachrichten per AJAM abfragen Hinweise zu AJAX und AJAM Asterisk Gateway Interface (AGI) Datenströme STDIN STDOUT STDERR Verzeichnisse und Rechte Aufruf eines AGI im Dialplan Perl Schritt-für-Schritt-Analyse des agi-test.agi-skripts PHP phpagi Andere Programmiersprachen AGI-Befehle ANSWER CHANNEL STATUS DATABASE DEL DATABASE DELTREE DATABASE GET DATABASE PUT EXEC GET DATA GET FULL VARIABLE GET OPTION GET VARIABLE HANGUP NOOP RECEIVE CHAR RECEIVE TEXT RECORD FILE

14 SAY ALPHA SAY DATE SAY DATETIME SAY DIGITS SAY NUMBER SAY PHONETIC SAY TIME SEND IMAGE SEND TEXT SET AUTOHANGUP SET CALLERID SET CONTEXT SET EXTENSION SET MUSIC SET PRIORITY SET VARIABLE STREAM FILE TDD MODE VERBOSE WAIT FOR DIGIT Features Transfer von Gesprächen Blind Transfer Attended Transfer Gespräche parken Telefone Einleitung snom VoIP-Telefone Konfiguration von Asterisk Konfiguration der Telefone Unterschiedliche Klingeltöne Benutzerdefinierte Menüführung (nur snom 360) Ansteuerung der Leitungstasten und -LEDs Weitere verfügbare Applikationen Asterisk und VoiceXML Asterisk und Hastenix Sprachausgabe Abspielen von Sounddateien DTMF-Eingabe

15 20.5 Sprachaufnahme Upload von Sprachaufnahmen zum Webserver Verarbeitung von Sprachaufnahmen auf dem Webserver Anrufweiterleitung Fazit Upgrade Asterisk 1.2 auf Einleitung Das neue Buildsystem menuselect Neue Soundcodecs für die Voiceprompts Neue Struktur bei CLI-Kommandos Danksagungen Das Kernteam Spezialisten Helfer beim Beta-Test Glossar A GNU Free Documentation License A.1 PREAMBLE A.2 APPLICABILITY AND DEFINITIONS A.3 VERBATIM COPYING A.4 COPYING IN QUANTITY A.5 MODIFICATIONS A.6 COMBINING DOCUMENTS A.7 COLLECTIONS OF DOCUMENTS A.8 AGGREGATION WITH INDEPENDENT WORKS A.9 TRANSLATION A.10 TERMINATION A.11 FUTURE REVISIONS OF THIS LICENSE A.12 ADDENDUM: How to use this License for your documents B Spezielle SIP-Provider B.1 Einleitung B.2 SIP-Provider T-Online B.2.1 Asterisk bei T-Online registrieren B.2.2 Über T-Online telefonieren

16 B.3 SIP-Provider dus.net B.3.1 Asterisk bei dus.net registrieren B.3.2 Über dus.net telefonieren C IAX vs. SIP C.1 Original- von Mark Spencer D Konfigurations-Templates D.1 Templates anlegen D.2 Templates verwenden D.2.1 Beispiel E dcap-zertifizierung E.1 Digiums Asterisk-Zertifizierungen F Standard-Datenströme F.1 Standardeingabe (STDIN) F.1.1 Beispiel F.2 Standardausgabe (STDOUT) F.2.1 Beispiel F.3 Standardfehlerausgabe (STDERR) F.3.1 Beispiel Stichwortverzeichnis