LiveChat
LiveChat to oprogramowanie do obsługi klienta online z obsługą na żywo, oprogramowaniem pomocy technicznej i funkcjami analizy internetowej.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL |
Obsługa usługi Microsoft LogicApps Pomoc techniczna usługi Microsoft Power Automate Obsługa usługi Microsoft Power Apps |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://www.livechat.com/ |
| Zasady ochrony prywatności | https://www.livechat.com/legal/privacy-policy/ |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Nazwa użytkownika | ciąg | Adres e-mail dla tego konta | Prawda |
| Klucz interfejsu API | securestring | Klucz interfejsu API dla tego konta | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Bilet aktualizacji |
Ta operacja służy do aktualizowania szczegółów istniejącego biletu na koncie LiveChat. |
| Tworzenie nowego agenta |
Ta operacja służy do dodawania nowego agenta do konta LiveChat. |
| Tworzenie nowego biletu |
Ta operacja służy do dodawania nowego biletu do konta LiveChat. |
| Usuwanie agenta |
Ta operacja służy do usuwania agenta z konta LiveChat. |
| Uzyskiwanie biletu |
Ta operacja służy do pobierania szczegółów określonego biletu na koncie LiveChat. |
| Wylistuj agentów |
Ta operacja zwraca listę wszystkich agentów na koncie LiveChat. |
| Wyświetlanie listy biletów |
Ta operacja zwraca listę biletów na koncie LiveChat. |
Bilet aktualizacji
Ta operacja służy do aktualizowania szczegółów istniejącego biletu na koncie LiveChat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator biletu
|
ticketId | True | string |
Identyfikator biletu |
|
Message
|
message | string | ||
|
Adres e-mail nadawcy żądającego
|
True | string | ||
|
Nazwa osoby żądającego
|
name | string | ||
|
Temat
|
subject | string | ||
|
Identyfikator przypisywania
|
id | string |
Wybierz przypisanie. |
|
|
Typ źródła
|
type | string |
Wybierz źródło. |
|
|
Źródłowy adres URL
|
url | string |
Jeśli typ źródła to okno czatu. |
Zwraca
- Body
- TicketResponse
Tworzenie nowego agenta
Ta operacja służy do dodawania nowego agenta do konta LiveChat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Email
|
login | True | string | |
|
Name
|
name | True | string | |
|
Stan logowania
|
login_status | string | ||
|
Title
|
job_title | string |
Wartości domyślne: Agent pomocy technicznej. |
|
|
Pozwolenie
|
permission | string | ||
|
Hasło
|
password | string |
Minimalna długość 5. |
|
|
Maksymalna liczba czatów
|
max_chats_count | string |
Limit współbieżnych czatów. |
Zwraca
- Body
- CreateAgent_Response
Tworzenie nowego biletu
Ta operacja służy do dodawania nowego biletu do konta LiveChat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
Adres e-mail nadawcy żądającego
|
True | string | ||
|
Nazwa osoby żądającego
|
name | string | ||
|
Temat
|
subject | string | ||
|
Identyfikator przypisywania
|
id | string | ||
|
Typ źródła
|
type | string |
Wybierz źródło |
|
|
Źródłowy adres URL
|
url | string |
Jeśli typ źródła to okno czatu. |
Zwraca
- Body
- TicketResponse
Usuwanie agenta
Ta operacja służy do usuwania agenta z konta LiveChat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Email
|
login | True | string |
Wiadomość e-mail agenta. |
Zwraca
- Body
- DeleteAgent_Response
Uzyskiwanie biletu
Ta operacja służy do pobierania szczegółów określonego biletu na koncie LiveChat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator biletu
|
ticketId | True | string |
Identyfikator biletu |
Zwraca
- Body
- TicketResponse
Wylistuj agentów
Ta operacja zwraca listę wszystkich agentów na koncie LiveChat.
Zwraca
Lista wszystkich agentów ze swoimi szczegółami.
- Przedmioty
- ListAgents_Response
Wyświetlanie listy biletów
Wyzwalacze
| Po rozpoczęciu czatu |
Ta operacja jest wyzwalana po rozpoczęciu nowego czatu. |
| Po utworzeniu biletu |
Ta operacja jest wyzwalana po dodaniu nowego biletu. |
| Po zakończeniu czatu |
Ta operacja jest wyzwalana po zakończeniu czatu. |
Po rozpoczęciu czatu
Po utworzeniu biletu
Po zakończeniu czatu
Definicje
WebhookChatResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
Adres e-mail agenta
|
chat.agents.login | string |
Adres e-mail agenta. |
|
Nazwa agenta
|
chat.agents.name | string |
Nazwa agenta. |
|
Sygnatura czasowa zakończenia
|
chat.ended_timestamp | string |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
events
|
chat.events | array of object |
Tablica zdarzeń. |
|
Tekst zdarzenia
|
chat.events.text | string |
Komunikat skojarzony ze zdarzeniem. |
|
Date-Time zdarzeń
|
chat.events.timestamp | string |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Typ zdarzenia
|
chat.events.type | string |
Typ zdarzenia. |
|
Typ użytkownika zdarzenia
|
chat.events.user_type | string |
Typ użytkownika. |
|
groups
|
chat.groups | array of integer | |
|
Identyfikator grupy
|
chat.id | string |
Unikatowy identyfikator grupy. |
|
Message
|
chat.messages | array of object |
Tablica komunikatów. |
|
Identyfikator agenta
|
chat.messages.agent_id | string |
Unikatowy identyfikator agenta skojarzonego z komunikatem. |
|
Nazwa autora
|
chat.messages.author_name | string |
Nazwa autora wiadomości. |
|
Tekst
|
chat.messages.text | string |
Treść wiadomości. |
|
Wysłane Date-Time
|
chat.messages.timestamp | string |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Typ użytkownika
|
chat.messages.user_type | string |
Typ użytkownika wysyłającego wiadomość. |
|
Rozpoczęto Date-Time
|
chat.started_timestamp | string |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
adres URL
|
chat.url | string |
Adres URL witryny internetowej, w której rozpoczęto czat. |
|
Identyfikator zdarzenia
|
event_unique_id | string |
Unikatowy identyfikator zdarzenia skojarzonego z czatem. |
|
Ankieta przed czatem
|
pre_chat_survey | array of object |
Tablica odpowiedzi na ankietę przed czatem. |
|
Odpowiedź
|
pre_chat_survey.answer | string |
Odpowiedź na ankietę. |
|
Identyfikator ankiety
|
pre_chat_survey.id | string |
Identyfikator ankiety przed czatem. |
|
Question
|
pre_chat_survey.label | string |
Pytanie ankiety. |
|
Email
|
visitor.email | string |
Adres e-mail osoby odwiedzającej. |
|
Id
|
visitor.id | string |
Unikatowy identyfikator osoby odwiedzającej. |
|
Język
|
visitor.language | string |
Język skojarzony z kontem gościa. |
|
Name
|
visitor.name | string |
Imię i nazwisko gościa. |
|
Strona
|
visitor.page_current | string |
Strona internetowa, z którą pochodzi czat. |
Element webhookTicketResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
ticket.assignee.id | string |
Unikatowy identyfikator użytkownika. |
|
Name
|
ticket.assignee.name | string |
Nazwa osoby przydzielonej. |
|
events
|
ticket.events | array of object | |
|
Id
|
ticket.events.author.id | string |
Unikatowy identyfikator użytkownika. |
|
Name
|
ticket.events.author.name | string |
Nazwa autora. |
|
Typ
|
ticket.events.author.type | string |
Agent lub klient. |
|
Date-Time zdarzeń
|
ticket.events.date | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Jest prywatny
|
ticket.events.is_private | boolean |
Prawda, jeśli zdarzenie jest prywatne. |
|
Message
|
ticket.events.message | string |
Opis zdarzenia. |
|
Typ
|
ticket.events.source.type | string |
Okno czatu, poczta lub lc2. |
|
adres URL
|
ticket.events.source.url | string |
Adres URL witryny internetowej, z którą wysłano bilet. |
|
Typ zdarzenia
|
ticket.events.type | string |
Typ zdarzenia, które wygenerowało bilet. |
|
Grupa
|
ticket.groups | array of object |
Szczegóły skojarzonej grupy. |
|
Id
|
ticket.groups.id | integer |
Unikatowy identyfikator grupy. |
|
Name
|
ticket.groups.name | string |
Nazwa grupy. |
|
Identyfikator biletu
|
ticket.id | string |
Unikatowy identyfikator biletu. |
|
IP
|
ticket.requester.ip | string |
Adres IP obiektu żądającego. |
|
Email
|
ticket.requester.mail | string |
Adres e-mail obiektu żądającego. |
|
Name
|
ticket.requester.name | string |
Nazwa obiektu żądającego. |
|
Id
|
ticket.source.id | string |
Unikatowy identyfikator źródła. |
|
Typ
|
ticket.source.type | string |
Lc2, poczta, facebook, agent-app-manual lub chat-window. |
|
adres URL
|
ticket.source.url | string |
Adres URL witryny internetowej, w której utworzono bilet. |
|
Status
|
ticket.status | string |
Otwarte, oczekujące, rozwiązane lub spam. |
|
Temat
|
ticket.subject | string |
Krótki opis biletu. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Utworzono Date-Time
|
date | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Identyfikator biletu
|
id | string |
Unikatowy identyfikator biletu. |
|
Zmodyfikowany Date-Time
|
modified | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
IP
|
requester.ip | string |
Adres IP obiektu żądającego. |
|
Email
|
requester.mail | string |
Adres e-mail obiektu żądającego. |
|
Name
|
requester.name | string |
Pełna nazwa osoby żądającego. |
|
Id
|
source.id | string |
Unikatowy identyfikator źródła. |
|
Typ
|
source.type | string |
Z czatu, poczty lub lc2. |
|
adres URL
|
source.url | string |
Strona internetowa, na której utworzono bilet. |
|
Status
|
status | string |
Otwarte, oczekujące, rozwiązane lub spam. |
|
Temat
|
subject | string |
Opis źródła biletu. |
TicketResponse
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
currentGroup.id | integer |
Unikatowy identyfikator grupy. |
|
Name
|
currentGroup.name | string |
Nazwa grupy. |
|
Utworzono Date-Time
|
date | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
events
|
events | array of object | |
|
Id
|
events.author.id | string |
Unikatowy identyfikator użytkownika. |
|
Name
|
events.author.name | string |
Nazwa autora. |
|
Typ
|
events.author.type | string |
Agent lub klient. |
|
Date-Time zdarzeń
|
events.date | date-time |
rrrr-MM-ddTHH:mm:ss.fffZ |
|
Jest prywatny
|
events.is_private | boolean |
Prawda, jeśli zdarzenie jest prywatne. |
|
Message
|
events.message | string |
Opis zdarzenia. |
|
Typ
|
events.source.type | string |
Okno czatu, poczta lub lc2. |
|
adres URL
|
events.source.url | string |
Adres URL witryny internetowej, z którą wysłano bilet. |
|
Typ zdarzenia
|
events.type | string |
Typ zdarzenia, które wygenerowało bilet. |
|
Grupa
|
groups | array of object |
Szczegóły skojarzonej grupy. |
|
Id
|
groups.id | integer |
Unikatowy identyfikator grupy. |
|
Name
|
groups.name | string |
Nazwa grupy. |
|
Identyfikator biletu
|
id | string |
Unikatowy identyfikator biletu. |
|
IP
|
requester.ip | string |
Adres IP obiektu żądającego. |
|
Email
|
requester.mail | string |
Adres e-mail obiektu żądającego. |
|
Name
|
requester.name | string |
Nazwa obiektu żądającego. |
|
Id
|
source.id | string |
Unikatowy identyfikator źródła. |
|
Typ
|
source.type | string |
Lc2, poczta, facebook, agent-app-manual lub chat-window. |
|
adres URL
|
source.url | string |
Adres URL witryny internetowej, w której utworzono bilet. |
|
Status
|
status | string |
Otwarte, oczekujące, rozwiązane lub spam. |
|
Temat
|
subject | string |
Krótki opis biletu. |
|
tags
|
tags | array of string |
ListAgents_Response
Lista wszystkich agentów ze swoimi szczegółami.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Awatar
|
avatar | string |
Ścieżka do obrazu na Amazon s3. |
|
Adres e-mail logowania
|
login | string |
Adres e-mail agenta. |
|
Name
|
name | string |
Nazwa agenta. |
|
Pozwolenie
|
permission | string |
Właściciel, administrator lub normalny. |
CreateAgent_Response
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Awatar
|
avatar | string |
Ścieżka do obrazu na Amazon s3. |
|
Tablica grup
|
groups | array of object |
Lista wszystkich grup, z których agent jest częścią. |
|
Identyfikator grupy
|
groups.id | integer |
Unikatowy identyfikator grupy. |
|
Nazwa grupy
|
groups.name | string |
Nazwa grupy. |
|
Stanowisko
|
job_title | string |
Domyślnie obsługuje agenta. |
|
Email
|
login | string |
Adres e-mail agenta. |
|
Stan logowania
|
login_status | string |
Akceptowanie czatów lub akceptowanie czatów. |
|
Maksymalna liczba czatów
|
max_chats_count | integer |
Limit współbieżnych czatów. |
|
Name
|
name | string |
Nazwa agenta. |
|
Pozwolenie
|
permission | string |
Właściciel, administrator lub normalny |
|
Status
|
status | string |
Akceptowanie czatów, nie akceptowanie czatów ani offline. |