Difference between revisions of "PBX Function External DID"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(19 intermediate revisions by 7 users not shown)
Line 1: Line 1:
=External DID=
= Description =
 
''This option is available starting from [[MOR_10_documentation | MOR 10]]''
 
<br>
==What is External DID?==
 
'''!!WARNING - Deep Asterisk knowledge is a must before proceeding!!''' <br><br>
'''!!WARNING - Deep Asterisk knowledge is a must before proceeding!!''' <br><br>


Line 13: Line 7:


  /etc/asterisk/extensions_mor_external_did.conf
  /etc/asterisk/extensions_mor_external_did.conf
''NOTE: changes to this file are permanent. E.g. update do not overwrite this file.''


Prior to making configurations in that file, please keep in mind, that:
Prior to making configurations in that file, please keep in mind, that:
When call comes to DID, for example DID number 1234567890 it will be forwarded to the dial plan in that file with extension:
<br>
<br>
When call comes to DID, for example DID number 123456 it will be forwarded to the dial plan in that file with extension:
  exten => 1234567890,1,...
<br>
  exten=> 1234567890
<br>
DID number and PBX function Extension '''CANNOT''' be the same. So if your DID is 1234567890, your PBX function extension
cannot be 1234567890, it can be any other number, like *235485.
<br>
<br>
[[Image:warning.png|50px]]DID number and PBX function Extension (in GUI) '''CANNOT''' be the same. So if your DID is 1234567890, your PBX function extension
cannot be 1234567890. It can be any other number, like 99999 or same number but modified with additional characters like *1234567890. DID and extension in config file (/etc/asterisk/extensions_mor_external_did.conf) should be the same.
<br><br>
In this file you can basically configure any function that Asterisk supports to handle your call, like:
In this file you can basically configure any function that Asterisk supports to handle your call, like:


* [http://www.voip-info.org/wiki/view/Asterisk+call+queues Queues]<br>
* [http://www.voip-info.org/wiki/view/Asterisk+howto+dial+plan Custom dial plans]<br>
* [http://www.voip-info.org/wiki/view/Asterisk+howto+dial+plan Custom dial plans]<br>
* [http://www.voip-info.org/wiki/view/Asterisk#HowtosandTutorials And many others]<br>
* [http://www.voip-info.org/wiki/view/Asterisk#HowtosandTutorials And many others]<br>
<br><br>
<br><br>


==How to create External DID?==
= Usage =
1. Go to '''SETTINGS –> Billing -> DIDs -> PBX functions''':
Go to '''ADDON –> PBX functions –> External DIDs''':
<br><br>
<br><br>
[[File:Pbx_functions_menu.png]]
[[File:Pbx_functions_menu.png]]
<br><br>
<br><br>
2. When creating a PBX function select the marked option ''''External DID'''':
Here you will see list off PBX function External DIDs
<br><br>
<br><br>
[[File:Pbx_function_external_did.png]]
[[File:Pbx_function_external_did.png]]
<br><br>
<br><br>
Click on [[image:icon_edit.png]] icon to make changes for existing settings or enter Extension and Dial Plan name, select PBX Pool and PBX Function name and click on [[Image:icon_add.png]] icon to create new one.
*'''Note''': you  can change the User who will be billed by pressing the edit button;
duplicate Extensions can not be created in same PBX Pool.
= Echo test =
Create External DID with PBX function name ''112 - Tell balance'' and assign it to a DID. Let say DID is 37012345.
'''ADDONS > PBX functions > External DIDs'''
[[File:echotest1.png]]
'''DID 37012345 settings.''' Choose External DID dial plan which you created for echo and click green check park to assign DID to it.
[[File:echotest2.png]]
<br>
Make changes in this file:
/etc/asterisk/extensions_mor_external_did.conf
Add in the end of file:
exten => 37012345,1,Answer
exten => 37012345,2,Echo
exten => 37012345,3,Hangup
File should like like this after adding lines:
[mor_external_did]
exten => _X.,1,NoOp(EXTERNAL DID PBX FUNCTION DIAL-PLAN)
exten => _X.,2,NoOp(ERROR: You see this message because you routed call from DID to PBX Function External DID and did not created special entry for this DID in the file /etc/asterisk/extensions_mor_external_did.conf. Check this file for more explanation!)
exten => _X.,3,Hangup
exten => 37012345,1,Answer
exten => 37012345,2,Echo
exten => 37012345,3,Hangup
Safe file and reload dial plan:
asterisk -rx "dialplan reload"
Once you dial 37012345, you will hear the ''Echo'' test.


*'''Note''': you  can change the user who will be billed by pressing the edit button
= See also =
* [[PBX Functions Addon]]
* [http://www.voip-info.org/wiki/view/Asterisk+cmd+Echo Asterisk cmd Echo]

Latest revision as of 06:56, 10 April 2018

Description

!!WARNING - Deep Asterisk knowledge is a must before proceeding!!

External DID function allows you to implement different PBX (or other Asterisk related functions) into MOR.
When you assign some DID number pbxfunction External DID your call is forwarded to an extension file in Asterisk called:

/etc/asterisk/extensions_mor_external_did.conf

NOTE: changes to this file are permanent. E.g. update do not overwrite this file.

Prior to making configurations in that file, please keep in mind, that:

When call comes to DID, for example DID number 1234567890 it will be forwarded to the dial plan in that file with extension:

exten => 1234567890,1,...


Warning.pngDID number and PBX function Extension (in GUI) CANNOT be the same. So if your DID is 1234567890, your PBX function extension cannot be 1234567890. It can be any other number, like 99999 or same number but modified with additional characters like *1234567890. DID and extension in config file (/etc/asterisk/extensions_mor_external_did.conf) should be the same.

In this file you can basically configure any function that Asterisk supports to handle your call, like:



Usage

Go to ADDON –> PBX functions –> External DIDs:

Pbx functions menu.png

Here you will see list off PBX function External DIDs

Pbx function external did.png

Click on Icon edit.png icon to make changes for existing settings or enter Extension and Dial Plan name, select PBX Pool and PBX Function name and click on Icon add.png icon to create new one.

  • Note: you can change the User who will be billed by pressing the edit button;

duplicate Extensions can not be created in same PBX Pool.

Echo test

Create External DID with PBX function name 112 - Tell balance and assign it to a DID. Let say DID is 37012345.

ADDONS > PBX functions > External DIDs

Echotest1.png

DID 37012345 settings. Choose External DID dial plan which you created for echo and click green check park to assign DID to it.

Echotest2.png


Make changes in this file:

/etc/asterisk/extensions_mor_external_did.conf

Add in the end of file:

exten => 37012345,1,Answer
exten => 37012345,2,Echo
exten => 37012345,3,Hangup

File should like like this after adding lines:

[mor_external_did]
exten => _X.,1,NoOp(EXTERNAL DID PBX FUNCTION DIAL-PLAN)
exten => _X.,2,NoOp(ERROR: You see this message because you routed call from DID to PBX Function External DID and did not created special entry for this DID in the file /etc/asterisk/extensions_mor_external_did.conf. Check this file for more explanation!)
exten => _X.,3,Hangup

exten => 37012345,1,Answer
exten => 37012345,2,Echo
exten => 37012345,3,Hangup

Safe file and reload dial plan:

asterisk -rx "dialplan reload"

Once you dial 37012345, you will hear the Echo test.

See also