다음을 통해 공유

HubSpot 대화 V2(독립 게시자)(미리 보기)

HubSpot 대화 서비스를 사용하면 대화 받은 편지함, 채널 및 메시지를 관리하고 상호 작용할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 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)
연락처
이름 트로이 테일러
URL https://www.hitachisolutions.com
전자 메일 ttaylor@hitachisolutions.com
커넥터 메타데이터
게시자 트로이 테일러
웹 사이트 https://www.hubspot.com/products/crm/conversations
개인 정보 보호 정책 https://legal.hubspot.com/privacy-policy
카테고리 마케팅; 판매 및 CRM

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
액세스 토큰('전달자 YOUR_ACCESS_TOKEN' 형식) 시큐어스트링 (보안 문자열) 이 api에 대한 액세스 토큰('전달자 YOUR_ACCESS_TOKEN' 형식) 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

단일 대화 받은 편지함 가져오기

단일 대화 받은 편지함을 검색합니다.
단일 메시지 가져오기

단일 메시지를 검색합니다.
단일 메시지의 원래 콘텐츠 가져오기

메시지의 전체 원본 텍스트와 서식 있는 텍스트 본문을 반환합니다. 메시지의 truncationStatus가 NOT_TRUNCATED 이외의 경우 메시지 자체의 텍스트 및 서식 있는 텍스트와 다릅니다.
단일 스레드 가져오기

단일 스레드를 검색합니다.
단일 채널 가져오기

단일 채널을 검색합니다.
단일 채널 계정 가져오기

단일 채널 계정을 검색합니다.
단일 행위자 가져오기

단일 행위자를 검색합니다.
대화 받은 편지함 가져오기

대화 받은 편지함 목록을 검색합니다.
스레드 가져오기

스레드 목록을 검색합니다.
스레드 보관

단일 스레드를 보관합니다. 스레드는 보관된 상태로 배치된 후 30일 후에 영구적으로 삭제됩니다.
스레드 업데이트

단일 스레드를 업데이트합니다. 스레드 상태를 업데이트하거나 스레드를 복원할 수 있습니다.
스레드에 대한 메시지 기록 가져오기

스레드에 대한 메시지 기록 목록을 검색합니다.
스레드에 메시지 보내기

현재 타임스탬프의 스레드에 새 메시지를 보냅니다.
채널 가져오기

채널 목록을 검색합니다.
채널 계정 가져오기

채널 계정 목록을 검색합니다.
토큰 생성

새 방문자 식별 토큰을 생성합니다. 이 토큰은 동일한 전자 메일 주소로 호출되더라도 이 엔드포인트가 호출될 때마다 고유합니다. 이 토큰은 일시적이며 12시간 후에 만료됩니다.
행위자 가져오기

행위자 식별자를 기본 행위자 및 참가자로 확인합니다.

단일 대화 받은 편지함 가져오기

작업 ID:
GetASingleConversationsInbox

단일 대화 받은 편지함을 검색합니다.

매개 변수

Name 키 필수 형식 Description
받은 편지함 ID
 inboxId True string

받은 편지함 식별자입니다.

반환

Name 경로 형식 Description
아이디
 id string

식별자입니다.
이름
 name string

이름입니다.
만든 위치에서
 createdAt string

만들 때입니다.
업데이트 날짜
 updatedAt string

업데이트 시.

단일 메시지 가져오기

작업 ID:
GetASingleMessage

단일 메시지를 검색합니다.

매개 변수

Name 키 필수 형식 Description
property
 property string

속성입니다.
스레드 ID
 threadId True string

스레드 식별자입니다.
메시지 ID
 messageId True string

메시지 식별자입니다.

반환

Name 경로 형식 Description
가치
 value string

값입니다.

단일 메시지의 원래 콘텐츠 가져오기

작업 ID:
GetTheOriginalContentOfASingleMessage

메시지의 전체 원본 텍스트와 서식 있는 텍스트 본문을 반환합니다. 메시지의 truncationStatus가 NOT_TRUNCATED 이외의 경우 메시지 자체의 텍스트 및 서식 있는 텍스트와 다릅니다.

매개 변수

Name 키 필수 형식 Description
property
 property string

속성입니다.
스레드 ID
 threadId True string

스레드 식별자입니다.
메시지 ID
 messageId True string

메시지 식별자입니다.

반환

Name 경로 형식 Description
문자 메시지
 text string

텍스트입니다.
서식 있는 텍스트
 richText string

릭 텍스트입니다.

단일 스레드 가져오기

작업 ID:
GetASingleThread

단일 스레드를 검색합니다.

매개 변수

Name 키 필수 형식 Description
Archived
 archived boolean

