ComposioHQ/Kommo-Automation

Kommo Automation

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タイムスタンプ>, "to": <UNIXタイムスタンプ>}
• filter_updated_at – 最終更新日時の日付範囲
• filter_closed_at – クローズ日時の日付範囲
• order_by_created_at – 並び替え: "asc" または "desc"
• order_by_updated_at – 更新日時で並び替え
• limit – 1ページあたり最大250件
• page – ページネーションのページ番号
• with_params – 追加データ: "contacts"、"loss_reason"、"catalog_elements"、"source_id"

---

3. 新しいリードの作成

カスタムフィールド、タグ、パイプライン配置を指定して、Kommoパイプラインに新しい案件を追加します。

ツール: KOMMO_CREATE_LEAD

プロンプト例:

「'Acme Corp Deal'という名前の新しいリードを、価格5万ドルでパイプライン12345に作成して」

主要パラメータ:

• 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でリードに利用可能なカスタムフィールドは何ですか？」

主要パラメータ:

• エンティティタイプ（リード、連絡先、企業）

---

既知の問題点

• 日付フィルターはUNIXタイムスタンプを使用: すべての日付範囲フィルター（filter_created_at、filter_updated_at、filter_closed_at）は、{"from": <タイムスタンプ>, "to": <タイムスタンプ>}構造のUNIXタイムスタンプ形式が必要です。ISO8601文字列ではありません。
• パイプラインIDとステージIDが必要: リードをステータスでフィルタリングするには、pipeline_idとstatus_idの両方が必要です。最初にKOMMO_LIST_LEADS_PIPELINESとKOMMO_LIST_PIPELINE_STAGESを呼び出して有効なIDを確認してください。
• 1ページあたり最大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	エンティティタイプ

---

Powered by Composio