Differenze tra le versioni di "AdminGuide:Service:AMI"
(Creata pagina con "Click-to-callClick-to-call") |
|||
(5 versioni intermedie di 4 utenti non mostrate) | |||
Riga 1: | Riga 1: | ||
<languages /> | |||
<translate> | |||
<!--T:1--> | |||
Torna a [[AdminGuide:Service]] | |||
<!--T:2--> | |||
[[File:AMI.png|miniatura]] | |||
L'Asterisk Manager Interface presente su KalliopePBX consente l'interfacciamento con software di terze parti.<br> | |||
Il pannello mostrato a destra permette di definire le credenziali di autenticazione (username e password), insieme ad una ACL composta da uno o più indirizzi/subnet IP. | |||
L'utente configurato dispone dei diritti di lettura “call” e di scrittura “call,originate”. | |||
<!--T:3--> | |||
Abilitando l'interfaccia AMI da GUI Kalliope è, quindi, possibile interfacciare sistemi esterni con il KalliopePBX per effettuare operazioni di click-to-call. <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> | |||
<br> | |||
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% | |||
<br> | |||
Dove: <br> | |||
* '''%callerId%''' = in formato "%displayname%" <%numero%> ( noi impostiamo "c2c: %toNum%" <%toNum%>)<br> | |||
* '''%timeout%''' = numero di millisecondi di squillo per accettare la chiamata sul terminale del chiamante (noi impostiamo 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> | |||
<!--T:4--> | |||
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> | |||
<!--T:5--> | |||
Il messaggio AMI da far inviare diventa quindi (sono comunque supportate entrambe le modalità):<br> | |||
<br> | |||
Action: Originate | |||
Async: true | |||
Channel: Local/%interno%@c2c_%tenantUid% | |||
Context: from_c2c_%tenantUid% | |||
Exten: %toNum% | |||
CallerId: "c2c: %toNum%" <%interno%> | |||
Timeout: %timeout% | |||
Priority: 1 | |||
</translate> |
Versione attuale delle 15:01, 21 apr 2022
Torna a AdminGuide:Service
L'Asterisk Manager Interface presente su KalliopePBX consente l'interfacciamento con software di terze parti.
Il pannello mostrato a destra permette di definire le credenziali di autenticazione (username e password), insieme ad una ACL composta da uno o più indirizzi/subnet IP.
L'utente configurato dispone dei diritti di lettura “call” e di scrittura “call,originate”.
Abilitando l'interfaccia AMI da GUI Kalliope è, quindi, possibile interfacciare sistemi esterni con il KalliopePBX per effettuare operazioni di click-to-call.
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:
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%
Dove:
- %callerId% = in formato "%displayname%" <%numero%> ( noi impostiamo "c2c: %toNum%" <%toNum%>)
- %timeout% = numero di millisecondi di squillo per accettare la chiamata sul terminale del chiamante (noi impostiamo 10000)
- %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)
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.
Il messaggio AMI da far inviare diventa quindi (sono comunque supportate entrambe le modalità):
Action: Originate Async: true Channel: Local/%interno%@c2c_%tenantUid% Context: from_c2c_%tenantUid% Exten: %toNum% CallerId: "c2c: %toNum%" <%interno%> Timeout: %timeout% Priority: 1