Salesforce 커넥터

::: (정보) ()앱을 다운로드하려면 방문하세요: 라이브러리:::

소개

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

목적

이 문서는 Tulip 라이브러리에서 찾을 수 있는 Salesforce REST API 커넥터에 대해 자세히 설명합니다. 이 커넥터 함수를 구성하면 Tulip 앱에서 Salesforce 데이터를 검색, 쿼리 및 수정하는 데 사용할 수 있습니다.

API 문서

Salesforce REST API에 대한 문서는 여기에서 찾을 수 있습니다. 이 문서에 포함된 일부 커넥터 함수는 전체 구문은 여기에 설명되어 있는 SOQL(Salesforce 객체 쿼리 언어)을 사용하여 쿼리를 수행한다는 점에 유의하세요.

:::(Info) (API 변형)참고: Salesforce는 다양한 메서드에 걸쳐 여러 가지 API를 지원하며, 전체 목록은 여기에서 확인할 수 있습니다. 이 문서 및 관련 커넥터는 Salesforce REST API를 사용하도록 만들어졌습니다 .:::

처음 설정

:::(Warning) (권한 경고)경고: 다음 값을 생성하려면 Salesforce에서 개발자 또는 관리자 수준의 권한이 필요합니다.:::Salesforce API 인증은 OAuth 2.0 표준을 따르며, 다음 프로세스에서는 새로 고침 토큰을 생성하는 방법을 설명한 후 모든 Tulip 앱에서 Salesforce에 성공적으로 연결하는 데 필요한 액세스 토큰을 검색하는 데 사용할 수 있도록 합니다.

1. Salesforce에서 연결된 앱을 만듭니다. 이렇게 하려면 Salesforce의 '설정' 공간으로 이동합니다. 그런 다음 플랫폼 도구 >> 앱 >> 연결된 앱 >> 연결된 앱 관리로 이동합니다.
2. 새 연결된 앱을 만듭니다. 애플리케이션에 필요한 모든 범위를 포함하되, refresh_token을 포함해야 합니다. b. OAuth 설정 사용을 선택하고 콜백 URL을 https://login.salesforce.com/services/oauth2/success 으로 입력합니다.
3. 완료되면 소비자 세부 정보 관리를 클릭하여 '소비자 키'와 '소비자 비밀'을 확인합니다. 이는 나중에 사용됩니다.
4. 이제 Tulip에서 커넥터 기능 [설정] 인증 코드 가져오기 URL을 엽니다. 위 3단계에서 생성한 "소비자 키"를 쿼리 매개변수 client_id로 복사하여 붙여넣습니다.
5. "커넥터 함수를 '실행'합니다.
6. 커넥터의 "출력"으로 URL이 생성되었는지 확인합니다. 이 URL을 브라우저 창에 붙여넣습니다.
7. 표시되는 인증 프롬프트를 완료하여 Tulip이 Salesforce 인스턴스와 상호 작용할 수 있도록 권한을 부여합니다.
8. 성공하면 브라우저가 원격 액세스 애플리케이션 인증이라고 표시된 새 페이지로 리디렉션됩니다. 인증 코드는 이 페이지의 URL에서 찾을 수 있습니다. 예를 들어, https://login.salesforce.com/services/oauth2/success?code=asdf1234 URL에서 인증 코드는 asdf1234입니다.
9. 이 인증 코드를 저장합니다. 코드는 두 개의 등호 기호로 끝나야 합니다. 코드가 %3D%3D로 끝나는 경우 이 문자를 제거하고 ==로 바꾸세요.
10. 설정] 토큰 새로 고침 토큰 가져오기 튤립 커넥터 기능으로 이동합니다. 쿼리 매개변수에 위에서 수집한 모든 정보를 붙여넣습니다:
    • grant_type= authorization_code
    • redirect_uri= https://login.salesforce.com/services/oauth2/success
    • client_id= 위 3단계의 소비자 키
    • client_secret= 위 3단계의 소비자 시크릿
    • code= 위 9단계의 인증 코드
