1.2 Welche Kapitel sollten Sie lesen, und womit sollten Sie anfangen?... 40

Transkript

1

2 Vorwort Danksagungen Das How-To zu diesem Buch Was ist Asterisk? Unterschied zwischen klassischer Telefonanlage und Asterisk Welche Kapitel sollten Sie lesen, und womit sollten Sie anfangen? Absoluter Asterisk-Anfänger Leser mit etwas Asterisk-Erfahrung Der Asterisk-Profi Updates und Versionen des Buches Mitwirken und Feedback Arten der Hilfe FAQ für freiwillige Helfer Hilfe, ich habe immer noch ein Problem mit Asterisk! »Hello World« Einleitung Asterisk 1.4 oder 1.6? Asterisk auf dem Server installieren Hello-World im CLI aufrufen Asterisk konfigurieren Asterisk starten und Hello-World abrufen Hello-World mit einem SIP-Telefon sip.conf und das SIP-Telefon konfigurieren Asterisk und Telefon starten Der Test Vom CLI aus das Telefon anrufen Analyse Kommentare in der Konfiguration Eine Minimal-Telefonanlage mit zwei SIP-Telefonen und jetzt mit einem Anrufbeantworter Rechteverwaltung mit Contexten Quelle: Jedes Telefon ist in einem Context Ziel: Contexte in der extensions.conf

3 2.7 Telefonate vom und in das öffentliche Netz In das öffentliche Telefonnetz telefonieren Gespräche vom öffentlichen Netz entgegennehmen Dialplan die Grundlagen Context Syntax Extension Syntax Grundlegende Applikationen Priorität Pattern Matching Syntax Testen mit dialplan show Wann matcht welches Pattern? Includes im Dialplan Syntax Beispiel Die Reihenfolge beim Include Includes zeitgesteuert Die Variable ${EXTEN} und die Funktion ${CALLERID(num)} ${EXTEN} ${CALLERID(num)} Deutsche Anpassungen Töne und Signale Deutsche Sprachbausteine Download und Installation deutscher Sprachprompts Konfiguration der deutschen Prompts Verzeichnisstruktur der Sprachbausteine Case-Study einer Beispielfirma Einleitung Die Apfelmus GmbH Der Rufnummernplan Auswahl der Infrastruktur Netzwerk Server-Hardware

4 5.5 Die Grundkonfiguration sip.conf für fast 100 Teilnehmer Der Wählplan (Dialplan) Wie geht es weiter? FAQ Programmieren im Dialplan Kleines Programmierer-Howto Programmstruktur Variablen Labels und Goto() While()-Schleifen GotoIf()-Bedingung Gosub()-Unterprogramme Variablen Variablen in einer Extension auslesen Allgemeines Globale Variablen in der extensions.conf definieren Variablen mit Set() definieren Vererbung von Channel-Variablen Feste Channel-Variablen Variablenmanipulation Besondere Extensions Die h-extension Die i-extension Die o- und die a-extension Die t- und die T-Extension Die s-extension Makro Makro-Basics Priority Jumping ist deprecated! AEL (Asterisk Extension Language) CLI-Befehle für AEL aelparse extensions.conf extensions.ael Zeilenende/Befehlsende Kontexte, Extensions, Prioritäten

5 7.3.3 Kommentare Includes Andere Contexte einbinden Globale Variablen Ausdrücke und Zuweisungen Labels, goto und jump Bedingte Anweisungen (conditionals) Schleifen (loops) Makros (macros) Hints Filtern nach Anrufernummer extensions.ael oder extensions.conf? Protokolle Einleitung Netzwerkprotokolle Transmission Control Protocol (TCP) User Datagram Protocol (UDP) Channels Peers, Users und Friends 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 Beispiel mit einem festen Codec Beispiel mit mehreren Codecs zur Auswahl

6 9.5 Die wichtigsten Codecs Bandbreite und Trunking ISDN Einleitung Minimalgrundlagen von ISDN Welche ISDN-Karte soll ich nehmen? Empfehlung für den Privathaushalt Empfehlung für den geschäftlichen Einsatz Hersteller und Treiber Installationsanleitungen für ISDN-Karten Analoge Telefonie Einleitung ATA (Analog-Telefon-Adapter) Installationsanleitungen für Analog-Karten Media Gateways Einleitung Vorteile Nachteile Fazit Voic -System Einleitung Beispielanwendungen Die 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

