> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce 통합

> CrewAI를 위한 Salesforce 통합을 통한 CRM 및 영업 자동화.

## 개요

에이전트가 Salesforce를 통해 고객 관계, 영업 프로세스 및 데이터를 관리할 수 있도록 합니다. 레코드를 생성 및 업데이트하고, 리드와 기회를 관리하며, SOQL 쿼리를 실행하고, AI 기반 자동화로 CRM 워크플로를 간소화하세요.

## 사전 준비 사항

Salesforce 통합을 사용하기 전에 다음을 확인하세요:

* 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
* 적절한 권한이 있는 Salesforce 계정
* [통합 페이지](https://app.crewai.com/integrations)를 통해 Salesforce 계정 연결

<Note>
  Salesforce는 사용자가 연결하기 전에 **관리자가 CrewAI 패키지를 한 번 설치**
  해야 합니다. 이는 Spring '26 릴리스부터 모든 ExternalClientApp 기반 통합에
  적용되는 Salesforce 플랫폼의 요구 사항이며, CrewAI 고유의 단계가 아닙니다.
  CrewAI AMP의 Connect Salesforce 플로우가 첫 연결 시 이 과정을 안내합니다.
</Note>

## Salesforce 통합 설정

### 1. Salesforce 계정 연결

1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/unified_tools)으로 이동합니다.
2. 인증 통합 섹션에서 **Salesforce**를 찾습니다.
3. **연결**을 클릭합니다.

이후 동작은 관리자가 조직에 CrewAI 패키지를 이미 설치했는지에 따라 달라집니다:

* **패키지가 이미 설치된 경우:** 곧바로 Salesforce OAuth 동의 화면으로
  이동합니다. 승인하면 연결이 완료됩니다.
* **패키지가 아직 설치되지 않은 경우:** **Install CrewAI in Salesforce**
  페이지가 표시됩니다. 아래의 일회성 설치 단계를 따른 뒤, CrewAI AMP로
  돌아와 **연결**을 다시 클릭하세요.