보관 여부입니다.
property
 property string

속성입니다.
스레드 ID
 threadId True string

스레드 식별자입니다.

반환

Name 경로 형식 Description
연결된 연락처 ID
 associatedContactId string

연결된 연락처 식별자입니다.
만든 위치에서
 createdAt string

만들 때입니다.
아이디
 id string

식별자입니다.
받은 편지함 ID
 inboxId string

받은 편지함 식별자입니다.
스팸
 spam boolean

스팸입니다.
상태
 status string

상태입니다.
닫힘
 closedAt string

닫힌 경우.
최신 메시지 타임스탬프
 latestMessageTimestamp string

최신 메시지 타임스탬프입니다.
최신 메시지 전송 타임스탬프
 latestMessageSentTimestamp string

타임스탬프를 보낸 최신 메시지입니다.
최신 메시지 수신 타임스탬프
 latestMessageReceivedTimestamp string

최신 메시지가 타임스탬프를 받았습니다.
Assigned To
 assignedTo string

할당된 대상입니다.
Archived
 archived boolean

보관 여부입니다.

단일 채널 가져오기

작업 ID:
GetASingleChannel

단일 채널을 검색합니다.

매개 변수

Name 키 필수 형식 Description
채널 ID
 channelId True string

채널 식별자입니다.

반환

Name 경로 형식 Description
아이디
 id string

식별자입니다.
이름
 name string

이름입니다.

단일 채널 계정 가져오기

작업 ID:
GetASingleChannelAccount

단일 채널 계정을 검색합니다.

매개 변수

Name 키 필수 형식 Description
채널 계정 ID
 channelAccountId True string

채널 계정 식별자입니다.

반환

Name 경로 형식 Description
아이디
 id string

식별자입니다.
채널 ID
 channelId string

채널 식별자입니다.
이름
 name string

이름입니다.
받은 편지함 ID
 inboxId string

받은 편지함 식별자입니다.
Active
 active boolean

활성 상태인지 여부입니다.
권한을 부여받은
 authorized boolean

권한 있는지 여부입니다.
만든 위치에서
 createdAt string

만들 때입니다.
유형
 deliveryIdentifier.type string

형식입니다.
가치
 deliveryIdentifier.value string

값입니다.

단일 행위자 가져오기

작업 ID:
GetASingleActor

단일 행위자를 검색합니다.

매개 변수

Name 키 필수 형식 Description
property
 property string

속성입니다.
행위자 ID
 actorId True string

행위자 식별자입니다.

반환

Name 경로 형식 Description
아이디
 id string

식별자입니다.
유형
 type string

형식입니다.
이름
 name string

이름입니다.
전자 메일
 email string

전자 메일 주소입니다.
아바타
 avatar string

아바타입니다.

대화 받은 편지함 가져오기

작업 ID:
GetConversationsInboxes

대화 받은 편지함 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
이후
after string

After 링크입니다.
한계
 limit string

응답 제한입니다.
Sort
 sort string

정렬 순서입니다.
페이지 길이
 defaultPageLength string

기본 페이지 길이입니다.

반환

Name 경로 형식 Description
Results
 results array of object
아이디
 results.id string

식별자입니다.
이름
 results.name string

이름입니다.
만든 위치에서
 results.createdAt string

만들 때입니다.
업데이트 날짜
 results.updatedAt string

업데이트 시.
총계
 total integer

합계입니다.
이후
paging.next.after string

After 링크입니다.
Link
 paging.next.link string

링크입니다.

스레드 가져오기

작업 ID:
GetThreads

스레드 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
이후
after string

After 링크입니다.
한계
 limit string

응답 제한입니다.
Sort
 sort string

정렬 순서입니다.
받은 편지함 ID
 inboxId string

받은 편지함 식별자입니다.
연결된 연락처 ID
 associatedContactId string

연결된 연락처 식별자입니다.
스레드 상태
 threadStatus string

스레드 상태입니다.
최신 타임스탬프
 latestMessageTimestampAfter string

이후의 최신 메시지 타임스탬프입니다.
Archived
 archived boolean

보관 여부입니다.
property
 property string

속성입니다.

반환

Name 경로 형식 Description
Results
 results array of object
연결된 연락처 ID
 results.associatedContactId string

연결된 연락처 식별자입니다.
만든 위치에서
 results.createdAt string

만들 때입니다.
아이디
 results.id string

식별자입니다.
받은 편지함 ID
 results.inboxId string

받은 편지함 식별자입니다.
스팸
 results.spam boolean

스팸 여부입니다.
상태
 results.status string

상태입니다.
닫힘
 results.closedAt string

닫힌 경우.
최신 메시지 타임스탬프
 results.latestMessageTimestamp string