7 13.6 voic .conf als Passwortspeicher Mini-Voic (MiniVM) Verzeichnisstruktur minivm.conf CLI-Befehle für Mini-Voic MiniVM-Applikationen und -Funktionen 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 Tiefe der IVR Text-to-Speech (TTS) Installation von Cepstral Text-to-Speech Beispiele und Tests Pausen in Texten Die Asterisk-Datenbank (AstDB) Einleitung Performance Die 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 Call-Forwarding Einfaches Call-Forwarding Komplexes Call-Forwarding Anwendungsbeispiel Calling-Card

8 16 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 eventwhencalled eventmemberstatus reportholdtime memberdelay timeoutrestart autopause ringinuse member agents.conf autologoff ackcall endcall wrapuptime musiconhold updatecdr

9 recordagentcalls recordformat createlink urlprefix savecallsin agent extensions.conf Log-Datei Queue-Log in MySQL importieren Features Transfer von Gesprächen Blind Transfer Attended Transfer Gespräche parken Telefonkonferenzen Einleitung Installation und das Timing-Device Definition von Konferenzräumen Zugang im Dialplan Anzahl der Teilnehmer ansagen Asterisk fernsteuern asterisk -rx»befehl« Beispiel Call Files Parameter Call Files 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 Asynchronous Javascript Asterisk Manager (AJAM) Beispiel: Anzahl der Mailbox-Nachrichten per AJAM abfragen Hinweise zu AJAX und AJAM

10 20 Asterisk Gateway Interface (AGI) Datenströme STDIN STDOUT STDERR Verzeichnisse und Rechte Aufruf eines AGI-Skripts im Dialplan Beispiele in verschiedenen Programmiersprachen Perl PHP Ruby und Adhearsion Andere Programmiersprachen Fax-Server Faxserver mit IAXmodem und HylaFax Installation von IAXmodem Installation von HylaFax Faxe empfangen Faxe versenden Empfangene Faxe als versenden Hylafax-FAQ SIP-Telefone Einleitung Snom VoIP-Telefone Konfiguration von Asterisk Konfiguration der Telefone Unterschiedliche Klingeltöne Benutzerdefinierte Menüführung Telefone per Fernwartung neu starten Weitere verfügbare Applikationen BLF, Hints, Pickup Ansteuerung der LEDs sip.conf Hints Verfahren für SIP-Subscriptions Konfiguration der Telefone für BLF Test der Hints

11 23.5 Heranholen eines Anrufs (»Pickup«) extensions.conf für Pickup Konfiguration des Telefons für Pickup Heranholen von einer Gruppe Gezielte Ansteuerung der LEDs A Installationsanleitungen für Asterisk 1.4 und B A.1 Installation von Asterisk 1.4.x auf Debian Linux A.2 Installation von Asterisk 1.6.x auf Debian Linux A.3 Installation von Asterisk 1.4.x auf Knoppix Spezielle Installationsanleitungen für Asterisk mit ISDN- oder Analog-Karten B.1 Installation der Sangoma B700 FlexBRI B.1.1 Die FlexBRI-Karte einbauen B.1.2 Build-Umgebung B.1.3 Quellen von Zaptel und Asterisk B.1.4 Installation von Wanpipe B.1.5 Konfiguration für die FlexBRI B.1.6 Wichtige Befehle für Wanpipe B.2 Installation der Sangoma A500 ISDN-Karte B.2.1 Einbau der A500-Karte B.2.2 Build-Umgebung B.2.3 Quellen von Asterisk B.2.4 Installation von Wanpipe B.2.5 Silent-Modus-Installation B.2.6 Interaktiver-Modus-Installation B.2.7 Runlevel B.2.8 Konfiguration für die A B.2.9 Wichtige Befehle für Wanpipe B.3 Installation der Digium B410p B.3.1 Konfiguration der ISDN-Karte B.3.2 Konfiguration der ISDN-Anschlussart B.4 Installation der Digium TDM400p Analog-Karte B.4.1 Installation B.4.2 Beispiel-Dialplan

