Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Recupero dei dati di configurazione utente

L'API Apps è progettata per recuperare i dati di configurazione dell'utente. Puoi leggere la configurazione utente attuale per tutti gli utenti o per un singolo utente, indipendentemente dal ruolo o dallo stato. In questo output sono inclusi sia i ruoli di sistema sia quelli personalizzati.

Questo endpoint è diverso da quelli utilizzati nella procedura di caricamento collettivo degli utenti e fornisce le informazioni necessarie per supportare le operazioni collettive. Per saperne di più su come eseguire le procedure di gestione collettiva degli utenti, consulta l'API di gestione collettiva degli utenti.

Funzionalità e limitazioni dell'API

Quando recuperi i dati utente, puoi includere parametri per personalizzare la risposta dell'API in base alle tue esigenze. Sono supportati i seguenti parametri:

Utenti specifici
- Opzioni ID: email, ID di sistema o ID utente personalizzato. Gli utenti possono specificare uno o più ID. Se più ID utente rimandano allo stesso utente, quest'ultimo deve essere rappresentato una sola volta nella risposta.
Impaginazione
- Gli utenti possono recuperare i risultati in set paginati per gestire set di dati di grandi dimensioni. La risposta dell'API deve indicare se sono presenti altre pagine da recuperare.
- Un parametro API consente agli utenti di richiedere una pagina specifica di risultati.
- Gli utenti possono specificare le dimensioni della pagina. Le dimensioni predefinite della pagina sono 100, mentre quelle massime sono 1000. Quando viene fornito un numero di pagina specifico, gli ID utente non possono essere inclusi nella richiesta.

La risposta dell'API include tutti i campi di configurazione e del profilo utente, ad eccezione del campo "Stato". Al posto del campo "Stato", l'API fornirà un campo deactivated_at. Questo campo conterrà:

Nessun valore per gli utenti attivi.
La data e l'ora in cui un utente è stato disattivato.

La tabella seguente elenca i campi del profilo utente che verranno inclusi nella risposta dell'API:

Tabella 1. Tabella dei campi del profilo utente

Ordina	Tipo di colonna	Numero di colonne	Nome/i della colonna	Valori validi
1	Email	1	Email	Email
2	ID agente	1	ID agente	Stringa
3	Nome	1	Nome	Stringa
4	Cognome	1	Cognome	Stringa
5	Alias	1	Alias	Stringa
6	Disattivato il	1	Disattivato il	Nessun valore, data/ora
7	Località	1	Località	Una stringa che è un nome di località, Vuoto (nessuna modifica), Null (rimuovi la località attuale).
8	Concorrenza della chat	1	Concorrenza della chat	Da 1 a X (dove X è il valore configurato), Vuoto
9	Stato della concorrenza della chat	1	Stato della concorrenza della chat	0, 1, Vuoto
10	Chiamate internazionali senza restrizioni	1	Chiamate internazionali senza restrizioni	(Vero/Falso)
11	Utente esterno	1	Utente esterno	(Sì/No)
12	URI SIP esterno	1	URI SIP esterno	Stringa
13	Nome utente UCaaS	1	Nome utente UCaaS	Stringa
14	Estensioni dell'agente	1	Estensioni dell'agente
15	Ruoli	Multiplo	Ruolo: Nome ruolo A Ruolo: Nome ruolo B Ruolo: Nome ruolo C e così via.	0, 1, Vuoto
16	Team	Multiplo	Team: Nome team A, Team: Nome team B, Team: Nome team C e così via.	0, 1, Vuoto
17	Numero di telefono	Multiplo	Numero di chiamata diretta: 1, Numero di chiamata diretta: 2, Numero di chiamata diretta: 3	Numero di telefono in formato E.164
18	Filtro	Singolo	Filtro	Stringa
19	Timeout del filtro	Singolo	Timeout del filtro	Valore numerico compreso tra 0 e 1440

Limitazioni

Per ogni richiesta è supportato un solo tipo di ID utente.
Il numero massimo di ID per richiesta API è 1000.
Gli utenti non possono fornire sia gli ID utente sia una richiesta di numero di pagina in un'unica richiesta API. L'API restituirà tutti gli utenti in base alla richiesta, fino a 1000.

Messaggi di errore dell'API

L'API fornirà i seguenti messaggi di errore per scenari specifici:

Dimensioni della pagina: "Exceeded maximum page size request (1,000 is the maximum)" (È stata superata la richiesta di dimensioni massime della pagina (il valore massimo è 1000))
Dimensioni della pagina (requisito di input numerico): "Richiesta di dimensioni della pagina non valida; deve essere un valore numerico"
Richiesta combinata di ID utente e impaginazione: "Combination of user ID and pagination request is not supported" (La combinazione di ID utente e richiesta di impaginazione non è supportata)
ID utente (superato): "È stato superato il numero massimo di ID utente (il valore massimo è 1000)"

Esempio di richiesta e risposta

Questo esempio mostra come recuperare la prima pagina di utenti con 100 utenti per pagina. Il corpo della risposta include un array di oggetti utente, ognuno dei quali contiene dati di configurazione utente dettagliati.

Richiesta:

Method: GET
Type:
URL: https://{{subdomain}}.{{domain}}/apps/api/v1/users?page=1&per_page=100

Risposta:

[
  {
    "email": "email",
    "agent_number": "number",
    "first_name": "first",
    "last_name": "last",
    "status": "Active",
    "location": "location",
    "max_chat_limt": 3,
    "max_chat_limit_enabled": true,
    "deleted_at": "2024-07-16T15:57:12.000Z",
    "ucaas_user_name": "username",
    "external_user": true,
    "ucaas_sip_uri": "sip uri",
    "unrestricted_international_calling": false,
    "roles": [
      { "name": "Admin" },
      { "name": "Manager" }
    ],
    "teams": [
      { "name": "name" }
    ],
    "phone_numbers": [
      "123-456-7890",
      "098-765-4321"
    ]
  },
  ...
]

Questo esempio mostra come recuperare i dettagli di un singolo utente passando un parametro email. Il corpo della risposta include un oggetto utente contenente dati di configurazione utente dettagliati.