LiveChat
LiveChat är en kundtjänstprogramvara online med livesupport, supportprogramvara och webbanalysfunktioner.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänster | Class | Regioner |
|---|---|---|
| Copilot Studio | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Norm | Alla Logic Apps-regioner utom följande: – Azure Government-regioner – Regioner i Azure Kina - US Department of Defense (DoD) |
| Power Apps | Premie | Alla Power Apps-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premie | Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Namn | Microsoft |
| URL | https://www.livechat.com/ |
| Metadata för anslutningsprogram | |
|---|---|
| Utgivare | Microsoft |
| Webbplats | https://www.livechat.com/ |
| Sekretesspolicy | https://www.livechat.com/legal/privacy-policy/ |
| Kategorier | Kommunikation |
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standardinställning | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Typ | Description | Krävs |
|---|---|---|---|
| Äldre entitets-ID (inaktuellt) | snöre | Entitets-ID (e-postadress) som endast används av inaktuella LiveChat API v2-åtgärder. | |
| Konto-ID | snöre | Konto-ID (GUID) som visas på sidan Personliga åtkomsttoken för LiveChat. Nya (V2) anslutningsåtgärder använder det här värdet med LiveChat API v3.6. | Sann |
| Personlig åtkomsttoken | securestring | Den fullständiga, okodade personliga åtkomsttoken för det här kontot. | Sann |
Begränsningsgränser
| Name | Anrop | Förnyelseperiod |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
Åtgärder
| Hämta biljett (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter. |
| Lista agenter (V2) |
Returnerar alla agenter i LiveChat-licensen med LiveChat API v3.6. Den personliga åtkomsttoken kräver agenterna – allt:ro-omfång. |
| Lista biljetter (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter. |
| Listagenter (inaktuella) [INAKTUELLA] |
Den här inaktuella åtgärden returnerar agenter med LiveChat API v2. Använd Listagenter (V2) i stället. |
| Skapa en ny agent (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden skapar en agent med LiveChat API v2. Använd Skapa en ny agent (V2) i stället. |
| Skapa en ny agent (V2) |
Skapar en agent med LiveChat API v3.6. Agenten kan kräva godkännande beroende på omfången för personlig åtkomsttoken och LiveChat-prenumerationen. |
| Skapa en ny biljett (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter. |
| Ta bort en agent (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden tar bort en agent med LiveChat API v2. Använd Ta bort en agent (V2) i stället. |
| Ta bort en agent (V2) |
Tar bort en agent med LiveChat API v3.6. För att ta bort en annan agent krävs agenterna --all:rw och accounts--all:rw scopes. |
| Uppdateringsbiljett (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter. |
Hämta biljett (inaktuell) [INAKTUELL]
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Biljett-ID
|
ticketId | True | string |
ID:t för biljetten |
Returer
- Body
- TicketResponse
Lista agenter (V2)
Returnerar alla agenter i LiveChat-licensen med LiveChat API v3.6. Den personliga åtkomsttoken kräver agenterna – allt:ro-omfång.
Returer
Agenterna i LiveChat-licensen.
- Föremål
- ListAgentsV2_Response
Lista biljetter (inaktuell) [INAKTUELL]
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter.
Returer
- Föremål
- ListTicketsResponse
Listagenter (inaktuella) [INAKTUELLA]
Den här inaktuella åtgärden returnerar agenter med LiveChat API v2. Använd Listagenter (V2) i stället.
Returer
Lista över alla agenter med deras information.
- Föremål
- ListAgents_Response
Skapa en ny agent (inaktuell) [INAKTUELL]
Den här inaktuella åtgärden skapar en agent med LiveChat API v2. Använd Skapa en ny agent (V2) i stället.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
E-postmeddelande
|
login | True | string | |
|
Namn
|
name | True | string | |
|
Inloggningsstatus
|
login_status | string | ||
|
Titel
|
job_title | string |
Standardvärdet är: Supportagent. |
|
|
Tillåtelse
|
permission | string | ||
|
Lösenord
|
password | string |
Minsta längd 5. |
|
|
Maximalt antal chattar
|
max_chats_count | string |
Gräns för samtidiga chattar. |
Returer
- Body
- CreateAgent_Response
Skapa en ny agent (V2)
Skapar en agent med LiveChat API v3.6. Agenten kan kräva godkännande beroende på omfången för personlig åtkomsttoken och LiveChat-prenumerationen.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
AgentID
|
id | True | string |
Agent-ID:t, vanligtvis agentens e-postadress. |
|
Namn
|
name | True | string |
Agentnamnet. |
|
Roll
|
role | string |
För att skapa en roll som är högre än normalt krävs omfånget accounts.roles.lc--all:rw. |
|
|
Inloggningsstatus
|
login_status | string | ||
|
Befattning
|
job_title | string | ||
|
Mobile
|
mobile | string | ||
|
Maximalt antal chattar
|
max_chats_count | integer | ||
|
Väntar på godkännande
|
awaiting_approval | boolean |
Om du ställer in detta på false krävs det privata omfånget subscription.lc:rw. |
|
|
grupp-id
|
id | True | integer | |
|
Priority
|
priority | True | string | |
|
Notifications
|
notifications | array of string | ||
|
E-postprenumerationer
|
email_subscriptions | array of string | ||
|
Tidszon
|
timezone | string |
Tidszonen som används av arbetsschemat. |
|
|
Dag
|
day | True | string | |
|
Enabled
|
enabled | True | boolean | |
|
Start
|
start | True | string | |
|
Sluta
|
end | True | string |
Skapa en ny biljett (inaktuell) [INAKTUELL]
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
Beställarens e-post
|
True | string | ||
|
Beställarens namn
|
name | string | ||
|
Ämne
|
subject | string | ||
|
Tilldelnings-ID
|
id | string | ||
|
Källtyp
|
type | string |
Välj en källa |
|
|
Käll-URL
|
url | string |
Om källtypen är chattfönster. |
Returer
- Body
- TicketResponse
Ta bort en agent (inaktuell) [INAKTUELL]
Den här inaktuella åtgärden tar bort en agent med LiveChat API v2. Använd Ta bort en agent (V2) i stället.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
E-postmeddelande
|
login | True | string |
E-postmeddelandet till agenten. |
Returer
- Body
- DeleteAgent_Response
Ta bort en agent (V2)
Tar bort en agent med LiveChat API v3.6. För att ta bort en annan agent krävs agenterna --all:rw och accounts--all:rw scopes.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
AgentID
|
id | True | string |
ID:t för agenten som ska ta bort. |
Uppdateringsbiljett (inaktuell) [INAKTUELL]
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Biljett-ID
|
ticketId | True | string |
ID:t för biljetten |
|
Message
|
message | string | ||
|
Beställarens e-post
|
True | string | ||
|
Beställarens namn
|
name | string | ||
|
Ämne
|
subject | string | ||
|
Tilldelnings-ID
|
id | string |
Välj en tilldelare. |
|
|
Källtyp
|
type | string |
Välj en källa. |
|
|
Käll-URL
|
url | string |
Om källtypen är chattfönster. |
Returer
- Body
- TicketResponse
Utlösare
| När en biljett skapas (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter. |
| När en chatt slutar (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden använder LiveChat API v2. |
| När en chatt startar (inaktuell) [INAKTUELL] |
Den här inaktuella åtgärden använder LiveChat API v2. |
När en biljett skapas (inaktuell) [INAKTUELL]
Den här inaktuella åtgärden använder api:et för indragna LiveChat-biljetter.
Returer
När en chatt slutar (inaktuell) [INAKTUELL]
När en chatt startar (inaktuell) [INAKTUELL]
Definitioner
WebhookChatResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
E-post för agent
|
chat.agents.login | string |
E-postadress till agenten. |
|
Agentnamn
|
chat.agents.name | string |
Agentens namn. |
|
Tidsstämpel för avslutade
|
chat.ended_timestamp | string |
åååå-MM-ddTHH:mm:ss.fffZ |
|
events
|
chat.events | array of object |
Matris med händelser. |
|
Händelsetext
|
chat.events.text | string |
Meddelande som är associerat med händelsen. |
|
Händelse Date-Time
|
chat.events.timestamp | string |
åååå-MM-ddTHH:mm:ss.fffZ |
|
Händelsetyp
|
chat.events.type | string |
Typ av händelse. |
|
Händelseanvändartyp
|
chat.events.user_type | string |
Typ av användare. |
|
groups
|
chat.groups | array of integer | |
|
Grupp-ID
|
chat.id | string |
Unik identifierare för gruppen. |
|
Message
|
chat.messages | array of object |
Matris med meddelanden. |
|
Agent-ID
|
chat.messages.agent_id | string |
Unikt ID för agenten som är associerad med meddelandet. |
|
Författarens namn
|
chat.messages.author_name | string |
Namnet på meddelandets författare.. |
|
Text
|
chat.messages.text | string |
Meddelandets brödtext. |
|
Skickade Date-Time
|
chat.messages.timestamp | string |
åååå-MM-ddTHH:mm:ss.fffZ |
|
Användartyp
|
chat.messages.user_type | string |
Typ av användare som skickar meddelandet. |
|
Startade Date-Time
|
chat.started_timestamp | string |
åååå-MM-ddTHH:mm:ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
URL
|
chat.url | string |
Url till webbplatsen där chatten startades. |
|
Händelse-ID
|
event_unique_id | string |
Unikt ID för händelsen som är associerad med chatten. |
|
Undersökning före chatt
|
pre_chat_survey | array of object |
Matris med enkätsvar före chatt. |
|
Answer
|
pre_chat_survey.answer | string |
Undersökningssvar. |
|
Undersöknings-ID
|
pre_chat_survey.id | string |
Undersöknings-ID före chatt. |
|
Question
|
pre_chat_survey.label | string |
Undersökningsfråga. |
|
E-postmeddelande
|
visitor.email | string |
Besökarens e-postadress. |
|
Id
|
visitor.id | string |
Besökarens unika ID. |
|
Language
|
visitor.language | string |
Språk som är associerat med besökarens konto. |
|
Namn
|
visitor.name | string |
Namnet på besökaren. |
|
Sida
|
visitor.page_current | string |
Webbsida som chatten kommer från. |
WebhookTicketResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Id
|
ticket.assignee.id | string |
Unik identifierare för användaren. |
|
Namn
|
ticket.assignee.name | string |
Namnet på tilldelningsobjektet. |
|
events
|
ticket.events | array of object | |
|
Id
|
ticket.events.author.id | string |
Unikt ID för användaren. |
|
Namn
|
ticket.events.author.name | string |
Författarens namn. |
|
Typ
|
ticket.events.author.type | string |
Agent eller klient. |
|
Händelse Date-Time
|
ticket.events.date | date-time |
åååå-MM-ddTHH:mm:ss.fffZ |
|
Är privat
|
ticket.events.is_private | boolean |
Sant om händelsen är privat. |
|
Message
|
ticket.events.message | string |
Beskrivning av händelsen. |
|
Typ
|
ticket.events.source.type | string |
Chattfönster, e-post eller lc2. |
|
URL
|
ticket.events.source.url | string |
Url till webbplatsen som biljetten skickades från. |
|
Händelsetyp
|
ticket.events.type | string |
Typ av händelse som genererade biljetten. |
|
Grupp
|
ticket.groups | array of object |
Information om den associerade gruppen. |
|
Id
|
ticket.groups.id | integer |
Unikt ID för gruppen. |
|
Namn
|
ticket.groups.name | string |
Gruppens namn. |
|
Biljett-ID
|
ticket.id | string |
Unikt ID för biljetten. |
|
IP
|
ticket.requester.ip | string |
IP-adressen för beställaren. |
|
E-postmeddelande
|
ticket.requester.mail | string |
Avsändarens e-postadress. |
|
Namn
|
ticket.requester.name | string |
Namnet på beställaren. |
|
Id
|
ticket.source.id | string |
Unikt ID för källan. |
|
Typ
|
ticket.source.type | string |
Lc2, mail, facebook, agent-app-manual eller chat-window. |
|
URL
|
ticket.source.url | string |
Url till webbplatsen där biljetten skapades. |
|
Läge
|
ticket.status | string |
Öppna, väntande, löst eller skräppost. |
|
Ämne
|
ticket.subject | string |
Kort beskrivning av biljetten. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Skapade Date-Time
|
date | date-time |
åååå-MM-ddTHH:mm:ss.fffZ |
|
Biljett-ID
|
id | string |
Unik identifierare för biljetten. |
|
Ändrad Date-Time
|
modified | date-time |
åååå-MM-ddTHH:mm:ss.fffZ |
|
IP
|
requester.ip | string |
IP-adressen för beställaren. |
|
E-postmeddelande
|
requester.mail | string |
Avsändarens e-postadress. |
|
Namn
|
requester.name | string |
Det fullständiga namnet på beställaren. |
|
Id
|
source.id | string |
Unik identifierare för källan. |
|
Typ
|
source.type | string |
Från chatt, e-post eller lc2. |
|
URL
|
source.url | string |
Webbsida där biljetten skapades. |
|
Läge
|
status | string |
Öppna, väntande, löst eller skräppost. |
|
Ämne
|
subject | string |
Beskrivning av biljettkällan. |
TicketResponse
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Id
|
currentGroup.id | integer |
Unikt ID för gruppen. |
|
Namn
|
currentGroup.name | string |
Gruppens namn. |
|
Skapade Date-Time
|
date | date-time |
åååå-MM-ddTHH:mm:ss.fffZ |
|
events
|
events | array of object | |
|
Id
|
events.author.id | string |
Unikt ID för användaren. |
|
Namn
|
events.author.name | string |
Författarens namn. |
|
Typ
|
events.author.type | string |
Agent eller klient. |
|
Händelse Date-Time
|
events.date | date-time |
åååå-MM-ddTHH:mm:ss.fffZ |
|
Är privat
|
events.is_private | boolean |
Sant om händelsen är privat. |
|
Message
|
events.message | string |
Beskrivning av händelsen. |
|
Typ
|
events.source.type | string |
Chattfönster, e-post eller lc2. |
|
URL
|
events.source.url | string |
Url till webbplatsen som biljetten skickades från. |
|
Händelsetyp
|
events.type | string |
Typ av händelse som genererade biljetten. |
|
Grupp
|
groups | array of object |
Information om den associerade gruppen. |
|
Id
|
groups.id | integer |
Unikt ID för gruppen. |
|
Namn
|
groups.name | string |
Gruppens namn. |
|
Biljett-ID
|
id | string |
Unikt ID för biljetten. |
|
IP
|
requester.ip | string |
IP-adressen för beställaren. |
|
E-postmeddelande
|
requester.mail | string |
Avsändarens e-postadress. |
|
Namn
|
requester.name | string |
Namnet på beställaren. |
|
Id
|
source.id | string |
Unikt ID för källan. |
|
Typ
|
source.type | string |
Lc2, mail, facebook, agent-app-manual eller chat-window. |
|
URL
|
source.url | string |
Url till webbplatsen där biljetten skapades. |
|
Läge
|
status | string |
Öppna, väntande, löst eller skräppost. |
|
Ämne
|
subject | string |
Kort beskrivning av biljetten. |
|
tags
|
tags | array of string |
ListAgentsV2_Response
Agenterna i LiveChat-licensen.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Föremål
|
AgentV2 |
AgentV2
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
AgentID
|
id | string |
Agent-ID:t, vanligtvis agentens e-postadress. |
|
Namn
|
name | string |
Agentnamnet. |
|
Avatar
|
avatar | string |
Agentens avatar-URL. |
|
Roll
|
role | string |
Agentrollen. |
|
Inloggningsstatus
|
login_status | string |
Status för agentinloggning. |
|
Befattning
|
job_title | string |
Agentjobbets titel. |
|
Mobile
|
mobile | string |
Agentens mobilnummer. |
|
Maximalt antal chattar
|
max_chats_count | integer |
Maximalt antal samtidiga chattar. |
|
Avstängd
|
suspended | boolean |
Om agenten är avstängd. |
|
Väntar på godkännande
|
awaiting_approval | boolean |
Om agenten väntar på godkännande. |
|
groups
|
groups | array of AgentGroupV2 |
De grupper som tilldelats agenten. |
AgentGroupV2
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
grupp-id
|
id | integer | |
|
Priority
|
priority | string |
ListAgents_Response
Lista över alla agenter med deras information.
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Avatar
|
avatar | string |
Sökväg till bilden på Amazon s3. |
|
E-post för inloggning
|
login | string |
Agentens e-postadress. |
|
Namn
|
name | string |
Agentens namn. |
|
Tillåtelse
|
permission | string |
Ägare, administratör eller normal. |
CreateAgent_Response
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Avatar
|
avatar | string |
Sökväg till bilden på Amazon s3. |
|
Matris för grupper
|
groups | array of object |
Lista över alla grupper som agenten ingår i. |
|
Grupp-ID
|
groups.id | integer |
Unikt ID för gruppen. |
|
Gruppnamn
|
groups.name | string |
Gruppens namn. |
|
Befattning
|
job_title | string |
Supportagent som standard. |
|
E-postmeddelande
|
login | string |
Agentens e-postadress. |
|
Inloggningsstatus
|
login_status | string |
Acceptera chattar eller inte acceptera chattar. |
|
Maximalt antal chattar
|
max_chats_count | integer |
Gräns för samtidiga chattar. |
|
Namn
|
name | string |
Agentens namn. |
|
Tillåtelse
|
permission | string |
Ägare, administratör eller normal |
|
Läge
|
status | string |
Acceptera chattar, acceptera inte chattar eller offline. |