Capsule CRM 자동화은(는) 무엇을 하나요?
Capsule CRM을 관리하세요. 연락처 생성 및 업데이트, 파티/기회/케이스에 대한 강력한 필터 쿼리 실행, 작업 및 프로젝트 추적, 활동 항목 조회, 팀 관계 정리 등을 모두 자연어 명령으로 수행할 수 있습니다.
도구 설명서: composio.dev/toolkits/capsule_crm
설정
- 클라이언트 설정에 Composio MCP 서버를 추가합니다:
https://rube.app/mcp - 메시지가 표시되면 Capsule CRM 계정을 연결합니다(OAuth 인증).
- 자연어 명령을 사용하여 CRM을 관리하기 시작합니다.
핵심 워크플로
1. 구조화된 필터 쿼리 실행
파티, 기회 또는 케이스(프로젝트)를 여러 필터 조건, 연산자 및 정렬을 사용하여 조회합니다.
도구: CAPSULE_CRM_RUN_FILTER_QUERY
예시 프롬프트:
"캘리포니아에 있는 'VIP' 태그가 지정된 모든 Capsule CRM 연락처를 이름순으로 정렬하여 찾아줘"
주요 매개변수:
entity(필수) -- 다음 중 하나:parties,opportunities,kasesfilter(필수) -- 필터 객체:conditions-- 조건 배열, 각 조건:field-- 필드 이름 (예: "name", "email", "state", "country", "tag", "owner", "jobTitle", "addedOn")operator-- 다음 중 하나: "is", "is not", "starts with", "ends with", "contains", "is greater than", "is less than", "is after", "is before", "is older than", "is within last", "is within next"value-- 비교할 값
orderBy--field와direction("ascending"/"descending")을 포함한 정렬 객체 배열
embed-- 응답에 포함할 추가 데이터page/perPage-- 페이지네이션(페이지당 최대 100개)
중요 필드 참고사항:
- 주소 필드(
city,state,country,zip)는 "address" 아래에 중첩되지 않고 최상위 레벨입니다. - 국가 코드는 ISO 3166-1 alpha-2 코드(예: "US", "GB", "CA")여야 합니다.
- 사용자 정의 필드는
custom:{fieldId}형식을 사용합니다. - 조직 필드는
org.접두사를 사용합니다(예:org.name,org.tag).
2. 연락처(파티) 목록 보기 및 관리
수정 날짜 및 임베드된 관련 데이터로 선택적 필터링을 통해 모든 연락처를 검색합니다.
도구: CAPSULE_CRM_LIST_PARTIES
예시 프롬프트:
"2025년 1월 이후 수정된 모든 Capsule CRM 연락처를 태그와 조직 정보와 함께 보여줘"
주요 매개변수:
since-- 이 날짜 이후 변경된 연락처를 필터링하는 ISO8601 날짜embed-- 추가 데이터: "tags", "fields", "organisation", "missingImportantFields"page/perPage-- 페이지네이션(페이지당 최대 100개, 기본값 50)
3. 새 연락처 생성
이메일, 전화번호, 주소, 태그 및 사용자 정의 필드를 포함한 전체 세부 정보로 Capsule CRM에 개인 또는 조직을 추가합니다.
도구: CAPSULE_CRM_CREATE_PARTY
예시 프롬프트:
"Capsule CRM에 새 사람을 생성해줘: John Smith, Acme Corp의 영업 부사장, [email protected]"
주요 매개변수:
type(필수) -- "person" 또는 "organisation"- 개인:
firstName,lastName,jobTitle,title - 조직:
name emailAddresses--{address, type}객체 배열phoneNumbers--{number, type}객체 배열addresses--street,city,state,country,zip,type(Home/Postal/Office/Billing/Shipping)을 포함한 주소 객체 배열organisation--{id}또는{name}으로 조직에 연결(찾을 수 없으면 생성)tags--{name}또는{id}로 태그 배열fields--{definition, value}가 있는 사용자 정의 필드 값websites--{address, service, type}객체 배열owner-- 소유자 사용자{id}할당
4. 기존 연락처 업데이트
이메일, 전화번호, 태그 및 사용자 정의 필드 추가/제거를 포함하여 파티 레코드의 모든 측면을 수정합니다.
도구: CAPSULE_CRM_UPDATE_PARTY
예시 프롬프트:
"Capsule CRM 파티 11587을 업데이트해줘: 업무 이메일 [email protected]을 추가하고 'prospect' 태그를 제거해줘"
주요 매개변수:
partyId(필수) -- 업데이트할 파티의 정수 IDparty(필수) -- 업데이트할 필드가 있는 객체. 지원:- 모든 생성 필드(이름, 이메일, 전화번호, 주소 등)
- 하위 항목을 제거하려면
_delete: true사용(항목의id필요) - 태그:
{name}으로 추가하거나{id, _delete: true}로 제거
5. 작업 추적
상태별로 필터링하고 관련 데이터를 임베드하여 작업 목록을 표시합니다.
도구: CAPSULE_CRM_LIST_TASKS
예시 프롬프트:
"Capsule CRM의 모든 열린 작업을 연결된 파티와 소유자와 함께 보여줘"
주요 매개변수:
status-- 상태별 필터: "open", "completed", "pending" (배열)embed-- 추가 데이터: "party", "opportunity", "kase", "owner", "nextTask"page/perPage-- 페이지네이션(페이지당 최대 100개, 기본값 50)
6. 프로젝트 및 활동 항목 탐색
프로젝트(케이스) 및 최근 활동 항목(노트, 이메일, 완료된 작업 포함) 목록을 표시합니다.
도구: CAPSULE_CRM_LIST_PROJECTS, CAPSULE_CRM_LIST_ENTRIES_BY_DATE
예시 프롬프트:
"Capsule CRM의 모든 열린 프로젝트를 보여줘" / "파티 세부 정보와 함께 최근 활동 항목을 보여줘"
프로젝트 주요 매개변수:
status-- "OPEN" 또는 "CLOSED"로 필터search-- 프로젝트 이름/설명 검색어since-- 이 날짜 이후 수정된 항목을 필터링하는 ISO8601 날짜embed-- "tags,fields,party,opportunity,missingImportantFields"
항목 주요 매개변수:
embed-- "party", "kase", "opportunity", "creator", "activityType"page/perPage-- 페이지네이션(페이지당 최대 100개)
알려진 문제점
- 주소 필드는 최상위 레벨입니다: 필터링 시
address.state또는 중첩 구문 대신state,city,country,zip을 직접 사용하세요. - 국가 코드는 ISO alpha-2입니다: "United States" 또는 "United Kingdom"이 아닌 "US", "GB", "CA"로 필터링하세요.
- 사용자 정의 필드는 특수 구문을 사용합니다: 필터 조건에서 사용자 정의 필드를
custom:{fieldId}로 참조하세요. 조직 수준 사용자 정의 필드의 경우org.custom:{fieldId}를 사용하세요. - API에서 프로젝트는 "kases"라고 합니다: UI에서는 "프로젝트"이지만 API 엔티티 타입은
kases입니다. 필터 쿼리에서는kases를 사용하세요. - 삭제 작업에는 항목 ID가 필요합니다: 하위 항목(이메일, 전화번호, 태그)을 제거하기 위해 파티를 업데이트할 때는 항목의
id와 함께_delete: true를 포함해야 합니다. 하위 항목 ID를 얻으려면 먼저 파티 목록을 조회하세요. - 페이지네이션 기본값은 50입니다: 모든 목록 엔드포인트의 기본값은 페이지당 50개이며 최대 100개입니다. 완전한 데이터 검색을 위해 항상 페이지네이션을 구현하세요.
- 임베드 값은 엔티티에 따라 다릅니다: 모든 엔드포인트에서 모든 임베드 옵션이 작동하는 것은 아닙니다. 엔드포인트별 지원되는 임베드 값은 설명서를 확인하세요.
빠른 참조
| 작업 | 도구 슬러그 | 필수 매개변수 |
|---|---|---|
| 필터 쿼리 실행 | CAPSULE_CRM_RUN_FILTER_QUERY | entity, filter |
| 연락처 목록 보기 | CAPSULE_CRM_LIST_PARTIES | 없음(선택적 필터) |
| 연락처 생성 | CAPSULE_CRM_CREATE_PARTY | type |
| 연락처 업데이트 | CAPSULE_CRM_UPDATE_PARTY | partyId, party |
| 연락처 삭제 | CAPSULE_CRM_DELETE_PARTY | party_id |
| 작업 목록 보기 | CAPSULE_CRM_LIST_TASKS | 없음(선택적 필터) |
| 프로젝트 목록 보기 | CAPSULE_CRM_LIST_PROJECTS | 없음(선택적 필터) |
| 활동 항목 목록 보기 | CAPSULE_CRM_LIST_ENTRIES_BY_DATE | 없음(선택적 필터) |
| 조직 직원 목록 보기 | CAPSULE_CRM_LIST_ORG_EMPLOYEES | 조직 ID |
| 삭제된 기회 목록 보기 | CAPSULE_CRM_LIST_DELETED_OPPORTUNITIES | since |
Composio 제공