LiveChat
LiveChat ist eine Online-Kundendienstsoftware mit Live-Support, Helpdesk-Software und Web analytics-Funktionen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL | https://www.livechat.com/ |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Webseite | https://www.livechat.com/ |
| Datenschutzrichtlinie | https://www.livechat.com/legal/privacy-policy/ |
| Kategorien | Kommunikation |
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Legacy-Entitäts-ID (veraltet) | Schnur | Die Entitäts-ID (E-Mail-Adresse), die nur von veralteten LiveChat-API v2-Vorgängen verwendet wird. | |
| Konto-ID | Schnur | Die Konto-ID (GUID), die auf der Seite "Persönliche Zugriffstoken für LiveChat" angezeigt wird. Neue (V2)-Connectorvorgänge verwenden diesen Wert mit der LiveChat-API v3.6. | Richtig |
| Persönliches Zugriffstoken | securestring | Das vollständige, nicht codierte persönliche Zugriffstoken für dieses Konto. | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Agents auflisten (V2) |
Gibt alle Agents in der LiveChat-Lizenz mit der LiveChat-API v3.6 zurück. Das persönliche Zugriffstoken erfordert den Agents--all:ro-Bereich. |
| Agents auflisten (veraltet) [VERALTET] |
Dieser veraltete Vorgang gibt Agents mit der LiveChat-API v2 zurück. Verwenden Sie stattdessen Listen-Agents (V2). |
| Entfernen eines Agents (V2) |
Entfernt einen Agent mit der LiveChat-API v3.6. Das Entfernen eines anderen Agents erfordert die Agents --all:rw und accounts--all:rw Bereiche. |
| Entfernen eines Agents (veraltet) [VERALTET] |
Dieser veraltete Vorgang entfernt einen Agent mit der LiveChat-API v2. Verwenden Sie stattdessen remove an agent (V2). |
| Erstellen eines neuen Agents (V2) |
Erstellt einen Agent mit der LiveChat-API v3.6. Der Agent erfordert möglicherweise eine Genehmigung, abhängig von den Bereichen "Persönliche Zugriffstoken" und dem LiveChat-Abonnement. |
| Erstellen eines neuen Agents (veraltet) [VERALTET] |
Dieser veraltete Vorgang erstellt einen Agent mit der LiveChat-API v2. Verwenden Sie stattdessen create a new agent (V2). |
| Erstellen eines neuen Tickets (veraltet) [VERALTET] |
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API. |
| Ticket abrufen (veraltet) [VERALTET] |
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API. |
| Tickets auflisten (veraltet) [VERALTET] |
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API. |
| Updateticket (veraltet) [VERALTET] |
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API. |
Agents auflisten (V2)
Gibt alle Agents in der LiveChat-Lizenz mit der LiveChat-API v3.6 zurück. Das persönliche Zugriffstoken erfordert den Agents--all:ro-Bereich.
Gibt zurück
Die Agents in der LiveChat-Lizenz.
- Gegenstände
- ListAgentsV2_Response
Agents auflisten (veraltet) [VERALTET]
Dieser veraltete Vorgang gibt Agents mit der LiveChat-API v2 zurück. Verwenden Sie stattdessen Listen-Agents (V2).
Gibt zurück
Liste aller Agenten mit ihren Details.
- Gegenstände
- ListAgents_Response
Entfernen eines Agents (V2)
Entfernt einen Agent mit der LiveChat-API v3.6. Das Entfernen eines anderen Agents erfordert die Agents --all:rw und accounts--all:rw Bereiche.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Agenten-ID
|
id | True | string |
Die ID des zu entfernenden Agents. |
Entfernen eines Agents (veraltet) [VERALTET]
Dieser veraltete Vorgang entfernt einen Agent mit der LiveChat-API v2. Verwenden Sie stattdessen remove an agent (V2).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Email
|
login | True | string |
Die E-Mail des Agents. |
Gibt zurück
- Body
- DeleteAgent_Response
Erstellen eines neuen Agents (V2)
Erstellt einen Agent mit der LiveChat-API v3.6. Der Agent erfordert möglicherweise eine Genehmigung, abhängig von den Bereichen "Persönliche Zugriffstoken" und dem LiveChat-Abonnement.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Agenten-ID
|
id | True | string |
Die Agent-ID, in der Regel die E-Mail-Adresse des Agents. |
|
Name
|
name | True | string |
Der Agentname. |
|
Rolle
|
role | string |
Das Erstellen einer Rolle, die höher als normal ist, erfordert den Bereich accounts.roles.lc-all:rw. |
|
|
Anmeldestatus
|
login_status | string | ||
|
Berufsbezeichnung
|
job_title | string | ||
|
Mobile
|
mobile | string | ||
|
Maximale Chatanzahl
|
max_chats_count | integer | ||
|
Genehmigung wird erwartet
|
awaiting_approval | boolean |
Wenn Sie diesen Wert auf "false" festlegen, ist der Private subscription.lc:rw-Bereich erforderlich. |
|
|
Gruppen-ID
|
id | True | integer | |
|
Priority
|
priority | True | string | |
|
Benachrichtigungen
|
notifications | array of string | ||
|
E-Mail-Abonnements
|
email_subscriptions | array of string | ||
|
Zeitzone
|
timezone | string |
Die Zeitzone, die vom Arbeitsplan verwendet wird. |
|
|
Tag
|
day | True | string | |
|
Enabled
|
enabled | True | boolean | |
|
Start
|
start | True | string | |
|
Ende
|
end | True | string |
Erstellen eines neuen Agents (veraltet) [VERALTET]
Dieser veraltete Vorgang erstellt einen Agent mit der LiveChat-API v2. Verwenden Sie stattdessen create a new agent (V2).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Email
|
login | True | string | |
|
Name
|
name | True | string | |
|
Anmeldestatus
|
login_status | string | ||
|
Title
|
job_title | string |
Standardwert: Support-Agent. |
|
|
Erlaubnis
|
permission | string | ||
|
Kennwort
|
password | string |
Mindestlänge 5. |
|
|
Maximale Anzahl von Chats
|
max_chats_count | string |
Grenzwert der gleichzeitigen Chats. |
Gibt zurück
- Body
- CreateAgent_Response
Erstellen eines neuen Tickets (veraltet) [VERALTET]
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nachricht
|
message | True | string | |
|
E-Mail-Adresse des Antragstellers
|
True | string | ||
|
Name des Antragstellers
|
name | string | ||
|
Betreff
|
subject | string | ||
|
Assignee-ID
|
id | string | ||
|
Quellentyp
|
type | string |
Quelle auswählen |
|
|
Quell-URL
|
url | string |
Wenn der Quelltyp Chatfenster ist. |
Gibt zurück
- Body
- TicketResponse
Ticket abrufen (veraltet) [VERALTET]
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | string |
Die ID des Tickets |
Gibt zurück
- Body
- TicketResponse
Tickets auflisten (veraltet) [VERALTET]
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API.
Gibt zurück
- Gegenstände
- ListTicketsResponse
Updateticket (veraltet) [VERALTET]
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ticket-ID
|
ticketId | True | string |
Die ID des Tickets |
|
Nachricht
|
message | string | ||
|
E-Mail-Adresse des Antragstellers
|
True | string | ||
|
Name des Antragstellers
|
name | string | ||
|
Betreff
|
subject | string | ||
|
Assignee-ID
|
id | string |
Wählen Sie einen Zugewiesenen aus. |
|
|
Quellentyp
|
type | string |
Wählen Sie eine Quelle aus. |
|
|
Quell-URL
|
url | string |
Wenn der Quelltyp Chatfenster ist. |
Gibt zurück
- Body
- TicketResponse
Trigger
| Wenn ein Chat endet (veraltet) [VERALTET] |
Dieser veraltete Vorgang verwendet die LiveChat-API v2. |
| Wenn ein Chat gestartet wird (veraltet) [VERALTET] |
Dieser veraltete Vorgang verwendet die LiveChat-API v2. |
| Wenn ein Ticket erstellt wird (veraltet) [VERALTET] |
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API. |
Wenn ein Chat endet (veraltet) [VERALTET]
Wenn ein Chat gestartet wird (veraltet) [VERALTET]
Wenn ein Ticket erstellt wird (veraltet) [VERALTET]
Dieser veraltete Vorgang verwendet die eingestellte LiveChat-Tickets-API.
Gibt zurück
Definitionen
WebhookChatResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
Agent-E-Mail
|
chat.agents.login | string |
E-Mail-Adresse des Agents. |
|
Agentname
|
chat.agents.name | string |
Name des Agents. |
|
Beendeter Zeitstempel
|
chat.ended_timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
events
|
chat.events | array of object |
Array von Ereignissen. |
|
Ereignistext
|
chat.events.text | string |
Nachricht, die dem Ereignis zugeordnet ist. |
|
EreignisDate-Time
|
chat.events.timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Ereignistyp
|
chat.events.type | string |
Ereignistyp. |
|
Ereignisbenutzertyp
|
chat.events.user_type | string |
Typ des Benutzers. |
|
Gruppen
|
chat.groups | array of integer | |
|
Gruppen-ID
|
chat.id | string |
Eindeutiger Bezeichner der Gruppe. |
|
Nachricht
|
chat.messages | array of object |
Array von Nachrichten. |
|
Agent-ID
|
chat.messages.agent_id | string |
Eindeutige ID des Agents, der der Nachricht zugeordnet ist. |
|
Name des Autors
|
chat.messages.author_name | string |
Name des Autors der Nachricht. |
|
Text
|
chat.messages.text | string |
Textkörper der Nachricht. |
|
Gesendete Date-Time
|
chat.messages.timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Benutzertyp
|
chat.messages.user_type | string |
Typ des Benutzers, der die Nachricht sendet. |
|
Gestartet Date-Time
|
chat.started_timestamp | string |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
URL
|
chat.url | string |
URL der Website, auf der der Chat gestartet wurde. |
|
Ereignis-ID
|
event_unique_id | string |
Eindeutige ID des Ereignisses, das dem Chat zugeordnet ist. |
|
Umfrage vor dem Chat
|
pre_chat_survey | array of object |
Array der Antworten vor dem Chat. |
|
Antwort
|
pre_chat_survey.answer | string |
Umfrageantwort. |
|
Umfrage-ID
|
pre_chat_survey.id | string |
Id der Vorabchatumfrage. |
|
Frage
|
pre_chat_survey.label | string |
Umfragefrage. |
|
Email
|
visitor.email | string |
E-Mail-Adresse des Besuchers. |
|
Id
|
visitor.id | string |
Eindeutige ID des Besuchers. |
|
Language
|
visitor.language | string |
Sprache, die dem Konto des Besuchers zugeordnet ist. |
|
Name
|
visitor.name | string |
Name des Besuchers. |
|
Seite
|
visitor.page_current | string |
Webseite, von der der Chat stammt. |
WebhookTicketResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
ticket.assignee.id | string |
Eindeutiger Bezeichner des Benutzers |
|
Name
|
ticket.assignee.name | string |
Name des Zugewiesenen. |
|
events
|
ticket.events | array of object | |
|
Id
|
ticket.events.author.id | string |
Eindeutige ID des Benutzers. |
|
Name
|
ticket.events.author.name | string |
Name des Autors. |
|
Typ
|
ticket.events.author.type | string |
Agent oder Client. |
|
EreignisDate-Time
|
ticket.events.date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Ist privat
|
ticket.events.is_private | boolean |
True, wenn das Ereignis privat ist. |
|
Nachricht
|
ticket.events.message | string |
Beschreibung des Ereignisses. |
|
Typ
|
ticket.events.source.type | string |
Chatfenster, E-Mail oder lc2. |
|
URL
|
ticket.events.source.url | string |
Url der Website, von der das Ticket gesendet wurde. |
|
Ereignistyp
|
ticket.events.type | string |
Typ des Ereignisses, das das Ticket generiert hat. |
|
Gruppe
|
ticket.groups | array of object |
Details der zugeordneten Gruppe. |
|
Id
|
ticket.groups.id | integer |
Eindeutige ID der Gruppe. |
|
Name
|
ticket.groups.name | string |
Name der Gruppe. |
|
Ticket-ID
|
ticket.id | string |
Eindeutige ID des Tickets. |
|
IP
|
ticket.requester.ip | string |
IP-Adresse des Anforderers. |
|
Email
|
ticket.requester.mail | string |
E-Mail-Adresse des Antragstellers. |
|
Name
|
ticket.requester.name | string |
Name des Anforderers. |
|
Id
|
ticket.source.id | string |
Eindeutige ID der Quelle. |
|
Typ
|
ticket.source.type | string |
Lc2, mail, facebook, agent-app-manual or chat-window. |
|
URL
|
ticket.source.url | string |
URL der Website, auf der das Ticket erstellt wurde. |
|
Der Status
|
ticket.status | string |
Öffnen, ausstehend, gelöst oder Spam. |
|
Betreff
|
ticket.subject | string |
Kurze Beschreibung des Tickets. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erstellt Date-Time
|
date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Ticket-ID
|
id | string |
Eindeutiger Bezeichner des Tickets. |
|
Geänderte Date-Time
|
modified | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
IP
|
requester.ip | string |
IP-Adresse des Anforderers. |
|
Email
|
requester.mail | string |
E-Mail-Adresse des Antragstellers. |
|
Name
|
requester.name | string |
Vollständiger Name des Antragstellers. |
|
Id
|
source.id | string |
Eindeutiger Bezeichner der Quelle. |
|
Typ
|
source.type | string |
Von Chat, E-Mail oder lc2. |
|
URL
|
source.url | string |
Webseite, auf der das Ticket erstellt wurde. |
|
Der Status
|
status | string |
Öffnen, ausstehend, gelöst oder Spam. |
|
Betreff
|
subject | string |
Beschreibung der Ticketquelle. |
TicketResponse
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
currentGroup.id | integer |
Eindeutige ID der Gruppe. |
|
Name
|
currentGroup.name | string |
Name der Gruppe. |
|
Erstellt Date-Time
|
date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
events
|
events | array of object | |
|
Id
|
events.author.id | string |
Eindeutige ID des Benutzers. |
|
Name
|
events.author.name | string |
Name des Autors. |
|
Typ
|
events.author.type | string |
Agent oder Client. |
|
EreignisDate-Time
|
events.date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
Ist privat
|
events.is_private | boolean |
True, wenn das Ereignis privat ist. |
|
Nachricht
|
events.message | string |
Beschreibung des Ereignisses. |
|
Typ
|
events.source.type | string |
Chatfenster, E-Mail oder lc2. |
|
URL
|
events.source.url | string |
Url der Website, von der das Ticket gesendet wurde. |
|
Ereignistyp
|
events.type | string |
Typ des Ereignisses, das das Ticket generiert hat. |
|
Gruppe
|
groups | array of object |
Details der zugeordneten Gruppe. |
|
Id
|
groups.id | integer |
Eindeutige ID der Gruppe. |
|
Name
|
groups.name | string |
Name der Gruppe. |
|
Ticket-ID
|
id | string |
Eindeutige ID des Tickets. |
|
IP
|
requester.ip | string |
IP-Adresse des Anforderers. |
|
Email
|
requester.mail | string |
E-Mail-Adresse des Antragstellers. |
|
Name
|
requester.name | string |
Name des Anforderers. |
|
Id
|
source.id | string |
Eindeutige ID der Quelle. |
|
Typ
|
source.type | string |
Lc2, mail, facebook, agent-app-manual or chat-window. |
|
URL
|
source.url | string |
URL der Website, auf der das Ticket erstellt wurde. |
|
Der Status
|
status | string |
Öffnen, ausstehend, gelöst oder Spam. |
|
Betreff
|
subject | string |
Kurze Beschreibung des Tickets. |
|
tags
|
tags | array of string |
ListAgentsV2_Response
Die Agents in der LiveChat-Lizenz.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gegenstände
|
AgentV2 |
AgentV2
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Agenten-ID
|
id | string |
Die Agent-ID, in der Regel die E-Mail-Adresse des Agents. |
|
Name
|
name | string |
Der Agentname. |
|
Avatar
|
avatar | string |
Die Agent-Avatar-URL. |
|
Rolle
|
role | string |
Die Agentrolle. |
|
Anmeldestatus
|
login_status | string |
Der Agent-Anmeldestatus. |
|
Berufsbezeichnung
|
job_title | string |
Die Position des Agenten. |
|
Mobile
|
mobile | string |
Die Mobiltelefonnummer des Agents. |
|
Maximale Chatanzahl
|
max_chats_count | integer |
Die maximale Anzahl gleichzeitiger Chats. |
|
Gesperrt
|
suspended | boolean |
Gibt an, ob der Agent angehalten wird. |
|
Genehmigung wird erwartet
|
awaiting_approval | boolean |
Gibt an, ob der Agent auf die Genehmigung wartet. |
|
Gruppen
|
groups | array of AgentGroupV2 |
Die dem Agent zugewiesenen Gruppen. |
AgentGroupV2
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gruppen-ID
|
id | integer | |
|
Priority
|
priority | string |
ListAgents_Response
Liste aller Agenten mit ihren Details.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Avatar
|
avatar | string |
Pfad zum Bild auf Amazon s3. |
|
Anmelde-E-Mail
|
login | string |
Die E-Mail-Adresse des Agents. |
|
Name
|
name | string |
Name des Agents. |
|
Erlaubnis
|
permission | string |
Besitzer, Administrator oder Normal. |
CreateAgent_Response
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Avatar
|
avatar | string |
Pfad zum Bild auf Amazon s3. |
|
Gruppenarray
|
groups | array of object |
Liste aller Gruppen, zu der der Agent gehört. |
|
Gruppen-ID
|
groups.id | integer |
Eindeutige ID der Gruppe. |
|
Gruppenname
|
groups.name | string |
Name der Gruppe. |
|
Position
|
job_title | string |
Support-Agent standardmäßig. |
|
Email
|
login | string |
Die E-Mail-Adresse des Agents. |
|
Anmeldestatus
|
login_status | string |
Annehmen von Chats oder nicht annehmen von Chats. |
|
Max. Chatanzahl
|
max_chats_count | integer |
Grenzwert der gleichzeitigen Chats. |
|
Name
|
name | string |
Name des Agents. |
|
Erlaubnis
|
permission | string |
Besitzer, Administrator oder normal |
|
Der Status
|
status | string |
Annehmen von Chats, nicht Annehmen von Chats oder offline. |