AdminGuide:Service:AMI

Return to AdminGuide:Service

The Asterisk Manager Interface lets KalliopepBX interface with third party software. This panel lets you define the authentication credentials (username and password) along with an ACL comprised of one or more IP addresses or subnets. The configured user has read permissions for "call" and write permissions for "call,originate".

By enabling the AMI interface from the Kalliope GUI, you can interface with external systems to carry out click-to-call operations.

The standard syntax to carry out c2c via AMI (from the extension %extension% towards the destination %toNum%, including the outbound prefix for external numbers) on KalliopePBXv4 is the following, in which some channel variables are set:

 Action: Originate
 Async: true
 Channel: Local/%interno%@c2c
 Context: from_c2c
 Exten: %toNum%
 CallerId: %callerId%
 Timeout: %timeout%
 Priority: 1
 Variable: C2C_SRC=%interno%
 Variable: C2C_DST=%toNum%
 Variable: __TENANT_UUID=%tenantUid%

Where:

• %callerId% = in "%displayname%" <%number%> format (we set "c2c: %toNum%" <%toNum%>)
  
• %timeout% = the number of milliseconds in which to accept the call on the caller's terminal (we set 10000)
  
• %tenantUid% = the tenant UUID. It must be indicated even in silge tenant systems; it can be found in the the AMI settings page (with firware version 4.2.x) or the dashboard widget (with firmware version 4.3.x)
  

With TSP Xtelsio Tapi for asterisk (frequently used to integrate the Estos ProCall application with Asterisk systems), it is not currently possilbe to set these variables in the AMI call, so a mechanism has been developed based on context wrappers to set the required variables.

The AMI message to send is therefore (both modes are supported):

 Action: Originate
 Async: true
 Channel: Local/%interno%@c2c_%tenantUid%
 Context: from_c2c_%tenantUid%
 Exten: %toNum%
 CallerId: "c2c: %toNum%" <%interno%>
 Timeout: %timeout%
 Priority: 1