FreePBX Internals. Astricon, 2008 Glendale, AZ by Philippe Lindheimer FreePBX Project Leader

Transcription

1 FreePBX Internals Astricon, 2008 Glendale, AZ by Philippe Lindheimer FreePBX Project Leader

2 The FreePBX Project Open Source GPLv2 Installed Base Estimated 250,000 Installed Base Estimated growth of thousands per month ~3M Downloads 100,000 Visits/Month (400,000 Page Views) Proven Stability with Mature Release History 10/14/ (AMP) 03/17/ (FreePBX) 05/16/ /05/ /25/ /10/ /19/

3 The FreePBX Project >>Who s Using FreePBX? Many others (some have come and gone) + = Adminparadise Asterisk Suite Centris CentPBX Converged Interaction EasyVoxBox ESCAUX net. PBX Generic User Management System kasterx Miruna Asterisk System Pound Team PBX ST-PBX Live VoizEdge More

4 FreePBX Internals >>Goals Goals Overall Get a high level orientation around core concepts in the FreePBX dialplan Understand how FreePBX implements extensions Devices and Users, different then classic Asterisk text book examples and simple dialplans Understand the high level layout of the FreePBX extensions.conf Understand how FreePBX dials out to trunks Understand which macros and AGI scripts are used for internal and outbound dialing, and their general purpose Understand how to connect your custom dialplans into FreePBX to be used in the GUI, and how to register your custom extensions/feature codes

5 Text Book View of Extension SIP Section == Extension Number Calling SIP Extension == Dial(SIP/${EXTEN})

6 FreePBX Internals >>Devices and Users Important FreePBX Terms User A User on the system that can be called The User number is how you dial them User = Extension (usually) Device A FreePBX Object Links a User to a Physical Endpoint Fixed Permanently Assigned Adhoc Users can login/out of device Extension User + Device User Endpoint or Phone The phone that is associated with a FreePBX Device Device

7 FreePBX Internals >>Devices and Users Understanding Users / Devices Interactions when a phone makes a call internal extension (User) initiating a call Interactions when a call is made to an extension (User) call directed to internal phones

8 FreePBX Internals >>Devices and Users AMPUSER/210 Device Initiates Call DEVICE/216 SIP/

9 FreePBX Internals >> Devices and Users macro-user-callerid Call this first Determines Internal, External and Masquerading s Determines Language requirements for the user [CallerID!(always)== The Caller] (${AMPUSER} is true identity) Important when implementing Feature Codes

10 FreePBX Internals >>Devices and Users AMPUSER/210 Call Made to User DEVICE/210 DEVICE/216 SIP/210 SIP/

11 FreePBX Internals >>Internal Dialing key components Key Macros/AGI Scripts macro-user-callerid macro-exten-vm dialparties.agi + macro-dial macro-vm Important AstDB Objects AMPUSER DEVICE

12 Text Book View of Outbound Dialing Streamlined call to Dial() command No differentiation in handling

13 FreePBX View of Inbound/Outbound >> extensions.conf simplified [globals] Trunks [from-pstn] Inbound routes Security separation [from-internal] Internal extensions Internal features [outbound-allroutes] Outbound Trunk Access [from-trunk-<tech>-<name>] Inbound Trunks (optional) Used for channel counting

14 Outbound Dialing >>key macros/agi scripts macro-user-callerid macro-dialout-trunk Variations: macro-dialout-enum macro-dialout-dundi macro-outbound-callerid fixlocalprefix (AGI Script) macro-dialout-trunk-predial-hook this is yours!

15 Outbound Dialing >>CallerID CallerID Handling Originated Call From User or Forwarded Call (CF, Follow-Me, etc.) Yes No Use Emergency Use Internal Emergency? Yes Yes No Emergency Route No Intra- Company Internal Caller? Never Overide Set? Yes Yes No Trunk Set Use Trunk Use Forwarded No If CallerID(name) == hidden ( hidden < >) SetCallerPres(prohib_passed_screen) No Use Outboundcid Yes Outbound Trunk? Yes Use Trunk Use Trunk Yes No Trunk No Use Extension (Undefined Results) No No Transmitted

16 FreePBX GUI Integration >>Extension Registry Custom Apps Registry Register You Custom extensions Example: Custom WakeUp Call exten => *62,1,Answer() exten => *62,n,Macro(user-callerid) exten => *62,n,AGI(wakeup.php) exten => *62,n,Hangup() Tell FreePBX Extension Registry

17 FreePBX GUI Integration >>Destination Registry Custom Destination Registry Register your custom destinations Example: Custom Callback [custom-callback] exten => h,1,hangup() exten => hang,1,playback(vm-goodbye) exten => hang,n,hangup() exten => i,1,playback(conf-errormenu) exten => i,n,goto(s,inval) exten => s,1,gotoif($[${dialstatus} = ANSWER]?ans) exten => s,n,answer() exten => s,n,wait(2) exten => s,n(ans),setvar(looped=1) Tell FreePBX Destination Registry: z

18 FreePBX Internals >>Summary FreePBX implements its extensions as a combination of Devices and Users Your dialplan should always call macro-user-callerid to determine the real identity of the calling device FreePBX uses a handful of key macros when accessing trunks to decipher a user and the appropriate callerid to be used as well as to further manipulate dialed digits on each trunk It s easy to connect custom dialplans and destinations used in call flows through the FreePBX Custom Extension and Destination Registry

19 Where to Learn More >>Open Telephony Training Seminar Open Telephony Training Seminar Where: Digium Headquaters Huntsville, AL When: Oct 7-10 TH More Info: Learn About: Components of Asterisk and FreePBX and how they fit together, and FreePBX Internal, troubleshooting and integration with custom Asterisk dialplans. PSTN Integration, Trunks, Troubleshooting with the PSTN, IP Phones and lots more. Successful Marketing, positioning, competition, selling, sales cycle and techniques to differentiate your offerings in the small and medium business PBX space. Past attendees are saying: Great seminar - worth the money and, more important, the time!" Calvin W. Extremely well prepared and presented! Ronald C. The OTTS was a valuable injection of information regarding the vibrant and dynamic Asterisk ecosphere; it should be attended yearly by anyone trying to keep abreast of this area. Ron B.