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、kasesのいずれかfilter（必須）-- フィルターオブジェクト: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-- ページネーション（1ページ最大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-- ページネーション（1ページ最大100件、デフォルト50件）
3. 新規連絡先の作成
メールアドレス、電話番号、住所、タグ、カスタムフィールドなどの詳細情報を含めて、個人または組織を Capsule CRM に追加します。
ツール: CAPSULE_CRM_CREATE_PARTY
プロンプト例:
"Capsule CRMに新しい人を作成して: 山田太郎、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-- ページネーション（1ページ最大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-- ページネーション（1ページ最大100件）
既知の注意点
- 住所フィールドはトップレベル: フィルタリング時は
state、city、country、zipを直接使用し、address.stateやネスト構文は使用しないでください。 - 国コードはISO alpha-2: "US"、"GB"、"CA" でフィルタリングし、"United States" や "United Kingdom" は使用しないでください。
- カスタムフィールドには特殊な構文が必要: フィルター条件ではカスタムフィールドを
custom:{fieldId}として参照します。組織レベルのカスタムフィールドにはorg.custom:{fieldId}を使用します。 - プロジェクトはAPI上では "kases" と呼ばれる: UI 上では "projects" ですが、API エンティティタイプは
kasesです。フィルタークエリではkasesを使用してください。 - 削除操作にはアイテムIDが必要: パーティを更新してサブアイテム（メール、電話、タグ）を削除するには、アイテムの
idと_delete: trueを指定する必要があります。まずパーティを一覧表示してサブアイテムのIDを取得してください。 - ページネーションのデフォルトは50: すべての一覧エンドポイントはデフォルトで1ページあたり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 |
Powered by Composio