기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Connect Customer Profiles에 대한 정기 업데이트를 제공하도록 Shopify 통합 설정
Amazon Connect Customer Profiles를 정기적으로 업데이트하려면 Amazon AppIntegrations를 사용하여 Shopify와 통합할 수 있습니다. 먼저 Amazon Connect 및 Shopify에서 연결을 설정한 다음 Shopify 통합을 확인합니다.
Amazon Connect 및 Shopify에서 연결을 설정합니다.
-
https://console.aws.amazon.com/connect/
에서 Amazon Connect 콘솔을 엽니다. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 Amazon Connect URL에 표시되는 인스턴스 이름이기도 합니다. 다음 이미지는 Amazon Connect 가상 고객 센터 인스턴스 페이지를 보여주며, 인스턴스 별칭을 둘러싼 상자가 있습니다.
-
탐색 창에서 고객 프로필을 선택합니다.
-
고객 프로필 구성 페이지에서 통합 추가를 선택합니다.
-
소스 선택 페이지에서 Shopify를 선택합니다. 애플리케이션 선택 페이지에 나열된 애플리케이션 요구 사항을 검토하세요.
-
연결 설정 페이지에서 다음 중 하나를 선택합니다.
-
기존 연결 사용: 이를 통해에서 생성했을 수 있는 기존 Amazon EventBridge 리소스를 재사용할 수 있습니다 AWS 계정.
-
새 연결 생성: 외부 애플리케이션에 필요한 정보를 입력합니다.
-
연결 이름: 연결 이름을 입력합니다. 연결 이름은 이 연결을 사용하는 통합에서 참조됩니다.
-
연결 URL: 애플리케이션 연결 URL을 입력합니다. 이 URL은 외부 애플리케이션에서 생성된 객체에 딥 링크하는 데 사용됩니다. 연결 URL은 애플리케이션 웹 사이트에서 사용할 수 있는 Shopify 파트너 앱 URL입니다.
Shopify 파트너 앱 URL을 찾으려면
-
partners.shopify.com 계정에 로그인합니다.
-
앱으로 이동합니다.
-
브라우저에서 URL을 복사합니다.
-
-
클라이언트 ID: 애플리케이션 클라이언트 ID를 입력합니다. 외부 애플리케이션에서 클라이언트를 고유하게 구분하는 문자열입니다. 이 클라이언트 ID는 애플리케이션 웹 사이트에서 사용할 수 있는 소스 이름입니다. 여기에서 지정한 ID를 사용하여 Customer Profiles에서 객체를 수집하려는 클라이언트를 식별합니다. 소스 설정 단계를 수행한 후 클라이언트 ID를 사용할 수 있습니다.
소스 이름을 찾으려면
-
partners.shopify.com 계정에 로그인합니다.
-
앱으로 이동합니다.
-
Amazon EventBridge 이벤트 소스에서 소스 이름을 복사합니다.
-
-
-
-
소스 설정 페이지에서 AWS 계정 ID를 클립보드에 복사한 다음 Shopify에 로그인을 선택합니다.
-
다음 지침에 따라 Shopify를 설정합니다.
-
partners.shopify.com에 로그인합니다.
-
Amazon EventBridge에서 소스 생성을 선택합니다.
-
AWS 계정 ID를 붙여넣고 AWS 리전을 선택합니다.
-
이벤트 소스 대상을 설정한 후 Customer Profiles로 돌아갑니다. Amazon Connect가 Shopify와 성공적으로 연결되었음을 나타내는 알림이 표시됩니다.
-
-
통합 옵션 페이지에서 수집하려는 소스 객체를 선택하고 해당 객체 유형을 선택합니다.
객체 유형은 수집된 데이터를 저장합니다. 또한 통합의 객체를 수집할 때 프로필에 매핑하는 방법을 정의합니다. Customer Profiles는 소스 객체의 속성을 Customer Profiles의 표준 객체에 매핑하는 방법을 정의하는 데 사용할 수 있는 기본 객체 유형 템플릿을 제공합니다. PutProfileObjectType에서 생성한 객체 매핑을 사용할 수도 있습니다.
-
수집 시작 날짜의 경우 Customer Profiles는 통합이 추가된 후에 생성된 레코드를 수집하기 시작합니다.
참고
기록 레코드가 필요한 경우 Amazon S3를 통합 소스로 사용하여 해당 기록을 가져올 수 있습니다.
-
검토 및 통합 페이지에서 연결 상태가 연결됨으로 표시되는지 확인한 다음 통합 추가를 선택합니다.
참고
이 통합을 추가한 후에는 이벤트가 이 통합으로 유입되기 시작할 수 있도록 Webhook 구독을 설정해야 합니다.
-
통합을 설정한 후 고객 프로필 구성 페이지로 돌아가면 통합 섹션에 현재 설정된 통합이 표시됩니다. 이 유형의 통합에는 현재 마지막 실행 및 통합 상태를 사용할 수 없습니다.
전송되는 데이터를 확인하려면 통합을 선택하고 객체 보기를 선택합니다.
-
이벤트가 이 통합으로 유입되기 시작할 수 있도록 다음 단계에서 API를 사용하여 Webhook 구독을 설정합니다.
Webhook 구독 설정
-
다음 URL을 사용하여 앱에 필요한 권한이 있는지 확인합니다.
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
위치:
-
shop
은 Shopify 스토어 이름입니다. -
api_key
는 Shopify 앱의 API 키입니다. Shopify 앱 세부 정보 페이지에서 확인할 수 있습니다. -
scopes
에는read_customers,read_orders,read_draft_orders
값이 있어야 합니다. -
redirect_uri
는 앱을 만들 때 지정한 리디렉션 URI입니다. 여기서는 모든 유효한 URL이 될 수 있습니다. -
nonce
는 다른 사람의 특정 승인 요청을 식별하기 위한 임의의 고유한 값일 수 있습니다. 타임스탬프를 사용하는 것이 좋습니다.
URL을 구성한 후 브라우저에 붙여넣으면 됩니다. 다음 이미지와 비슷한 설치/승인 페이지가 표시되어 스토어 소유자에게 정의된 범위에 대한 권한을 부여하도록 요청합니다.
-
-
미등록 앱 설치를 선택하여 스토어 대신 앱을 설치하고 승인합니다.
입력한 리디렉션 URI에 승인 코드가 쿼리 파라미터로 추가된 주소로 이동됩니다. 예시:
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
-
이 URI에서
authorization_code
를 복사합니다. 다음 단계에서 이를 사용하여 영구 액세스 토큰을 받을 것입니다. -
영구 액세스 토큰을 받으려면 Shopify
Admin
API에 이 엔드포인트에 대한 POST 요청을 보냅니다.https://{shop}.myshopify.com/admin/oauth/access_token
요청 본문은 다음과 같습니다.
{ "code": "authorization_code_received_from_redirect_uri", "client_id": "your_app_api_key", "client_secret": "your_app_api_secret" }
이 요청은 다음과 같은 응답을 반환합니다.
{ "access_token": "permanent_access_token", "scope": "read_customers,read_orders,read_draft_orders" }
-
access_token
을 기록합니다. 이 토큰은 이전 단계에서 지정한 범위를 가진 영구 토큰입니다. 이제 Webhook 구독을 생성할 준비가 되었습니다. -
다음 API 호출의 경우 HTTP 헤더 키
X-Shopify-Access-Token
을 이전 호출 응답에서 수신한access_token
으로 설정해야 합니다. -
Webhook 구독을 설정하려면 다음 단계에 나열된 각
topic
값에 대해 다음과 같은 POST 요청을 수행합니다.엔드포인트:
https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json
요청 본문:
{ "webhook": { "topic": "replace_this_with_one_of_the_topics_in_the_list_below", "address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration", "format": "json" } }
-
각 구독에 대해
topic
의 값을 다음 값으로 바꿉니다.-
customers/create
-
customers/enable
-
customers/update
-
draft_orders/create
-
draft_orders/update
-
orders/cancelled
-
orders/create
-
orders/fulfilled
-
orders/paid
-
orders/partially_fulfilled
-
orders/updated
-
이제 Shopify 스토어에서 이벤트를 수신할 준비가 모두 완료되었습니다. 다음으로 Shopify 통합을 확인합니다.
Shopify 통합 확인
-
Shopify 스토어에 관리자로 로그인합니다.
-
왼쪽 탐색 메뉴에서 고객을 선택합니다.
-
고객 추가를 선택합니다.
-
고객 세부 정보를 입력합니다. 전화번호와 이메일을 반드시 입력하세요. 실제 고객의 소유일 필요는 없습니다. 통합을 확인한 후 이 고객 항목을 삭제하게 됩니다.
-
고객 객체를 저장합니다.
-
이벤트 전송은 거의 즉각적으로 이루지지만, 전송될 때까지 1분 정도 기다린 후 고객 프로필을 생성하세요.
-
Amazon Connect 에이전트 환경을 열고 Shopify 스토어에 입력한 이메일 또는 전화번호로 사용자를 검색합니다. 이메일 또는 전화번호가 동일한 고객 프로필을 볼 수 있어야 합니다.
-
고객 프로필이 보이지 않으면 통합에 문제가 있는 것입니다. 문제를 해결하려면
-
Amazon EventBridge 콘솔로 이동합니다.
-
EventSource가 활성 상태이며 매칭되는 EventBus가 존재하고 실행 중인지 확인합니다.
문제가 해결되면 Support 에 문의하여 문제를 조사하는 데 도움을 받으세요.
-
Customer Profiles 통합 모니터링
연결이 설정된 후 작동이 중지되면 통합을 삭제한 다음 다시 설정하세요.
객체가 전송되지 않는 경우 취해야 할 조치
객체 전송에 실패한 경우 흐름 세부 정보를 선택하여 무엇이 잘못되었는지 자세히 알아보세요.
구성을 삭제하고 외부 애플리케이션에 다시 연결해야 할 수 있습니다.