login | register
Tue 09 of Feb, 2010 [20:45 UTC]

voip-info.org

History

Asterisk cmd Hangup

Created by: oej,Last modification on Tue 22 of Dec, 2009 [11:26 UTC] by FreezeS

Synopsis:

 Hangup(<causecode>)  

Description:

 This application will hang up the calling channel. If a causecode is given the channel's hangup cause will be set to the given value.
 
Unconditionally hangs up a given channel by returning -1 always.

For SIP Connections

It is possible to send different reply errors ("404 Not found", "484 Address incomplete" etc.) by setting <causecode> to one of the values defined by RFC 3398 - page 24.
Very important!!! The <causecode> parameter is the ISDN causecode and not SIP. So, for example, in order to get Asterisk to hang up a call with the SIP cause 503 you'll need to call hangup(42).



For PRI Connections: Setting a PRI_CAUSE

  • Available on CVS versions March, 2004
On Zap PRI channels it is possible to set the PRI_CAUSE variable prior to Hangup(). This will send a PRI DISCONNECT message with the set CAUSE element to the switch. Some commonly used cause codes:

    1 = Unallocated number
   16 = Normal call clearing
   17 = User busy
   18 = No user responding (telephone device not connected)
   21 = Call rejected
   22 = Number changed
   27 = Destignation out of order
   38 = Network out of order
   41 = Temporary failure

In Canada, through Group Telecom (May work through others) The hangup with PRI_CAUSE delivers these messages.


PRI_CAUSE = 0,22,28,65-66 We're sorry your call cannot be completed as dialed, please contact the group telecom customer service center at 1-877-484-5101 if you require assistance.

PRI_CAUSE = 2-16,19-20,23-27,29-40,43-53,55-64,67-100 Fast Busy Signal / Congestions

PRI_CAUSE = 17,41 Slow Busy Signal (Normal busy signal you hear every day)

PRI_CAUSE = 18,21 Ringing (Normal ringing you hear every day)

PRI_CAUSE = 42,54 We're sorry, all circuits are busy, please try your call again later.



Example:


    exten => i,1,SetVar(PRI_CAUSE=1)    
    ; invalid extension dialed - PRI_CAUSE=unallocated number
    exten => i,2,Hangup                 
    ; send the DISCONNECT message
    ; This will in most cases result in a network generated recording like
    "The number you have dialed has been disconnected ..."

See also


Asterisk | Applications | Functions | Variables | Expressions | Asterisk FAQ


Comments

Comments Filter
222

333Softphone Hung up when Voicemail Answered

by lumpy, Wednesday 22 of February, 2006 [17:44:20 UTC]
I was calling an outside DID that, when answered by the persons voice mail, would trigger Asterisk to "hang up" the call. I was getting a debug message like detected busy, hanging up. The deal is that I stupidly had busydetect=yes set in my zapata.conf. This setting, I believe, is geared more towards analog lines which are 'unsupervised" by the telco so that Asterisk knows that it should stop processing a call.
222

333Softphone Hung up when Voicemail Answered

by lumpy, Wednesday 22 of February, 2006 [17:43:40 UTC]
I was calling an outside DID that, when answered by the persons voice mail, would trigger Asterisk to "hang up" the call. I was getting a debug message like detected busy, hanging up. The deal is that I stupidly had busydetect=yes set in my zapata.conf. This setting, I believe, is geared more towards analog lines which are 'unsupervised" by the telco so that Asterisk knows that it should stop processing a call.