Salesforce 커넥터

Additional Configuration Required

This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Salesforce to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.

To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/salesforce-connector/">Library

소개

Salesforce는 영업 리드 추적부터 주문 및 재고 관리에 이르기까지 다양한 애플리케이션에 사용되는 클라우드 기반 CRM 소프트웨어 플랫폼입니다.

목적

이 문서는 튤립 라이브러리에 포함된 Salesforce REST API 커넥터에 대해 자세히 설명합니다. 구성이 완료되면, 이러한 커넥터 함수를 사용하여 튤립 앱에서 Salesforce 데이터를 가져오고, 쿼리하며, 수정할 수 있습니다.

API 문서

Salesforce REST API에 대한 문서는 여기에서 확인할 수 있습니다. 이 문서에 포함된 일부 커넥터 함수는 SOQL(Salesforce Object Query Language)을 사용하여 쿼리를 수행하며, SOQL의 전체 구문은 여기에서 확인할 수 있습니다.

API Variations

Note: Salesforce supports a number of API across a variety of methods, the full list of which can be found here. This article and the Connectors to which it is related are built to use the Salesforce REST API.

초기 설정

Permissions Warning

Warning: generating the following values requires developer- or administrator-level permissions in Salesforce.

Salesforce API 인증은 OAuth 2.0 표준을 따릅니다. 다음 절차는 리프레시 토큰을 생성하는 방법을 설명하며, 이 토큰은 모든 Tulip 앱에서 Salesforce에 성공적으로 연결하는 데 필요한 액세스 토큰을 가져오는 데 사용됩니다.

Salesforce에서 연결된 앱(Connected App)을 생성합니다. 이를 위해 Salesforce의 "설정(Setup)" 영역으로 이동합니다. 그런 다음, 플랫폼 도구(PLATFORM TOOLS) >> 앱(Apps) >> 연결된 앱(Connected Apps) >> 연결된 앱 관리(Manage Connected Apps)로 이동합니다.
새로운 연결된 앱을 생성합니다. 다음을 포함하십시오: a. 애플리케이션에 필요한 모든 범위(scope)를 지정하되, 반드시 refresh_token을 포함해야 합니다. b. 'OAuth 설정 활성화'를 선택하고, 콜백 URL(Callback URL)에 https://login.salesforce.com/services/oauth2/success을 입력합니다.
완료되면 '소비자 세부 정보 관리'를 클릭하여 '소비자 키'와 '소비자 비밀 키'를 확인하십시오. 이 정보는 나중에 사용됩니다.
이제 Tulip에서 ‘ Connector Function ’ [설정]> ‘인증 코드 URL 가져오기’를 엽니다. 위 3단계에서 생성된 “컨슈머 키”를 복사하여 쿼리 매개변수 client_id로 붙여넣으십시오.
Connector Function 을 “실행”합니다.
커넥터의 "출력"으로 URL이 생성된 것을 확인하십시오. 이 URL을 브라우저 창에 붙여넣으십시오.
표시되는 인증 프롬프트를 완료하여 Tulip이 귀하의 Salesforce 인스턴스와 상호 작용할 수 있도록 성공적으로 승인하십시오.
성공하면 브라우저가 “원격 액세스 애플리케이션 승인(Remote Access Application Authorization)”이라고 표시된 새 페이지로 리디렉션됩니다. 이 페이지의 URL에서 인증 코드를 확인할 수 있습니다. 예를 들어, URL https://login.salesforce.com/services/oauth2/success?code=asdf1234 에서 인증 코드는 asdf1234입니다.
이 인증 코드를 저장하십시오. 코드는 반드시 두 개의 등호( == )로 끝나야 합니다. 코드가 %3D%3D로 끝나는 경우, 해당 문자를 제거하고 ==로 대체하십시오.
[설정] 툴립 리프레시 토큰 가져오기 Connector Function 로 이동하십시오. 쿼리 매개변수란에 위에서 수집한 모든 정보를 붙여넣으십시오:
- grant_type= authorization_code
- redirect_uri= https://login.salesforce.com/services/oauth2/success
- client_id= 위 3단계에서 얻은 Consumer Key
- client_secret= 위 3단계에서 확인한 Consumer Secret
- code= 위 9단계에서 얻은 인증 코드
이 커넥터를 실행하고, 응답에 표시되는 refresh_token을 저장하십시오.
마지막으로 [Auth] 액세스 토큰 가져오기 Connector Function 로 이동하십시오. 다음 쿼리 매개변수를 입력하십시오:
- grant_type= authorization_code
- client_id= 위 3단계에서 얻은 컨슈머 키
- client_secret= 위 3단계에서 얻은 컨슈머 시크릿
- refresh_token= 위 10단계에서 얻은 리프레시 토큰
커넥터를 실행하십시오. 응답에는 output으로 매핑된 access_token이 포함되어 있음을 유의하십시오. 리프레시 토큰을 저장하려면 커넥터를 저장하십시오.

