LiveChat
LiveChat je online software zákaznických služeb s živou podporou, softwarem helpdesku a možnostmi analýzy webu.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logické aplikace | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Automatizace napájení | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Microsoft |
| URL | https://www.livechat.com/ |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
| Internetová stránka | https://www.livechat.com/ |
| Zásady ochrany osobních údajů | https://www.livechat.com/legal/privacy-policy/ |
| Kategorie | Komunikace |
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| ZASTARALÉ ID entity (zastaralé) | řetězec | ID entity (e-mailová adresa) používané pouze zastaralými operacemi rozhraní LiveChat API v2. | |
| ID účtu | řetězec | ID účtu (GUID) zobrazené na stránce Osobní přístupové tokeny LiveChat. Nové operace konektoru (V2) používají tuto hodnotu s rozhraním LiveChat API v3.6. | Pravdivé |
| Osobní přístupový token | securestring | Úplný nekódovaný osobní přístupový token pro tento účet. | Pravdivé |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Aktualizace lístku (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API. |
| Odebrání agenta (V2) |
Odebere agenta pomocí rozhraní LIVEChat API verze 3.6. Odebrání jiného agenta vyžaduje obory agents--all:rw a accounts-all:rw. |
| Odebrání agenta (zastaralého) [ZASTARALÉHO] |
Tato zastaralá operace odebere agenta pomocí rozhraní LIVEChat API v2. Místo toho použijte odebrat agenta (V2). |
| Seznam agentů (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace vrací agenty pomocí rozhraní LIVEChat API v2. Místo toho použijte agenty seznamu (V2). |
| Vytvoření nového agenta (V2) |
Vytvoří agenta pomocí rozhraní LIVEChat API v3.6. Agent může vyžadovat schválení v závislosti na rozsahech tokenů osobního přístupu a předplatném LiveChat. |
| Vytvoření nového agenta (zastaralého) [ZASTARALÉ] |
Tato zastaralá operace vytvoří agenta pomocí rozhraní LIVEChat API v2. Místo toho použijte vytvořit nového agenta (V2). |
| Vytvoření nového lístku (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API. |
| Výpis agentů (V2) |
Vrátí všechny agenty v licenci LiveChat pomocí rozhraní LIVEChat API v3.6. Osobní přístupový token vyžaduje agenty --all:ro rozsah. |
| Výpis lístků (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API. |
| Získání lístku (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API. |
Aktualizace lístku (zastaralé) [ZASTARALÉ]
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID lístku
|
ticketId | True | string |
ID lístku |
|
Message
|
message | string | ||
|
E-mail žadatele
|
True | string | ||
|
Jméno žadatele
|
name | string | ||
|
Předmět
|
subject | string | ||
|
ID přiřazené uživatele
|
id | string |
Vyberte přiřazeného uživatele. |
|
|
Typ zdroje
|
type | string |
Vyberte zdroj. |
|
|
Zdrojová adresa URL
|
url | string |
Pokud je typ zdroje chat-okno. |
Návraty
- Body
- TicketResponse
Odebrání agenta (V2)
Odebere agenta pomocí rozhraní LIVEChat API verze 3.6. Odebrání jiného agenta vyžaduje obory agents--all:rw a accounts-all:rw.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID agenta
|
id | True | string |
ID agenta, který chcete odebrat. |
Odebrání agenta (zastaralého) [ZASTARALÉHO]
Tato zastaralá operace odebere agenta pomocí rozhraní LIVEChat API v2. Místo toho použijte odebrat agenta (V2).
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Email
|
login | True | string |
E-mail agenta. |
Návraty
- Body
- DeleteAgent_Response
Seznam agentů (zastaralé) [ZASTARALÉ]
Tato zastaralá operace vrací agenty pomocí rozhraní LIVEChat API v2. Místo toho použijte agenty seznamu (V2).
Návraty
Seznam všech agentů s podrobnostmi
- Položky
- ListAgents_Response
Vytvoření nového agenta (V2)
Vytvoří agenta pomocí rozhraní LIVEChat API v3.6. Agent může vyžadovat schválení v závislosti na rozsahech tokenů osobního přístupu a předplatném LiveChat.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID agenta
|
id | True | string |
ID agenta, obvykle e-mailová adresa agenta. |
|
Název
|
name | True | string |
Název agenta. |
|
Role
|
role | string |
Vytvoření role vyšší než normální vyžaduje obor accounts.roles.lc--all:rw. |
|
|
Stav přihlášení
|
login_status | string | ||
|
Pracovní pozice
|
job_title | string | ||
|
Mobile
|
mobile | string | ||
|
Maximální počet chatů
|
max_chats_count | integer | ||
|
Čekání na schválení
|
awaiting_approval | boolean |
Nastavení na hodnotu false vyžaduje privátní rozsah subscription.lc:rw. |
|
|
ID skupiny
|
id | True | integer | |
|
Priorita
|
priority | True | string | |
|
Notifications
|
notifications | array of string | ||
|
Odběry e-mailů
|
email_subscriptions | array of string | ||
|
Časové pásmo
|
timezone | string |
Časové pásmo používané pracovním plánem. |
|
|
Den
|
day | True | string | |
|
Povoleno
|
enabled | True | boolean | |
|
Start
|
start | True | string | |
|
konec
|
end | True | string |
Vytvoření nového agenta (zastaralého) [ZASTARALÉ]
Tato zastaralá operace vytvoří agenta pomocí rozhraní LIVEChat API v2. Místo toho použijte vytvořit nového agenta (V2).
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Email
|
login | True | string | |
|
Název
|
name | True | string | |
|
Stav přihlášení
|
login_status | string | ||
|
Title
|
job_title | string |
Výchozí hodnota: Agent podpory. |
|
|
Povolení
|
permission | string | ||
|
Heslo
|
password | string |
Minimální délka 5. |
|
|
Maximální počet chatů
|
max_chats_count | string |
Omezení souběžných chatů |
Návraty
- Body
- CreateAgent_Response
Vytvoření nového lístku (zastaralé) [ZASTARALÉ]
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
E-mail žadatele
|
True | string | ||
|
Jméno žadatele
|
name | string | ||
|
Předmět
|
subject | string | ||
|
ID přiřazené uživatele
|
id | string | ||
|
Typ zdroje
|
type | string |
Výběr zdroje |
|
|
Zdrojová adresa URL
|
url | string |
Pokud je typ zdroje chat-okno. |
Návraty
- Body
- TicketResponse
Výpis agentů (V2)
Vrátí všechny agenty v licenci LiveChat pomocí rozhraní LIVEChat API v3.6. Osobní přístupový token vyžaduje agenty --all:ro rozsah.
Návraty
Agenti v licenci LiveChat.
- Položky
- ListAgentsV2_Response
Výpis lístků (zastaralé) [ZASTARALÉ]
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API.
Návraty
- Položky
- ListTicketsResponse
Získání lístku (zastaralé) [ZASTARALÉ]
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID lístku
|
ticketId | True | string |
ID lístku |
Návraty
- Body
- TicketResponse
Aktivační události
| Po ukončení chatu (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace používá rozhraní LIVEChat API v2. |
| Při spuštění chatu (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace používá rozhraní LIVEChat API v2. |
| Při vytvoření lístku (zastaralé) [ZASTARALÉ] |
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API. |
Po ukončení chatu (zastaralé) [ZASTARALÉ]
Při spuštění chatu (zastaralé) [ZASTARALÉ]
Při vytvoření lístku (zastaralé) [ZASTARALÉ]
Tato zastaralá operace používá vyřazené rozhraní LIVEChat Tickets API.
Návraty
Definice
WebhookChatResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
agenti
|
chat.agents | array of object |
agenti |
|
E-mail agenta
|
chat.agents.login | string |
E-mailová adresa agenta |
|
Název agenta
|
chat.agents.name | string |
Název agenta. |
|
Časové razítko skončilo
|
chat.ended_timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
events
|
chat.events | array of object |
Pole událostí. |
|
Text události
|
chat.events.text | string |
Zpráva přidružená k události |
|
Date-Time událostí
|
chat.events.timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Typ události
|
chat.events.type | string |
Typ události. |
|
Typ uživatele události
|
chat.events.user_type | string |
Typ uživatele |
|
groups
|
chat.groups | array of integer | |
|
ID skupiny
|
chat.id | string |
Jedinečný identifikátor skupiny. |
|
Message
|
chat.messages | array of object |
Pole zpráv |
|
ID agenta
|
chat.messages.agent_id | string |
Jedinečné ID agenta přidruženého ke zprávě |
|
Jméno autora
|
chat.messages.author_name | string |
Jméno autora zprávy. |
|
Text
|
chat.messages.text | string |
Text zprávy. |
|
Odeslaná Date-Time
|
chat.messages.timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Typ uživatele
|
chat.messages.user_type | string |
Typ uživatele, který zprávu odesílá |
|
Spuštěno Date-Time
|
chat.started_timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
URL
|
chat.url | string |
Adresa URL webu, kde chat začal. |
|
ID události
|
event_unique_id | string |
Jedinečné ID události přidružené k chatu |
|
Průzkum před chatem
|
pre_chat_survey | array of object |
Pole odpovědí na průzkum před chatem |
|
Odpověď
|
pre_chat_survey.answer | string |
Odpověď na průzkum |
|
ID průzkumu
|
pre_chat_survey.id | string |
ID průzkumů před chatem |
|
Question
|
pre_chat_survey.label | string |
Otázka průzkumu |
|
Email
|
visitor.email | string |
E-mailová adresa návštěvníka. |
|
identifikační číslo
|
visitor.id | string |
Jedinečné ID návštěvníka. |
|
Jazyk
|
visitor.language | string |
Jazyk spojený s účtem návštěvníka. |
|
Název
|
visitor.name | string |
Jméno návštěvníka. |
|
Stránka
|
visitor.page_current | string |
Webová stránka, ze které chat pochází. |
WebhookTicketResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
identifikační číslo
|
ticket.assignee.id | string |
Jedinečný identifikátor uživatele. |
|
Název
|
ticket.assignee.name | string |
Název přiřazeného uživatele. |
|
events
|
ticket.events | array of object | |
|
identifikační číslo
|
ticket.events.author.id | string |
Jedinečné ID uživatele |
|
Název
|
ticket.events.author.name | string |
Jméno autora. |
|
Typ
|
ticket.events.author.type | string |
Agent nebo klient. |
|
Date-Time událostí
|
ticket.events.date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Je soukromé
|
ticket.events.is_private | boolean |
Hodnota True, pokud je událost soukromá. |
|
Message
|
ticket.events.message | string |
Popis události |
|
Typ
|
ticket.events.source.type | string |
Okno chatu, pošta nebo lc2. |
|
URL
|
ticket.events.source.url | string |
Adresa URL webu, ze kterého byl lístek odeslán. |
|
Typ události
|
ticket.events.type | string |
Typ události, která vygenerovala lístek |
|
Skupina
|
ticket.groups | array of object |
Podrobnosti o přidružené skupině |
|
identifikační číslo
|
ticket.groups.id | integer |
Jedinečné ID skupiny |
|
Název
|
ticket.groups.name | string |
Název skupiny. |
|
ID lístku
|
ticket.id | string |
Jedinečné ID lístku |
|
IP
|
ticket.requester.ip | string |
IP adresa žadatele. |
|
Email
|
ticket.requester.mail | string |
E-mailová adresa žadatele |
|
Název
|
ticket.requester.name | string |
Název žadatele. |
|
identifikační číslo
|
ticket.source.id | string |
Jedinečné ID zdroje |
|
Typ
|
ticket.source.type | string |
Lc2, pošta, facebook, agent-app-manual nebo chat-window. |
|
URL
|
ticket.source.url | string |
Adresa URL webu, na kterém byl lístek vytvořen. |
|
Stav
|
ticket.status | string |
Otevřený, čekající, nevyřešený nebo spam |
|
Předmět
|
ticket.subject | string |
Stručný popis lístku. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Vytvořeno Date-Time
|
date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
ID lístku
|
id | string |
Jedinečný identifikátor lístku |
|
Změněné Date-Time
|
modified | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
IP
|
requester.ip | string |
IP adresa žadatele. |
|
Email
|
requester.mail | string |
E-mailová adresa žadatele |
|
Název
|
requester.name | string |
Úplný název žadatele. |
|
identifikační číslo
|
source.id | string |
Jedinečný identifikátor zdroje |
|
Typ
|
source.type | string |
Z chatu, pošty nebo lc2. |
|
URL
|
source.url | string |
Webová stránka, kde byl lístek vytvořen. |
|
Stav
|
status | string |
Otevřený, čekající, nevyřešený nebo spam |
|
Předmět
|
subject | string |
Popis zdroje lístku |
TicketResponse
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
identifikační číslo
|
currentGroup.id | integer |
Jedinečné ID skupiny |
|
Název
|
currentGroup.name | string |
Název skupiny. |
|
Vytvořeno Date-Time
|
date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
events
|
events | array of object | |
|
identifikační číslo
|
events.author.id | string |
Jedinečné ID uživatele |
|
Název
|
events.author.name | string |
Jméno autora. |
|
Typ
|
events.author.type | string |
Agent nebo klient. |
|
Date-Time událostí
|
events.date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Je soukromé
|
events.is_private | boolean |
Hodnota True, pokud je událost soukromá. |
|
Message
|
events.message | string |
Popis události |
|
Typ
|
events.source.type | string |
Okno chatu, pošta nebo lc2. |
|
URL
|
events.source.url | string |
Adresa URL webu, ze kterého byl lístek odeslán. |
|
Typ události
|
events.type | string |
Typ události, která vygenerovala lístek |
|
Skupina
|
groups | array of object |
Podrobnosti o přidružené skupině |
|
identifikační číslo
|
groups.id | integer |
Jedinečné ID skupiny |
|
Název
|
groups.name | string |
Název skupiny. |
|
ID lístku
|
id | string |
Jedinečné ID lístku |
|
IP
|
requester.ip | string |
IP adresa žadatele. |
|
Email
|
requester.mail | string |
E-mailová adresa žadatele |
|
Název
|
requester.name | string |
Název žadatele. |
|
identifikační číslo
|
source.id | string |
Jedinečné ID zdroje |
|
Typ
|
source.type | string |
Lc2, pošta, facebook, agent-app-manual nebo chat-window. |
|
URL
|
source.url | string |
Adresa URL webu, na kterém byl lístek vytvořen. |
|
Stav
|
status | string |
Otevřený, čekající, nevyřešený nebo spam |
|
Předmět
|
subject | string |
Stručný popis lístku. |
|
tags
|
tags | array of string |
ListAgentsV2_Response
Agenti v licenci LiveChat.
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Položky
|
AgentV2 |
AgentV2
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID agenta
|
id | string |
ID agenta, obvykle e-mailová adresa agenta. |
|
Název
|
name | string |
Název agenta. |
|
Avatar
|
avatar | string |
Adresa URL avatara agenta. |
|
Role
|
role | string |
Role agenta. |
|
Stav přihlášení
|
login_status | string |
Stav přihlášení agenta. |
|
Pracovní pozice
|
job_title | string |
Název úlohy agenta. |
|
Mobile
|
mobile | string |
Číslo mobilního agenta. |
|
Maximální počet chatů
|
max_chats_count | integer |
Maximální počet souběžných chatů. |
|
Pozastavený
|
suspended | boolean |
Jestli je agent pozastavený. |
|
Čekání na schválení
|
awaiting_approval | boolean |
Jestli agent čeká na schválení. |
|
groups
|
groups | array of AgentGroupV2 |
Skupiny přiřazené agentovi. |
AgentGroupV2
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID skupiny
|
id | integer | |
|
Priorita
|
priority | string |
ListAgents_Response
Seznam všech agentů s podrobnostmi
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Avatar
|
avatar | string |
Cesta k obrázku na Amazonu s3 |
|
Přihlašovací e-mail
|
login | string |
E-mailová adresa agenta. |
|
Název
|
name | string |
Jméno agenta. |
|
Povolení
|
permission | string |
Vlastník, správce nebo normální. |
CreateAgent_Response
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Avatar
|
avatar | string |
Cesta k obrázku na Amazonu s3 |
|
Pole skupin
|
groups | array of object |
Seznam všech skupin, na které je agent součástí. |
|
ID skupiny
|
groups.id | integer |
Jedinečné ID skupiny |
|
Název skupiny
|
groups.name | string |
Název skupiny. |
|
Název pracovní pozice
|
job_title | string |
Agent podpory je ve výchozím nastavení. |
|
Email
|
login | string |
E-mailová adresa agenta. |
|
Stav přihlášení
|
login_status | string |
Přijímání chatů nebo nepřijímání chatů |
|
Maximální počet chatů
|
max_chats_count | integer |
Omezení souběžných chatů |
|
Název
|
name | string |
Jméno agenta. |
|
Povolení
|
permission | string |
Vlastník, správce nebo normální |
|
Stav
|
status | string |
Přijímání chatů, nepřijímání chatů nebo offline |