Shopify에 대한 통합 설정 - Amazon Connect

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Shopify에 대한 통합 설정

Amazon Connect 고객 프로필을 정기적으로 업데이트하려면 Amazon을 사용하여 Shopify와 통합할 수 있습니다. AppIntegrations. 먼저 Amazon Connect 커넥트와 Shopify에서 연결을 설정한 다음 Shopify 통합을 확인합니다.

Amazon Connect 커넥트와 Shopify에서 연결을 설정합니다.

  1. 에서 Amazon Connect 콘솔을 엽니다.https://console.aws.amazon.com/connect/.

  2. 인스턴스 페이지에서 인스턴스 별칭을 선택합니다. 인스턴스 별칭은 또한인스턴스 이름Amazon Connect URL에 표시됩니다.

  3. 탐색 창에서 [] 를 선택합니다.고객 프로필.

  4. 온 더고객 프로필 구성페이지에서 를 선택합니다.통합 추가.

  5. 온 더소스 선택페이지에서 를 선택합니다.Shopify. 에 나열된 신청 요건을 검토하십시오.애플리케이션 선택페이지

  6. 온 더연결 설정페이지에서 다음 중 하나를 선택합니다.

    • 기존 연결 사용: 따라서 기존 Amazon을 다시 사용할 수 있습니다. EventBridge 에서 만들었을 수 있는 리소스AWS 계정.

    • 새 연결 생성: 외부 응용 프로그램에 필요한 정보를 입력합니다.

      • 연결 이름: 연결에 대한 이름을 제공합니다. 연결 이름은 이 연결을 사용하는 통합에서 참조합니다.

      • 연결 URL: 애플리케이션 연결 URL을 입력합니다. 이 URL은 외부 응용 프로그램에서 만든 객체에 딥링크하는 데 사용됩니다. 연결 URL은 애플리케이션 웹 사이트에서 사용할 수 있는 Shopify 파트너 앱 URL입니다.

        Shopify 파트너 앱 URL을 찾으려면:

        • 파트너.shopify.com 계정에 로그인합니다.

        • 앱으로 이동합니다.

        • 브라우저에서 URL을 복사합니다.

      • 클라이언트 ID입니다: 애플리케이션 클라이언트 ID를 입력합니다. 외부 응용 프로그램에서 클라이언트를 고유하게 구분하는 문자열입니다. 이 클라이언트 ID는 애플리케이션 웹 사이트에서 사용할 수 있는 소스 이름입니다. 여기에서 지정한 ID를 사용하여 고객 프로필에서 객체를 수집할 클라이언트를 식별합니다. 소스 설정 단계를 수행한 후에 클라이언트 ID를 사용할 수 있습니다.

        소스 이름을 찾으려면:

        • 파트너.shopify.com 계정에 로그인합니다.

        • 앱으로 이동합니다.

        • Amazon에서 소스 이름을 복사합니다. EventBridge 이벤트 소스.

  7. 온 더소스 설정페이지, 복사AWS 계정클립보드에 ID를 입력한 다음 선택Shopify에 로그인.

  8. 다음 지침에 따라 Shopify를 설정합니다.

    1. 파트너.shopify.com에 로그인하세요.

    2. Amazon 아래에서 EventBridge, 선택원본 만들기.

    3. 용 통합AWS 계정아이디를 입력하고 본인을 선택하세요AWS리전.

    4. 이벤트 소스 대상을 설정한 후 고객 프로필로 돌아가십시오. 아마존 커넥트가 Shopify와 성공적으로 연결되었음을 나타내는 알림이 표시됩니다.

  9. 온 더통합 옵션페이지에서 인제스트할 소스 객체를 선택하고 해당 객체 유형을 선택합니다.

    객체 유형은 수집된 데이터를 저장합니다. 또한 통합의 객체를 인제스트할 때 프로파일에 매핑되는 방식을 정의합니다. 고객 프로파일은 소스 객체의 속성이 고객 프로파일의 표준 객체에 매핑되는 방식을 정의하는 데 사용할 수 있는 기본 객체 유형 템플릿을 제공합니다. 에서 만든 객체 매핑을 사용할 수도 있습니다.PutProfileObjectType.

  10. 를 위해처리 시작 날짜, 고객 프로필은 통합이 추가된 후에 생성된 레코드를 수집하기 시작합니다.

    참고

    역사적 기록이 필요한 경우 다음을 수행할 수 있습니다.Amazon S3 S3를 통합 소스로 사용하여 가져오기.

  11. 온 더검토 및 통합페이지, 확인연결 상태말한다Connected를 선택한 다음 를 선택합니다.통합 추가.

    참고

    이 통합을 추가한 후에는 다음을 수행해야 합니다.웹후크 구독 설정이벤트가 이 통합으로 유입되기 시작할 수 있도록 하기 위해서입니다.

  12. 통합이 설정된 후 다시고객 프로필 구성페이지,통합페이지에는 현재 설정된 통합이 표시됩니다. 이Last 실행통합 상태현재 이 유형의 통합에는 사용할 수 없습니다.

    어떤 데이터가 전송되는지 확인하려면 통합을 선택한 다음 선택하십시오.객체 확인.

  13. 다음 단계로 진행하여 API를 사용하여 설정합니다.웹후크 구독따라서 이벤트가 이 통합으로 유입되기 시작할 수 있습니다.