4. CRM 및 영업 관리에 필요한 권한을 부여합니다.
5. [통합 설정](https://app.crewai.com/crewai_plus/settings/integrations)에서 Enterprise Token을 복사합니다.

#### 일회성 관리자 설치 (Salesforce 관리자 전용)

조직 내 누군가 **Connect Salesforce**를 처음 클릭하면, CrewAI는 CrewAI
관리형 패키지의 설치 페이지로 리디렉션합니다. Salesforce 관리자가 조직
전체를 위해 한 번만 설치하면 됩니다.

1. CrewAI 내 설치 페이지에서 **Install in Salesforce**를 클릭합니다.
   (해당 페이지 URL을 관리자에게 공유해도 됩니다. 설치 링크는 누구든 열 수
   있도록 동작합니다.)
2. 관리자 권한으로 Salesforce에 로그인합니다. 샌드박스 환경에서는 URL의
   `login.salesforce.com`을 `test.salesforce.com`으로 바꾼 뒤 엽니다.
3. **Install for All Users**를 선택하고, 서드파티 앱 동의 항목을 확인한 뒤
   **Install**을 클릭합니다.
4. Salesforce Setup에서 **External Client App Manager** → **CrewAI App** →
   **Policies** 탭 → **Edit**로 이동하여 다음과 같이 설정합니다:
   * **Permitted Users:** All users may self-authorize
   * **IP Relaxation:** Relax IP restrictions
   * **Refresh Token Policy:** Refresh token is valid until revoked
5. 저장합니다.
6. CrewAI AMP로 돌아가 **Connect Salesforce**를 다시 클릭합니다. 이번에는
   OAuth가 정상적으로 완료됩니다.

<Note>
  **Salesforce 관리자가 아니신가요?** 설치 페이지의 URL(또는 설치 링크 자체)
  을 Salesforce 관리자에게 전달하고 위 단계를 진행해 달라고 요청하세요.
  관리자가 완료하면 CrewAI AMP로 돌아와 **연결**을 다시 클릭하면 됩니다.
</Note>

### 2. 필수 패키지 설치

```bash theme={null}
uv add crewai-tools
```

### 3. 환경 변수 설정

<Note>
  `Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
  `CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>

```bash theme={null}
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
```

또는 `.env` 파일에 추가하세요:

```
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```

## 사용 가능한 도구

### **레코드 관리**

<AccordionGroup>
  <Accordion title="salesforce/create_record_contact">
    **설명:** Salesforce에서 새로운 Contact 레코드를 생성합니다.

    **파라미터:**

    * `FirstName` (string, 선택): 이름
    * `LastName` (string, 필수): 성 - 이 필드는 필수입니다
    * `accountId` (string, 선택): Account ID - 이 Contact가 소속된 Account
    * `Email` (string, 선택): 이메일 주소
    * `Title` (string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)
    * `Description` (string, 선택): Contact에 대한 설명
    * `additionalFields` (object, 선택): 사용자 정의 Contact 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/create_record_lead">
    **설명:** Salesforce에서 새로운 Lead 레코드를 생성합니다.

    **파라미터:**

    * `FirstName` (string, 선택): 이름
    * `LastName` (string, 필수): 성 - 이 필드는 필수입니다
    * `Company` (string, 필수): 회사명 - 이 필드는 필수입니다
    * `Email` (string, 선택): 이메일 주소
    * `Phone` (string, 선택): 전화번호
    * `Website` (string, 선택): 웹사이트 URL
    * `Title` (string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)
    * `Status` (string, 선택): 리드 상태 - 리드 상태를 선택하려면 Connect Portal Workflow 설정을 사용하세요
    * `Description` (string, 선택): Lead에 대한 설명
    * `additionalFields` (object, 선택): 사용자 정의 Lead 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/create_record_opportunity">
    **설명:** Salesforce에서 새로운 Opportunity 레코드를 생성합니다.

    **파라미터:**

    * `Name` (string, 필수): Opportunity 이름 - 이 필드는 필수입니다
    * `StageName` (string, 선택): Opportunity 단계 - 단계를 선택하려면 Connect Portal Workflow 설정을 사용하세요
    * `CloseDate` (string, 선택): 마감일(YYYY-MM-DD 형식) - 기본값은 현재 날짜로부터 30일 이후
    * `AccountId` (string, 선택): 이 Opportunity가 소속된 Account
    * `Amount` (string, 선택): 예상 전체 판매 금액
    * `Description` (string, 선택): Opportunity에 대한 설명
    * `OwnerId` (string, 선택): 이 Opportunity를 담당하는 Salesforce 사용자
    * `NextStep` (string, 선택): Opportunity 마감을 위한 다음 작업의 설명
    * `additionalFields` (object, 선택): 사용자 정의 Opportunity 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/create_record_task">
    **설명:** Salesforce에서 새로운 Task 레코드를 생성합니다.

    **파라미터:**

    * `whatId` (string, 선택): 관련 ID - 이 Task가 관련된 Account 또는 Opportunity의 ID
    * `whoId` (string, 선택): 이름 ID - 이 Task가 관련된 Contact 또는 Lead의 ID
    * `subject` (string, 필수): 작업 제목
    * `activityDate` (string, 선택): 작업 날짜(YYYY-MM-DD 형식)
    * `description` (string, 선택): Task에 대한 설명
    * `taskSubtype` (string, 필수): Task 하위 유형 - 선택 항목: task, email, listEmail, call
    * `Status` (string, 선택): 상태 - 선택 항목: Not Started, In Progress, Completed
    * `ownerId` (string, 선택): 담당자 ID - 이 Task를 담당하는 Salesforce 사용자
    * `callDurationInSeconds` (string, 선택): 통화 시간(초)
    * `isReminderSet` (boolean, 선택): 알림 설정 여부
    * `reminderDateTime` (string, 선택): 알림 날짜/시간(ISO 형식)
    * `additionalFields` (object, 선택): 사용자 정의 Task 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/create_record_account">
    **설명:** Salesforce에서 새로운 Account 레코드를 생성합니다.

    **파라미터:**

    * `Name` (string, 필수): Account 이름 - 이 필드는 필수입니다
    * `OwnerId` (string, 선택): 이 Account를 담당하는 Salesforce 사용자
    * `Website` (string, 선택): 웹사이트 URL
    * `Phone` (string, 선택): 전화번호
    * `Description` (string, 선택): Account 설명
    * `additionalFields` (object, 선택): 사용자 정의 Account 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/create_record_any">
    **설명:** Salesforce에서 모든 오브젝트 유형의 레코드를 생성합니다.

    **참고:** 이 기능은 사용자 정의 또는 알려지지 않은 오브젝트 유형의 레코드를 생성할 때 유연하게 사용할 수 있습니다.
  </Accordion>
</AccordionGroup>

### **레코드 업데이트**

<AccordionGroup>
  <Accordion title="salesforce/update_record_contact">
    **설명:** Salesforce에서 기존 연락처(Contact) 레코드를 업데이트합니다.

    **파라미터:**

    * `recordId` (string, 필수): 업데이트할 레코드의 ID
    * `FirstName` (string, 선택): 이름
    * `LastName` (string, 선택): 성
    * `accountId` (string, 선택): 계정 ID - 연락처가 속한 계정
    * `Email` (string, 선택): 이메일 주소
    * `Title` (string, 선택): 연락처의 직함
    * `Description` (string, 선택): 연락처에 대한 설명
    * `additionalFields` (object, 선택): 커스텀 연락처 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/update_record_lead">
    **설명:** Salesforce에서 기존 리드(Lead) 레코드를 업데이트합니다.

    **파라미터:**

    * `recordId` (string, 필수): 업데이트할 레코드의 ID
    * `FirstName` (string, 선택): 이름
    * `LastName` (string, 선택): 성
    * `Company` (string, 선택): 회사명
    * `Email` (string, 선택): 이메일 주소
    * `Phone` (string, 선택): 전화번호
    * `Website` (string, 선택): 웹사이트 URL
    * `Title` (string, 선택): 연락처의 직함
    * `Status` (string, 선택): 리드 상태
    * `Description` (string, 선택): 리드에 대한 설명
    * `additionalFields` (object, 선택): 커스텀 리드 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/update_record_opportunity">
    **설명:** Salesforce에서 기존 기회(Opportunity) 레코드를 업데이트합니다.

    **파라미터:**

    * `recordId` (string, 필수): 업데이트할 레코드의 ID
    * `Name` (string, 선택): 기회명
    * `StageName` (string, 선택): 기회 단계
    * `CloseDate` (string, 선택): 마감 날짜 (YYYY-MM-DD 형식)
    * `AccountId` (string, 선택): 기회가 속한 계정
    * `Amount` (string, 선택): 예상 총 판매 금액
    * `Description` (string, 선택): 기회에 대한 설명
    * `OwnerId` (string, 선택): 이 기회를 담당하는 Salesforce 사용자
    * `NextStep` (string, 선택): 기회 마감을 위한 다음 작업의 설명
    * `additionalFields` (object, 선택): 커스텀 기회 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/update_record_task">
    **설명:** Salesforce에서 기존 작업(Task) 레코드를 업데이트합니다.

    **파라미터:**

    * `recordId` (string, 필수): 업데이트할 레코드의 ID
    * `whatId` (string, 선택): 관련 ID - 이 작업이 연결된 계정 또는 기회의 ID
    * `whoId` (string, 선택): 이름 ID - 이 작업이 연결된 연락처 또는 리드의 ID
    * `subject` (string, 선택): 작업의 주제
    * `activityDate` (string, 선택): 활동 날짜 (YYYY-MM-DD 형식)
    * `description` (string, 선택): 작업에 대한 설명
    * `Status` (string, 선택): 상태 - 옵션: Not Started, In Progress, Completed
    * `ownerId` (string, 선택): 담당자 ID - 이 작업을 할당받은 Salesforce 사용자
    * `callDurationInSeconds` (string, 선택): 통화 시간(초)
    * `isReminderSet` (boolean, 선택): 알림 설정 여부
    * `reminderDateTime` (string, 선택): 알림 날짜/시간 (ISO 형식)
    * `additionalFields` (object, 선택): 커스텀 작업 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/update_record_account">
    **설명:** Salesforce에서 기존 계정(Account) 레코드를 업데이트합니다.

    **파라미터:**

    * `recordId` (string, 필수): 업데이트할 레코드의 ID
    * `Name` (string, 선택): 계정 이름
    * `OwnerId` (string, 선택): 이 계정에 할당된 Salesforce 사용자
    * `Website` (string, 선택): 웹사이트 URL
    * `Phone` (string, 선택): 전화번호
    * `Description` (string, 선택): 계정 설명
    * `additionalFields` (object, 선택): 커스텀 계정 필드를 위한 JSON 형식의 추가 필드
  </Accordion>

  <Accordion title="salesforce/update_record_any">
    **설명:** Salesforce에서 어떤 객체 유형이든 레코드를 업데이트합니다.

    **참고:** 이는 커스텀 또는 미확인 객체 유형의 레코드 업데이트를 위한 유연한 도구입니다.
  </Accordion>
</AccordionGroup>

### **레코드 조회**

<AccordionGroup>
  <Accordion title="salesforce/get_record_by_id_contact">
    **설명:** ID로 Contact 레코드를 조회합니다.

    **파라미터:**

    * `recordId` (string, 필수): Contact의 레코드 ID
  </Accordion>

  <Accordion title="salesforce/get_record_by_id_lead">
    **설명:** ID로 Lead 레코드를 조회합니다.

    **파라미터:**

    * `recordId` (string, 필수): Lead의 레코드 ID
  </Accordion>

  <Accordion title="salesforce/get_record_by_id_opportunity">
    **설명:** ID로 Opportunity 레코드를 조회합니다.

    **파라미터:**

    * `recordId` (string, 필수): Opportunity의 레코드 ID
  </Accordion>

  <Accordion title="salesforce/get_record_by_id_task">
    **설명:** ID로 Task 레코드를 조회합니다.

    **파라미터:**

    * `recordId` (string, 필수): Task의 레코드 ID
  </Accordion>

  <Accordion title="salesforce/get_record_by_id_account">
    **설명:** ID로 Account 레코드를 조회합니다.

    **파라미터:**

    * `recordId` (string, 필수): Account의 레코드 ID
  </Accordion>

  <Accordion title="salesforce/get_record_by_id_any">
    **설명:** ID로 임의 객체 유형의 레코드를 조회합니다.

    **파라미터:**

    * `recordType` (string, 필수): 레코드 유형 (예: "CustomObject\_\_c")
    * `recordId` (string, 필수): 레코드 ID
  </Accordion>
</AccordionGroup>

### **레코드 검색**

<AccordionGroup>
  <Accordion title="salesforce/search_records_contact">
    **설명:** 고급 필터링으로 연락처(Contact) 레코드를 검색합니다.

    **파라미터:**

    * `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형(Disjunctive Normal Form)의 고급 필터
    * `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
    * `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
    * `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
    * `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/search_records_lead">
    **설명:** 고급 필터링으로 리드(Lead) 레코드를 검색합니다.

    **파라미터:**

    * `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
    * `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
    * `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
    * `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
    * `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/search_records_opportunity">
    **설명:** 고급 필터링으로 기회(Opportunity) 레코드를 검색합니다.

    **파라미터:**

    * `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
    * `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
    * `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
    * `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
    * `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/search_records_task">
    **설명:** 고급 필터링으로 작업(Task) 레코드를 검색합니다.

    **파라미터:**

    * `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
    * `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
    * `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
    * `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
    * `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/search_records_account">
    **설명:** 고급 필터링으로 계정(Account) 레코드를 검색합니다.

    **파라미터:**

    * `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
    * `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
    * `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
    * `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
    * `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/search_records_any">
    **설명:** 모든 오브젝트 유형의 레코드를 검색합니다.

    **파라미터:**

    * `recordType` (string, 필수): 검색할 레코드 유형
    * `filterFormula` (string, 선택): 필터 검색 조건
    * `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
    * `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
  </Accordion>
</AccordionGroup>

### **리스트 뷰 조회**

<AccordionGroup>
  <Accordion title="salesforce/get_record_by_view_id_contact">
    **설명:** 특정 리스트 뷰에서 Contact 레코드를 가져옵니다.

    **파라미터:**

    * `listViewId` (string, 필수): 리스트 뷰 ID
    * `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/get_record_by_view_id_lead">
    **설명:** 특정 리스트 뷰에서 Lead 레코드를 가져옵니다.

    **파라미터:**

    * `listViewId` (string, 필수): 리스트 뷰 ID
    * `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/get_record_by_view_id_opportunity">
    **설명:** 특정 리스트 뷰에서 Opportunity 레코드를 가져옵니다.

    **파라미터:**

    * `listViewId` (string, 필수): 리스트 뷰 ID
    * `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/get_record_by_view_id_task">
    **설명:** 특정 리스트 뷰에서 Task 레코드를 가져옵니다.

    **파라미터:**

    * `listViewId` (string, 필수): 리스트 뷰 ID
    * `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/get_record_by_view_id_account">
    **설명:** 특정 리스트 뷰에서 Account 레코드를 가져옵니다.

    **파라미터:**

    * `listViewId` (string, 필수): 리스트 뷰 ID
    * `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
  </Accordion>

  <Accordion title="salesforce/get_record_by_view_id_any">
    **설명:** 특정 리스트 뷰에서 임의의 객체 유형의 레코드를 가져옵니다.

    **파라미터:**

    * `recordType` (string, 필수): 레코드 유형
    * `listViewId` (string, 필수): 리스트 뷰 ID
    * `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
  </Accordion>
</AccordionGroup>

### **커스텀 필드**

<AccordionGroup>
  <Accordion title="salesforce/create_custom_field_contact">
    **설명:** Contact 오브젝트에 대한 커스텀 필드를 배포합니다.

    **파라미터:**

    * `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
    * `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
    * `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
    * `length` (string, 필수): 숫자/텍스트 필드의 길이
    * `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
    * `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
    * `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
    * `description` (string, 선택): 필드 설명
    * `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
    * `defaultFieldValue` (string, 선택): 필드의 기본값
  </Accordion>

  <Accordion title="salesforce/create_custom_field_lead">
    **설명:** Lead 오브젝트에 대한 커스텀 필드를 배포합니다.

    **파라미터:**

    * `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
    * `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
    * `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
    * `length` (string, 필수): 숫자/텍스트 필드의 길이
    * `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
    * `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
    * `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
    * `description` (string, 선택): 필드 설명
    * `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
    * `defaultFieldValue` (string, 선택): 필드의 기본값
  </Accordion>

  <Accordion title="salesforce/create_custom_field_opportunity">
    **설명:** Opportunity 오브젝트에 대한 커스텀 필드를 배포합니다.

    **파라미터:**

    * `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
    * `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
    * `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
    * `length` (string, 필수): 숫자/텍스트 필드의 길이
    * `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
    * `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
    * `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
    * `description` (string, 선택): 필드 설명
    * `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
    * `defaultFieldValue` (string, 선택): 필드의 기본값
  </Accordion>

  <Accordion title="salesforce/create_custom_field_task">
    **설명:** Task 오브젝트에 대한 커스텀 필드를 배포합니다.

    **파라미터:**

    * `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
    * `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, Time, Url
    * `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
    * `length` (string, 필수): 숫자/텍스트 필드의 길이
    * `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
    * `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
    * `visibleLines` (string, 필수): 멀티셀렉트 필드의 표시 줄 수
    * `description` (string, 선택): 필드 설명
    * `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
    * `defaultFieldValue` (string, 선택): 필드의 기본값
  </Accordion>

  <Accordion title="salesforce/create_custom_field_account">
    **설명:** Account 오브젝트에 대한 커스텀 필드를 배포합니다.

    **파라미터:**

    * `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
    * `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
    * `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
    * `length` (string, 필수): 숫자/텍스트 필드의 길이
    * `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
    * `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
    * `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
    * `description` (string, 선택): 필드 설명
    * `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
    * `defaultFieldValue` (string, 선택): 필드의 기본값
  </Accordion>

  <Accordion title="salesforce/create_custom_field_any">
    **설명:** 모든 오브젝트 타입에 대한 커스텀 필드를 배포합니다.

    **참고:** 커스텀 또는 미지의 오브젝트 타입에 커스텀 필드를 생성할 수 있는 유연한 도구입니다.
  </Accordion>
</AccordionGroup>

### **고급 작업**

<AccordionGroup>
  <Accordion title="salesforce/write_soql_query">
    **설명:** Salesforce 데이터에 대해 커스텀 SOQL 쿼리를 실행합니다.

    **파라미터:**

    * `query` (string, 필수): SOQL 쿼리 (예: "SELECT Id, Name FROM Account WHERE Name = 'Example'")
  </Accordion>

  <Accordion title="salesforce/create_custom_object">
    **설명:** Salesforce에 새로운 커스텀 오브젝트를 배포합니다.

    **파라미터:**

    * `label` (string, 필수): 탭, 페이지 레이아웃, 리포트에 사용되는 오브젝트 라벨
    * `pluralLabel` (string, 필수): 복수형 라벨 (예: "Accounts")
    * `description` (string, 선택): 커스텀 오브젝트에 대한 설명
    * `recordName` (string, 필수): 레이아웃과 검색에 표시되는 레코드 이름 (예: "Account Name")
  </Accordion>

  <Accordion title="salesforce/describe_action_schema">
    **설명:** 특정 오브젝트 타입에 대한 작업의 예상 스키마를 가져옵니다.

    **파라미터:**

    * `recordType` (string, 필수): 설명할 레코드 타입
    * `operation` (string, 필수): 작업 타입 (예: "CREATE\_RECORD" 또는 "UPDATE\_RECORD")

    **참고:** 커스텀 오브젝트 작업 시, 해당 스키마를 이해하기 위해 제일 먼저 이 기능을 사용하세요.
  </Accordion>
</AccordionGroup>

## 사용 예시

### 기본 Salesforce 에이전트 설정

```python theme={null}
from crewai import Agent, Task, Crew

# Create an agent with Salesforce capabilities
salesforce_agent = Agent(
    role="CRM Manager",
    goal="Manage customer relationships and sales processes efficiently",
    backstory="An AI assistant specialized in CRM operations and sales automation.",
    apps=['salesforce']
)

# Task to create a new lead
create_lead_task = Task(
    description="Create a new lead for John Doe from Example Corp with email john.doe@example.com",
    agent=salesforce_agent,
    expected_output="Lead created successfully with lead ID"
)

# Run the task
crew = Crew(
    agents=[salesforce_agent],
    tasks=[create_lead_task]
)

crew.kickoff()
```

### 특정 Salesforce 도구 필터링

```python theme={null}

sales_manager = Agent(
    role="Sales Manager",
    goal="Manage leads and opportunities in the sales pipeline",
    backstory="An experienced sales manager who handles lead qualification and opportunity management.",
    apps=['salesforce']
)

# Task to manage sales pipeline
pipeline_task = Task(
    description="Create a qualified lead and convert it to an opportunity with $50,000 value",
    agent=sales_manager,
    expected_output="Lead created and opportunity established successfully"
)

crew = Crew(
    agents=[sales_manager],
    tasks=[pipeline_task]
)

crew.kickoff()
```

### 연락처 및 계정 관리

```python theme={null}
from crewai import Agent, Task, Crew

account_manager = Agent(
    role="Account Manager",
    goal="Manage customer accounts and maintain strong relationships",
    backstory="An AI assistant that specializes in account management and customer relationship building.",
    apps=['salesforce']
)

# Task to manage customer accounts
account_task = Task(
    description="""
    1. Create a new account for TechCorp Inc.
    2. Add John Doe as the primary contact for this account
    3. Create a follow-up task for next week to check on their project status
    """,
    agent=account_manager,
    expected_output="Account, contact, and follow-up task created successfully"
)

crew = Crew(
    agents=[account_manager],
    tasks=[account_task]
)

crew.kickoff()
```

### 고급 SOQL 쿼리 및 리포팅

```python theme={null}
from crewai import Agent, Task, Crew

data_analyst = Agent(
    role="Sales Data Analyst",
    goal="Generate insights from Salesforce data using SOQL queries",
    backstory="An analytical AI that excels at extracting meaningful insights from CRM data.",
    apps=['salesforce']
)

# Complex task involving SOQL queries and data analysis
analysis_task = Task(
    description="""
    1. Execute a SOQL query to find all opportunities closing this quarter
    2. Search for contacts at companies with opportunities over $100K
    3. Create a summary report of the sales pipeline status
    4. Update high-value opportunities with next steps
    """,
    agent=data_analyst,
    expected_output="Comprehensive sales pipeline analysis with actionable insights"
)

crew = Crew(
    agents=[data_analyst],
    tasks=[analysis_task]
)

crew.kickoff()
```

이 포괄적인 문서는 모든 Salesforce 도구를 기능별로 정리하여, 사용자가 CRM 자동화 작업에 필요한 특정 작업을 쉽게 찾을 수 있도록 도와줍니다.

### 도움 받기

<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
  Salesforce 통합 설정 또는 문제 해결에 대해 지원팀에 문의하세요.
</Card>