Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleSubscription URI

For SIP endpoints that are attached to a DPMA-configured Digium phone, the subscribe_to parameter should point to a special hint automatically created by DPMA. This hint is in the format "auto_hint_<peer>," e.g.:

Code Block
xml
xml
subscribe_to="auto_hint_1234"

In this case, it is not necessary to create a dialplan hint, as it is automatically created by DPMA.

For non-DPMA-configured endpoints, no "auto_hint" is created, and subscriptions should be a normal SIP URI that is provided by the target system, e.g..:

Code Block
xml
xml
subscribe_to="sip:500@my.pbx.com"
Tip

If your phone is registered using a transport other than the default, UDP, then the subscribe_to URI should look like:

Code Block
subscribe_to="sip:500@my.pbx.com:5060;transport=tcp

or

Code Block
subscribe_to="sip:500@my.pbx.com:5061;transport=tls

 

or, simply to an extension, where the phone will automatically subscribe to the registered server, e.g.:

Code Block
xml
xml
subscribe_to="500"

Also, when DPMA is not used, it is necessary to create a dialplan hint, e.g.:

No Format
exten => 1234,hint,PJSIP/mypeer
exten => 1234,1,NoOp()
exten => 1234,n,Dial(PJSIP/mypeer,20)

Users of DPMA with older versions of Asterisk, or chan_sip instead of chan_pjsip, should note that the callcounter sip.conf parameter is necessary.

...

Option

Values

Description

id

string

mandatory, unique identifier for the action, used by blf_item definitions. One id with the reserved name "primary" should be used for each contact, to designate the primary action, that occurs when no other action is matched.

Magic action ids "intercom," "monitor," "sendtovm" and "dialvmdial_vm" will result in special icons displayed for the action.

dial

string

optional, number, e.g. 1234, or URI like sip:host or sip:user@host, to be passed to the phone application and dialed for this action

dial_prefix

string

optional, number to be prepended before dial, where be passed to the phone application and dialed for this action

app_id

string

optional, identifier for an application to which events or functions are sent. The identifier should be either one of the phone default applications (contacts, voicemail, parking, status, queues) or should be the identifier of a user-loaded custom application.

label

string

mandatory, pertinent information about the number for the Contacts application, e.g. SIP Extension, Cell; appears to the left of the number or application within the contact's information screen

name

string

mandatory, a name for this action, used as its language key within applications, e.g. custom applications; appears to the right, in square brackets, of the number or application within the contact's information screen

...