개요
에이전트가 Salesforce를 통해 고객 관계, 영업 프로세스 및 데이터를 관리할 수 있도록 합니다. 레코드를 생성 및 업데이트하고, 리드와 기회를 관리하며, SOQL 쿼리를 실행하고, AI 기반 자동화로 CRM 워크플로를 간소화하세요.사전 준비 사항
Salesforce 통합을 사용하기 전에 다음을 확인하세요:- 활성 구독이 있는 CrewAI AMP 계정
 - 적절한 권한이 있는 Salesforce 계정
 - 통합 페이지를 통해 Salesforce 계정 연결
 
Salesforce 통합 설정
1. Salesforce 계정 연결
- CrewAI AMP 통합으로 이동합니다.
 - 인증 통합 섹션에서 Salesforce를 찾습니다.
 - 연결을 클릭하고 OAuth 과정을 완료합니다.
 - CRM 및 영업 관리에 필요한 권한을 부여합니다.
 - 통합 설정에서 Enterprise Token을 복사합니다.
 
2. 필수 패키지 설치
3. 환경 변수 설정
Agent(apps=[])와 함께 통합을 사용하려면 Enterprise Token으로 CREWAI_PLATFORM_INTEGRATION_TOKEN 환경 변수를 설정해야 합니다..env 파일에 추가하세요:
사용 가능한 도구
레코드 관리
salesforce/create_record_contact
salesforce/create_record_contact
FirstName(string, 선택): 이름LastName(string, 필수): 성 - 이 필드는 필수입니다accountId(string, 선택): Account ID - 이 Contact가 소속된 AccountEmail(string, 선택): 이메일 주소Title(string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)Description(string, 선택): Contact에 대한 설명additionalFields(object, 선택): 사용자 정의 Contact 필드를 위한 JSON 형식의 추가 필드
salesforce/create_record_lead
salesforce/create_record_lead
FirstName(string, 선택): 이름LastName(string, 필수): 성 - 이 필드는 필수입니다Company(string, 필수): 회사명 - 이 필드는 필수입니다Email(string, 선택): 이메일 주소Phone(string, 선택): 전화번호Website(string, 선택): 웹사이트 URLTitle(string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)Status(string, 선택): 리드 상태 - 리드 상태를 선택하려면 Connect Portal Workflow 설정을 사용하세요Description(string, 선택): Lead에 대한 설명additionalFields(object, 선택): 사용자 정의 Lead 필드를 위한 JSON 형식의 추가 필드
salesforce/create_record_opportunity
salesforce/create_record_opportunity
Name(string, 필수): Opportunity 이름 - 이 필드는 필수입니다StageName(string, 선택): Opportunity 단계 - 단계를 선택하려면 Connect Portal Workflow 설정을 사용하세요CloseDate(string, 선택): 마감일(YYYY-MM-DD 형식) - 기본값은 현재 날짜로부터 30일 이후AccountId(string, 선택): 이 Opportunity가 소속된 AccountAmount(string, 선택): 예상 전체 판매 금액Description(string, 선택): Opportunity에 대한 설명OwnerId(string, 선택): 이 Opportunity를 담당하는 Salesforce 사용자NextStep(string, 선택): Opportunity 마감을 위한 다음 작업의 설명additionalFields(object, 선택): 사용자 정의 Opportunity 필드를 위한 JSON 형식의 추가 필드
salesforce/create_record_task
salesforce/create_record_task
whatId(string, 선택): 관련 ID - 이 Task가 관련된 Account 또는 Opportunity의 IDwhoId(string, 선택): 이름 ID - 이 Task가 관련된 Contact 또는 Lead의 IDsubject(string, 필수): 작업 제목activityDate(string, 선택): 작업 날짜(YYYY-MM-DD 형식)description(string, 선택): Task에 대한 설명taskSubtype(string, 필수): Task 하위 유형 - 선택 항목: task, email, listEmail, callStatus(string, 선택): 상태 - 선택 항목: Not Started, In Progress, CompletedownerId(string, 선택): 담당자 ID - 이 Task를 담당하는 Salesforce 사용자callDurationInSeconds(string, 선택): 통화 시간(초)isReminderSet(boolean, 선택): 알림 설정 여부reminderDateTime(string, 선택): 알림 날짜/시간(ISO 형식)additionalFields(object, 선택): 사용자 정의 Task 필드를 위한 JSON 형식의 추가 필드
salesforce/create_record_account
salesforce/create_record_account
Name(string, 필수): Account 이름 - 이 필드는 필수입니다OwnerId(string, 선택): 이 Account를 담당하는 Salesforce 사용자Website(string, 선택): 웹사이트 URLPhone(string, 선택): 전화번호Description(string, 선택): Account 설명additionalFields(object, 선택): 사용자 정의 Account 필드를 위한 JSON 형식의 추가 필드
salesforce/create_record_any
salesforce/create_record_any
레코드 업데이트
salesforce/update_record_contact
salesforce/update_record_contact
recordId(string, 필수): 업데이트할 레코드의 IDFirstName(string, 선택): 이름LastName(string, 선택): 성accountId(string, 선택): 계정 ID - 연락처가 속한 계정Email(string, 선택): 이메일 주소Title(string, 선택): 연락처의 직함Description(string, 선택): 연락처에 대한 설명additionalFields(object, 선택): 커스텀 연락처 필드를 위한 JSON 형식의 추가 필드
salesforce/update_record_lead
salesforce/update_record_lead
recordId(string, 필수): 업데이트할 레코드의 IDFirstName(string, 선택): 이름LastName(string, 선택): 성Company(string, 선택): 회사명Email(string, 선택): 이메일 주소Phone(string, 선택): 전화번호Website(string, 선택): 웹사이트 URLTitle(string, 선택): 연락처의 직함Status(string, 선택): 리드 상태Description(string, 선택): 리드에 대한 설명additionalFields(object, 선택): 커스텀 리드 필드를 위한 JSON 형식의 추가 필드
salesforce/update_record_opportunity
salesforce/update_record_opportunity
recordId(string, 필수): 업데이트할 레코드의 IDName(string, 선택): 기회명StageName(string, 선택): 기회 단계CloseDate(string, 선택): 마감 날짜 (YYYY-MM-DD 형식)AccountId(string, 선택): 기회가 속한 계정Amount(string, 선택): 예상 총 판매 금액Description(string, 선택): 기회에 대한 설명OwnerId(string, 선택): 이 기회를 담당하는 Salesforce 사용자NextStep(string, 선택): 기회 마감을 위한 다음 작업의 설명additionalFields(object, 선택): 커스텀 기회 필드를 위한 JSON 형식의 추가 필드
salesforce/update_record_task
salesforce/update_record_task
recordId(string, 필수): 업데이트할 레코드의 IDwhatId(string, 선택): 관련 ID - 이 작업이 연결된 계정 또는 기회의 IDwhoId(string, 선택): 이름 ID - 이 작업이 연결된 연락처 또는 리드의 IDsubject(string, 선택): 작업의 주제activityDate(string, 선택): 활동 날짜 (YYYY-MM-DD 형식)description(string, 선택): 작업에 대한 설명Status(string, 선택): 상태 - 옵션: Not Started, In Progress, CompletedownerId(string, 선택): 담당자 ID - 이 작업을 할당받은 Salesforce 사용자callDurationInSeconds(string, 선택): 통화 시간(초)isReminderSet(boolean, 선택): 알림 설정 여부reminderDateTime(string, 선택): 알림 날짜/시간 (ISO 형식)additionalFields(object, 선택): 커스텀 작업 필드를 위한 JSON 형식의 추가 필드
salesforce/update_record_account
salesforce/update_record_account
recordId(string, 필수): 업데이트할 레코드의 IDName(string, 선택): 계정 이름OwnerId(string, 선택): 이 계정에 할당된 Salesforce 사용자Website(string, 선택): 웹사이트 URLPhone(string, 선택): 전화번호Description(string, 선택): 계정 설명additionalFields(object, 선택): 커스텀 계정 필드를 위한 JSON 형식의 추가 필드
salesforce/update_record_any
salesforce/update_record_any
레코드 조회
salesforce/get_record_by_id_contact
salesforce/get_record_by_id_contact
recordId(string, 필수): Contact의 레코드 ID
salesforce/get_record_by_id_lead
salesforce/get_record_by_id_lead
recordId(string, 필수): Lead의 레코드 ID
salesforce/get_record_by_id_opportunity
salesforce/get_record_by_id_opportunity
recordId(string, 필수): Opportunity의 레코드 ID
salesforce/get_record_by_id_task
salesforce/get_record_by_id_task
recordId(string, 필수): Task의 레코드 ID
salesforce/get_record_by_id_account
salesforce/get_record_by_id_account
recordId(string, 필수): Account의 레코드 ID
salesforce/get_record_by_id_any
salesforce/get_record_by_id_any
recordType(string, 필수): 레코드 유형 (예: “CustomObject__c”)recordId(string, 필수): 레코드 ID
레코드 검색
salesforce/search_records_contact
salesforce/search_records_contact
filterFormula(object, 선택): 필드별 연산자가 지정된 분리적 정규형(Disjunctive Normal Form)의 고급 필터sortBy(string, 선택): 정렬 기준 필드 (예: “CreatedDate”)sortDirection(string, 선택): 정렬 방향 - 옵션: ASC, DESCincludeAllFields(boolean, 선택): 결과에 모든 필드를 포함paginationParameters(object, 선택): pageCursor를 포함한 페이지네이션 설정
salesforce/search_records_lead
salesforce/search_records_lead
filterFormula(object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터sortBy(string, 선택): 정렬 기준 필드 (예: “CreatedDate”)sortDirection(string, 선택): 정렬 방향 - 옵션: ASC, DESCincludeAllFields(boolean, 선택): 결과에 모든 필드를 포함paginationParameters(object, 선택): pageCursor를 포함한 페이지네이션 설정
salesforce/search_records_opportunity
salesforce/search_records_opportunity
filterFormula(object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터sortBy(string, 선택): 정렬 기준 필드 (예: “CreatedDate”)sortDirection(string, 선택): 정렬 방향 - 옵션: ASC, DESCincludeAllFields(boolean, 선택): 결과에 모든 필드를 포함paginationParameters(object, 선택): pageCursor를 포함한 페이지네이션 설정
salesforce/search_records_task
salesforce/search_records_task
filterFormula(object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터sortBy(string, 선택): 정렬 기준 필드 (예: “CreatedDate”)sortDirection(string, 선택): 정렬 방향 - 옵션: ASC, DESCincludeAllFields(boolean, 선택): 결과에 모든 필드를 포함paginationParameters(object, 선택): pageCursor를 포함한 페이지네이션 설정
salesforce/search_records_account
salesforce/search_records_account
filterFormula(object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터sortBy(string, 선택): 정렬 기준 필드 (예: “CreatedDate”)sortDirection(string, 선택): 정렬 방향 - 옵션: ASC, DESCincludeAllFields(boolean, 선택): 결과에 모든 필드를 포함paginationParameters(object, 선택): pageCursor를 포함한 페이지네이션 설정
salesforce/search_records_any
salesforce/search_records_any
recordType(string, 필수): 검색할 레코드 유형filterFormula(string, 선택): 필터 검색 조건includeAllFields(boolean, 선택): 결과에 모든 필드를 포함paginationParameters(object, 선택): pageCursor를 포함한 페이지네이션 설정
리스트 뷰 조회
salesforce/get_record_by_view_id_contact
salesforce/get_record_by_view_id_contact
listViewId(string, 필수): 리스트 뷰 IDpaginationParameters(object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
salesforce/get_record_by_view_id_lead
salesforce/get_record_by_view_id_lead
listViewId(string, 필수): 리스트 뷰 IDpaginationParameters(object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
salesforce/get_record_by_view_id_opportunity
salesforce/get_record_by_view_id_opportunity
listViewId(string, 필수): 리스트 뷰 IDpaginationParameters(object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
salesforce/get_record_by_view_id_task
salesforce/get_record_by_view_id_task
listViewId(string, 필수): 리스트 뷰 IDpaginationParameters(object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
salesforce/get_record_by_view_id_account
salesforce/get_record_by_view_id_account
listViewId(string, 필수): 리스트 뷰 IDpaginationParameters(object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
salesforce/get_record_by_view_id_any
salesforce/get_record_by_view_id_any
recordType(string, 필수): 레코드 유형listViewId(string, 필수): 리스트 뷰 IDpaginationParameters(object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
커스텀 필드
salesforce/create_custom_field_contact
salesforce/create_custom_field_contact
label(string, 필수): 표시 및 내부 참조를 위한 필드 라벨type(string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue(boolean, 선택): 체크박스 필드의 기본값length(string, 필수): 숫자/텍스트 필드의 길이decimalPlace(string, 필수): 숫자 필드의 소수 자릿수pickListValues(string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)visibleLines(string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수description(string, 선택): 필드 설명helperText(string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트defaultFieldValue(string, 선택): 필드의 기본값
salesforce/create_custom_field_lead
salesforce/create_custom_field_lead
label(string, 필수): 표시 및 내부 참조를 위한 필드 라벨type(string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue(boolean, 선택): 체크박스 필드의 기본값length(string, 필수): 숫자/텍스트 필드의 길이decimalPlace(string, 필수): 숫자 필드의 소수 자릿수pickListValues(string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)visibleLines(string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수description(string, 선택): 필드 설명helperText(string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트defaultFieldValue(string, 선택): 필드의 기본값
salesforce/create_custom_field_opportunity
salesforce/create_custom_field_opportunity
label(string, 필수): 표시 및 내부 참조를 위한 필드 라벨type(string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue(boolean, 선택): 체크박스 필드의 기본값length(string, 필수): 숫자/텍스트 필드의 길이decimalPlace(string, 필수): 숫자 필드의 소수 자릿수pickListValues(string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)visibleLines(string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수description(string, 선택): 필드 설명helperText(string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트defaultFieldValue(string, 선택): 필드의 기본값
salesforce/create_custom_field_task
salesforce/create_custom_field_task
label(string, 필수): 표시 및 내부 참조를 위한 필드 라벨type(string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, Time, UrldefaultCheckboxValue(boolean, 선택): 체크박스 필드의 기본값length(string, 필수): 숫자/텍스트 필드의 길이decimalPlace(string, 필수): 숫자 필드의 소수 자릿수pickListValues(string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)visibleLines(string, 필수): 멀티셀렉트 필드의 표시 줄 수description(string, 선택): 필드 설명helperText(string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트defaultFieldValue(string, 선택): 필드의 기본값
salesforce/create_custom_field_account
salesforce/create_custom_field_account
label(string, 필수): 표시 및 내부 참조를 위한 필드 라벨type(string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, UrldefaultCheckboxValue(boolean, 선택): 체크박스 필드의 기본값length(string, 필수): 숫자/텍스트 필드의 길이decimalPlace(string, 필수): 숫자 필드의 소수 자릿수pickListValues(string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)visibleLines(string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수description(string, 선택): 필드 설명helperText(string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트defaultFieldValue(string, 선택): 필드의 기본값
salesforce/create_custom_field_any
salesforce/create_custom_field_any
고급 작업
salesforce/write_soql_query
salesforce/write_soql_query
query(string, 필수): SOQL 쿼리 (예: “SELECT Id, Name FROM Account WHERE Name = ‘Example’”)
salesforce/create_custom_object
salesforce/create_custom_object
label(string, 필수): 탭, 페이지 레이아웃, 리포트에 사용되는 오브젝트 라벨pluralLabel(string, 필수): 복수형 라벨 (예: “Accounts”)description(string, 선택): 커스텀 오브젝트에 대한 설명recordName(string, 필수): 레이아웃과 검색에 표시되는 레코드 이름 (예: “Account Name”)
salesforce/describe_action_schema
salesforce/describe_action_schema
recordType(string, 필수): 설명할 레코드 타입operation(string, 필수): 작업 타입 (예: “CREATE_RECORD” 또는 “UPDATE_RECORD”)
