Mobili Stotele (anteprima)
Mobili Stotele è un servizio PBX virtuale mobile per i sottoscrittori di Tele2 per dispositivi mobili. Questo connettore consente agli utenti di inviare facilmente tutti i dati e gli eventi relativi a chiamate, segreteria telefonica, contatti e configurazione ad altri servizi.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Tele2 |
| URL | https://mobili-stotele.tele2.lt |
| integrations@tele2.lt |
| Metadati del connettore | |
|---|---|
| Editore | Tele2 |
| Sito web | https://mobili-stotele.tele2.lt |
| Informativa sulla privacy | https://www.tele2.com/sustainability/information-for-sustainability-professionals/privacy-and-integrity/ |
| Categorie | Comunicazione; operazioni IT |
Mobili Stotele è un servizio PBX virtuale mobile per i sottoscrittori di Tele2 per dispositivi mobili. Questo connettore consente agli utenti di inviare facilmente tutti i dati e gli eventi relativi a chiamate, segreteria telefonica, contatti e configurazione ad altri servizi.
Prerequisiti
Per procedere, è necessario quanto segue:
- Numero di telefono con abbonamento a Tele2 Mobili Stotele
- Una chiave API, che può essere generata in https://mobili-stotele.tele2.lt/integration
Come ottenere le credenziali
Usare la chiave API generata in https://mobili-stotele.tele2.lt/integration come token di connessione:
Bearer OnYSrLTH3i2qiyb873au2LNdAajXjf5I
Introduzione al connettore
- Creare una nuova chiave API
- Aggiungere un elenco di controllo di accesso IP come
0.0.0.0/0l'IP può cambiare - Aggiungere tutti i metodi API necessari che verranno usati con Microsoft Power Automate
Problemi noti e limitazioni
- Non possono essere creati più di 20 webhook contemporaneamente, quindi se si verificano problemi con i trigger, controllare il numero di webhook nell'API -> WEB HOOKS nel pannello Mobili Stotele
- Gli elementi non vengono raccolti con
Get <anything>i trigger. Si noti che solo gli elementi appena creati vengono raccolti con i trigger. - Eventuali problemi di autenticazione: assicurarsi di configurare la chiave API nel formato seguente:
Bearer <api_key>
Errori e rimedi comuni
403 Limite webhook raggiunto
Non possono essere creati più di 20 webhook contemporaneamente, quindi se si verificano problemi con i trigger, controllare il numero di webhook nell'API -> WEB HOOKS nel pannello Mobili Stotele
404 Nessun elemento trovato
Nessun elemento trovato in base alla richiesta. Assicurarsi che gli elementi esistano e controllare i campi filtro se sono compilati correttamente.
422 Entità non elaborabile
Verificare se i valori del filtro vengono compilati correttamente.
Domande frequenti
Quali sono i vantaggi dell'uso di questo connettore?
A differenza di uno scenario normale, in cui si sviluppa una soluzione che raccoglie dati da un'API, questo connettore fornisce già il passaggio intermedio tra l'origine (mobili Stotele API) e la destinazione, in cui vengono inviati i dati. Ad esempio, configurando un flusso con CallConnected trigger, è possibile inviare informazioni su tutte le chiamate risposte direttamente al foglio di Excel di OneDrive.
Quali sono i requisiti per iniziare a usare questo connettore?
È necessario essere sottoscrittori del gestore telefonico tele2 e sottoscrittore del servizio Mobili Stotele.
Qual è la differenza tra callback webhook e operazioni regolari Get ?
Get le operazioni mantengono un elenco di determinati tipi di elementi, ad esempio le chiamate con Get call History e ogni volta che raccoglie solo gli elementi della cronologia delle chiamate appena creati. I callback del webhook, tuttavia, vengono attivati automaticamente dal lato del servizio Mobili Stotele quando viene ricevuto un nuovo evento. Ad esempio, quando viene lasciato un nuovo messaggio vocale, Mobili Stotele invia un evento al connettore con i dati relativi al nuovo messaggio vocale.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Chiave API | securestring | Chiave API per questa API | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Componi numero |
Richiedere l'inizio della nuova chiamata inviando una richiesta a un dispositivo. |
| Get Voicemail Box By ID |
Recuperare un singolo oggetto casella vocale specificando un ID. |
| Ottenere chiamate perse |
Recuperare tutti i record di chiamata persi dalla cronologia delle chiamate che non sono state risposte, sono stati richiamati o il chiamante non ha raggiunto il dipendente in tentativi ripetuti nello stesso giorno. |
| Ottenere i contatti in base all'ID |
Recuperare un singolo oggetto dipendente specificando un ID. |
| Ottenere il gruppo per ID |
Recuperare un singolo oggetto gruppo di dipendenti specificando un ID. |
| Ottenere l'elemento della cronologia delle chiamate in base all'ID |
Recuperare una singola voce della cronologia delle chiamate specificando un ID. |
| Ottenere l'endpoint VoIP per ID |
Recuperare un singolo oggetto endpoint VoIP specificando un ID. |
| Ottenere la registrazione delle chiamate in base all'ID |
Recuperare una singola registrazione di chiamata specificando un ID. |
| Ottenere la segreteria telefonica in base all'ID |
Recuperare un singolo oggetto segreteria telefonica specificando un ID. |
| Ottenere una richiesta audio in base all'ID |
Recuperare un singolo oggetto prompt audio specificando un ID. |
Componi numero
Richiedere l'inizio della nuova chiamata inviando una richiesta a un dispositivo.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Destinazione
|
destination | True | string |
Numero di destinazione. |
|
ID contatto
|
contactID | True | integer |
ID univoco del dipendente |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
Get Voicemail Box By ID
Recuperare un singolo oggetto casella vocale specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID casella vocale
|
box_id | True | integer |
ID univoco della casella della segreteria telefonica. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
clientID
|
data.clientID | integer |
clientID |
|
boxName
|
data.boxName | string |
boxName |
|
creato
|
data.created | string |
creato |
|
voicemailBoxID
|
data.voicemailBoxID | integer |
voicemailBoxID |
Ottenere chiamate perse
Recuperare tutti i record di chiamata persi dalla cronologia delle chiamate che non sono state risposte, sono stati richiamati o il chiamante non ha raggiunto il dipendente in tentativi ripetuti nello stesso giorno.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
|
|
Destinazione
|
destination | string |
Numero a cui è stata effettuata la chiamata. |
|
|
Data da
|
date_from | date-time |
Data di inizio nell'intervallo di date filtrato. |
|
|
Da data a
|
date_to | date-time |
Data di fine nell'intervallo di date filtrato. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
contact_name
|
data.contact_name | string |
contact_name |
|
destination
|
data.destination | string |
destination |
|
Tentativi
|
data.attempts | integer |
Tentativi |
|
callerid
|
data.callerid | string |
callerid |
|
Ultimo contatto
|
data.last_contact | date-time |
last_contact |
Ottenere i contatti in base all'ID
Recuperare un singolo oggetto dipendente specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID contatto
|
contact_id | True | integer |
ID univoco del dipendente. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
current_callerid
|
data.current_callerid | string |
current_callerid |
|
Archiviati
|
data.archived | integer |
Archiviati |
|
firstname
|
data.firstname | string |
firstname |
|
lastname
|
data.lastname | string |
lastname |
|
creato
|
data.created | string |
creato |
|
numero
|
data.number | string |
numero |
|
contactID
|
data.contactID | integer |
contactID |
|
group_membership
|
data.group_membership | array of object |
group_membership |
|
creato
|
data.group_membership.created | string |
creato |
|
groupID
|
data.group_membership.groupID | integer |
groupID |
|
type
|
data.group_membership.type | integer |
type |
|
nome
|
data.group_membership.name | string |
nome |
|
Membri
|
data.group_membership.members | array of object |
Membri |
|
contactID
|
data.group_membership.members.contactID | integer |
contactID |
|
avatar
|
data.avatar | string |
avatar |
Ottenere il gruppo per ID
Recuperare un singolo oggetto gruppo di dipendenti specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID del Gruppo
|
group_id | True | integer |
ID univoco del gruppo di dipendenti. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
Created
|
data.created | date-time |
creato |
|
groupID
|
data.groupID | integer |
groupID |
|
type
|
data.type | integer |
type |
|
nome
|
data.name | string |
nome |
|
Membri
|
data.members | array of object |
Membri |
|
contactID
|
data.members.contactID | integer |
contactID |
Ottenere l'elemento della cronologia delle chiamate in base all'ID
Recuperare una singola voce della cronologia delle chiamate specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID chiamata
|
call_id | True | integer |
ID univoco della chiamata. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
direction
|
data.direction | string |
direction |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
callConnected
|
data.callConnected | string |
callConnected |
|
callEnded
|
data.callEnded | string |
callEnded |
|
connectionTime
|
data.connectionTime | integer |
connectionTime |
|
contactID
|
data.contactID | integer |
contactID |
|
recordingID
|
data.recordingID | integer |
recordingID |
Ottenere l'endpoint VoIP per ID
Recuperare un singolo oggetto endpoint VoIP specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
VoIP endpoint ID
|
endpoint_id | True | integer |
ID univoco dell'endpoint VoIP. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
id
|
data.id | integer |
id |
|
nome
|
data.name | string |
nome |
|
employee_id
|
data.employee_id | integer |
employee_id |
Ottenere la registrazione delle chiamate in base all'ID
Recuperare una singola registrazione di chiamata specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID record
|
record_id | True | integer |
ID univoco della registrazione. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
recordingID
|
data.recordingID | integer |
recordingID |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
direction
|
data.direction | string |
direction |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
callConnected
|
data.callConnected | string |
callConnected |
|
callEnded
|
data.callEnded | string |
callEnded |
|
contactID
|
data.contactID | integer |
contactID |
|
recordingURL
|
data.recordingURL | string |
recordingURL |
Ottenere la segreteria telefonica in base all'ID
Recuperare un singolo oggetto segreteria telefonica specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID segreteria telefonica
|
voicemail_id | True | integer |
ID univoco della segreteria telefonica. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
mittente
|
data.sender | string |
mittente |
|
voicemailID
|
data.voicemailID | integer |
voicemailID |
|
length
|
data.length | integer |
length |
|
callStarted
|
data.callStarted | string |
callStarted |
|
voicemailBoxID
|
data.voicemailBoxID | integer |
voicemailBoxID |
|
voicemailBoxName
|
data.voicemailBoxName | string |
voicemailBoxName |
|
messageURL
|
data.messageURL | string |
messageURL |
Ottenere una richiesta audio in base all'ID
Recuperare un singolo oggetto prompt audio specificando un ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID richiesta audio
|
prompt_id | True | integer |
ID univoco della richiesta audio. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
id
|
data.id | integer |
id |
|
nome
|
data.name | string |
nome |
|
type
|
data.type | integer |
type |
Trigger
|
Callback del webhook Lost |
Fornisce all'evento i dati del payload della chiamata quando viene ricevuto l'evento LostCallerCreated durante un momento in cui la chiamata non viene risposta e viene registrata come persa. |
|
Callback del webhook Voicemail |
Fornisce un payload di dati sulla segreteria telefonica quando l'evento VoicemailDeleted viene ricevuto durante un momento in cui un utente ha eliminato un messaggio di segreteria telefonica. |
|
Callback webhook lost |
Fornisce l'evento con payload dei dati sulla chiamata quando l'evento evento LostCallerDeleted viene ricevuto durante un momento in cui la chiamata persa viene richiamata dal dipendente o viene risposta in un secondo momento in una chiamata ripetuta dallo stesso chiamante. |
|
Callback webhook Lost |
Fornisce un evento con i dati del payload dei dati sulla chiamata quando l'evento LostCallerUpdated viene ricevuto durante un momento in cui un altro tentativo di chiamata non riuscito viene ricevuto dallo stesso numero, quindi i tentativi di record di chiamata persi e i campi last_contact vengono aggiornati con un nuovo numero e un nuovo timestamp. |
|
Call |
Fornisce un payload di dati sulla chiamata quando viene ricevuto callCompletedEvent durante un momento in cui la chiamata è terminata. |
|
Call |
Fornisce l'evento con payload di dati sulla chiamata quando viene ricevuto l'evento CallConnectedEvent durante un momento in cui la chiamata viene risposta. |
|
Call |
Fornisce un payload di dati sulla chiamata quando viene ricevuto l'evento CallRecorded durante un momento in cui viene creata la registrazione delle chiamate. |
|
Call |
Fornisce l'evento con payload di dati sulla chiamata quando viene ricevuto l'evento CallStarted durante l'inizio della chiamata. |
|
Call |
Fornisce l'evento con payload di dati sulla chiamata quando l'evento CallTransfered viene ricevuto durante un momento in cui la chiamata viene trasferita a terze parti da un trasferimento cieco di trasferimento associato. |
| Ottenere caselle vocali |
Recuperare un elenco di caselle vocali create. |
| Ottenere contatti |
Attiva quando viene creato un nuovo dipendente |
| Ottenere endpoint VoIP |
Recuperare le voci dell'endpoint VoIP. |
| Ottenere gruppi |
Recuperare i dati dei gruppi di dipendenti. Inoltre, il consumer di API può filtrare i record restituiti in base a contact_id, per limitare il risultato solo a tali gruppi, che hanno un determinato dipendente come membro. |
| Ottenere la cronologia delle chiamate |
Recuperare le voci della cronologia delle chiamate. Inoltre, il consumer di API può filtrare i record restituiti in base a un numero specifico o a un dipendente coinvolto nella chiamata (origine, destinazione o contact_id), nonché alla direzione per escludere solo le chiamate in ingresso o in uscita o solo le chiamate effettuate all'interno di un intervallo di date specificato (date_range). |
| Ottenere le registrazioni delle chiamate |
Recuperare le registrazioni delle chiamate. Inoltre, il consumer di API può filtrare i record restituiti in base a un numero specifico o a un dipendente coinvolto nella chiamata (origine, destinazione o contact_id), nonché alla direzione per escludere solo le chiamate in ingresso o in uscita o solo le chiamate effettuate all'interno di un intervallo di date specificato (date_range). |
| Ottenere messaggi vocali |
Recuperare i messaggi della segreteria telefonica. Inoltre, il consumer di API può filtrare i record restituiti in base a contact_id, origine, box_id o date_range per limitare il risultato solo ai messaggi lasciati per un dipendente specifico, una casella vocale, da un numero specifico o all'interno di un intervallo di date richiesto. |
| Ottenere richieste audio |
Recuperare le voci della richiesta audio. |
|
Segreteria telefonica |
Fornisce un payload di dati sulla segreteria telefonica quando viene ricevuto l'evento VoicemailCreated durante un momento in cui un chiamante ha lasciato una segreteria telefonica. |
Callback del webhook LostCallerAdded
Fornisce all'evento i dati del payload della chiamata quando viene ricevuto l'evento LostCallerCreated durante un momento in cui la chiamata non viene risposta e viene registrata come persa.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
contact_name
|
data.contact_name | string |
contact_name |
|
destination
|
data.destination | string |
destination |
|
Tentativi
|
data.attempts | integer |
Tentativi |
|
callerid
|
data.callerid | string |
callerid |
|
last_contact
|
data.last_contact | string |
last_contact |
Callback del webhook VoicemailDeleted
Fornisce un payload di dati sulla segreteria telefonica quando l'evento VoicemailDeleted viene ricevuto durante un momento in cui un utente ha eliminato un messaggio di segreteria telefonica.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
mittente
|
data.sender | string |
mittente |
|
voicemailID
|
data.voicemailID | integer |
voicemailID |
Callback webhook lostCallerRemoved
Fornisce l'evento con payload dei dati sulla chiamata quando l'evento evento LostCallerDeleted viene ricevuto durante un momento in cui la chiamata persa viene richiamata dal dipendente o viene risposta in un secondo momento in una chiamata ripetuta dallo stesso chiamante.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
destination
|
data.destination | string |
destination |
|
callerid
|
data.callerid | string |
callerid |
Callback webhook LostCallerUpdated
Fornisce un evento con i dati del payload dei dati sulla chiamata quando l'evento LostCallerUpdated viene ricevuto durante un momento in cui un altro tentativo di chiamata non riuscito viene ricevuto dallo stesso numero, quindi i tentativi di record di chiamata persi e i campi last_contact vengono aggiornati con un nuovo numero e un nuovo timestamp.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
contact_name
|
data.contact_name | string |
contact_name |
|
destination
|
data.destination | string |
destination |
|
Tentativi
|
data.attempts | integer |
Tentativi |
|
callerid
|
data.callerid | string |
callerid |
|
last_contact
|
data.last_contact | string |
last_contact |
CallCompleted webhook callback
Fornisce un payload di dati sulla chiamata quando viene ricevuto callCompletedEvent durante un momento in cui la chiamata è terminata.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
direction
|
data.direction | string |
direction |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
callConnected
|
data.callConnected | string |
callConnected |
|
connectionTime
|
data.connectionTime | integer |
connectionTime |
|
contactID
|
data.contactID | integer |
contactID |
|
previous_contactID
|
data.previous_contactID | integer |
previous_contactID |
CallConnected webhook callback
Fornisce l'evento con payload di dati sulla chiamata quando viene ricevuto l'evento CallConnectedEvent durante un momento in cui la chiamata viene risposta.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
direction
|
data.direction | string |
direction |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
callConnected
|
data.callConnected | string |
callConnected |
|
contactID
|
data.contactID | integer |
contactID |
CallRecorded webhook callback
Fornisce un payload di dati sulla chiamata quando viene ricevuto l'evento CallRecorded durante un momento in cui viene creata la registrazione delle chiamate.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
recordingID
|
data.recordingID | integer |
recordingID |
|
callID
|
data.callID | integer |
callID |
|
callStarted
|
data.callStarted | string |
callStarted |
|
recordingURL
|
data.recordingURL | string |
recordingURL |
|
direction
|
data.direction | string |
direction |
|
connectionTime
|
data.connectionTime | integer |
connectionTime |
CallStarted webhook callback
Fornisce l'evento con payload di dati sulla chiamata quando viene ricevuto l'evento CallStarted durante l'inizio della chiamata.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
direction
|
data.direction | string |
direction |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
contactID
|
data.contactID | integer |
contactID |
CallTransfered webhook callback
Fornisce l'evento con payload di dati sulla chiamata quando l'evento CallTransfered viene ricevuto durante un momento in cui la chiamata viene trasferita a terze parti da un trasferimento cieco di trasferimento associato.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
callConnected
|
data.callConnected | string |
callConnected |
|
connectionTime
|
data.connectionTime | integer |
connectionTime |
|
contactID
|
data.contactID | integer |
contactID |
|
previous_contactID
|
data.previous_contactID | integer |
previous_contactID |
|
direction
|
data.direction | string |
direction |
Ottenere caselle vocali
Recuperare un elenco di caselle vocali create.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID casella vocale
|
box_id | integer |
ID univoco della casella della segreteria telefonica. |
|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
clientID
|
data.clientID | integer |
clientID |
|
boxName
|
data.boxName | string |
boxName |
|
creato
|
data.created | string |
creato |
|
voicemailBoxID
|
data.voicemailBoxID | integer |
voicemailBoxID |
Ottenere contatti
Attiva quando viene creato un nuovo dipendente
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
|
|
ID contatto
|
contact_id | integer |
ID univoco del dipendente. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
current_callerid
|
data.current_callerid | string |
current_callerid |
|
Archiviati
|
data.archived | integer |
Archiviati |
|
firstname
|
data.firstname | string |
firstname |
|
lastname
|
data.lastname | string |
lastname |
|
creato
|
data.created | string |
creato |
|
numero
|
data.number | string |
numero |
|
contactID
|
data.contactID | integer |
contactID |
|
group_membership
|
data.group_membership | array of object |
group_membership |
|
creato
|
data.group_membership.created | string |
creato |
|
groupID
|
data.group_membership.groupID | integer |
groupID |
|
type
|
data.group_membership.type | integer |
type |
|
nome
|
data.group_membership.name | string |
nome |
|
Membri
|
data.group_membership.members | array of object |
Membri |
|
contactID
|
data.group_membership.members.contactID | integer |
contactID |
|
avatar
|
data.avatar | string |
avatar |
Ottenere endpoint VoIP
Recuperare le voci dell'endpoint VoIP.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
VoIP endpoint ID
|
endpoint_id | integer |
ID univoco dell'endpoint VoIP. |
|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
id
|
data.id | integer |
id |
|
nome
|
data.name | string |
nome |
|
employee_id
|
data.employee_id | integer |
employee_id |
Ottenere gruppi
Recuperare i dati dei gruppi di dipendenti. Inoltre, il consumer di API può filtrare i record restituiti in base a contact_id, per limitare il risultato solo a tali gruppi, che hanno un determinato dipendente come membro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID del Gruppo
|
group_id | integer |
ID univoco del gruppo. |
|
|
ID contatto
|
contact_id | integer |
ID univoco del dipendente. |
|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
creato
|
data.created | string |
creato |
|
groupID
|
data.groupID | integer |
groupID |
|
type
|
data.type | integer |
type |
|
nome
|
data.name | string |
nome |
|
Membri
|
data.members | array of object |
Membri |
|
contactID
|
data.members.contactID | integer |
contactID |
Ottenere la cronologia delle chiamate
Recuperare le voci della cronologia delle chiamate. Inoltre, il consumer di API può filtrare i record restituiti in base a un numero specifico o a un dipendente coinvolto nella chiamata (origine, destinazione o contact_id), nonché alla direzione per escludere solo le chiamate in ingresso o in uscita o solo le chiamate effettuate all'interno di un intervallo di date specificato (date_range).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID chiamata
|
call_id | integer |
ID univoco della chiamata. |
|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
|
|
Numero di destinazione
|
destination | string |
Numero a cui è stata effettuata la chiamata. |
|
|
Numero di origine
|
source | string |
Numero di entità chiamante. |
|
|
Direction
|
direction | string |
"in" o "out" per indicare se la chiamata era in ingresso o in uscita. |
|
|
ID contatto
|
contact_id | integer |
ID univoco del dipendente coinvolto nella chiamata. |
|
|
Data da
|
date_from | date-time |
Data di inizio nell'intervallo di date filtrato. |
|
|
Da data a
|
date_to | date-time |
Data di fine nell'intervallo di date filtrato. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
direction
|
data.direction | string |
direction |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
callConnected
|
data.callConnected | string |
callConnected |
|
callEnded
|
data.callEnded | string |
callEnded |
|
connectionTime
|
data.connectionTime | integer |
connectionTime |
|
contactID
|
data.contactID | integer |
contactID |
|
recordingID
|
data.recordingID | integer |
recordingID |
Ottenere le registrazioni delle chiamate
Recuperare le registrazioni delle chiamate. Inoltre, il consumer di API può filtrare i record restituiti in base a un numero specifico o a un dipendente coinvolto nella chiamata (origine, destinazione o contact_id), nonché alla direzione per escludere solo le chiamate in ingresso o in uscita o solo le chiamate effettuate all'interno di un intervallo di date specificato (date_range).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID record
|
record_id | integer |
ID univoco della registrazione. |
|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
|
|
Numero di destinazione
|
destination | string |
Numero a cui è stata effettuata la chiamata. |
|
|
Numero di origine
|
source | string |
Numero di entità chiamante. |
|
|
Direction
|
direction | string |
"in" o "out" per indicare se la chiamata era in ingresso o in uscita. |
|
|
ID contatto
|
contact_id | integer |
ID univoco del dipendente coinvolto nella chiamata. |
|
|
Data da
|
date_from | date-time |
Data di inizio nell'intervallo di date filtrato. |
|
|
Da data a
|
date_to | date-time |
Data di fine nell'intervallo di date filtrato. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
recordingID
|
data.recordingID | integer |
recordingID |
|
callID
|
data.callID | integer |
callID |
|
chiamante
|
data.caller | string |
chiamante |
|
destination
|
data.destination | string |
destination |
|
direction
|
data.direction | string |
direction |
|
status
|
data.status | integer |
status |
|
callStarted
|
data.callStarted | string |
callStarted |
|
callConnected
|
data.callConnected | string |
callConnected |
|
callEnded
|
data.callEnded | string |
callEnded |
|
contactID
|
data.contactID | integer |
contactID |
|
recordingURL
|
data.recordingURL | string |
recordingURL |
Ottenere messaggi vocali
Recuperare i messaggi della segreteria telefonica. Inoltre, il consumer di API può filtrare i record restituiti in base a contact_id, origine, box_id o date_range per limitare il risultato solo ai messaggi lasciati per un dipendente specifico, una casella vocale, da un numero specifico o all'interno di un intervallo di date richiesto.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID segreteria telefonica
|
voicemail_id | integer |
ID univoco del messaggio di segreteria telefonica. |
|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
|
|
Numero di origine
|
source | string |
Numero di entità chiamante. |
|
|
ID contatto
|
contact_id | integer |
ID univoco del dipendente. |
|
|
ID casella vocale
|
box_id | integer |
ID univoco della casella della segreteria telefonica. |
|
|
Data da
|
date_from | date-time |
Data di inizio nell'intervallo di date filtrato. |
|
|
Da data a
|
date_to | date-time |
Data di fine nell'intervallo di date filtrato. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
mittente
|
data.sender | string |
mittente |
|
voicemailID
|
data.voicemailID | integer |
voicemailID |
|
length
|
data.length | integer |
length |
|
callStarted
|
data.callStarted | string |
callStarted |
|
voicemailBoxID
|
data.voicemailBoxID | integer |
voicemailBoxID |
|
voicemailBoxName
|
data.voicemailBoxName | string |
voicemailBoxName |
|
messageURL
|
data.messageURL | string |
messageURL |
Ottenere richieste audio
Recuperare le voci della richiesta audio.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID richiesta audio
|
prompt_id | integer |
ID univoco della richiesta audio. |
|
|
Limite
|
limit | integer |
Limitare il numero di risultati da recuperare. |
|
|
Offset
|
offset | integer |
Consente di specificare da quale risultato si desidera recuperare i dati. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
version
|
version | string |
version |
|
status
|
status | string |
status |
|
Codice di stato
|
statusCode | integer |
Codice di stato |
|
message
|
message | string |
message |
|
data
|
data | array of object |
data |
|
id
|
data.id | integer |
id |
|
nome
|
data.name | string |
nome |
|
type
|
data.type | integer |
type |
Segreteria telefonicaCreato callback webhook
Fornisce un payload di dati sulla segreteria telefonica quando viene ricevuto l'evento VoicemailCreated durante un momento in cui un chiamante ha lasciato una segreteria telefonica.
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
type
|
type | string |
type |
|
version
|
version | string |
version |
|
eventType
|
eventType | string |
eventType |
|
mittente
|
data.sender | string |
mittente |
|
voicemailID
|
data.voicemailID | integer |
voicemailID |
|
length
|
data.length | integer |
length |
|
callStarted
|
data.callStarted | string |
callStarted |
|
voicemailBoxID
|
data.voicemailBoxID | integer |
voicemailBoxID |
|
voicemailBoxName
|
data.voicemailBoxName | string |
voicemailBoxName |
|
messageURL
|
data.messageURL | string |
messageURL |