최신 메시지 타임스탬프입니다.
최신 메시지 전송 타임스탬프
 results.latestMessageSentTimestamp string

타임스탬프를 보낸 최신 메시지입니다.
최신 메시지 수신 타임스탬프
 results.latestMessageReceivedTimestamp string

최신 메시지가 타임스탬프를 받았습니다.
Assigned To
 results.assignedTo string

할당된 대상입니다.
Archived
 results.archived boolean

보관 여부입니다.
이후
paging.next.after string

After 링크입니다.
Link
 paging.next.link string

링크입니다.

스레드 보관

작업 ID:
ArchivesAThread

단일 스레드를 보관합니다. 스레드는 보관된 상태로 배치된 후 30일 후에 영구적으로 삭제됩니다.

매개 변수

Name 키 필수 형식 Description
스레드 ID
 threadId True string

스레드 식별자입니다.

반환

response
string

스레드 업데이트

작업 ID:
UpdateAThread

단일 스레드를 업데이트합니다. 스레드 상태를 업데이트하거나 스레드를 복원할 수 있습니다.

매개 변수

Name 키 필수 형식 Description
Archived
 archived boolean

보관 여부입니다.
스레드 ID
 threadId True string

스레드 식별자입니다.
상태
 status string

상태입니다.
Archived
 archived boolean

보관 여부입니다.

반환

Name 경로 형식 Description
연결된 연락처 ID
 associatedContactId string

연결된 연락처 식별자입니다.
만든 위치에서
 createdAt string

만들 때입니다.
아이디
 id string

식별자입니다.
받은 편지함 ID
 inboxId string

받은 편지함 식별자입니다.
스팸
 spam boolean

스팸입니다.
상태
 status string

상태입니다.
닫힘
 closedAt string

닫힌 경우.
최신 메시지 타임스탬프
 latestMessageTimestamp string

최신 메시지 타임스탬프입니다.
최신 메시지 전송 타임스탬프
 latestMessageSentTimestamp string

타임스탬프를 보낸 최신 메시지입니다.
최신 메시지 수신 타임스탬프
 latestMessageReceivedTimestamp string

최신 메시지가 타임스탬프를 받았습니다.
Assigned To
 assignedTo string

할당된 대상입니다.
Archived
 archived boolean

보관 여부입니다.

스레드에 대한 메시지 기록 가져오기

작업 ID:
GetMessageHistoryForAThread

스레드에 대한 메시지 기록 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
이후
after string

After 링크입니다.
한계
 limit string

응답 제한입니다.
Sort
 sort string

정렬 순서입니다.
Archived
 archived boolean

보관 여부입니다.
property
 property string

속성입니다.
스레드 ID
 threadId True string

스레드 식별자입니다.

반환

Name 경로 형식 Description
Results
 results array of object
Archived
 results.archived boolean

보관 여부입니다.
클라이언트 유형
 results.client.clientType string

클라이언트 유형입니다.
통합 앱 ID
 results.client.integrationAppId string

통합 앱 식별자입니다.
만든 위치에서
 results.createdAt string

만들 때입니다.
작성자
 results.createdBy string

만든 사람입니다.
방향
 results.direction string

방향.
아이디
 results.id string

식별자입니다.
받는 사람
 results.recipients array of object
유형
 results.recipients.deliveryIdentifier.type string

형식입니다.
가치
 results.recipients.deliveryIdentifier.value string

값입니다.
행위자 ID
 results.recipients.actorId string

행위자 식별자입니다.
이름
 results.recipients.name string

이름입니다.
받는 사람 필드
 results.recipients.recipientField string

받는 사람 필드입니다.
보낸 사람
 results.senders array of object
행위자 ID
 results.senders.actorId string

행위자 식별자입니다.
이름
 results.senders.name string

이름입니다.
보낸 사람 필드
 results.senders.senderField string

보낸 사람 필드입니다.
유형
 results.senders.deliveryIdentifier.type string

형식입니다.
가치
 results.senders.deliveryIdentifier.value string

값입니다.
문자 메시지
 results.text string

텍스트입니다.
잘림 상태
 results.truncationStatus string

잘림 상태입니다.
유형
 results.type string

형식입니다.
업데이트 날짜
 results.updatedAt string

업데이트 시.
서식 있는 텍스트
 results.richText string

서식 있는 텍스트입니다.
주제
 results.subject string

제목입니다.
ID에 대한 회신
 results.inReplyToId string

식별자에 대한 응답입니다.
상태 유형
 results.status.statusType string

상태 유형입니다.
오류 메시지
 results.status.failureDetails.errorMessage string

