Last time I showed you how to add voicemail facilities to your incoming lines. We concentrated on the local end, how a single access number could pickup voicemail from different mailboxes depending on the extension it was dialled from. I didn\u00e2\u20ac\u2122t discuss the receiving side very much, and simply gave you this template:<\/p>\n
[external]\nexten => voiptalkRESIDENTIAL,1,Verbose(1,Incoming call on callbackextension=${EXTEN})\nexten => voiptalkRESIDENTIAL,n,Queue(residential,cnrtk,,,30)\nexten => voiptalkRESIDENTIAL,n,Voicemail(household)\nexten => voiptalkOFFICE,1,Verbose(1,Incoming call on callbackextension=${EXTEN} from ${CALLERID(all)})\nexten => voiptalkOFFICE,n,Queue(business,cnrtk,,,30)\nexten => voiptalkOFFICE,n,Voicemail(business)<\/code><\/pre>\nThis form has an error in it. Queue()<\/code> rings your extension, you answer and have a conversation, then hang up. Your caller hasn\u00e2\u20ac\u2122t hung up yet \u00e2\u20ac\u201c the Queue()<\/code> call returns and they are put through to Voicemail()<\/code>. That\u00e2\u20ac\u2122s unlikely to be what you want, when you hang up your extension that\u00e2\u20ac\u2122s the end of the call, and the telephone system should hang up on the caller as well. We\u00e2\u20ac\u2122ll deal with that problem, and reduce our code duplication by using a facility we have used before, subroutines.<\/p>\n[stdqueue]\nexten => s,1,Verbose(1,Start stdqueue ${ARG1},${ARG2},${ARG3})\nexten => s,n,Set(LOCAL(ext)=${ARG1})\nexten => s,n,Set(LOCAL(queue)=${IF($[${ISNULL(${ARG2})}]?${ext}:${ARG2})})\nexten => s,n,Set(LOCAL(mbx)=${IF($[${ISNULL(${ARG3})}]?${ext}:${ARG3})})\nexten => s,n,Queue(${queue},${QUEUEFLAGS},,,${QUEUETIMEOUT})\n; QUEUESTATUS The status of the call as a text string, one of TIMEOUT | FULL |\n; JOINEMPTY | LEAVEEMPTY | JOINUNAVAIL | LEAVEUNAVAIL | CONTINUE\nexten => s,n,Goto(s-${QUEUESTATUS},1)\nexten => s-CONTINUE,1,Return()\nexten => s-TIMEOUT,1,Voicemail(${mbx},u)\nexten => s-TIMEOUT,n,Return()\nexten => s-FULL,1,Voicemail(${mbx},b)\nexten => s-FULL,n,Return()\n; Treat anything else as no answer\nexten => _s-.,1,Goto(s-TIMEOUT,1)<\/code><\/pre>\nThis is very similar to the stdexten<\/code> subroutine we used in asterisk3<\/a> to standardise dialling an extension. This time the core of the subroutine is Queue()<\/code> instead of Dial()<\/code>, but the principle is the same. Note in particular<\/p>\n\nVoicemail()<\/code> is only called on error conditions.<\/li>\n- we have passed the appropriate type flag (
u<\/code> or b<\/code>) to Voicemail()<\/code> depending on the queue fault.<\/li>\n- the queue to call and the fallback mailbox are parameters, but have reasonable defaults if they aren\u00e2\u20ac\u2122t present.<\/li>\n
- the flags to the
Queue()<\/code> call are now a global variable, ${QUEUEFLAGS}<\/code>, which you should set as you wish (probably cnrtkx<\/code>).<\/li>\n- the queue timeout is now a global variable,
${QUEUETIMEOUT}<\/code>.<\/li>\n<\/ul>\nWe can now update our [external]<\/code> context to use this subroutine.<\/p>\n[external]\nexten => voiptalkRESIDENTIAL,1,Gosub(stdqueue,s,1(${EXTEN},residential))\nexten => voiptalkOFFICE,1,Gosub(stdqueue,s,1(${EXTEN},business))<\/code><\/pre>\nWe\u00e2\u20ac\u2122ve given the name of the queue to call, and stdqueue<\/code> takes care of setting the mailbox to the same name when we don\u00e2\u20ac\u2122t supply an explicit mailbox.<\/p>\nOne extra convenience I find is to move the stdqueue<\/code> calls to the internal-extensions context and then Goto()<\/code> them from the external context. That means you can then easily test your queues with internal calls only. Let\u00e2\u20ac\u2122s look at the part of our dialplan that\u00e2\u20ac\u2122s doing all the mapping.<\/p>\n[internal-extensions]\n; Numeric aliases\nexten => 2100,1,Goto(andyp,1)\nexten => 2101,1,Goto(wife,1)\nexten => 2102,1,Goto(handytone1,1)\nexten => 2103,1,Goto(handytone2,1)\nexten => 2200,1,Goto(residential,1)\nexten => 2201,1,Goto(business,1)\n; Named extensions -- endpoints named after sip.conf sections\nexten => andyp,1,Gosub(stdexten,s,1(SIP\/${EXTEN},${EXTEN}))\nexten => andyp,hint,SIP\/${EXTEN}\nexten => wife,1,Gosub(stdexten,s,1(SIP\/${EXTEN},${EXTEN}))\nexten => wife,hint,SIP\/${EXTEN}\nexten => handytone1,1,Gosub(stdexten,s,1(SIP\/${EXTEN},${EXTEN}))\nexten => handytone1,hint,SIP\/${EXTEN}\nexten => handytone2,1,Gosub(stdexten,s,1(SIP\/${EXTEN},${EXTEN}))\nexten => handytone2,hint,SIP\/${EXTEN}\n; Named extensions -- ring groups\nexten => residential,1,Gosub(stdqueue,s,1(${EXTEN}))\nexten => business,1,Gosub(stdqueue,s,1(${EXTEN}))\n\n[internal-residential]\ninclude => internal-extensions\nexten => _0X.,1,Dial(SIP\/voiptalkRESIDENTIAL\/${EXTEN})\n\n[internal-business]\ninclude => internal-extensions\nexten => _0X.,1,Dial(SIP\/voiptalkOFFICE\/${EXTEN})\n\n[external]\nexten => voiptalkRESIDENTIAL,1,Goto(internal-residential,residential,1)\nexten => voiptalkOFFICE,1,Goto(internal-business,business,1)<\/code><\/pre>\nWhat have we achieved then?<\/p>\n
\n- Isolated all the call handling inside subroutines
stdexten<\/code> and stdqueue<\/code><\/li>\n- Mapped the endpoints to extensions<\/li>\n
- Supplied hints to asterisk to let it map endpoints to extensions (which we made easy by giving them the same name
${EXTEN}=SIP\/${EXTEN}<\/code>).<\/li>\n- Mapped the external lines to ring groups<\/li>\n
- Mapped the ring groups to extensions, which can be dialled internally as well as externally<\/li>\n
- Given everything a numeric alias<\/li>\n
- Made dial-out use different outgoing lines depending on which extension is used (set using the
context=<\/code> option in sip.conf<\/code>)<\/li>\n- Made it possible to map any endpoint onto any mailbox (set using the
mailbox=<\/code> option in sip.conf<\/code>)<\/li>\n<\/ul>\nIn short: we\u00e2\u20ac\u2122re nicely organised. Adding new extensions, external lines or groups is a copy-and-paste job.<\/p>\n
Next time<\/a> I\u00e2\u20ac\u2122ll talk about getting an Asterisk-generated dialtone.<\/p>\nasterisk1<\/a> asterisk2<\/a> asterisk3<\/a> asterisk4<\/a> asterisk5<\/a> asterisk6<\/a> asterisk7<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"Last time I showed you how to add voicemail facilities to your incoming lines. We concentrated on the local end, how a single access number could pickup voicemail from different mailboxes depending on the extension it was dialled from. I didn\u00e2\u20ac\u2122t discuss the receiving side very much, and simply gave you this template: [external] exten\u2026 Read More »<\/a><\/span><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[31,42,6],"_links":{"self":[{"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=\/wp\/v2\/posts\/776"}],"collection":[{"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=776"}],"version-history":[{"count":4,"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=\/wp\/v2\/posts\/776\/revisions"}],"predecessor-version":[{"id":785,"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=\/wp\/v2\/posts\/776\/revisions\/785"}],"wp:attachment":[{"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=776"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=776"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.fussylogic.co.uk\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=776"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}