AdminGuide:Service:DynamicRouting - Cronologia

Troccoli il 10:39, 19 gen 2023

2023-01-19T10:39:22Z

← Versione meno recente		Versione delle 10:39, 19 gen 2023
Riga 14:		Riga 14:
	<!--T:2-->		<!--T:2-->
	La richiesta al server web o il riscontro del file possono essere effettuate passando una serie di parametri numerici da richiedere al chiamante tramite prompt vocali pre-registrati.<br>		La richiesta al server web o il riscontro del file possono essere effettuate passando una serie di parametri numerici da richiedere al chiamante tramite prompt vocali pre-registrati.<br>
	Per un approfondimento sul funzionamento del servizio Instradamento dinamico si può fare riferimento al video tutorial riportato qui a fianco (a partire dal minuto 37:27.		Per un approfondimento sul funzionamento del servizio Instradamento dinamico si può fare riferimento al video tutorial riportato qui a fianco (a partire dal minuto 37:27).

	==Configurazione del servizio== <!--T:3-->		==Configurazione del servizio== <!--T:3-->

Troccoli: Versione segnata per la traduzione

2022-02-17T11:07:41Z

Versione segnata per la traduzione

← Versione meno recente		Versione delle 11:07, 17 feb 2022
Riga 5:		Riga 5:


			<!--T:1-->
	{{#evu:https://vimeo.com/508382279#t=37m26s		{{#evu:https://vimeo.com/508382279#t=37m26s
	\|alignment=right\|dimensions=305		\|alignment=right\|dimensions=305
	}}		}}
	~~<!--T:1-->~~
	[[File:Api esterne.png\|miniatura]]		[[File:Api esterne.png\|miniatura]]
	Questo servizio permette di effettuare l’instradamento di una chiamata in ingresso in base alla risposta ad una API HTTP invocata su un WEB server esterno o al riscontro di uno o più parametri definiti in un file caricato sul PBX.<br>		Questo servizio permette di effettuare l’instradamento di una chiamata in ingresso in base alla risposta ad una API HTTP invocata su un WEB server esterno o al riscontro di uno o più parametri definiti in un file caricato sul PBX.<br>

Rossi il 20:14, 15 mar 2021

2021-03-15T20:14:40Z

