实时聊天（LiveChat）

LiveChat 是一种在线客户服务软件，提供实时支持、技术支持软件和 Web 分析功能。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	Microsoft
URL	Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持

连接器元数据
发布者	Microsoft
网站	https://www.livechat.com/
隐私策略	https://www.livechat.com/legal/privacy-policy/

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
用户名	字符串	此帐户的电子邮件地址	True
API 密钥	securestring	此帐户的 API 密钥	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

列出代理	此作返回 LiveChat 帐户中所有代理的列表。
列出票证	此作返回 LiveChat 帐户中的票证列表。
创建新代理	此作用于向 LiveChat 帐户添加新代理。
创建新票证	此作用于向 LiveChat 帐户添加新票证。
删除代理	此作用于从 LiveChat 帐户中删除代理。
更新票证	此作用于更新 LiveChat 帐户中现有票证的详细信息。
获取票证	此作用于提取 LiveChat 帐户中特定票证的详细信息。

列出代理

操作 ID:: ListAgents

此作返回 LiveChat 帐户中所有代理的列表。

包含其详细信息的所有代理的列表。

物品: ListAgents_Response

列出票证

操作 ID:: ListTickets

此作返回 LiveChat 帐户中的票证列表。

物品: ListTicketsResponse

创建新代理

操作 ID:: CreateAgent

此作用于向 LiveChat 帐户添加新代理。

参数

名称	密钥	必需	类型	说明
Email	login	True	string
Name	name	True	string
登录状态	login_status		string
Title	job_title		string	默认值为：支持代理。
许可	permission		string
密码	password		string	最小长度 5.
最大聊天计数	max_chats_count		string	并发聊天的限制。

Body: CreateAgent_Response

创建新票证

操作 ID:: CreateTicket

此作用于向 LiveChat 帐户添加新票证。

参数

名称	密钥	必需	类型	说明
Message	message	True	string
请求者的电子邮件	mail	True	string
请求者的姓名	name		string
Subject	subject		string
被分配者 ID	id		string
源类型	type		string	选取源
源 URL	url		string	如果源类型为聊天窗口。

Body: TicketResponse

删除代理

操作 ID:: DeleteAgent

此作用于从 LiveChat 帐户中删除代理。

参数

名称	密钥	必需	类型	说明
Email	login	True	string	代理的电子邮件。

Body: DeleteAgent_Response

更新票证

操作 ID:: UpdateTicket

此作用于更新 LiveChat 帐户中现有票证的详细信息。

参数

名称	密钥	必需	类型	说明
票证 ID	ticketId	True	string	票证的 ID
Message	message		string
请求者的电子邮件	mail	True	string
请求者的姓名	name		string
Subject	subject		string
被分配者 ID	id		string	选取被分配者。
源类型	type		string	选取源。
源 URL	url		string	如果源类型为聊天窗口。

Body: TicketResponse

获取票证

操作 ID:: GetTicket

此作用于提取 LiveChat 帐户中特定票证的详细信息。

参数

名称	密钥	必需	类型	说明
票证 ID	ticketId	True	string	票证的 ID

Body: TicketResponse

触发器

创建票证时	添加新票证时，此作将触发。
聊天启动时	此作会在新聊天启动时触发。
聊天结束时	此作在聊天结束时触发。

创建票证时

操作 ID:: WebhookTicketCreated

添加新票证时，此作将触发。

Body: WebhookTicketResponse

聊天启动时

操作 ID:: WebhookChatStarted

此作会在新聊天启动时触发。

Body: WebhookChatResponse

聊天结束时

操作 ID:: WebhookChatEnded

此作在聊天结束时触发。

Body: WebhookChatResponse

定义

WebhookChatResponse