11. 이 커넥터를 실행하고 응답에 표시되는 새로고침_토큰을 저장합니다.
12. 마지막으로 [인증] 액세스 토큰 가져오기 커넥터 기능으로 이동합니다. 다음 쿼리 매개 변수를 입력합니다:
    • grant_type= 권한``부여 코드
    • client_id= 위 3단계의 소비자 키
    • client_secret= 위 3단계의 소비자 비밀번호
    • refresh_token= 위 10단계의 새로 고침 토큰
13. 커넥터를 실행합니다. 응답에는 출력으로 매핑된 액세스 토큰이 포함됩니다. 커넥터를 저장하여 새로 고침 토큰 저장

이 함수가 access_token을 생성할 수 있게 되면 설정이 완료된 것입니다! 이제 이 액세스 토큰은 2단계에서 구성한 시간 제한 설정이 허용하는 한 이후의 모든 커넥터 함수에서 사용할 수 있습니다.

튤립 연결 세부 정보

커넥터가 Salesforce와 인터페이스할 수 있도록 하려면 커넥터의 연결 세부 정보 아래에 Salesforce 인스턴스의 하위 도메인을 "기본 하위 도메인"으로 입력하세요. 예를 들어 Salesforce 인스턴스가 sample.my.salesforce.com에서 찾을 수 있는 경우 기본 하위 도메인은 sample.my가 되어야 합니다.

여기의 모든 커넥터 함수는 Salesforce REST API v46.0에서 작동하도록 만들어졌습니다.

커넥터 함수

커넥터에는 개체 유형 커넥터와 쿼리 유형 커넥터의 두 가지 기본 유형이 있습니다. 두 커넥터 모두 액세스 토큰이 필요하므로 앱에서 [인증] 액세스 토큰 가져오기를 먼저 실행해야 합니다! 일반적으로 앱 또는 프로세스가 시작될 때 새 액세스 토큰을 생성하고 나중에 사용할 수 있도록 앱 변수에 저장하는 것이 좋습니다.

객체 유형 커넥터

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

쿼리 유형 커넥터

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

포함된 커넥터 함수

다음 커넥터 함수는 이 팩에 포함되어 있으며 Salesforce API를 통해 가능한 기능을 소개하기 위한 것입니다.* [설정] 인증 코드 URL 가져오기 및 [설정] 새로 고침 토큰 가져오기 * 처음 설정할 때만 사용됩니다. 자세한 내용은 위를 참조하세요.* [인증] 액세스 토큰 가져오기 * 이후의 모든 커넥터 함수에 포함되어야 하는 액세스 토큰을 생성하는 데 사용됩니다.* [기회] 함수: * 모든 필드 가져오기 * 쿼리된 기회에 대한 모든 필드를 반환합니다. 액세스 토큰과 기회 ID가 필요합니다. * 스테이지 변경 * 표시된 기회 스테이지를 지정된 값으로 업데이트합니다.* [주문] 기능: * 모든 상태의 주문 가져오기 * 지정된 상태의 모든 주문 목록을 반환합니다. * 상태의 주문 수 계산 * 지정된 상태의 모든 주문 수를 반환합니다. * ID에서 주문 번호 가져오기 * 지정된 주문 ID에서 주문 번호를 반환합니다.

이러한 함수를 필요에 맞게 수정하려면 아래 조언을 참고하세요: 1. 객체 유형 커넥터 함수를 수정하려면 URL에 표시된 객체를 변경하기만 하면 됩니다. 필요에 따라 새 출력을 추가하거나 제거합니다.2. 쿼리 유형 커넥터 함수를 수정하려면 쿼리에서 모든 변경 사항을 수행해야 합니다. 이는 쿼리 매개변수에서 q 키로 찾을 수 있습니다.1. 팁: LIMIT(number_of_responses) 함수를 사용하여 쿼리에서 응답 수를 제한하세요.

원하는 정보를 찾았나요?

community.tulip.co로 이동하여 질문을 게시하거나 다른 사람들이 비슷한 질문을 했는지 확인할 수도 있습니다!