이 함수가 access_token을 생성할 수 있게 되면 설정이 완료됩니다! 이 access_token은 2단계에서 구성한 타임아웃 설정이 허용하는 한, 이후의 모든 Connector Function 에서 사용할 수 있습니다.

Tulip 연결 세부 정보

커넥터가 Salesforce와 연동되도록 하려면, 커넥터의 ‘연결 세부 정보’에서 ‘기본 서브도메인’으로 Salesforce 인스턴스의 서브도메인을 입력하십시오. 예를 들어, Salesforce 인스턴스의 주소가 sample.my.salesforce.com인 경우 기본 서브도메인은 sample.my로 설정해야 합니다.

여기에 나열된 모든 Connector Functions 는 Salesforce REST API v46.0과 연동되도록 구축되었습니다.

Connector Functions

커넥터에는 객체형과 쿼리형이라는 두 가지 주요 유형이 있습니다. 두 커넥터 모두 access_token이 필요하므로, 이를 사용하기 전에 앱에서 [Auth] 액세스 토큰 가져오기를 실행해야 합니다! 일반적으로 앱이나 프로세스가 시작될 때 새로운 액세스 토큰을 생성하고, 나중에 사용할 수 있도록 앱 변수에 저장하는 것이 권장됩니다.

객체형 커넥터

해당 객체의 모든 필드를 반환합니다.
엔드포인트 ./services/data/v46.0/sobjects/<객체 이름>/<객체 ID>를 사용합니다.
예: 커넥터 [Opportunity] 모든 필드 가져오기

쿼리형 커넥터

쿼리에 지정된 필드만 반환합니다.
연결된 정보(예: 기회와 관련된 계정 이름) 또는 집계된 정보(예: 레코드 수)를 반환할 수 있습니다.
엔드포인트 ./services/data/v46.0/query를 사용하십시오.
SOQL을 사용하여 쿼리를 작성해야 합니다(문서 참조{target=_blank}).
예시: 커넥터 [주문] 상태별 모든 주문 가져오기

포함 사항 Connector Functions

다음 Connector Functions 이 이 팩에 포함되어 있으며, Salesforce API를 통해 가능한 기능에 대한 소개 역할을 합니다:* [Setup] 인증 코드 URL 가져오기 및 [Setup] 새로 고침 토큰 가져오기 * 최초 설정 시에만 사용됩니다. 자세한 내용은 위를 참조하십시오.*[Auth] 액세스 토큰 가져오기 * 액세스 토큰을 생성하는 데 사용되며, 이후 모든 Connector Functions 호출에 이 액세스 토큰을 포함해야 합니다.*[Opportunity] 함수: * 모든 필드 가져오기 * 쿼리된 Opportunity의 모든 필드를 반환합니다. 액세스 토큰과 Opportunity ID가 필요합니다. * 단계 변경 * 지정된 Opportunity의 단계를 지정된 값으로 업데이트합니다.*[주문] 함수: * 특정 상태의 모든 주문 가져오기 * 지정된 상태를 가진 모든 주문 목록을 반환합니다. * 특정 상태의 주문 수 계산 * 지정된 상태를 가진 모든 주문의 개수를 반환합니다. * ID로 주문 번호 가져오기 * 지정된 주문 ID에 해당하는 주문 번호를 반환합니다.

Connector Functions이러한 함수를 필요에 맞게 수정하려면 다음 지침을 참고하십시오. 1. 객체 유형 Connector Functions 를 수정하려면 URL에 지정된 객체를 변경하기만 하면 됩니다. 필요에 따라 새로운 출력 항목을 추가하거나 제거하십시오. 2. 쿼리 유형 을 수정하려면 모든 변경 사항을 쿼리에서 수행해야 합니다. 이는 쿼리 매개변수에서 'q' 키로 확인할 수 있습니다. 1. 팁: LIMIT(응답 수) 함수를 사용하여 쿼리에서 반환되는 응답 수를 제한할 수 있습니다.

원하시는 정보를 찾으셨나요?

community.tulip.co로 이동하여 질문을 게시하거나 다른 사용자가 비슷한 질문을 올렸는지 확인해 보세요!