웹후크 구독 설정

  1. 다음 URL을 사용하여 앱에 필요한 권한이 있는지 확인하세요.

    https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}

    여기서 각 항목은 다음과 같습니다.

    • shopShopify 스토어의 이름입니다.

    • api_keyShopify 앱의 API 키입니다. Shopify에서 이 정보를 확인할 수 있습니다.세부 정보 페이지.

    • scopes가치가 있어야 합니다read_customers,read_orders,read_draft_orders.

    • redirect_uri는 앱을 만들 때 지정한 리디렉션 URI입니다. 당사의 목적상 모든 유효한 URL이 될 수 있습니다.

    • nonce다른 사람의 특정 권한 부여 요청을 식별하기 위한 모든 고유 값일 수 있습니다. 타임스탬프를 사용하는 것이 좋습니다.

    URL을 구성한 후 브라우저에 붙여넣기하면 됩니다. 다음 이미지와 비슷한 설치/권한 부여 페이지가 표시되어 스토어 소유자에게 정의된 범위에 대한 권한을 부여하도록 요청합니다.

  2. 선택목록에 없는 앱 설치스토어를 대신하여 앱을 설치하고 승인할 수 있습니다.

    리디렉션 URI에 쿼리 파라미터로 추가된 인증 코드와 함께 입력한 리디렉션 URI로 이동합니다. 예:

    https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}&timestamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
  3. 복사authorization_code이 URI에서. 다음 단계에서 영구 액세스 토큰을 얻는 데 사용할 것입니다.

  4. API 호출에 사용하는 모든 도구로 이동합니다. 예,또는우편집배원.

  5. 영구 액세스 토큰을 받으려면 Shopify에 POST를 요청하십시오.Admin이 엔드포인트에 대한 API:

    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" }
  6. access_token을 기록합니다. 이 토큰은 이전 단계에서 제공된 범위를 가진 영구 토큰입니다. 이제 웹후크 구독을 생성할 준비가 되었습니다.

  7. 다음 API 호출의 경우 HTTP 헤더 키를 설정해야 합니다.X-Shopify-Access-Tokenaccess_token이전 통화의 응답에서 받았습니다.

  8. 웹후크 구독을 설정하려면 각각에 대해 다음 POST 요청을 하십시오.topic다음 단계에 나열된 값:

    엔드포인트: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" } }
  9. 각 구독에 대해 다음 값을 바꾸십시오.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 통합 확인

  1. Shopify 스토어에 관리자로 로그인합니다.

  2. 왼쪽 탐색 메뉴에서 을 선택합니다.Address.

  3. Select고객 추가.

  4. 고객 세부 정보를 입력합니다. 전화번호와 이메일을 반드시 입력하세요. 실제 고객 소유일 필요는 없습니다. 통합을 확인한 후 이 고객 항목을 삭제합니다.

  5. 고객 객체를 저장합니다.

  6. 이벤트 전달은 거의 즉시 이루어져야 하지만 이벤트가 전달되고 고객 프로필을 생성하려면 1분 정도 기다려야 합니다.

  7. Amazon Connect 상담원 환경을 열고 Shopify 스토어에 입력한 이메일 또는 전화번호로 사용자를 조회합니다. 동일한 이메일 또는 전화 번호로 고객 프로필을 볼 수 있을 것입니다.

  8. 고객 프로필이 보이지 않으면 통합에 문제가 있는 것입니다. 문제 해결:

    1. Amazon으로 이동합니다. EventBridge 콘솔.

    2. 여부 확인 EventSource 활성 상태이고 일치하는 상태입니다. EventBus 존재하고 실행 중입니다.

    문제가 해결되지 않으면 다음 연락처로 문의하십시오.AWS Support문제를 조사하는 데 도움을 청합니다.

고객 프로필 통합 모니터링

연결이 설정된 후 연결이 중지되면 통합을 삭제한 다음 다시 설정하십시오.

객체가 전송되지 않는 경우 취해야 할 조치

객체 전송에 실패할 경우 선택흐름 세부 정보무엇이 잘못되었는지에 대해 더 자세히 알아보십시오.

구성을 삭제하고 외부 응용 프로그램에 다시 연결해야 할 수 있습니다.