View a markdown version of this page

Salesforce 통합 - Amazon Quick
사전 조건1단계: Salesforce에서 외부 클라이언트 앱 생성2단계: OAuth 설정 구성3단계: 소비자 자격 증명 가져오기4단계: Amazon Quick에서 Salesforce 커넥터 구성5단계: 확인 및 게시사용 가능한 작업문제 해결

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

Salesforce 통합

Amazon Quick의 Salesforce 작업 커넥터를 사용하면 레코드 관리, 데이터 쿼리, Salesforce APIs. Amazon Quick 구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.

참고

Salesforce Spring 26 릴리스(2026년 2월)부터 모든 Salesforce 조직에서 새 Connected Apps 생성이 기본적으로 비활성화됩니다. 이 가이드에서는 Amazon Quick Salesforce 커넥터와 완벽하게 호환되는 Salesforce의 외부 클라이언트 앱(ECAs)을 사용합니다.

사전 조건

Salesforce 통합을 설정하기 전에 다음이 있는지 확인합니다.

  • 시스템 관리자 액세스 권한이 있는 Salesforce 조직입니다.

  • Amazon Quick Author 역할 이상.

  • Amazon Quick 인스턴스 URL(예: https://us-east-1.quicksight.aws.amazon.com).

1단계: Salesforce에서 외부 클라이언트 앱 생성

Salesforce에서 외부 클라이언트 앱(ECA)을 생성하여 Amazon Quick에서 OAuth 인증을 활성화합니다.

외부 클라이언트 앱 관리자로 이동

  1. Salesforce 조직에 로그인하고 설정(오른쪽 상단의 톱니 모양 아이콘)을 선택합니다.

  2. 탐색 창에서 플랫폼 도구 > 앱 > 외부 클라이언트 앱 > 외부 클라이언트 앱 관리자를 확장합니다.

  3. 새 외부 클라이언트 앱을 선택합니다.

기본 정보 입력

외부 클라이언트 앱에 대한 다음 기본 정보를 입력합니다.

외부 클라이언트 앱 기본 정보
Field 값
외부 클라이언트 앱 이름 설명이 포함된 이름(예: "Amazon Quick Integration")
API 이름 앱 이름에서 자동 생성됨
연락처 이메일 관리자 이메일 주소
배포 상태 로컬(기본값)

2단계: OAuth 설정 구성

OAuth 활성화

API(OAuth 설정 활성화) 섹션에서 OAuth 활성화를 선택하여 OAuth 구성 패널을 확장합니다.

콜백 URL 설정

콜백 URL 필드에 Amazon Quick OAuth 콜백 URL을 입력합니다.

<your-quick-instance-url>/sn/oauthcallback

예: https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback

OAuth 범위 추가

사용 가능한 OAuth 범위에서 선택한 OAuth 범위로 다음 범위를 이동합니다.

  • 자격 증명 URL 서비스 액세스(id, profile, email, address, phone)

  • API로 사용자 데이터 관리(api)

  • 웹 브라우저(웹)를 통해 사용자 데이터 관리

  • 전체 액세스(전체)

  • Visualforce 애플리케이션 액세스(visualforce)

  • 언제든지 요청 수행(refresh_token, offline_access)

  • 고유한 사용자 식별자 액세스(openid)

  • 사용자 지정 권한 액세스(custom_permissions)

  • Connect REST API 리소스 액세스(chatter_api)

  • Analytics REST API 리소스(wave_api)에 액세스

  • Analytics REST API 차트 Geodata 리소스(eclair_api)에 액세스

  • Pardot 서비스 관리(pardot_api)

OAuth 흐름 활성화

다음 흐름 옵션을 선택합니다.

  • 클라이언트 자격 증명 흐름 활성화

  • 권한 부여 코드 및 자격 증명 흐름 활성화

  • 토큰 교환 흐름 활성화

보안 설정 활성화

다음 보안 옵션을 선택합니다.

  • 코드 교환을 위한 증명 키 필요(PKCE)

  • 웹 서버 흐름에 보안 암호 필요(기본적으로 선택됨)

  • 토큰 새로 고침 흐름에 보안 암호 필요(기본적으로 선택됨)

생성을 선택하여 외부 클라이언트 앱을 저장합니다.

3단계: 소비자 자격 증명 가져오기

  1. 생성 후 ECA 세부 정보 페이지에 표시됩니다.

  2. 설정 탭으로 이동하거나 소비자 세부 정보 관리를 선택합니다.

  3. 자격 증명을 확인해야 할 수 있습니다(이메일 확인 코드).

  4. 소비자 키(클라이언트 ID) 및 소비자 보안 암호(클라이언트 보안 암호)를 복사합니다.

중요

이러한 자격 증명을 안전하게 저장합니다. Amazon Quick에서 커넥터를 구성할 때 필요합니다.

4단계: Amazon Quick에서 Salesforce 커넥터 구성

커넥터로 이동

  1. Amazon Quick을 열고 커넥터를 선택합니다.

  2. 팀에 대해 생성 탭을 선택합니다.

  3. Salesforce를 찾아 선택합니다.

  4. 커넥터가 이미 존재한다는 메시지가 표시되면 아니요, 새로 생성을 선택합니다.

연결 세부 정보 입력

다음 연결 세부 정보를 입력합니다.

Salesforce 커넥터 연결 세부 정보
Field 값
이름 설명이 포함된 이름(예: "Salesforce ECA")
네트워크 퍼블릭 네트워크
인증 유형 사용자 지정 OAuth 앱
기본 URL https://<your-domain>.my.salesforce.com/services/data/v60.0
클라이언트 ID 3단계의 소비자 키
클라이언트 보안 암호 3단계의 소비자 보안 암호
토큰 URL https://<your-domain>.my.salesforce.com/services/oauth2/token
권한 부여 URL https://<your-domain>.my.salesforce.com/services/oauth2/authorize
리디렉션 URL 미리 채워짐(변경하지 않음)

다음을 선택하여 계속 진행합니다.

5단계: 확인 및 게시

  1. 검토 페이지에서 사용 가능한 Salesforce 작업(최대 42개의 작업)을 확인합니다.

  2. 다음을 선택하여 사용자 공유로 진행합니다.

  3. 이 커넥터에 액세스할 수 있어야 하는 사용자 또는 그룹을 선택합니다.

  4. 게시를 선택하여 커넥터를 게시합니다.

커넥터를 게시한 후 Amazon Quick Chat, 흐름 및 자동화에서 Salesforce 작업을 사용할 수 있습니다.

사용 가능한 작업

커넥터를 설정한 후 다음 Salesforce 작업을 사용할 수 있습니다.

  • 표준 및 사용자 지정 객체에 대한 CRUD(CRUD) 작업을 생성, 읽기, 업데이트 및 삭제합니다.

  • SOQL(Salesforce 객체 쿼리 언어)을 사용하여 Salesforce 데이터를 쿼리합니다.

  • 리드, 계정, 연락처 및 기회를 관리합니다.

  • Apex 메서드 및 사용자 지정 로직을 실행합니다.

  • 사례, 작업 및 활동을 관리합니다.

  • 보고서 및 대시보드에 액세스합니다.

참고

Salesforce 통합은 작업 실행만 지원합니다. Salesforce 시스템에서는 데이터 액세스 및 지식 기반 생성을 사용할 수 없습니다.

문제 해결

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.

  • “URL이 더 이상 존재하지 않음” 오류 - 토큰 URL 및 권한 부여 URL에서 올바른 Salesforce 도메인을 사용하고 있는지 확인합니다. 레거시 엔드포인트를 사용하지 마십시오.

  • OAuth 검증 실패 - ECA에서 PKCE가 활성화되어 있고 콜백 URL이 Amazon Quick 인스턴스 URL과 정확히 일치하는지 확인합니다/sn/oauthcallback.

  • 범위 누락 오류 - Salesforce의 ECA 구성으로 돌아가서 필요한 모든 OAuth 범위가 아직 사용 가능 상태가 아닌 선택된 목록에 있는지 확인합니다.

  • “연결된 앱” 옵션이 회색으로 표시됨 - 이는 Salesforce 2026년 봄 이후에 예상됩니다. 대신 외부 클라이언트 앱을 사용합니다. ECAs는 지원되는 대체 버전입니다.