12 C Applikationen im Dialplan C.1 AbsoluteTimeout() C.2 AddQueueMember() C.3 ADSIProg() C.4 AgentCallbackLogin() C.5 AgentLogin() C.6 AgentMonitorOutgoing() C.7 AGI() C.8 AlarmReceiver() C.9 AMD() C.10 Answer() C.11 AppendCDRUserField() C.12 Authenticate() C.13 Background() C.14 BackgroundDetect() C.15 Bridge() C.16 Busy() C.17 ChangeMonitor() C.18 ChanIsAvail() C.19 ChannelRedirect() C.20 ChanSpy() C.21 CheckGroup() C.22 ClearHash() C.23 Congestion() C.24 ContinueWhile() C.25 ControlPlayback() C.26 Curl() C.27 Cut() C.28 DAHDIBarge() C.29 DAHDIRAS() C.30 DAHDIScan() C.31 DAHDISendKeypadFacility() C.32 DateTime()

13 C.33 DBdel() C.34 DBdeltree() C.35 DBget() C.36 DBput() C.37 DeadAGI() C.38 Dial() C.39 Dictate() C.40 DigitTimeout() C.41 Directory() C.42 DISA() C.43 DumpChan() C.44 DUNDiLookup() C.45 EAGI() C.46 Echo() C.47 EndWhile() C.48 EnumLookup() C.49 Eval() C.50 Exec() C.51 ExecIf() C.52 ExecIfTime() C.53 ExitWhile() C.54 ExtenSpy() C.55 ExternalIVR() C.56 Festival() C.57 Flash() C.58 FollowMe() C.59 ForkCDR() C.60 GetCPEID() C.61 GetGroupCount() C.62 GetGroupMatchCount() C.63 Gosub() C.64 GosubIf() C.65 Goto()

14 C.66 GotoIf() C.67 GotoIfTime() C.68 Hangup() C.69 HasNewVoic () C.70 HasVoic () C.71 IAX2Provision() C.72 ICES() C.73 ImportVar() C.74 Incomplete() C.75 JabberSend() C.76 JabberStatus() C.77 KeepAlive() C.78 Log() C.79 LookupBlacklist() C.80 LookupCIDName() C.81 Macro() C.82 MacroExclusive() C.83 MacroExit() C.84 MacroIf() C.85 MailboxExists() C.86 Math() C.87 MD5() C.88 MD5Check() C.89 MeetMe() C.90 MeetMeAdmin() C.91 MeetMeChannelAdmin() C.92 MeetMeCount() C.93 Milliwatt() C.94 MinivmAccMess() C.95 MinivmDelete() C.96 MinivmGreet() C.97 MinivmNotify() C.98 MinivmRecord()

15 C.99 MixMonitor() C.100 Monitor() C.101 Morsecode() C.102 MP3Player() C.103 MSet() C.104 MusicOnHold() C.105 NBScat() C.106 NoCDR() C.107 NoOp() C.108 ODBCFinish() C.109 Page() C.110 Park() C.111 ParkAndAnnounce() C.112 ParkedCall() C.113 PauseMonitor() C.114 PauseQueueMember() C.115 Pickup() C.116 PickupChan() C.117 Playback() C.118 Playtones() C.119 PrivacyManager() C.120 Proceeding() C.121 Progress() C.122 Queue() C.123 QueueLog() C.124 RaiseException() C.125 Random() C.126 Read() C.127 ReadExten() C.128 ReadFile() C.129 RealTime() C.130 RealTimeUpdate() C.131 ReceiveFAX()

16 C.132 Record() C.133 RemoveQueueMember() C.134 ResetCDR() C.135 ResponseTimeout() C.136 RetryDial() C.137 Return() C.138 Ringing() C.139 SayAlpha() C.140 SayDigits() C.141 SayNumber() C.142 SayPhonetic() C.143 SayUnixTime() C.144 SendDTMF() C.145 SendFAX() C.146 SendImage() C.147 SendText() C.148 SendURL() C.149 Set() C.150 SetAccount() C.151 SetAMAFlags() C.152 SetCallerID() C.153 SetCallerPres() C.154 SetCDRUserField() C.155 SetCIDName() C.156 SetCIDNum() C.157 SetGlobalVar() C.158 SetGroup() C.159 SetLanguage() C.160 SetMusicOnHold() C.161 SetRDNIS() C.162 SetTransferCapability() C.163 SetVar() C.164 SIPAddHeader()

17 C.165 SIPdtmfMode() C.166 SIPGetHeader() C.167 SMS() C.168 SoftHangup() C.169 Sort() C.170 StackPop() C.171 StartMusicOnHold() C.172 StopMixMonitor() C.173 StopMonitor() C.174 StopMusicOnHold() C.175 StopPlaytones() C.176 System() C.177 Transfer() C.178 TryExec() C.179 TrySystem() C.180 TXTCIDName() C.181 UnpauseMonitor() C.182 UnpauseQueueMember() C.183 UserEvent() C.184 Verbose() C.185 VMAuthenticate() C.186 Voic () C.187 Voic Main() C.188 Wait() C.189 WaitExten() C.190 WaitForNoise() C.191 WaitForRing() C.192 WaitForSilence() C.193 WaitMusicOnHold() C.194 WaitUntil() C.195 While() C.196 Zapateller() C.197 ZapBarge()

