Differenze tra le versioni di "AdminGuide:Service:AMI/en"

Versione attuale delle 14:23, 27 apr 2022

Altre lingue:

English
italiano

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

@@ Riga 3: / Riga 3: @@
-The Asterisk Manager Interface lets KalliopepBX interface with third party software.
+[[File:AMI.png|miniatura]]
+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".
-Abilitando l'interfaccia AMI da GUI Kalliope è, quindi, possibile interfacciare sistemi esterni con il KalliopePBX per effettuare operazioni di click-to-call. <br>
+By enabling the AMI interface from the Kalliope GUI, you can interface with  external systems to carry out click-to-call operations.<br>
 <br>
-La sintassi standard per effettuare il c2c via AMI (dall'interno %interno% verso la destinazione %toNum%, comprensivo di prefisso di uscita se esterno) su KalliopePBXv4 è la seguente, in cui vengono impostate alcune variabili di canale: <br>
+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: <br>
 <br>
-Action: Originate<br>
+  Action: Originate
-Async: true<br>
+  Async: true
-Channel: Local/%interno%@c2c<br>
+  Channel: Local/%interno%@c2c
-Context: from_c2c<br>
+  Context: from_c2c
-Exten: %toNum%<br>
+  Exten: %toNum%
-CallerId: %callerId%<br>
+  CallerId: %callerId%
-Timeout: %timeout%<br>
+  Timeout: %timeout%
-Priority: 1<br>
+  Priority: 1
-Variable: C2C_SRC=%interno%<br>
+  Variable: C2C_SRC=%interno%
-Variable: C2C_DST=%toNum%<br>
+  Variable: C2C_DST=%toNum%
-Variable: __TENANT_UUID=%tenantUid%<br>
+  Variable: __TENANT_UUID=%tenantUid%
 <br>
-Dove: <br>
+Where: <br>
-%callerId% = in formato "%displayname%" <%numero%> ( noi impostiamo "c2c: %toNum%" <%toNum%>)<br>
+* '''%callerId%''' = in "%displayname%" <%number%> format (we set "c2c: %toNum%" <%toNum%>)<br>
-%timeout% = numero di millisecondi di squillo per accettare la chiamata sul terminale del chiamante (noi impostiamo 10000)<br>
+* '''%timeout%''' = the number of milliseconds in which to accept the call on the caller's terminal (we set 10000)<br>
-%tenantUid% = l'UUID del tenant utilizzato. In caso di PBX monotenant va indicato comunque, è riportato sul pannello dei settings AMI (nei firmware 4.2.x) o nel widget della dashboard (nei firmware 4.3.x)<br>
+* '''%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)<br>
-Nel caso del TSP  Xtelsio Tapi for asterisk (frequentemente utilizzato per l'integrazione dell'applicativo Estos ProCall con sistemi Asterisk) non è possibile (alla data odierna) impostare queste variabili nella chiamata AMI, per cui è stato sviluppato un  meccanismo che si basa su dei contesti wrapper per impostare a dialplan le variabili necessarie.<br>
+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.
-Il messaggio AMI da far inviare diventa quindi (sono comunque supportate entrambe le modalità):<br>
+The AMI message to send is therefore (both modes are supported):<br>
 <br>
-Action: Originate<br>
+  Action: Originate
-Async: true<br>
+  Async: true
-Channel: Local/%interno%@c2c_%tenantUid%<br>
+  Channel: Local/%interno%@c2c_%tenantUid%
-Context: from_c2c_%tenantUid%<br>
+  Context: from_c2c_%tenantUid%
-Exten: %toNum%<br>
+  Exten: %toNum%
-CallerId: "c2c: %toNum%" <%interno%><br>
+  CallerId: "c2c: %toNum%" <%interno%>
-Timeout: %timeout%<br>
+  Timeout: %timeout%
-Priority: 1<br>
+  Priority: 1

Differenze tra le versioni di "AdminGuide:Service:AMI/en"

Versione attuale delle 14:23, 27 apr 2022

Menu di navigazione

Ricerca