Kommo 자동화

Kommo 자동화은(는) 무엇을 하나요?

Kommo CRM 판매 파이프라인을 관리하세요. 리드 목록 조회 및 필터링, 파이프라인 단계 탐색, 딜 생성 및 업데이트, 작업 할당, 사용자 정의 필드 작업을 모두 자연어 명령으로 수행할 수 있습니다.

툴킷 문서: composio.dev/toolkits/kommo

---

설정

1. 클라이언트 구성에 Composio MCP 서버를 추가하세요:

   https://rube.app/mcp
   

2. 메시지가 표시되면 Kommo 계정을 연결하세요 (OAuth 인증).
3. 자연어 명령을 사용하여 CRM을 관리하세요.

---

핵심 워크플로우

1. 파이프라인 및 단계 탐색

모든 리드 파이프라인을 나열한 후, 특정 파이프라인 단계를 조사하여 판매 깔때기 구조를 파악하세요.

툴: KOMMO_LIST_LEADS_PIPELINES, KOMMO_LIST_PIPELINE_STAGES

예시 프롬프트:

"내 모든 Kommo 파이프라인과 메인 판매 파이프라인의 단계를 보여줘"

파이프라인 목록 조회의 주요 파라미터: 없음

단계 목록 조회의 주요 파라미터:

• pipeline_id (필수) -- 단계를 조회할 파이프라인 ID
• with_description -- 응답에 단계 설명 포함 여부 (불리언)

---

2. 리드 목록 조회 및 필터링

파이프라인, 상태, 날짜 범위, 담당 사용자, 가격 등 강력한 필터로 리드를 검색하세요.

툴: KOMMO_LIST_LEADS

예시 프롬프트:

"파이프라인 12345에서 이번 주에 생성된 모든 리드를 최신순으로 보여줘"

주요 파라미터:

• query -- 모든 입력 필드에 대한 자유 텍스트 검색
• filter_pipeline_ids -- 파이프라인 ID로 필터링 (정수 배열)
• filter_status -- 파이프라인 내 상태별 필터링: {"pipeline_id": 123, "status_id": 456}
• filter_responsible_user_ids -- 할당된 사용자 ID로 필터링
• filter_names -- 리드 이름으로 필터링
• filter_price -- 딜 가격으로 필터링
• filter_created_at -- 날짜 범위: {"from": <unix_timestamp>, "to": <unix_timestamp>}
• filter_updated_at -- 마지막 수정일 기준 날짜 범위
• filter_closed_at -- 마감일 기준 날짜 범위
• order_by_created_at -- 정렬: "asc" 또는 "desc"
• order_by_updated_at -- 수정일 기준 정렬
• limit -- 페이지당 최대 250개
• page -- 페이지네이션을 위한 페이지 번호
• with_params -- 추가 데이터: "contacts", "loss_reason", "catalog_elements", "source_id"

---

3. 새 리드 생성

사용자 정의 필드, 태그, 파이프라인 배치와 함께 Kommo 파이프라인에 새 딜을 추가하세요.

툴: KOMMO_CREATE_LEAD

예시 프롬프트:

"파이프라인 12345에 'Acme Corp 딜'이라는 새 리드를 50,000달러 가치로 생성해줘"

주요 파라미터:

• name (필수) -- 리드/딜의 이름
• price -- 딜 가격 (정수)
• pipeline_id -- 리드를 추가할 파이프라인
• status_id -- 파이프라인 내 단계 (기본값: 메인 파이프라인의 첫 번째 단계)
• responsible_user_id -- 할당된 사용자 ID
• custom_fields_values -- 사용자 정의 필드 값 객체 배열
• tags_to_add -- 태그 배열 (이름 또는 ID로 지정)
• created_by -- 생성자 사용자 ID (0은 로봇)
• loss_reason_id -- 손실 사유 ID (해당되는 경우)

---

4. 기존 리드 업데이트

이름, 가격, 파이프라인 단계, 담당 사용자, 태그, 사용자 정의 필드 등 리드 속성을 수정하세요.

툴: KOMMO_UPDATE_LEAD

예시 프롬프트:

"리드 789를 파이프라인 123의 단계 456으로 이동하고 가격을 75,000달러로 업데이트해줘"

주요 파라미터:

• 리드 ID (필수)
• 다음 중 원하는 조합: name, price, pipeline_id, status_id, responsible_user_id, tags_to_add, tags_to_delete, custom_fields_values

---

5. 작업 생성

리드, 연락처 또는 회사에 연결된 후속 작업을 할당하세요.

툴: KOMMO_CREATE_TASK

예시 프롬프트:

"리드 789에 대해 내일 마감인 후속 전화 작업을 만들어 사용자 42에게 할당해줘"

주요 파라미터:

• 작업 텍스트/설명
• 엔티티 유형 및 ID (리드, 연락처, 회사)
• 담당 사용자 ID
• 마감일 (Unix 타임스탬프)
• 작업 유형

---

6. 사용자 정의 필드 조회

리드, 연락처 또는 회사의 모든 사용자 정의 필드를 나열하여 CRM 스키마를 파악하세요.

툴: KOMMO_LIST_CUSTOM_FIELDS

예시 프롬프트:

"Kommo에서 리드에 사용할 수 있는 사용자 정의 필드는 무엇인가요?"

주요 파라미터:

• 엔티티 유형 (leads, contacts, companies)

---

알려진 문제점

• 날짜 필터는 Unix 타임스탬프 사용: 모든 날짜 범위 필터(filter_created_at, filter_updated_at, filter_closed_at)는 ISO8601 문자열이 아닌 {"from": <timestamp>, "to": <timestamp>} 구조의 Unix 타임스탬프 형식이 필요합니다.
• 파이프라인 및 단계 ID 필요: 상태별로 리드를 필터링하려면 pipeline_id와 status_id가 모두 필요합니다. 항상 KOMMO_LIST_LEADS_PIPELINES와 KOMMO_LIST_PIPELINE_STAGES를 먼저 호출하여 유효한 ID를 확인하세요.
• 페이지당 최대 250개 리드: limit 파라미터는 250개로 제한됩니다. 대규모 데이터셋의 경우 page 파라미터를 사용하여 페이지네이션을 구현하세요.
• 사용자 정의 필드 값 형식: 사용자 정의 필드는 특정 중첩 객체 형식을 사용합니다. 값을 설정하기 전에 KOMMO_LIST_CUSTOM_FIELDS를 사용하여 필드 ID와 예상 값 형식을 확인하세요.
• 상태 필터는 두 ID 모두 필요: filter_status 파라미터는 pipeline_id와 status_id를 결합된 객체로 제공해야 합니다. 상태만으로는 필터링할 수 없습니다.
• Created_by 0은 로봇을 의미: created_by 또는 updated_by를 0으로 설정하면 해당 작업이 사람이 아닌 로봇/자동화에 의해 수행된 것으로 기록됩니다.

---

빠른 참조

작업	툴 슬러그	필수 파라미터
파이프라인 목록 조회	KOMMO_LIST_LEADS_PIPELINES	없음
파이프라인 단계 목록 조회	KOMMO_LIST_PIPELINE_STAGES	pipeline_id
리드 목록 조회	KOMMO_LIST_LEADS	없음 (선택적 필터)
리드 생성	KOMMO_CREATE_LEAD	name
리드 업데이트	KOMMO_UPDATE_LEAD	리드 ID
작업 생성	KOMMO_CREATE_TASK	작업 세부 정보
사용자 정의 필드 목록 조회	KOMMO_LIST_CUSTOM_FIELDS	엔티티 유형

---

Composio 제공