LiveChat
A LiveChat egy online ügyfélszolgálati szoftver élő támogatással, ügyfélszolgálati szoftverekkel és webelemzési képességekkel.
Ez az összekötő a következő termékekben és régiókban érhető el:
| Service | Class | Régiók |
|---|---|---|
| Copilot Studio | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Logikai alkalmazások | Standard | Az összes Logic Apps-régió , kivéve a következőket: - Azure Government-régiók - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD) |
| Power Alkalmazások | prémium | Az összes Power Apps-régió , kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Power Automate | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Érintkezés | |
|---|---|
| Név | Microsoft |
| URL | https://www.livechat.com/ |
| Összekötő metaadatai | |
|---|---|
| Kiadó | Microsoft |
| Webhely | https://www.livechat.com/ |
| Adatvédelmi irányelvek | https://www.livechat.com/legal/privacy-policy/ |
| Categories | Communication |
Kapcsolat létrehozása
Az összekötő a következő hitelesítési típusokat támogatja:
| Alapértelmezett | A kapcsolat létrehozásának paraméterei. | Minden régió | Nem osztható meg |
Alapértelmezett
Alkalmazható: Minden régió
A kapcsolat létrehozásának paraméterei.
Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.
| Név | Típus | Description | Kötelező |
|---|---|---|---|
| Örökölt entitásazonosító (elavult) | karakterlánc | A csak elavult LiveChat API v2-műveletek által használt entitásazonosító (e-mail-cím). | |
| Számlaazonosító | karakterlánc | A LiveChat Személyes hozzáférési jogkivonatok lapon látható fiókazonosító (GUID). Az új (V2) összekötőműveletek ezt az értéket használják a LiveChat API 3.6-os verzióval. | True |
| Személyes hozzáférési jogkivonat | securestring | A fiók teljes, kódolatlan személyes hozzáférési jogkivonata. | True |
Szabályozási korlátok
| Name | Hívások | Megújítási időszak |
|---|---|---|
| API-hívások kapcsolatonként | 100 | 60 másodperc |
Műveletek
| Frissítési jegy (elavult) [ELAVULT] |
Ez az elavult művelet a kivont LiveChat Tickets API-t használja. |
| Jegy lekérése (elavult) [ELAVULT] |
Ez az elavult művelet a kivont LiveChat Tickets API-t használja. |
| Jegyek listázása (elavult) [ELAVULT] |
Ez az elavult művelet a kivont LiveChat Tickets API-t használja. |
| Új jegy létrehozása (elavult) [ELAVULT] |
Ez az elavult művelet a kivont LiveChat Tickets API-t használja. |
| Új ügynök létrehozása (elavult) [ELAVULT] |
Ez az elavult művelet létrehoz egy ügynököt a LiveChat API 2-es verzióval. Használja helyette az Új ügynök létrehozása (V2) parancsot. |
| Új ügynök létrehozása (V2) |
Létrehoz egy ügynököt a LiveChat API 3.6-os verzióval. Az ügynök a személyes hozzáférési jogkivonat hatókörétől és a LiveChat-előfizetéstől függően jóváhagyást igényelhet. |
| Ügynök eltávolítása (elavult) [ELAVULT] |
Ez az elavult művelet eltávolít egy ügynököt a LiveChat API 2-es verzióval. Ehelyett használja az Ügynök eltávolítása (V2) lehetőséget. |
| Ügynök eltávolítása (V2) |
Eltávolít egy ügynököt a LiveChat API 3.6-os verzióval. Egy másik ügynök eltávolításához szükség van az ügynökökre - all:rw és accounts --all:rw hatókörökre. |
| Ügynökök listázása (elavult) [ELAVULT] |
Ez az elavult művelet a LiveChat API 2-es verziót használó ügynököket ad vissza. Használja helyette a Listaügynökök (V2) parancsot. |
| Ügynökök listázása (V2) |
A LiveChat-licencben szereplő összes ügynököt a LiveChat API 3.6-os verzióval adja vissza. A személyes hozzáférési jogkivonathoz az ügynökökre van szükség – all:ro hatókör. |
Frissítési jegy (elavult) [ELAVULT]
Ez az elavult művelet a kivont LiveChat Tickets API-t használja.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Jegyazonosító
|
ticketId | True | string |
A jegy azonosítója |
|
Message
|
message | string | ||
|
A kérelmező e-mail-címe
|
True | string | ||
|
Kérelmező neve
|
name | string | ||
|
Tárgy
|
subject | string | ||
|
Hozzárendelt azonosító
|
id | string |
Válasszon ki egy hozzárendeltet. |
|
|
Forrás típusa
|
type | string |
Válasszon egy forrást. |
|
|
Forrás URL-címe
|
url | string |
Ha a forrás típusa csevegőablak. |
Válaszok
- Törzs
- TicketResponse
Jegy lekérése (elavult) [ELAVULT]
Ez az elavult művelet a kivont LiveChat Tickets API-t használja.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Jegyazonosító
|
ticketId | True | string |
A jegy azonosítója |
Válaszok
- Törzs
- TicketResponse
Jegyek listázása (elavult) [ELAVULT]
Ez az elavult művelet a kivont LiveChat Tickets API-t használja.
Válaszok
- Elemek
- ListTicketsResponse
Új jegy létrehozása (elavult) [ELAVULT]
Ez az elavult művelet a kivont LiveChat Tickets API-t használja.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
A kérelmező e-mail-címe
|
True | string | ||
|
Kérelmező neve
|
name | string | ||
|
Tárgy
|
subject | string | ||
|
Hozzárendelt azonosító
|
id | string | ||
|
Forrás típusa
|
type | string |
Forrás kiválasztása |
|
|
Forrás URL-címe
|
url | string |
Ha a forrás típusa csevegőablak. |
Válaszok
- Törzs
- TicketResponse
Új ügynök létrehozása (elavult) [ELAVULT]
Ez az elavult művelet létrehoz egy ügynököt a LiveChat API 2-es verzióval. Használja helyette az Új ügynök létrehozása (V2) parancsot.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Email
|
login | True | string | |
|
Név
|
name | True | string | |
|
Bejelentkezési állapot
|
login_status | string | ||
|
Cím
|
job_title | string |
Alapértelmezett beállítás: Támogatási ügynök. |
|
|
Engedély
|
permission | string | ||
|
Jelszó
|
password | string |
Minimális hossz 5. |
|
|
Csevegések maximális száma
|
max_chats_count | string |
Az egyidejű csevegések korlátja. |
Válaszok
- Törzs
- CreateAgent_Response
Új ügynök létrehozása (V2)
Létrehoz egy ügynököt a LiveChat API 3.6-os verzióval. Az ügynök a személyes hozzáférési jogkivonat hatókörétől és a LiveChat-előfizetéstől függően jóváhagyást igényelhet.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Ügynök azonosítója
|
id | True | string |
Az ügynök azonosítója, általában az ügynök e-mail-címe. |
|
Név
|
name | True | string |
Az ügynök neve. |
|
Szerep
|
role | string |
A normálnál magasabb szerepkör létrehozásához a accounts.roles.lc--all:rw hatókör szükséges. |
|
|
Bejelentkezési állapot
|
login_status | string | ||
|
Beosztás
|
job_title | string | ||
|
Mobile
|
mobile | string | ||
|
Csevegések maximális száma
|
max_chats_count | integer | ||
|
Jóváhagyásra vár
|
awaiting_approval | boolean |
Ha ezt hamisra állítja, a privát előfizetés.lc:rw hatókörre van szükség. |
|
|
Csoportazonosító
|
id | True | integer | |
|
Priority
|
priority | True | string | |
|
Notifications
|
notifications | array of string | ||
|
E-mail-előfizetések
|
email_subscriptions | array of string | ||
|
Időzóna
|
timezone | string |
A munkaütemezés által használt időzóna. |
|
|
Nap
|
day | True | string | |
|
Enabled
|
enabled | True | boolean | |
|
Start
|
start | True | string | |
|
Vége
|
end | True | string |
Ügynök eltávolítása (elavult) [ELAVULT]
Ez az elavult művelet eltávolít egy ügynököt a LiveChat API 2-es verzióval. Ehelyett használja az Ügynök eltávolítása (V2) lehetőséget.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Email
|
login | True | string |
Az ügynök e-mail-címe. |
Válaszok
- Törzs
- DeleteAgent_Response
Ügynök eltávolítása (V2)
Eltávolít egy ügynököt a LiveChat API 3.6-os verzióval. Egy másik ügynök eltávolításához szükség van az ügynökökre - all:rw és accounts --all:rw hatókörökre.
Paraméterek
| Name | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Ügynök azonosítója
|
id | True | string |
Az eltávolítani kívánt ügynök azonosítója. |
Ügynökök listázása (elavult) [ELAVULT]
Ez az elavult művelet a LiveChat API 2-es verziót használó ügynököket ad vissza. Használja helyette a Listaügynökök (V2) parancsot.
Válaszok
Az összes ügynök listája az adataikkal.
- Elemek
- ListAgents_Response
Ügynökök listázása (V2)
A LiveChat-licencben szereplő összes ügynököt a LiveChat API 3.6-os verzióval adja vissza. A személyes hozzáférési jogkivonathoz az ügynökökre van szükség – all:ro hatókör.
Válaszok
A LiveChat-licencben szereplő ügynökök.
- Elemek
- ListAgentsV2_Response
Triggerek
| Csevegés indításakor (elavult) [ELAVULT] |
Ez az elavult művelet a LiveChat API 2-es verziót használja. |
| Ha egy csevegés véget ér (elavult) [ELAVULT] |
Ez az elavult művelet a LiveChat API 2-es verziót használja. |
| Jegy létrehozásakor (elavult) [ELAVULT] |
Ez az elavult művelet a kivont LiveChat Tickets API-t használja. |
Csevegés indításakor (elavult) [ELAVULT]
Ha egy csevegés véget ér (elavult) [ELAVULT]
Jegy létrehozásakor (elavult) [ELAVULT]
Ez az elavult művelet a kivont LiveChat Tickets API-t használja.
Válaszok
- Törzs
- WebhookTicketResponse
Definíciók
WebhookChatResponse
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
Ügynök e-mail-címe
|
chat.agents.login | string |
Az ügynök e-mail-címe. |
|
Ügynök neve
|
chat.agents.name | string |
Az ügynök neve. |
|
Befejeződött időbélyeg
|
chat.ended_timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
events
|
chat.events | array of object |
Események tömbje. |
|
Eseményszöveg
|
chat.events.text | string |
Az eseményhez társított üzenet. |
|
Esemény Date-Time
|
chat.events.timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Esemény típusa
|
chat.events.type | string |
Az esemény típusa. |
|
Eseményfelhasználó típusa
|
chat.events.user_type | string |
Felhasználó típusa. |
|
groups
|
chat.groups | array of integer | |
|
Csoportazonosító
|
chat.id | string |
A csoport egyedi azonosítója. |
|
Message
|
chat.messages | array of object |
Üzenetek tömbje. |
|
Ügynök azonosítója
|
chat.messages.agent_id | string |
Az üzenethez társított ügynök egyedi azonosítója. |
|
Szerző neve
|
chat.messages.author_name | string |
Az üzenet szerzőjének neve. |
|
Szöveg
|
chat.messages.text | string |
Az üzenet törzse. |
|
Elküldött Date-Time
|
chat.messages.timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Felhasználó típusa
|
chat.messages.user_type | string |
Az üzenetet küldő felhasználó típusa. |
|
Első lépések Date-Time
|
chat.started_timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
URL
|
chat.url | string |
Annak a webhelynek az URL-címe, ahol a csevegés elindult. |
|
Eseményazonosító
|
event_unique_id | string |
A csevegéshez társított esemény egyedi azonosítója. |
|
Csevegés előtti felmérés
|
pre_chat_survey | array of object |
A csevegés előtti felmérésre adott válaszok tömbje. |
|
Válasz
|
pre_chat_survey.answer | string |
Felmérési válasz. |
|
Felmérés azonosítója
|
pre_chat_survey.id | string |
Csevegés előtti felmérés azonosítója. |
|
Question
|
pre_chat_survey.label | string |
Felmérési kérdés. |
|
Email
|
visitor.email | string |
A látogató e-mail-címe. |
|
Azonosító
|
visitor.id | string |
A látogató egyedi azonosítója. |
|
Nyelv
|
visitor.language | string |
A látogató fiókjához társított nyelv. |
|
Név
|
visitor.name | string |
A látogató neve. |
|
Oldal
|
visitor.page_current | string |
Weblap, amelyről a csevegés származik. |
WebhookTicketResponse
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Azonosító
|
ticket.assignee.id | string |
A felhasználó egyedi azonosítója. |
|
Név
|
ticket.assignee.name | string |
A hozzárendelt személy neve. |
|
events
|
ticket.events | array of object | |
|
Azonosító
|
ticket.events.author.id | string |
A felhasználó egyedi azonosítója. |
|
Név
|
ticket.events.author.name | string |
A szerző neve. |
|
Típus
|
ticket.events.author.type | string |
Ügynök vagy ügyfél. |
|
Esemény Date-Time
|
ticket.events.date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Privát
|
ticket.events.is_private | boolean |
Igaz, ha az esemény privát. |
|
Message
|
ticket.events.message | string |
Az esemény leírása. |
|
Típus
|
ticket.events.source.type | string |
Csevegőablak, e-mail vagy lc2. |
|
URL
|
ticket.events.source.url | string |
Annak a webhelynek az URL-címe, amelyről a jegyet elküldték. |
|
Esemény típusa
|
ticket.events.type | string |
A jegyet létrehozó esemény típusa. |
|
Csoport
|
ticket.groups | array of object |
A társított csoport részletei. |
|
Azonosító
|
ticket.groups.id | integer |
A csoport egyedi azonosítója. |
|
Név
|
ticket.groups.name | string |
A csoport neve. |
|
Jegyazonosító
|
ticket.id | string |
A jegy egyedi azonosítója. |
|
IP
|
ticket.requester.ip | string |
A kérelmező IP-címe. |
|
Email
|
ticket.requester.mail | string |
A kérelmező e-mail-címe. |
|
Név
|
ticket.requester.name | string |
A kérelmező neve. |
|
Azonosító
|
ticket.source.id | string |
A forrás egyedi azonosítója. |
|
Típus
|
ticket.source.type | string |
Lc2, mail, facebook, agent-app-manual vagy chat-window. |
|
URL
|
ticket.source.url | string |
Annak a webhelynek az URL-címe, ahol a jegy létrejött. |
|
Státusz
|
ticket.status | string |
Megnyitás, függőben, megoldva vagy levélszemét. |
|
Tárgy
|
ticket.subject | string |
A jegy rövid leírása. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Létrehozott Date-Time
|
date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Jegyazonosító
|
id | string |
A jegy egyedi azonosítója. |
|
Módosított Date-Time
|
modified | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
IP
|
requester.ip | string |
A kérelmező IP-címe. |
|
Email
|
requester.mail | string |
A kérelmező e-mail-címe. |
|
Név
|
requester.name | string |
A kérelmező teljes neve. |
|
Azonosító
|
source.id | string |
A forrás egyedi azonosítója. |
|
Típus
|
source.type | string |
Csevegésből, levelezésből vagy lc2-ből. |
|
URL
|
source.url | string |
Weblap, ahol a jegy létre lett hozva. |
|
Státusz
|
status | string |
Megnyitás, függőben, megoldva vagy levélszemét. |
|
Tárgy
|
subject | string |
A jegyforrás leírása. |
TicketResponse
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Azonosító
|
currentGroup.id | integer |
A csoport egyedi azonosítója. |
|
Név
|
currentGroup.name | string |
A csoport neve. |
|
Létrehozott Date-Time
|
date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
events
|
events | array of object | |
|
Azonosító
|
events.author.id | string |
A felhasználó egyedi azonosítója. |
|
Név
|
events.author.name | string |
A szerző neve. |
|
Típus
|
events.author.type | string |
Ügynök vagy ügyfél. |
|
Esemény Date-Time
|
events.date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Privát
|
events.is_private | boolean |
Igaz, ha az esemény privát. |
|
Message
|
events.message | string |
Az esemény leírása. |
|
Típus
|
events.source.type | string |
Csevegőablak, e-mail vagy lc2. |
|
URL
|
events.source.url | string |
Annak a webhelynek az URL-címe, amelyről a jegyet elküldték. |
|
Esemény típusa
|
events.type | string |
A jegyet létrehozó esemény típusa. |
|
Csoport
|
groups | array of object |
A társított csoport részletei. |
|
Azonosító
|
groups.id | integer |
A csoport egyedi azonosítója. |
|
Név
|
groups.name | string |
A csoport neve. |
|
Jegyazonosító
|
id | string |
A jegy egyedi azonosítója. |
|
IP
|
requester.ip | string |
A kérelmező IP-címe. |
|
Email
|
requester.mail | string |
A kérelmező e-mail-címe. |
|
Név
|
requester.name | string |
A kérelmező neve. |
|
Azonosító
|
source.id | string |
A forrás egyedi azonosítója. |
|
Típus
|
source.type | string |
Lc2, mail, facebook, agent-app-manual vagy chat-window. |
|
URL
|
source.url | string |
Annak a webhelynek az URL-címe, ahol a jegy létrejött. |
|
Státusz
|
status | string |
Megnyitás, függőben, megoldva vagy levélszemét. |
|
Tárgy
|
subject | string |
A jegy rövid leírása. |
|
tags
|
tags | array of string |
ListAgentsV2_Response
A LiveChat-licencben szereplő ügynökök.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Elemek
|
AgentV2 |
AgentV2
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Ügynök azonosítója
|
id | string |
Az ügynök azonosítója, általában az ügynök e-mail-címe. |
|
Név
|
name | string |
Az ügynök neve. |
|
Megtestesülés
|
avatar | string |
Az ügynök avatar URL-címe. |
|
Szerep
|
role | string |
Az ügynöki szerepkör. |
|
Bejelentkezési állapot
|
login_status | string |
Az ügynök bejelentkezési állapota. |
|
Beosztás
|
job_title | string |
Az ügynöki feladat címe. |
|
Mobile
|
mobile | string |
Az ügynök mobilszáma. |
|
Csevegések maximális száma
|
max_chats_count | integer |
Az egyidejű csevegések maximális száma. |
|
Felfüggesztve
|
suspended | boolean |
Azt, hogy az ügynök fel van-e függesztve. |
|
Jóváhagyásra vár
|
awaiting_approval | boolean |
Azt jelzi, hogy az ügynök jóváhagyásra vár-e. |
|
groups
|
groups | array of AgentGroupV2 |
Az ügynökhöz rendelt csoportok. |
AgentGroupV2
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Csoportazonosító
|
id | integer | |
|
Priority
|
priority | string |
ListAgents_Response
Az összes ügynök listája az adataikkal.
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Megtestesülés
|
avatar | string |
A kép elérési útja az Amazon s3-on. |
|
Bejelentkezési e-mail
|
login | string |
Az ügynök e-mail-címe. |
|
Név
|
name | string |
Az ügynök neve. |
|
Engedély
|
permission | string |
Tulajdonos, rendszergazda vagy normál. |
CreateAgent_Response
| Name | Elérési út | Típus | Description |
|---|---|---|---|
|
Megtestesülés
|
avatar | string |
A kép elérési útja az Amazon s3-on. |
|
Csoportok tömbje
|
groups | array of object |
Az ügynökhöz tartozó összes csoport listája. |
|
Csoportazonosító
|
groups.id | integer |
A csoport egyedi azonosítója. |
|
Csoport neve
|
groups.name | string |
A csoport neve. |
|
Beosztás
|
job_title | string |
A támogatási ügynök alapértelmezés szerint. |
|
Email
|
login | string |
Az ügynök e-mail-címe. |
|
Bejelentkezési állapot
|
login_status | string |
Csevegések elfogadása vagy csevegések nem elfogadása. |
|
Csevegések maximális száma
|
max_chats_count | integer |
Az egyidejű csevegések korlátja. |
|
Név
|
name | string |
Az ügynök neve. |
|
Engedély
|
permission | string |
Tulajdonos, rendszergazda vagy normál |
|
Státusz
|
status | string |
Csevegések elfogadása, csevegések nem elfogadása vagy offline. |