개요
에이전트가 Salesforce를 통해 고객 관계, 영업 프로세스 및 데이터를 관리할 수 있도록 합니다. 레코드를 생성 및 업데이트하고, 리드와 기회를 관리하며, SOQL 쿼리를 실행하고, AI 기반 자동화로 CRM 워크플로를 간소화하세요.사전 준비 사항
Salesforce 통합을 사용하기 전에 다음을 확인하세요:- 활성 구독이 있는 CrewAI Enterprise 계정
- 적절한 권한이 있는 Salesforce 계정
- 통합 페이지를 통해 Salesforce 계정 연결
사용 가능한 도구
레코드 관리
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”)