inQuba Journey(미리 보기)
inQuba Customer Journey API에 데이터를 원활하게 게시하고 고객 경험을 효과적으로 추적합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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) |
| 연락처 | |
|---|---|
| 이름 | inQuba 지원 |
| URL | https://inquba.com |
| 전자 메일 | support@inquba.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Inquba Customer Intelligence Pty Ltd |
| 웹 사이트 | https://inquba.com/ |
| 개인 정보 보호 정책 | https://www.inquba.com/data-privacy/ |
| 카테고리 | 데이터; 통신 |
inQuba Journey Connector를 사용하면 기존 시스템과 inQuba Journey 플랫폼 간에 원활하게 통합할 수 있습니다. 커넥터를 통해 데이터를 쉽게 보내 고객 경험을 빠르게 시각화하고 고객이 말하고 수행하는 작업을 파악할 수 있습니다. 커넥터는 inQuba 플랫폼에서 사용하는 고객 경험 및 이벤트를 게시할 수 있는 사용하기 쉬운 REST API를 제공합니다.
필수 조건
inQuba Journey Connector를 활용하려면 다음이 필요합니다.
- 등록된 InQuba Journey 인스턴스 배포됨
- 활성 Azure 구독
- 사용자 지정 커넥터 기능이 있는 Microsoft Power Apps 또는 Power Automate 계획
Azure Market 장소를 방문하거나 inQuba 웹 사이트를 방문하여 영업에 문의하여 구독을 구매할 수 있습니다.
자격 증명을 가져오는 방법
모든 inQuba API에 대한 권한 부여가 필요합니다. inQuba 등록 프로세스를 완료했으면 계정 관리자 또는 inQuba 지원에 문의하여 API 자격 증명을 얻습니다. 그러면 이러한 자격 증명이 모든 API 작업에 대해 Journey 커넥터에서 사용됩니다.
커넥터 시작
inQuba Journey Connector에는 모든 작업에 대한 권한 부여가 필요합니다. "이벤트 만들기" 또는 "트랜잭션 만들기" 작업을 사용하기 전에 항상 "액세스 토큰 획득" 작업 사용을 시작하세요.
inQuba에서 이벤트 또는 트랜잭션 특성 정의 및 자격 증명을 검색합니다. 이러한 특성 정의는 고객과 상호 작용하거나 고객 경험을 추적하는 데 필요한 특성을 나타냅니다. 관련 정의 및 자격 증명은 계정 관리자 또는 inQuba 지원에 문의할 수 있습니다.
액세스 토큰 획득 작업: 액세스 토큰
액세스 작업에서 제공된 세부 정보 사용
이벤트 만들기 또는 트랜잭션 만들기 작업을 사용합니다. 액세스 토큰 획득 작업의 동적 콘텐츠를 사용하여 '인증 토큰' 필드를 업데이트하세요. 'Bearer' 값을 추가한 다음 아래와 같이 이전 단계의 권한 부여 토큰 값을 사용하여 동적 콘텐츠를 선택하세요.
그 후 작업 양식에 필요한 세부 정보를 입력하고 inQuba 플랫폼과 통합을 진행할 수 있습니다.
Dynamics를 사용하는 인기 있는 흐름의 예는 다음과 같습니다. 아래 흐름은 Dynamics: 에서 흐름 단계가 실행될 때 트리거됩니다.
알려진 문제 및 제한 사항
이벤트 만들기 및 트랜잭션 만들기 API는 현재 요청당 단일 이벤트 및 트랜잭션 페이로드만 지원합니다. 여러 이벤트 및 트랜잭션의 경우 여러 반복된 요청을 시작하는 것이 좋습니다.
일반적인 오류 및 해결
응답에 HTTP 401 오류가 포함됩니다.
자격 증명이 올바른지 확인하고 inQuba에서 제공한 대로 제공된 자격 증명과 일치하는지 확인하세요. 자격 증명을 확인하려면 inQuba 지원에 문의할 수 있습니다.
응답에 HTTP 404 오류가 포함됩니다.
inQuba에서 제공한 대로 올바른 테넌트 이름 및 호스트 URL을 사용하고 있는지 확인하세요. 테넌트 이름을 확인하려면 inQuba 지원에 문의할 수 있습니다.
응답에 HTTP 500 오류가 포함됩니다.
특성 배열 입력을 사용하거나 원시 특성이 올바른지 확인하여 이벤트 또는 트랜잭션 특성 배열이 올바르게 정의되었는지 확인하세요. 구성을 확인하려면 inQuba 지원에 문의할 수 있습니다.
자주 묻는 질문(FAQ)
이벤트 또는 트랜잭션 엔드포인트를 사용하여 보낼 수 있는 요청 수는 몇 개입니까? 전송할 수 있는 요청 수에는 하드 제한이 없지만 여정 및 이벤트 처리는 유료 구독 계층에 의해 제한됩니다. 구독 가격은 여기에서 찾을 수 있습니다.
이벤트 및 트랜잭션에 대한 Open API 정의는 어디에서 찾을 수 있나요? Swagger 설명서는 이벤트 및 트랜잭션 API에 사용할 수 있습니다 .
비프로덕션 엔드포인트를 테스트에 사용할 수 있나요? 예. 테스트 자격 증명을 얻으려면 계정 관리자 또는 inQuba 지원에 문의하세요.
커넥터에서 지원하는 데이터 원본은 무엇인가요? 커넥터는 Power Automate 내에서 사용할 수 있는 모든 데이터 원본을 지원합니다. 구성한 흐름에 대한 단계로 커넥터를 추가할 수 있습니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 액세스 토큰 획득 |
inQuba API를 사용하여 인증하고 모든 API 상호 작용에 사용할 권한 부여 토큰을 받습니다. |
| 이벤트 만들기 |
inQuba API에 이벤트 레코드를 게시합니다. 전달자 토큰은 API와 상호 작용하는 데 필요합니다. |
| 트랜잭션 만들기 |
inQuba Journey API에 트랜잭션을 게시합니다. 전달자 토큰은 API와 상호 작용하는 데 필요합니다. |
액세스 토큰 획득
inQuba API를 사용하여 인증하고 모든 API 상호 작용에 사용할 권한 부여 토큰을 받습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테넌트 이름
|
TenantName | True | string |
inQuba에 등록된 테넌트 이름입니다. |
|
호스트 URL
|
HostURL | True | string |
토큰 엔드포인트의 호스트는 스키마 이름 없이 제공해야 합니다. 예. api.inqubacx.com |
|
사용자 이름
|
username | True | string |
InQuba에서 제공한 계정 사용자 이름입니다. |
|
암호
|
password | True | string |
inQuba에서 제공한 계정 암호입니다. |
|
클라이언트 ID
|
client_id | True | string |
inQuba에서 제공하는 클라이언트 ID입니다. |
|
클라이언트 암호
|
client_secret | True | string |
inQuba에서 제공하는 클라이언트 암호입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
권한 부여 토큰
|
access_token | string |
모든 API 상호 작용에 사용할 권한 부여 토큰입니다. |
이벤트 만들기
inQuba API에 이벤트 레코드를 게시합니다. 전달자 토큰은 API와 상호 작용하는 데 필요합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테넌트 이름
|
TenantName | True | string |
inQuba에 등록된 테넌트 이름입니다. |
|
권한 부여 토큰
|
AuthorizationToken | True | string |
InQuba에 대한 API 요청을 승인하기 위한 권한 부여 토큰입니다. |
|
이벤트 정의 코드
|
eventDefinitionCode | string |
이 요청을 게시하는 이벤트 코드입니다. |
|
|
테스트인가요?
|
isTest | boolean |
이 이벤트를 테스트 또는 라이브로 게시해야 하는지 여부를 나타내는 플래그입니다. |
|
|
코드
|
code | string |
이벤트 특성 코드 |
|
|
가치
|
value | string |
이벤트 특성 값 |
반환
- SuccessStatus
- string
트랜잭션 만들기
inQuba Journey API에 트랜잭션을 게시합니다. 전달자 토큰은 API와 상호 작용하는 데 필요합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
테넌트 이름
|
TenantName | True | string |
inQuba에 등록된 테넌트 이름입니다. |
|
권한 부여 토큰
|
AuthorizationToken | True | string |
InQuba에 대한 API 요청을 승인하기 위한 권한 부여 토큰입니다. |
|
트랜잭션 정의 코드
|
transactionDefinitionCode | string |
이 요청을 게시하는 트랜잭션 코드입니다. |
|
|
테스트인가요?
|
isTest | boolean |
이 변환을 테스트 또는 라이브로 게시해야 하는지 여부를 나타내는 플래그입니다. |
|
|
코드
|
code | string |
트랜잭션 특성 코드 |
|
|
가치
|
value | string |
트랜잭션 특성 값 |
반환
- SuccessStatus
- string
정의
문자열
기본 데이터 형식 'string'입니다.