← Versione meno recente		Versione delle 20:14, 15 mar 2021
Riga 13:		Riga 13:

	<!--T:2-->		<!--T:2-->
	La richiesta al server web o il riscontro del file possono essere effettuate passando una serie di parametri numerici da richiedere al chiamante tramite prompt vocali pre-registrati.		La richiesta al server web o il riscontro del file possono essere effettuate passando una serie di parametri numerici da richiedere al chiamante tramite prompt vocali pre-registrati.<br>
			Per un approfondimento sul funzionamento del servizio Instradamento dinamico si può fare riferimento al video tutorial riportato qui a fianco (a partire dal minuto 37:27.

	==Configurazione del servizio== <!--T:3-->		==Configurazione del servizio== <!--T:3-->

Rossi il 19:34, 15 mar 2021

2021-03-15T19:34:54Z

← Versione meno recente		Versione delle 19:34, 15 mar 2021
Riga 5:		Riga 5:


			{{#evu:https://vimeo.com/508382279#t=37m26s
			\|alignment=right\|dimensions=305
			}}
	<!--T:1-->		<!--T:1-->
	[[File:Api esterne.png\|miniatura]]		[[File:Api esterne.png\|miniatura]]

S.vistoli: Versione segnata per la traduzione

2019-03-29T14:11:59Z

Versione segnata per la traduzione

← Versione meno recente		Versione delle 14:11, 29 mar 2019
Riga 91:		Riga 91:
	</response>		</response>

			<!--T:32-->
	NOTA: la stringa %TENANT_UUID% deve essere sostituita con l'attuale valore del UUID specificato nel widget "Informazioni" sulla Dashboard		NOTA: la stringa %TENANT_UUID% deve essere sostituita con l'attuale valore del UUID specificato nel widget "Informazioni" sulla Dashboard

Stefano il 17:15, 27 mar 2019

2019-03-27T17:15:32Z

← Versione meno recente		Versione delle 17:15, 27 mar 2019
Riga 82:		Riga 82:
	<elem>number:200</elem>		<elem>number:200</elem>
	<elem>alpha:c234</elem>		<elem>alpha:c234</elem>
	<elem>audio:custom/misc/pluto</elem>		<elem>audio:custom/%TENANT_UUID%/sounds/misc/pluto</elem>
	<elem>number:201</elem>		<elem>number:201</elem>
	<elem>digit:123</elem>		<elem>digit:123</elem>
Riga 90:		Riga 90:
	<value>105</value>		<value>105</value>
	</response>		</response>

			NOTA: la stringa %TENANT_UUID% deve essere sostituita con l'attuale valore del UUID specificato nel widget "Informazioni" sulla Dashboard

	<!--T:14-->		<!--T:14-->

Silvia: Versione segnata per la traduzione

2018-07-03T07:12:49Z

Versione segnata per la traduzione

← Versione meno recente		Versione delle 07:12, 3 lug 2018
Riga 104:		Riga 104:
	Il contenuto dinamico da riprodurre è descritto dai tag <elem> contenuti all'interno del tag <message> della risposta. Di seguito si riporta la descrizione del formato dei tag <elem> ammessi ed il relativo contributo al contenuto dinamico:<br>		Il contenuto dinamico da riprodurre è descritto dai tag <elem> contenuti all'interno del tag <message> della risposta. Di seguito si riporta la descrizione del formato dei tag <elem> ammessi ed il relativo contributo al contenuto dinamico:<br>

			<!--T:31-->
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-

Stefano il 22:28, 2 lug 2018

2018-07-02T22:28:24Z

← Versione meno recente		Versione delle 22:28, 2 lug 2018
Riga 92:		Riga 92:

	<!--T:14-->		<!--T:14-->
	I tag <message> e <displayprefix> sono opzionali; il tag <message> specifica la componente dinamica del prompt audio eventualmente riprodotto all'interlocutore, mentre il tag <displayprefix> permette di modificare il Display Name della chiamata anteponendo a quello corrente un prefisso costituito dalla stringa specificata all'interno del tag stesso.<br>		I tag <message> e <displayprefix> (disponibile a partire dal firmware 4.3.5) sono opzionali; il tag <message> specifica la componente dinamica del prompt audio eventualmente riprodotto all'interlocutore, mentre il tag <displayprefix> permette di modificare il Display Name della chiamata anteponendo a quello corrente un prefisso costituito dalla stringa specificata all'interno del tag stesso.<br>
	Il tag <value> è invece obbligatorio ed indica la risposta dell’API in base alla quale vengono definite le azioni di instradamento da compiere.		Il tag <value> è invece obbligatorio ed indica la risposta dell’API in base alla quale vengono definite le azioni di instradamento da compiere.

Stefano il 22:24, 2 lug 2018

2018-07-02T22:24:21Z

← Versione meno recente		Versione delle 22:24, 2 lug 2018
Riga 87:		Riga 87:
	<elem>audio:custom/misc/pippo</elem>		<elem>audio:custom/misc/pippo</elem>
	</message>		</message>
			<displayprefix>testo</displayprefix>
	<value>105</value>		<value>105</value>
	</response>		</response>

	<!--T:14-->		<!--T:14-->
	Il tag <value> indica la risposta dell’API, in base alla quale vengono definite le azioni da compiere. ~~<br>~~		I tag <message> e <displayprefix> sono opzionali; il tag <message> specifica la componente dinamica del prompt audio eventualmente riprodotto all'interlocutore, mentre il tag <displayprefix> permette di modificare il Display Name della chiamata anteponendo a quello corrente un prefisso costituito dalla stringa specificata all'interno del tag stesso.<br>
			Il tag <value> è invece obbligatorio ed indica la risposta dell’API in base alla quale vengono definite le azioni di instradamento da compiere.

	<!--T:15-->		<!--T:15-->
	Le azioni ~~da compiere possono essere costruite come segue~~:		Ciascuna azione di inoltro (quella di default, quella di errore e quelle associate a specifici valori di risposta) è composta da 3 azioni seuqenziali:
	*Riproduzione di un file audio statico caricato sul sistema		* Riproduzione di un file audio statico caricato sul sistema
	*Riproduzione di un contenuto dinamico. ~~<br>~~		* Riproduzione di un contenuto dinamico.
			* Inoltro della chiamata ad una nuova destinazione (o riaggancio)

	<!--T:16-->		<!--T:16-->
	Il contenuto dinamico da riprodurre ~~puo essere costituito una serie di altri messaggi concatenati l’uno all’altro, e composti in base alla sequenza dei~~ tag <elem> ~~presenti nella risposta~~ <message>. <br>		Il contenuto dinamico da riprodurre è descritto dai tag <elem> contenuti all'interno del tag <message> della risposta. Di seguito si riporta la descrizione del formato dei tag <elem> ammessi ed il relativo contributo al contenuto dinamico:<br>
	~~I valori ammessi per il tag~~ <elem> ~~sono:~~ <br>
	* digit: ~~riproduce~~ i singoli digit, ~~uno alla volta (possono essere specificati numeri composti~~ da ~~più cifre,~~ che ~~saranno lette una alla volta)<br>~~		{\| class="wikitable"
	* number: ~~riproduce l’intero~~ numero~~<br>~~		\|-
	* alpha: ~~accetta cifre e lettere alfabetiche,~~ che ~~riproduce una alla volta<br>~~		! style="width: 30%;" \| <elem>...</elem>
	* audio: ~~specifica~~ il percorso ~~di un~~ file audio (~~contenuto nel PBX~~) da ~~riprodurre~~		! Esempio
			! Firmware
			! style="width: 40%;" \|Descrizione
			! Esempio di output
			\|-
			\| digit:{digit_sequence}
			\| digit:1234
			\| -
			\| Riproduce i singoli digit (numerici, da 0 a 9) che compongono la sequenza {digit_sequence}
			\| Riproduce il messaggio audio "Uno due tre quattro"
			\|-
			\| number:{number}
			\| number:1234
			\| -
			\| Riproduce il numero indicato in {number}
			\| Riproduce il messaggio audio "Milleduecentotrentaquattro"
			\|-
			\| alpha:{alphanumeric_sequence}
			\| alpha:1a2b3c4d
			\| -
			\| Riproduce i singoli caratteri (alfanumerici) che compongono la stringa {alphanumeric_sequence}
			\| Riproduce il messaggio audio "Uno a due b tre c quattro d"
			\|-
			\| audio:{audio_file}
			\| audio:custom/misc/test
			\| -
			\| Riproduce il file audio, presente sul KalliopePBX, identificato dal nome {audio_file} (comprensivo di percorso, come riportato all'interno del pannello "Suoni"->"File audio")
			\| Riproduce il file audio custom/misc/test
			\|-
			\| dtmf:{dtmf_sequence},{intertone_pause},{duration}
			\| dtmf:123w*,200,350
			\| 4.5.12+
			\| Riproduce i toni DTMF (in accordo alla modalità specificata per il canale da cui proviene la chiamata) specificati nella sequenza {dtmf_sequence}; ciascun tono ha durata pari a {duration} millisecondi (espresso come numero intero) e intervallati da una pausa di {intertone_pause} (anch'esso espresso in millisecondi). I caratteri ammessi sono i digit DTMF validi (0-9,*#,a-d,A-D) più "w" e "W" per indicare una pausa di 500 o 1000 millisecondi.<br>NOTA BENE: la pausa inter-digit viene inserita anche in caso di riproduzione dei silenzi (caratteri "w" e "W").
			\| Invia all'interlocutore una sequenza di toni DTMF (ciascuno di durata 350 millisecondi) così composta: "1", pausa di 200 ms, "2", pausa di 200 ms, "3", pausa di 200 + 500 + 200 ms, "*"
			\|-
			\| pause:{duration}
			\| pause:450
			\| 4.5.12+
			\| Inserisce una pausa di durata {duration} millisecondi
			\| Inserisce una pausa di 450 millisecondi
			\|}


	<!--T:17-->		<!--T:17-->

Silvia: Versione segnata per la traduzione

2018-05-21T07:37:48Z

Versione segnata per la traduzione

← Versione meno recente		Versione delle 07:37, 21 mag 2018
Riga 53:		Riga 53:
	Nel caso di richiesta di tipo POST, il corpo potrebbe essere:<br>		Nel caso di richiesta di tipo POST, il corpo potrebbe essere:<br>

	<?xml version="1.0"?>		<!--T:29-->
			<?xml version="1.0"?>
	<parameters>		<parameters>
	<caller>%CALLER_NUM%</caller>		<caller>%CALLER_NUM%</caller>
Riga 74:		Riga 75:
	Nel caso in cui la richiesta si di tipo HTTP il sistema si aspetta dal server web una risposta di tipo “200 OK”, il cui corpo deve contenere un testo XML come segue: <br>		Nel caso in cui la richiesta si di tipo HTTP il sistema si aspetta dal server web una risposta di tipo “200 OK”, il cui corpo deve contenere un testo XML come segue: <br>

	<?xml version="1.0"?>		<!--T:30-->
			<?xml version="1.0"?>
	<response>		<response>
	<message>		<message>