18 C.198 ZapRAS() C.199 ZapScan() C.200 ZapSendKeypadFacility() D Funktionen im Dialplan D.1 AGC() D.2 AGENT() D.3 ARRAY() D.4 AST_CONFIG() D.5 BASE64_DECODE() D.6 BASE64_ENCODE() D.7 BLACKLIST() D.8 CALLERID() D.9 CALLERPRES() D.10 CDR() D.11 CHANNEL() D.12 CHANNELS() D.13 CHECK_MD5() D.14 CHECKSIPDOMAIN() D.15 CURL() D.16 CUT() D.17 DB() D.18 DB_DELETE() D.19 DB_EXISTS() D.20 DENOISE() D.21 DEVICE_STATE() D.22 DIALGROUP() D.23 DIALPLAN_EXISTS() D.24 DUNDILOOKUP() D.25 DUNDIQUERY() D.26 DUNDIRESULT() D.27 ENUMLOOKUP() D.28 ENUMQUERY()

19 D.29 ENUMRESULT() D.30 ENV() D.31 EVAL() D.32 EXCEPTION() D.33 EXISTS() D.34 EXTENSION_STATE() D.35 FIELDQTY() D.36 FILE() D.37 FILTER() D.38 GLOBAL() D.39 GROUP() D.40 GROUP_COUNT() D.41 GROUP_LIST() D.42 GROUP_MATCH_COUNT() D.43 HASH() D.44 HASHKEYS() D.45 HINT() D.46 IAXPEER() D.47 IAXVAR() D.48 ICONV() D.49 IF() D.50 IFMODULE() D.51 IFTIME() D.52 IMPORT() D.53 ISNULL() D.54 JABBER_STATUS() D.55 KEYPADHASH() D.56 LANGUAGE() D.57 LEN() D.58 LOCAL() D.59 LOCK() D.60 MAILBOX_EXISTS() D.61 MATH()

20 D.62 MD5() D.63 MEETME_INFO() D.64 MINIVMACCOUNT() D.65 MINIVMCOUNTER() D.66 MUSICCLASS() D.67 ODBC_ANTIGF() D.68 ODBC_FETCH() D.69 ODBC_funktionsname() D.70 ODBC_PRESENCE() D.71 ODBC_SQL() D.72 QUEUE_MEMBER() D.73 QUEUE_MEMBER_COUNT() D.74 QUEUE_MEMBER_LIST() D.75 QUEUE_MEMBER_PENALTY() D.76 QUEUE_VARIABLES() D.77 QUEUE_WAITING_COUNT() D.78 QUEUEAGENTCOUNT() D.79 QUOTE() D.80 RAND() D.81 REALTIME() D.82 REALTIME_DESTROY() D.83 REALTIME_STORE() D.84 REGEX() D.85 SET() D.86 SHA1() D.87 SHARED() D.88 SHELL() D.89 SIP_HEADER() D.90 SIPCHANINFO() D.91 SIPPEER() D.92 SMDI_MSG() D.93 SMDI_MSG_RETRIEVE() D.94 SORT()

21 D.95 SPRINTF() D.96 SQL_ESC() D.97 STAT() D.98 STRFTIME() D.99 STRPTIME() D.100 SYSINFO() D.101 TIMEOUT() D.102 TOLOWER() D.103 TOUPPER() D.104 TRYLOCK() D.105 TXTCIDNAME() D.106 UNLOCK() D.107 URIDECODE() D.108 URIENCODE() D.109 VALID_EXTEN() D.110 VERSION() D.111 VMCOUNT() D.112 VOLUME() E AGI-Befehle E.1 ANSWER E.2 ASYNCAGI BREAK E.3 CHANNEL STATUS E.4 CONTROL STREAM FILE E.5 DATABASE DEL E.6 DATABASE DELTREE E.7 DATABASE GET E.8 DATABASE PUT E.9 EXEC E.10 GET DATA E.11 GET FULL VARIABLE E.12 GET OPTION E.13 GET VARIABLE