라이브 채팅
LiveChat은 라이브 지원, 지원 센터 소프트웨어 및 웹 분석 기능을 갖춘 온라인 고객 서비스 소프트웨어입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://www.livechat.com/ |
| 개인 정보 보호 정책 | https://www.livechat.com/legal/privacy-policy/ |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 사용자 이름 | 문자열 | 이 계정의 전자 메일 주소 | 진실 |
| API 키 | 시큐어스트링 (보안 문자열) | 이 계정의 API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 새 에이전트 만들기 |
이 작업은 LiveChat 계정에 새 에이전트를 추가하는 데 사용됩니다. |
| 새 티켓 만들기 |
이 작업은 LiveChat 계정에 새 티켓을 추가하는 데 사용됩니다. |
| 에이전트 제거 |
이 작업은 LiveChat 계정에서 에이전트를 삭제하는 데 사용됩니다. |
| 에이전트를 나열하다 |
이 작업은 LiveChat 계정의 모든 에이전트 목록을 반환합니다. |
| 티켓 가져오기 |
이 작업은 LiveChat 계정에서 특정 티켓의 세부 정보를 가져오는 데 사용됩니다. |
| 티켓 나열 |
이 작업은 LiveChat 계정의 티켓 목록을 반환합니다. |
| 티켓 업데이트 |
이 작업은 LiveChat 계정에서 기존 티켓의 세부 정보를 업데이트하는 데 사용됩니다. |
새 에이전트 만들기
이 작업은 LiveChat 계정에 새 에이전트를 추가하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전자 메일
|
login | True | string | |
|
이름
|
name | True | string | |
|
로그인 상태
|
login_status | string | ||
|
제목
|
job_title | string |
기본값: 지원 에이전트. |
|
|
허가
|
permission | string | ||
|
암호
|
password | string |
최소 길이 5. |
|
|
최대 채팅 수
|
max_chats_count | string |
동시 채팅의 제한입니다. |
반환
새 티켓 만들기
이 작업은 LiveChat 계정에 새 티켓을 추가하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
요청자의 전자 메일
|
True | string | ||
|
요청자의 이름
|
name | string | ||
|
주제
|
subject | string | ||
|
담당자 ID
|
id | string | ||
|
원본 유형
|
type | string |
원본 선택 |
|
|
원본 URL
|
url | string |
원본 유형이 채팅 창인 경우 |
반환
에이전트 제거
이 작업은 LiveChat 계정에서 에이전트를 삭제하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전자 메일
|
login | True | string |
에이전트의 이메일입니다. |
반환
에이전트를 나열하다
티켓 가져오기
이 작업은 LiveChat 계정에서 특정 티켓의 세부 정보를 가져오는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
티켓 ID
|
ticketId | True | string |
티켓의 ID입니다. |
반환
티켓 나열
티켓 업데이트
이 작업은 LiveChat 계정에서 기존 티켓의 세부 정보를 업데이트하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
티켓 ID
|
ticketId | True | string |
티켓의 ID입니다. |
|
Message
|
message | string | ||
|
요청자의 전자 메일
|
True | string | ||
|
요청자의 이름
|
name | string | ||
|
주제
|
subject | string | ||
|
담당자 ID
|
id | string |
담당자를 선택합니다. |
|
|
원본 유형
|
type | string |
원본을 선택합니다. |
|
|
원본 URL
|
url | string |
원본 유형이 채팅 창인 경우 |
반환
트리거
| 채팅이 시작되는 경우 |
이 작업은 새 채팅이 시작될 때 트리거됩니다. |
| 채팅이 종료되는 경우 |
이 작업은 채팅이 종료되면 트리거됩니다. |
| 티켓이 만들어지는 경우 |
이 작업은 새 티켓이 추가되면 트리거됩니다. |
채팅이 시작되는 경우
채팅이 종료되는 경우
티켓이 만들어지는 경우
정의
WebhookChatResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
에이전트 전자 메일
|
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 |
메시지 작성자의 이름입니다. |
|
문자 메시지
|
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입니다. |
|
Question
|
pre_chat_survey.label | string |
설문 조사 질문. |
|
전자 메일
|
visitor.email | string |
방문자의 전자 메일 주소입니다. |
|
아이디
|
visitor.id | string |
방문자의 고유 ID입니다. |
|
Language
|
visitor.language | string |
방문자 계정과 연결된 언어입니다. |
|
이름
|
visitor.name | string |
방문자의 이름입니다. |
|
페이지
|
visitor.page_current | string |
채팅이 시작된 웹 페이지입니다. |
WebhookTicketResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
ticket.assignee.id | string |
사용자의 고유 식별자입니다. |
|
이름
|
ticket.assignee.name | string |
담당자의 이름입니다. |
|
events
|
ticket.events | array of object | |
|
아이디
|
ticket.events.author.id | string |
사용자의 고유 ID입니다. |
|
이름
|
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 |
True이면 이벤트가 비공개입니다. |
|
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 |
연결된 그룹의 세부 정보입니다. |
|
아이디
|
ticket.groups.id | integer |
그룹의 고유 ID입니다. |
|
이름
|
ticket.groups.name | string |
그룹의 이름입니다. |
|
티켓 ID
|
ticket.id | string |
티켓의 고유 ID입니다. |
|
IP
|
ticket.requester.ip | string |
요청자의 IP 주소입니다. |
|
전자 메일
|
ticket.requester.mail | string |
요청자의 이메일 주소입니다. |
|
이름
|
ticket.requester.name | string |
요청자의 이름입니다. |
|
아이디
|
ticket.source.id | string |
원본의 고유 ID입니다. |
|
유형
|
ticket.source.type | string |
Lc2, 메일, facebook, agent-app-manual 또는 채팅 창. |
|
URL
|
ticket.source.url | string |
티켓을 만든 웹 사이트의 URL입니다. |
|
상태
|
ticket.status | string |
열기, 보류 중, 해결 또는 스팸. |
|
주제
|
ticket.subject | string |
티켓에 대한 간단한 설명입니다. |
|
tags
|
ticket.tags | array of string |
ListTicketsResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
만든 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 주소입니다. |
|
전자 메일
|
requester.mail | string |
요청자의 이메일 주소입니다. |
|
이름
|
requester.name | string |
요청자의 전체 이름입니다. |
|
아이디
|
source.id | string |
원본의 고유 식별자입니다. |
|
유형
|
source.type | string |
채팅, 메일 또는 lc2에서 |
|
URL
|
source.url | string |
티켓을 만든 웹 페이지입니다. |
|
상태
|
status | string |
열기, 보류 중, 해결 또는 스팸. |
|
주제
|
subject | string |
티켓 원본에 대한 설명입니다. |
TicketResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
currentGroup.id | integer |
그룹의 고유 ID입니다. |
|
이름
|
currentGroup.name | string |
그룹의 이름입니다. |
|
만든 Date-Time
|
date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
events
|
events | array of object | |
|
아이디
|
events.author.id | string |
사용자의 고유 ID입니다. |
|
이름
|
events.author.name | string |
작성자의 이름입니다. |
|
유형
|
events.author.type | string |
에이전트 또는 클라이언트. |
|
이벤트 Date-Time
|
events.date | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
|
비공개임
|
events.is_private | boolean |
True이면 이벤트가 비공개입니다. |
|
Message
|
events.message | string |
이벤트에 대한 설명입니다. |
|
유형
|
events.source.type | string |
채팅 창, 메일 또는 lc2. |
|
URL
|
events.source.url | string |
티켓이 전송된 웹 사이트의 URL입니다. |
|
이벤트 유형
|
events.type | string |
티켓을 생성한 이벤트의 유형입니다. |
|
그룹
|
groups | array of object |
연결된 그룹의 세부 정보입니다. |
|
아이디
|
groups.id | integer |
그룹의 고유 ID입니다. |
|
이름
|
groups.name | string |
그룹의 이름입니다. |
|
티켓 ID
|
id | string |
티켓의 고유 ID입니다. |
|
IP
|
requester.ip | string |
요청자의 IP 주소입니다. |
|
전자 메일
|
requester.mail | string |
요청자의 이메일 주소입니다. |
|
이름
|
requester.name | string |
요청자의 이름입니다. |
|
아이디
|
source.id | string |
원본의 고유 ID입니다. |
|
유형
|
source.type | string |
Lc2, 메일, facebook, agent-app-manual 또는 채팅 창. |
|
URL
|
source.url | string |
티켓을 만든 웹 사이트의 URL입니다. |
|
상태
|
status | string |
열기, 보류 중, 해결 또는 스팸. |
|
주제
|
subject | string |
티켓에 대한 간단한 설명입니다. |
|
tags
|
tags | array of string |
ListAgents_Response
세부 정보가 포함된 모든 에이전트 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아바타
|
avatar | string |
Amazon s3의 이미지 경로입니다. |
|
로그인 전자 메일
|
login | string |
에이전트의 이메일 주소입니다. |
|
이름
|
name | string |
에이전트의 이름입니다. |
|
허가
|
permission | string |
소유자, 관리자 또는 일반. |
CreateAgent_Response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아바타
|
avatar | string |
Amazon s3의 이미지 경로입니다. |
|
그룹 배열
|
groups | array of object |
에이전트가 속한 모든 그룹 목록입니다. |
|
그룹 ID
|
groups.id | integer |
그룹의 고유 ID입니다. |
|
그룹 이름
|
groups.name | string |
그룹의 이름입니다. |
|
직위
|
job_title | string |
기본적으로 지원 에이전트입니다. |
|
전자 메일
|
login | string |
에이전트의 이메일 주소입니다. |
|
로그인 상태
|
login_status | string |
채팅을 수락하거나 채팅을 수락하지 않습니다. |
|
최대 채팅 수
|
max_chats_count | integer |
동시 채팅의 제한입니다. |
|
이름
|
name | string |
에이전트의 이름입니다. |
|
허가
|
permission | string |
소유자, 관리자 또는 일반 |
|
상태
|
status | string |
채팅을 수락하거나 채팅을 수락하거나 오프라인으로 수락하지 않습니다. |