Difference between revisions of "Substations calling external telephone(s)"
From Zenitel Wiki
(7 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{AI}} |
[[image:Call Phone Sequence.png|thumb|right|600px|Calling external phone numbers in sequence]] | [[image:Call Phone Sequence.png|thumb|right|600px|Calling external phone numbers in sequence]] | ||
− | This article describes how substations in the AlphaCom can be configured to call external telephone number(s). | + | This article describes how substations in the ICX-AlphaCom can be configured to call external telephone number(s). |
* '''Multiple phone numbers''' can be called in sequence. If the first phone doesn't answer within a preset time, the call can be routed to a second (and a third...) phone number. | * '''Multiple phone numbers''' can be called in sequence. If the first phone doesn't answer within a preset time, the call can be routed to a second (and a third...) phone number. | ||
* If all lines in the SIP gateway are busy, the '''call will be queued'''. When the line becomes free, the call will automatically progress. | * If all lines in the SIP gateway are busy, the '''call will be queued'''. When the line becomes free, the call will automatically progress. | ||
− | {{Note|The AlphaCom and SIP Gateway must be configured to use '''One Stage''' (Enbloc) dialing to | + | {{Note|The ICX-AlphaCom and SIP Gateway must be configured to use '''One Stage''' (Enbloc) dialing to achieve sequential calls and call queuing}} |
== Prerequisites == | == Prerequisites == | ||
The AlphaCom and SIP Gateway must be configured as described in relevant articles. | The AlphaCom and SIP Gateway must be configured as described in relevant articles. | ||
+ | * [[IP Telephony Service (ICX-AlphaCom)]] | ||
* [[AudioCodes MP114/118, v6.2 and higher|AudioCodes MP114/118]] | * [[AudioCodes MP114/118, v6.2 and higher|AudioCodes MP114/118]] | ||
* [[GSM gateway (Mobile VoIP)|GSM gateway (MV370)]] | * [[GSM gateway (Mobile VoIP)|GSM gateway (MV370)]] | ||
− | |||
− | |||
==Configure the Call Button of the substation== | ==Configure the Call Button of the substation== | ||
Line 31: | Line 30: | ||
Start the string with a "T", followed by the prefix number "0". Then "w" or "W", followed by the phone number. "w" introduces a 0.5 second pause, while "W" introduces a 1.0 second pause. See [[Play DAK Feature]] for further details. | Start the string with a "T", followed by the prefix number "0". Then "w" or "W", followed by the phone number. "w" introduces a 0.5 second pause, while "W" introduces a 1.0 second pause. See [[Play DAK Feature]] for further details. | ||
− | |||
==Configure the Prefix Number == | ==Configure the Prefix Number == | ||
− | One Stage dialing ("enbloc dialing") must be used. After the prefix is dialed, the succeeding digits are collected in the AlphaCom and sent to the SIP gateway in the INVITE message. | + | One Stage dialing ("enbloc dialing") must be used. After the prefix is dialed, the succeeding digits are collected in the ICX-AlphaCom and sent to the SIP gateway in the INVITE message. |
The prefix number must be programmed in the [[Directory_%26_Features_(AlphaPro)|AlphaCom directory table]] with '''Feature 81''' and '''Node''' = SIP Trunk node number. In the "Parameter 2" field you must enter the maximum number of digits in a phone number. | The prefix number must be programmed in the [[Directory_%26_Features_(AlphaPro)|AlphaCom directory table]] with '''Feature 81''' and '''Node''' = SIP Trunk node number. In the "Parameter 2" field you must enter the maximum number of digits in a phone number. | ||
Line 40: | Line 38: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | When the prefix is dialed, the AlphaCom will collect the number of digits specified in the “Parameter 2" before sending the INVITE. If fewer digits are dialed, the AlphaCom will send the INVITE after a predefined timeout. | + | When the prefix is dialed, the ICX-AlphaCom will collect the number of digits specified in the “Parameter 2" before sending the INVITE. If fewer digits are dialed, the ICX-AlphaCom will send the INVITE after a predefined timeout. |
The timeout is by default 3 seconds, and can be configured in [[Exchange_%26_System_(AlphaPro)#VoIP|Exchange & System > System VoIP: '''SIP digit collection timeout''']]. The call setup time will be faster if this timer is set to a low value. | The timeout is by default 3 seconds, and can be configured in [[Exchange_%26_System_(AlphaPro)#VoIP|Exchange & System > System VoIP: '''SIP digit collection timeout''']]. The call setup time will be faster if this timer is set to a low value. | ||
[[File:SIPDigitTimeout.PNG|left|thumb|500px|Digit collection timeout set to 1.0 seconds]] | [[File:SIPDigitTimeout.PNG|left|thumb|500px|Digit collection timeout set to 1.0 seconds]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | |||
== Set SIP Gateway in One Stage dialing mode == | == Set SIP Gateway in One Stage dialing mode == | ||
Line 80: | Line 77: | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | * For the GSM gateway, enter the number "1", as this | + | * For the GSM gateway, enter the number "1", as this gateway has one channel only. |
* For the MP114/118, enter the number of analog FXO lines connected to the gateway. | * For the MP114/118, enter the number of analog FXO lines connected to the gateway. | ||
Line 87: | Line 84: | ||
The Camp on Busy Time is by default 30 seconds, but can be changed in [[Exchange_%26_System_(AlphaPro)#Timers|Exchange & System > System > Timers: '''Camp on Busy Time''']]. | The Camp on Busy Time is by default 30 seconds, but can be changed in [[Exchange_%26_System_(AlphaPro)#Timers|Exchange & System > System > Timers: '''Camp on Busy Time''']]. | ||
− | |||
== Calling multiple numbers in sequence == | == Calling multiple numbers in sequence == | ||
Line 94: | Line 90: | ||
The event handler is used to detect if a call is not answered, and to set up the next call. The event [[Private Ringing Outgoing (Event Type)|33 - Private Ringing Outgoing]] is reported OFF with subevent = 0 when a call in private ringing mode times out without being answered. | The event handler is used to detect if a call is not answered, and to set up the next call. The event [[Private Ringing Outgoing (Event Type)|33 - Private Ringing Outgoing]] is reported OFF with subevent = 0 when a call in private ringing mode times out without being answered. | ||
− | Example: A substation calls phone number 987654321. If no answer within the Private Ringing timeout, the call be routed to a second phone number | + | Example: A substation calls phone number 987654321. If no answer within the Private Ringing timeout, the call be routed to a second phone number 123456789: |
[[File:Dial Sequence.PNG|left|thumb|500px|Event 33 is used to manage the sequence of calls]] | [[File:Dial Sequence.PNG|left|thumb|500px|Event 33 is used to manage the sequence of calls]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
− | + | {{Code2| | |
− | + | IF %op(%2.dir,<nowiki>=</nowiki>,987654321) | |
− | IF %op(%2.dir,=,987654321) | ||
pause | pause | ||
pause | pause | ||
Line 108: | Line 103: | ||
$PD L%1.dir "0w123456789" | $PD L%1.dir "0w123456789" | ||
ENDIF | ENDIF | ||
+ | }} | ||
− | |||
The four PAUSE commands creates a 400ms delay, which is needed for the substation to return to idle before calling the next number. | The four PAUSE commands creates a 400ms delay, which is needed for the substation to return to idle before calling the next number. | ||
Line 130: | Line 125: | ||
[[File:PhoneSequence3.png|left|thumb|800px|Call intercom station A. If no answer, call phone B, then phone C.]] | [[File:PhoneSequence3.png|left|thumb|800px|Call intercom station A. If no answer, call phone B, then phone C.]] | ||
<br style="clear:both;" /> | <br style="clear:both;" /> | ||
+ | |||
+ | {{note|The intercom must be called in [[Private mode|Private Ringing mode]]. Other call features like [[Ringing Group Feature|Ringing Group]] or [[Call Request]] are not supported }} | ||
<br> | <br> | ||
Line 138: | Line 135: | ||
− | + | [[Category: ICX-AlphaCom - SIP Integration]] | |
− | + | [[Category: AlphaCom - SIP Integration]] | |
− | + | [[Category: AlphaCom Applications]] | |
− | + | [[Category: ICX-AlphaCom Applications]] | |
− | |||
− | |||
− | [[Category:AlphaCom - SIP Integration]] | ||
− | [[Category: Applications]] |
Latest revision as of 12:28, 24 February 2023
This article describes how substations in the ICX-AlphaCom can be configured to call external telephone number(s).
- Multiple phone numbers can be called in sequence. If the first phone doesn't answer within a preset time, the call can be routed to a second (and a third...) phone number.
- If all lines in the SIP gateway are busy, the call will be queued. When the line becomes free, the call will automatically progress.
The ICX-AlphaCom and SIP Gateway must be configured to use One Stage (Enbloc) dialing to achieve sequential calls and call queuing |
Contents
Prerequisites
The AlphaCom and SIP Gateway must be configured as described in relevant articles.
Configure the Call Button of the substation
The call button can be configured in two different ways to dial a preconfigured phone number.
Let's assume that the prefix to the external phone line is "0", and the phone number to call is 987654321.
Alternative 1:
Start the string with a "I", followed by the prefix number "0". Then "P", followed by the phone number.
Alternative 2:
Start the string with a "T", followed by the prefix number "0". Then "w" or "W", followed by the phone number. "w" introduces a 0.5 second pause, while "W" introduces a 1.0 second pause. See Play DAK Feature for further details.
Configure the Prefix Number
One Stage dialing ("enbloc dialing") must be used. After the prefix is dialed, the succeeding digits are collected in the ICX-AlphaCom and sent to the SIP gateway in the INVITE message. The prefix number must be programmed in the AlphaCom directory table with Feature 81 and Node = SIP Trunk node number. In the "Parameter 2" field you must enter the maximum number of digits in a phone number.
When the prefix is dialed, the ICX-AlphaCom will collect the number of digits specified in the “Parameter 2" before sending the INVITE. If fewer digits are dialed, the ICX-AlphaCom will send the INVITE after a predefined timeout. The timeout is by default 3 seconds, and can be configured in Exchange & System > System VoIP: SIP digit collection timeout. The call setup time will be faster if this timer is set to a low value.
Set SIP Gateway in One Stage dialing mode
GSM Gateway MV370
Set the GSM Gateway to One Stage dialing mode by selecting Route > LAN to Mobile Settings. Set "URL" = * and "Call Num" = #:
AudioCodes MP114/118
Set the MP114 to One Stage dialing mode by selecting the FXO Settings page, enable 'One-Stage' dialing, 'Wait for dialtone' and 'Answer Supervision'.
- If the FXO lines are assigned to a "Telephone Profile ID", you need to modify that particular "Telephone Profile ID". Check in the Endpoint Phone Number Table page if the FXO line is assigned to a "Telephone Profile ID":
- In the Tel Profile Settings page, select the Profile ID number, and set Dialing Mode to 'One-Stage'.
Call queuing
If all lines in the SIP Gateway is in use, the call can be queued in the AlphaCom, and processed when a line becomes free.
In order to provide this functionality, one have to define how many lines (VoIP channels) the SIP Gateway is allowed to use. This is done from AlphaPro, Exchange & System > NetRouting, Advanced Settings tab:
- For the GSM gateway, enter the number "1", as this gateway has one channel only.
- For the MP114/118, enter the number of analog FXO lines connected to the gateway.
When the call button is pressed and the gateway has no free lines, the call will be placed in a "Camp on Busy" queue and the caller will receive a busy signal. As soon as a line becomes free, the call will progress.
The Camp on Busy Time is by default 30 seconds, but can be changed in Exchange & System > System > Timers: Camp on Busy Time.
Calling multiple numbers in sequence
If the first number does not answer the call, it is possible to call a second number. If the second number doesn't answer, one can call a third number and so on. One can also route the call back to the first number, causing the calls to loop until answered. The number can be an external phone number or an internal intercom number, or a combination.
The event handler is used to detect if a call is not answered, and to set up the next call. The event 33 - Private Ringing Outgoing is reported OFF with subevent = 0 when a call in private ringing mode times out without being answered.
Example: A substation calls phone number 987654321. If no answer within the Private Ringing timeout, the call be routed to a second phone number 123456789:
Action commands:
IF %op(%2.dir,=,987654321) pause pause pause pause $PD L%1.dir "0w123456789" ENDIF
The four PAUSE commands creates a 400ms delay, which is needed for the substation to return to idle before calling the next number.
The ringing time between each number is configured in Exchange & System > System > Timers > Private Call Time. Default is 30.0 seconds. This is a global timer that applies to all private ringing calls in the system.
Example 1 - Call two different phone numbers in sequence
Example 2 - Call intercom station, then two different phone numbers in sequence.
The method described in this article work both for internal intercom numbers as well as for external phone numbers.
The intercom must be called in Private Ringing mode. Other call features like Ringing Group or Call Request are not supported |
Example 3 - Call three different phone numbers in sequence. Loop back if nobody answers