LiveChat
LiveChat è un software di servizio clienti online con supporto live, software help desk e funzionalità di analisi Web.
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 | Microsoft |
| URL | https://www.livechat.com/ |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://www.livechat.com/ |
| Informativa sulla privacy | https://www.livechat.com/legal/privacy-policy/ |
| Categorie | Comunicazione |
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 |
|---|---|---|---|
| ID entità legacy (deprecato) | corda | ID entità (indirizzo di posta elettronica) usato solo dalle operazioni deprecate dell'API LiveChat v2. | |
| ID dell'account | corda | ID account (GUID) visualizzato nella pagina Token di accesso personale di LiveChat. Le nuove operazioni del connettore (V2) usano questo valore con l'API LiveChat v3.6. | Vero |
| Token di accesso personale | securestring | Token di accesso personale completo e non codificato per questo account. | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Creare un nuovo agente (deprecato) [DEPRECATO] |
Questa operazione deprecata crea un agente usando l'API LiveChat v2. Usare invece Create a new agent (V2) (Crea un nuovo agente (V2). |
| Creare un nuovo agente (V2) |
Crea un agente usando l'API LiveChat v3.6. L'agente può richiedere l'approvazione a seconda degli ambiti del token di accesso personale e della sottoscrizione LiveChat. |
| Creare un nuovo ticket (deprecato) [DEPRECATO] |
Questa operazione deprecata usa l'API LiveChat Tickets ritirata. |
| Elencare gli agenti (deprecati) [DEPRECATO] |
Questa operazione deprecata restituisce agenti che usano l'API LiveChat v2. Usare invece List agents (V2). |
| Elencare gli agenti (V2) |
Restituisce tutti gli agenti nella licenza LiveChat usando l'API LiveChat v3.6. Il token di accesso personale richiede l'ambito agents--all:ro. |
| Elencare i ticket (deprecati) [DEPRECATO] |
Questa operazione deprecata usa l'API LiveChat Tickets ritirata. |
| Get ticket (deprecato) [DEPRECATO] |
Questa operazione deprecata usa l'API LiveChat Tickets ritirata. |
| Rimuovere un agente (deprecato) [DEPRECATO] |
Questa operazione deprecata rimuove un agente usando l'API LiveChat v2. Usare invece Rimuovi un agente (V2). |
| Rimuovere un agente (V2) |
Rimuove un agente usando l'API LiveChat v3.6. La rimozione di un altro agente richiede gli ambiti agents--all:rw e accounts--all:rw. |
| Ticket di aggiornamento (deprecato) [DEPRECATO] |
Questa operazione deprecata usa l'API LiveChat Tickets ritirata. |
Creare un nuovo agente (deprecato) [DEPRECATO]
Questa operazione deprecata crea un agente usando l'API LiveChat v2. Usare invece Create a new agent (V2) (Crea un nuovo agente (V2).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Email
|
login | True | string | |
|
Nome
|
name | True | string | |
|
Stato di accesso
|
login_status | string | ||
|
Titolo
|
job_title | string |
L'impostazione predefinita è: Support Agent.Defaults to: Support Agent. |
|
|
Autorizzazione
|
permission | string | ||
|
Parola chiave
|
password | string |
Lunghezza minima 5. |
|
|
Numero massimo di chat
|
max_chats_count | string |
Limite delle chat simultanee. |
Valori restituiti
- Corpo
- CreateAgent_Response
Creare un nuovo agente (V2)
Crea un agente usando l'API LiveChat v3.6. L'agente può richiedere l'approvazione a seconda degli ambiti del token di accesso personale e della sottoscrizione LiveChat.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID agente
|
id | True | string |
ID agente, in genere l'indirizzo di posta elettronica dell'agente. |
|
Nome
|
name | True | string |
Nome dell'agente. |
|
Ruolo
|
role | string |
La creazione di un ruolo superiore al normale richiede l'ambito accounts.roles.lc--all:rw. |
|
|
Stato di accesso
|
login_status | string | ||
|
Titolo di lavoro
|
job_title | string | ||
|
Mobile
|
mobile | string | ||
|
Numero massimo di chat
|
max_chats_count | integer | ||
|
In attesa di approvazione
|
awaiting_approval | boolean |
L'impostazione di questa proprietà su false richiede l'ambito private subscription.lc:rw. |
|
|
ID del Gruppo
|
id | True | integer | |
|
Priorità
|
priority | True | string | |
|
Notifications
|
notifications | array of string | ||
|
Sottoscrizioni tramite posta elettronica
|
email_subscriptions | array of string | ||
|
Fuso orario
|
timezone | string |
Fuso orario utilizzato dalla pianificazione del lavoro. |
|
|
Day
|
day | True | string | |
|
Enabled
|
enabled | True | boolean | |
|
Start
|
start | True | string | |
|
Fine
|
end | True | string |
Creare un nuovo ticket (deprecato) [DEPRECATO]
Questa operazione deprecata usa l'API LiveChat Tickets ritirata.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
Messaggio di posta elettronica del richiedente
|
True | string | ||
|
Nome del richiedente
|
name | string | ||
|
Oggetto
|
subject | string | ||
|
Id assegnatario
|
id | string | ||
|
Tipo di origine
|
type | string |
Selezionare un'origine |
|
|
URL di origine
|
url | string |
Se il tipo di origine è finestra di chat. |
Valori restituiti
- Corpo
- TicketResponse
Elencare gli agenti (deprecati) [DEPRECATO]
Questa operazione deprecata restituisce agenti che usano l'API LiveChat v2. Usare invece List agents (V2).
Valori restituiti
Elenco di tutti gli agenti con i relativi dettagli.
- Elementi
- ListAgents_Response
Elencare gli agenti (V2)
Restituisce tutti gli agenti nella licenza LiveChat usando l'API LiveChat v3.6. Il token di accesso personale richiede l'ambito agents--all:ro.
Valori restituiti
Gli agenti nella licenza LiveChat.
- Elementi
- ListAgentsV2_Response
Elencare i ticket (deprecati) [DEPRECATO]
Questa operazione deprecata usa l'API LiveChat Tickets ritirata.
Valori restituiti
- Elementi
- ListTicketsResponse
Get ticket (deprecato) [DEPRECATO]
Questa operazione deprecata usa l'API LiveChat Tickets ritirata.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | string |
ID del ticket |
Valori restituiti
- Corpo
- TicketResponse
Rimuovere un agente (deprecato) [DEPRECATO]
Questa operazione deprecata rimuove un agente usando l'API LiveChat v2. Usare invece Rimuovi un agente (V2).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Email
|
login | True | string |
Indirizzo di posta elettronica dell'agente. |
Valori restituiti
- Corpo
- DeleteAgent_Response
Rimuovere un agente (V2)
Rimuove un agente usando l'API LiveChat v3.6. La rimozione di un altro agente richiede gli ambiti agents--all:rw e accounts--all:rw.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID agente
|
id | True | string |
ID dell'agente da rimuovere. |
Ticket di aggiornamento (deprecato) [DEPRECATO]
Questa operazione deprecata usa l'API LiveChat Tickets ritirata.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Ticket Id
|
ticketId | True | string |
ID del ticket |
|
Message
|
message | string | ||
|
Messaggio di posta elettronica del richiedente
|
True | string | ||
|
Nome del richiedente
|
name | string | ||
|
Oggetto
|
subject | string | ||
|
Id assegnatario
|
id | string |
Selezionare un assegnatario. |
|
|
Tipo di origine
|
type | string |
Selezionare un'origine. |
|
|
URL di origine
|
url | string |
Se il tipo di origine è finestra di chat. |
Valori restituiti
- Corpo
- TicketResponse
Trigger
| All'avvio di una chat (deprecato) [DEPRECATO] |
Questa operazione deprecata usa l'API LiveChat v2. |
| Quando una chat termina (deprecata) [DEPRECATO] |
Questa operazione deprecata usa l'API LiveChat v2. |
| Quando viene creato un ticket (deprecato) [DEPRECATO] |
Questa operazione deprecata usa l'API LiveChat Tickets ritirata. |
All'avvio di una chat (deprecato) [DEPRECATO]
Quando una chat termina (deprecata) [DEPRECATO]
Quando viene creato un ticket (deprecato) [DEPRECATO]
Questa operazione deprecata usa l'API LiveChat Tickets ritirata.
Valori restituiti
- Corpo
- WebhookTicketResponse
Definizioni
WebhookChatResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
Posta elettronica agente
|
chat.agents.login | string |
Indirizzo di posta elettronica dell'agente. |
|
Nome agente
|
chat.agents.name | string |
Nome dell'agente. |
|
Timestamp terminato
|
chat.ended_timestamp | string |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
events
|
chat.events | array of object |
Matrice di eventi. |
|
Testo evento
|
chat.events.text | string |
Messaggio associato all'evento. |
|
Date-Time eventi
|
chat.events.timestamp | string |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
Tipo di evento
|
chat.events.type | string |
Tipo di evento. |
|
Tipo di utente evento
|
chat.events.user_type | string |
Tipo di utente. |
|
groups
|
chat.groups | array of integer | |
|
ID gruppo
|
chat.id | string |
Identificatore univoco del gruppo. |
|
Message
|
chat.messages | array of object |
Matrice di messaggi. |
|
ID agente
|
chat.messages.agent_id | string |
ID univoco dell'agente associato al messaggio. |
|
Nome autore
|
chat.messages.author_name | string |
Nome dell'autore del messaggio. |
|
Testo
|
chat.messages.text | string |
Corpo del messaggio. |
|
Date-Time inviati
|
chat.messages.timestamp | string |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
Tipo di utente
|
chat.messages.user_type | string |
Tipo di utente che invia il messaggio. |
|
Avviato Date-Time
|
chat.started_timestamp | string |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
URL
|
chat.url | string |
URL del sito Web in cui è stata avviata la chat. |
|
ID evento
|
event_unique_id | string |
ID univoco dell'evento associato alla chat. |
|
Sondaggio pre-chat
|
pre_chat_survey | array of object |
Matrice di risposte al sondaggio pre-chat. |
|
Risposta
|
pre_chat_survey.answer | string |
Risposta al sondaggio. |
|
ID sondaggio
|
pre_chat_survey.id | string |
ID sondaggio di pre-chat. |
|
Domanda
|
pre_chat_survey.label | string |
Domanda del sondaggio. |
|
Email
|
visitor.email | string |
Indirizzo di posta elettronica del visitatore. |
|
id
|
visitor.id | string |
ID univoco del visitatore. |
|
Language
|
visitor.language | string |
Lingua associata all'account del visitatore. |
|
Nome
|
visitor.name | string |
Nome del visitatore. |
|
Pagina
|
visitor.page_current | string |
Pagina Web da cui ha avuto origine la chat. |
WebhookTicketResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
ticket.assignee.id | string |
Identificatore univoco dell'utente. |
|
Nome
|
ticket.assignee.name | string |
Nome dell'assegnatario. |
|
events
|
ticket.events | array of object | |
|
id
|
ticket.events.author.id | string |
ID univoco dell'utente. |
|
Nome
|
ticket.events.author.name | string |
Nome dell'autore. |
|
TIPO
|
ticket.events.author.type | string |
Agente o client. |
|
Date-Time eventi
|
ticket.events.date | date-time |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
È privato
|
ticket.events.is_private | boolean |
True se l'evento è privato. |
|
Message
|
ticket.events.message | string |
Descrizione dell'evento. |
|
TIPO
|
ticket.events.source.type | string |
Finestra chat, posta o lc2. |
|
URL
|
ticket.events.source.url | string |
URL del sito Web da cui è stato inviato il ticket. |
|
Tipo di evento
|
ticket.events.type | string |
Tipo di evento che ha generato il ticket. |
|
Gruppo
|
ticket.groups | array of object |
Dettagli del gruppo associato. |
|
id
|
ticket.groups.id | integer |
ID univoco del gruppo. |
|
Nome
|
ticket.groups.name | string |
Nome del gruppo. |
|
Ticket Id
|
ticket.id | string |
ID univoco del ticket. |
|
IP
|
ticket.requester.ip | string |
Indirizzo IP del richiedente. |
|
Email
|
ticket.requester.mail | string |
Indirizzo di posta elettronica del richiedente. |
|
Nome
|
ticket.requester.name | string |
Nome del richiedente. |
|
id
|
ticket.source.id | string |
ID univoco dell'origine. |
|
TIPO
|
ticket.source.type | string |
Lc2, mail, facebook, agent-app-manual o chat-window. |
|
URL
|
ticket.source.url | string |
URL del sito Web in cui è stato creato il ticket. |
|
stato
|
ticket.status | string |
Aprire, in sospeso, risolvere o posta indesiderata. |
|
Oggetto
|
ticket.subject | string |
Breve descrizione del ticket. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Creazione di Date-Time
|
date | date-time |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
Ticket Id
|
id | string |
Identificatore univoco del ticket. |
|
Date-Time modificato
|
modified | date-time |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
IP
|
requester.ip | string |
Indirizzo IP del richiedente. |
|
Email
|
requester.mail | string |
Indirizzo di posta elettronica del richiedente. |
|
Nome
|
requester.name | string |
Nome completo del richiedente. |
|
id
|
source.id | string |
Identificatore univoco dell'origine. |
|
TIPO
|
source.type | string |
Da chat, posta o lc2. |
|
URL
|
source.url | string |
Pagina Web in cui è stato creato il ticket. |
|
stato
|
status | string |
Aprire, in sospeso, risolvere o posta indesiderata. |
|
Oggetto
|
subject | string |
Descrizione dell'origine del ticket. |
TicketResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
currentGroup.id | integer |
ID univoco del gruppo. |
|
Nome
|
currentGroup.name | string |
Nome del gruppo. |
|
Creazione di Date-Time
|
date | date-time |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
events
|
events | array of object | |
|
id
|
events.author.id | string |
ID univoco dell'utente. |
|
Nome
|
events.author.name | string |
Nome dell'autore. |
|
TIPO
|
events.author.type | string |
Agente o client. |
|
Date-Time eventi
|
events.date | date-time |
aaaa-MM-ggTHH:mm:ss.fffZ |
|
È privato
|
events.is_private | boolean |
True se l'evento è privato. |
|
Message
|
events.message | string |
Descrizione dell'evento. |
|
TIPO
|
events.source.type | string |
Finestra chat, posta o lc2. |
|
URL
|
events.source.url | string |
URL del sito Web da cui è stato inviato il ticket. |
|
Tipo di evento
|
events.type | string |
Tipo di evento che ha generato il ticket. |
|
Gruppo
|
groups | array of object |
Dettagli del gruppo associato. |
|
id
|
groups.id | integer |
ID univoco del gruppo. |
|
Nome
|
groups.name | string |
Nome del gruppo. |
|
Ticket Id
|
id | string |
ID univoco del ticket. |
|
IP
|
requester.ip | string |
Indirizzo IP del richiedente. |
|
Email
|
requester.mail | string |
Indirizzo di posta elettronica del richiedente. |
|
Nome
|
requester.name | string |
Nome del richiedente. |
|
id
|
source.id | string |
ID univoco dell'origine. |
|
TIPO
|
source.type | string |
Lc2, mail, facebook, agent-app-manual o chat-window. |
|
URL
|
source.url | string |
URL del sito Web in cui è stato creato il ticket. |
|
stato
|
status | string |
Aprire, in sospeso, risolvere o posta indesiderata. |
|
Oggetto
|
subject | string |
Breve descrizione del ticket. |
|
tags
|
tags | array of string |
ListAgentsV2_Response
Gli agenti nella licenza LiveChat.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Elementi
|
AgentV2 |
AgentV2
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID agente
|
id | string |
ID agente, in genere l'indirizzo di posta elettronica dell'agente. |
|
Nome
|
name | string |
Nome dell'agente. |
|
Avatar
|
avatar | string |
URL avatar dell'agente. |
|
Ruolo
|
role | string |
Ruolo agente. |
|
Stato di accesso
|
login_status | string |
Stato di accesso dell'agente. |
|
Titolo di lavoro
|
job_title | string |
Titolo del lavoro dell'agente. |
|
Mobile
|
mobile | string |
Numero di cellulare dell'agente. |
|
Numero massimo di chat
|
max_chats_count | integer |
Numero massimo di chat simultanee. |
|
Sospeso
|
suspended | boolean |
Indica se l'agente è sospeso. |
|
In attesa di approvazione
|
awaiting_approval | boolean |
Indica se l'agente è in attesa dell'approvazione. |
|
groups
|
groups | array of AgentGroupV2 |
Gruppi assegnati all'agente. |
AgentGroupV2
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID del Gruppo
|
id | integer | |
|
Priorità
|
priority | string |
ListAgents_Response
Elenco di tutti gli agenti con i relativi dettagli.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Avatar
|
avatar | string |
Percorso dell'immagine su Amazon s3. |
|
Indirizzo di posta elettronica di accesso
|
login | string |
Indirizzo di posta elettronica dell'agente. |
|
Nome
|
name | string |
Nome dell'agente. |
|
Autorizzazione
|
permission | string |
Proprietario, amministratore o normale. |
CreateAgent_Response
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Avatar
|
avatar | string |
Percorso dell'immagine su Amazon s3. |
|
Matrice di gruppi
|
groups | array of object |
Elenco di tutti i gruppi di cui fa parte l'agente. |
|
ID gruppo
|
groups.id | integer |
ID univoco del gruppo. |
|
Nome del gruppo
|
groups.name | string |
Nome del gruppo. |
|
Posizione
|
job_title | string |
Supporto dell'agente per impostazione predefinita. |
|
Email
|
login | string |
Indirizzo di posta elettronica dell'agente. |
|
Stato accesso
|
login_status | string |
Accettare chat o non accettare chat. |
|
Numero massimo di chat
|
max_chats_count | integer |
Limite delle chat simultanee. |
|
Nome
|
name | string |
Nome dell'agente. |
|
Autorizzazione
|
permission | string |
Proprietario, amministratore o normale |
|
stato
|
status | string |
Accettare chat, non accettare chat o offline. |