오류 메시지입니다.
채널 ID
 results.channelId string

채널 식별자입니다.
채널 계정 ID
 results.channelAccountId string

채널 계정 식별자입니다.
대화 스레드 ID
 results.conversationsThreadId string

대화 스레드 식별자입니다.
이후
paging.next.after string

After 링크입니다.
Link
 paging.next.link string

링크입니다.

스레드에 메시지 보내기

작업 ID:
SendAMessageToAThread

현재 타임스탬프의 스레드에 새 메시지를 보냅니다.

매개 변수

Name 키 필수 형식 Description
스레드 ID
 threadId True string

스레드 식별자입니다.
Attachments
 attachments array of

attachments 개체입니다.
채널 계정 ID
 channelAccountId string

채널 계정 식별자입니다.
채널 ID
 channelId string

채널 식별자입니다.
유형
 type string

형식입니다.
가치
 value string

값입니다.
행위자 ID
 actorId string

행위자 식별자입니다.
이름
 name string

이름입니다.
받는 사람 필드
 recipientField string

받는 사람 필드입니다.
유형
 type string

형식입니다.
가치
 value string

값입니다.
보낸 사람 행위자 ID
 senderActorId string

보낸 사람 행위자 식별자입니다.
문자 메시지
 text string

텍스트입니다.
유형
 type string

형식입니다.
서식 있는 텍스트
 richText string

릭 텍스트입니다.
주제
 subject string

제목입니다.

반환

response
string

채널 가져오기

작업 ID:
GetChannels

채널 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
이후
after string

After 링크입니다.
한계
 limit string

응답 제한입니다.
Sort
 sort string

정렬 순서입니다.
페이지 길이
 defaultPageLength string

기본 페이지 길이입니다.

반환

Name 경로 형식 Description
Results
 results array of object
아이디
 results.id string

식별자입니다.
이름
 results.name string

이름입니다.
총계
 total integer

합계입니다.
이후
paging.next.after string

After 링크입니다.
Link
 paging.next.link string

링크입니다.

채널 계정 가져오기

작업 ID:
GetChannelAccounts

채널 계정 목록을 검색합니다.

매개 변수

Name 키 필수 형식 Description
채널 ID
 channelId string

채널 식별자입니다.
받은 편지함 ID
 inboxId string

받은 편지함 식별자입니다.
이후
after string

After 링크입니다.
한계
 limit string

응답 제한입니다.
Sort
 sort string

정렬 순서입니다.
페이지 길이
 defaultPageLength string

기본 페이지 길이입니다.

반환

Name 경로 형식 Description
Results
 results array of object
아이디
 results.id string

식별자입니다.
채널 ID
 results.channelId string

채널 식별자입니다.
이름
 results.name string

이름입니다.
받은 편지함 ID
 results.inboxId string

받은 편지함 식별자입니다.
Active
 results.active boolean

활성 상태인지 여부입니다.
권한을 부여받은
 results.authorized boolean

권한 있는지 여부입니다.
만든 위치에서
 results.createdAt string

만들 때입니다.
유형
 results.deliveryIdentifier.type string

형식입니다.
가치
 results.deliveryIdentifier.value string

값입니다.
총계
 total integer

합계입니다.
이후
paging.next.after string

After 링크입니다.
Link
 paging.next.link string

링크입니다.

토큰 생성

작업 ID:
GenerateAToken

새 방문자 식별 토큰을 생성합니다. 이 토큰은 동일한 전자 메일 주소로 호출되더라도 이 엔드포인트가 호출될 때마다 고유합니다. 이 토큰은 일시적이며 12시간 후에 만료됩니다.

매개 변수

Name 키 필수 형식 Description
전자 메일
 email string

전자 메일 주소입니다.
이름 (First Name)
 firstName string

이름입니다.
성 이름
 lastName string

성입니다.

반환

Name 경로 형식 Description
토큰
 token string

토큰입니다.

행위자 가져오기

작업 ID:
GetActors

행위자 식별자를 기본 행위자 및 참가자로 확인합니다.

매개 변수

Name 키 필수 형식 Description
property
 property string

속성입니다.
입력
 inputs array of string

입력입니다.

반환

Name 경로 형식 Description
완료 시
 completedAt string

완료 시.
Results
 results array of object
아이디
 results.id string

식별자입니다.
유형
 results.type string

형식입니다.
이름
 results.name string

이름입니다.
전자 메일
 results.email string

전자 메일 주소입니다.
아바타
 results.avatar string

아바타입니다.
시작 날짜
 startedAt string

시작 시.
상태
 status string

상태입니다.
요청 시
 requestedAt string

요청 시

정의

문자열

기본 데이터 형식 'string'입니다.