名称	路径	类型	说明
代理	chat.agents	array of object	代理
代理电子邮件	chat.agents.login	string	代理的电子邮件地址。
代理名称	chat.agents.name	string	代理的名称。
结束时间戳	chat.ended_timestamp	string	yyyy-MM-ddTHH：mm：ss.fffZ
events	chat.events	array of object	事件数组。
事件文本	chat.events.text	string	与事件关联的消息。
事件 Date-Time	chat.events.timestamp	string	yyyy-MM-ddTHH：mm：ss.fffZ
事件类型	chat.events.type	string	事件类型。
事件用户类型	chat.events.user_type	string	用户类型。
groups	chat.groups	array of integer
组 ID	chat.id	string	组的唯一标识符。
Message	chat.messages	array of object	消息数组。
代理 ID	chat.messages.agent_id	string	与消息关联的代理的唯一 ID。
作者名称	chat.messages.author_name	string	消息的 author.
文本	chat.messages.text	string	消息正文。
已发送 Date-Time	chat.messages.timestamp	string	yyyy-MM-ddTHH：mm：ss.fffZ
用户类型	chat.messages.user_type	string	发送消息的用户的类型。
已启动 Date-Time	chat.started_timestamp	string	yyyy-MM-ddTHH：mm：ss.fffZ
tags	chat.tags	array of string
URL	chat.url	string	聊天开始的网站 URL。
事件 ID	event_unique_id	string	与聊天关联的事件的唯一 ID。
聊天前调查	pre_chat_survey	array of object	聊天前调查响应的数组。
答案	pre_chat_survey.answer	string	调查答案。
调查 ID	pre_chat_survey.id	string	预聊天调查 ID。
问题	pre_chat_survey.label	string	调查问题。
Email	visitor.email	string	访问者的电子邮件地址。
Id	visitor.id	string	访问者的唯一 ID。
语言	visitor.language	string	与访问者帐户关联的语言。
Name	visitor.name	string	访问者的名称。
页	visitor.page_current	string	聊天源自的网页。

WebhookTicketResponse

名称	路径	类型	说明
Id	ticket.assignee.id	string	用户的唯一标识符。
Name	ticket.assignee.name	string	被分配者的名称。
events	ticket.events	array of object
Id	ticket.events.author.id	string	用户的唯一 ID。
Name	ticket.events.author.name	string	作者的名称。
类型	ticket.events.author.type	string	代理或客户端。
事件 Date-Time	ticket.events.date	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
专用	ticket.events.is_private	boolean	如此如果事件是私有的。
Message	ticket.events.message	string	事件的说明。
类型	ticket.events.source.type	string	聊天窗口、邮件或 lc2。
URL	ticket.events.source.url	string	从中发送票证的网站 URL。
事件类型	ticket.events.type	string	生成票证的事件的类型。
组	ticket.groups	array of object	关联组的详细信息。
Id	ticket.groups.id	integer	组的唯一 ID。
Name	ticket.groups.name	string	组名称。
票证 ID	ticket.id	string	票证的唯一 ID。
IP	ticket.requester.ip	string	请求者的 IP 地址。
Email	ticket.requester.mail	string	请求者的电子邮件地址。
Name	ticket.requester.name	string	请求者的名称。
Id	ticket.source.id	string	源的唯一 ID。
类型	ticket.source.type	string	Lc2、mail、facebook、agent-app-manual 或 chat-window。
URL	ticket.source.url	string	创建票证的网站 URL。
状态	ticket.status	string	打开、挂起、已解决或垃圾邮件。
Subject	ticket.subject	string	票证的简短说明。
tags	ticket.tags	array of string

ListTicketsResponse

名称	路径	类型	说明
已创建 Date-Time	date	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
票证 ID	id	string	票证的唯一标识符。
修改后的 Date-Time	modified	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
IP	requester.ip	string	请求者的 IP 地址。
Email	requester.mail	string	请求者的电子邮件地址。
Name	requester.name	string	请求者的全名。
Id	source.id	string	源的唯一标识符。
类型	source.type	string	从聊天、邮件或 lc2。
URL	source.url	string	创建票证的网页。
状态	status	string	打开、挂起、已解决或垃圾邮件。
Subject	subject	string	票证源的说明。

TicketResponse

名称	路径	类型	说明
Id	currentGroup.id	integer	组的唯一 ID。
Name	currentGroup.name	string	组名称。
已创建 Date-Time	date	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
events	events	array of object
Id	events.author.id	string	用户的唯一 ID。
Name	events.author.name	string	作者的名称。
类型	events.author.type	string	代理或客户端。
事件 Date-Time	events.date	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
专用	events.is_private	boolean	如此如果事件是私有的。
Message	events.message	string	事件的说明。
类型	events.source.type	string	聊天窗口、邮件或 lc2。
URL	events.source.url	string	从中发送票证的网站 URL。
事件类型	events.type	string	生成票证的事件的类型。
组	groups	array of object	关联组的详细信息。
Id	groups.id	integer	组的唯一 ID。
Name	groups.name	string	组名称。
票证 ID	id	string	票证的唯一 ID。
IP	requester.ip	string	请求者的 IP 地址。
Email	requester.mail	string	请求者的电子邮件地址。
Name	requester.name	string	请求者的名称。
Id	source.id	string	源的唯一 ID。
类型	source.type	string	Lc2、mail、facebook、agent-app-manual 或 chat-window。
URL	source.url	string	创建票证的网站 URL。
状态	status	string	打开、挂起、已解决或垃圾邮件。
Subject	subject	string	票证的简短说明。
tags	tags	array of string

ListAgents_Response