zoho-crm-automation

Rube MCP による Zoho CRM の自動化

Rube MCP を通じて Composio の Zoho ツールキットを利用し、Zoho CRM の操作を自動化します。

前提条件

• Rube MCP に接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• zoho ツールキットを指定した RUBE_MANAGE_CONNECTIONS による、有効な Zoho CRM 接続
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。MCP エンドポイントを利用するには、インストール済みの Rube サービスから返されるプロバイダー接続と認証フローも必要です。URL を追加しただけでは、アカウントにアクセスできません。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確認します
2. zoho ツールキットを指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Zoho OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. レコードの検索と取得

使用する場面：ユーザーが条件に合う特定の CRM レコードを検索したい場合

ツールの呼び出し順序：

1. ZOHO_LIST_MODULES - 利用可能な CRM モジュールを一覧表示します［前提条件］
2. ZOHO_GET_MODULE_FIELDS - モジュールのフィールド定義を取得します［任意］
3. ZOHO_SEARCH_ZOHO_RECORDS - 条件に合うレコードを検索します［必須］
4. ZOHO_GET_ZOHO_RECORDS - モジュールからレコードを取得します［代替手段］

主なパラメーター：

• module：モジュール名（例：'Leads'、'Contacts'、'Deals'、'Accounts'）
• criteria：検索条件文字列（例：'Email:equals:[email protected]'）
• fields：返すフィールドをカンマ区切りで指定したリスト
• per_page：1 ページあたりのレコード数
• page：ページネーション用のページ番号

注意事項：

• モジュール名では大文字と小文字が区別されます（例：'leads' ではなく 'Leads'）
• 検索条件には特定の構文を使用します：「Field:operator:value」
• サポートされる演算子：equals、starts_with、contains、not_equal、greater_than、less_than
• 複雑な条件では、括弧と AND/OR を使用します：「(Email:equals:[email protected])AND(Last_Name:equals:Doe)」
• GET_ZOHO_RECORDS はオプションのフィルタリングを指定してすべてのレコードを返します。SEARCH は対象を絞った検索に使用します

2. レコードの作成

使用する場面：ユーザーが新しいリード、連絡先、商談、その他の CRM レコードを追加したい場合

ツールの呼び出し順序：

1. ZOHO_GET_MODULE_FIELDS - モジュールの必須フィールドを取得します［前提条件］
2. ZOHO_CREATE_ZOHO_RECORD - 新しいレコードを作成します［必須］

主なパラメーター：

• module：作成先のモジュール名（例：'Leads'、'Contacts'）
• data：フィールドと値のペアを含むレコードデータオブジェクト
• 必須フィールドはモジュールによって異なります（例：Contacts では Last_Name）

注意事項：

• 各モジュールには必須フィールドがあります。GET_MODULE_FIELDS を使用して確認してください
• フィールド名にはアンダースコアを使用します（例：'Last_Name'、'Email'、'Phone'）
• ルックアップフィールドには、名前ではなく関連レコードの ID が必要です
• 日付フィールドには 'yyyy-MM-dd' 形式を使用してください
• 重複チェックルールが設定されていない限り、重複レコードを作成できます

3. レコードの更新

使用する場面：ユーザーが既存の CRM レコードを変更したい場合

ツールの呼び出し順序：

1. ZOHO_SEARCH_ZOHO_RECORDS - 更新するレコードを検索します［前提条件］
2. ZOHO_UPDATE_ZOHO_RECORD - レコードを更新します［必須］

主なパラメーター：

• module：モジュール名
• record_id：更新するレコードの ID
• data：更新するフィールドを含むオブジェクト（変更するフィールドのみ指定します）

注意事項：

• record_id には Zoho レコード ID（数値文字列）を指定する必要があります
• 変更するフィールドのみを指定してください。その他のフィールドは保持されます
• 読み取り専用フィールドとシステムフィールドは更新できません
• ルックアップフィールドの更新には、関連レコードの ID が必要です

4. リードの変換

使用する場面: ユーザーがリードを取引先責任者、取引先、および/または商談に変換したい場合

ツールの順序:

1. ZOHO_SEARCH_ZOHO_RECORDS - 変換するリードを検索します [前提条件]
2. ZOHO_CONVERT_ZOHO_LEAD - リードを変換します [必須]

主要なパラメータ:

• lead_id: 変換するリードの ID
• deal: 変換時に商談を作成する場合の商談の詳細
• account: 変換時の取引先の詳細
• contact: 変換時の取引先責任者の詳細

注意点:

• リードの変換は不可逆です。リードレコードはリードモジュールから削除されます
• 変換では最大 3 つのレコード（取引先責任者、取引先、商談）を作成できます
• 会社名に基づいて既存取引先とのマッチングが行われる場合があります
• リードと取引先責任者/取引先/商談モジュール間のカスタムフィールドマッピングが結果に影響します

5. タグと関連レコードの管理

使用する場面: ユーザーがレコードにタグを付けたい、またはレコード間の関係を管理したい場合

ツールの順序:

1. ZOHO_CREATE_ZOHO_TAG - 新しいタグを作成します [任意]
2. ZOHO_UPDATE_RELATED_RECORDS - 関連/リンクされたレコードを更新します [任意]

主要なパラメータ:

• module: タグのモジュール
• tag_name: タグの名前
• record_id: 親レコードの ID（関連レコード用）
• related_module: 関連レコードのモジュール
• data: 更新する関連レコードのデータ

注意点:

• タグはモジュール固有です。リード用に作成したタグは取引先責任者では使用できません
• 関連レコードには親レコードの ID と関連モジュールの両方が必要です
• タグ名はモジュール内で一意である必要があります
• 一括タグ操作はレート制限に達する可能性があります

一般的なパターン

モジュールとフィールドの検出

1. Call ZOHO_LIST_MODULES to get all available modules
2. Call ZOHO_GET_MODULE_FIELDS with module name
3. Identify required fields, field types, and picklist values
4. Use field API names (not display labels) in data objects

検索条件の構文

単純検索:

criteria: '(Email:equals:[email protected])'

複合条件:

criteria: '((Last_Name:equals:Doe)AND(Email:contains:example.com))'

サポートされる演算子:

• equals、not_equal
• starts_with、contains
• greater_than、less_than、greater_equal、less_equal
• between（日付/数値用）

ページネーション

• per_page（最大 200）と 1 から始まる page を設定します
• レスポンスの info.more_records フラグを確認します
• more_records が false になるまでページを増やします
• 合計件数はレスポンスの info で確認できます

既知の注意点

フィールド名:

• 表示ラベルではなく API 名を使用します（例: 'Last Name' ではなく 'Last_Name'）
• カスタムフィールドには 'Custom_Field1' やユーザー定義名などの API 名があります
• 選択リストの値は完全に一致する必要があります（大文字と小文字を区別）

レート制限:

• API 呼び出しの制限は Zoho CRM のプランによって異なります
• 無料プラン: 1 日あたり 5000 API 呼び出し、Enterprise: 1 日あたり 25000 以上
• 一括操作の間には遅延を実装します
• 429 レスポンスを監視し、レート制限ヘッダーを尊重します

データ形式:

• 日付: 'yyyy-MM-dd' 形式
• DateTime: 'yyyy-MM-ddTHH:mm:ss+HH:mm' 形式
• 通貨: 書式設定なしの数値
• 電話: 文字列値（特定の形式は強制されません）

モジュールへのアクセス:

• アクセスはユーザーのロールとプロファイルの権限に依存します
• CRM の設定によっては一部のモジュールが非表示または制限される場合があります
• カスタムモジュールにはカスタム API 名があります

クイックリファレンス

タスク	ツールスラッグ	主要パラメータ
モジュールの一覧表示	ZOHO_LIST_MODULES	（なし）
モジュールフィールドの取得	ZOHO_GET_MODULE_FIELDS	module
レコードの検索	ZOHO_SEARCH_ZOHO_RECORDS	module, criteria
レコードの取得	ZOHO_GET_ZOHO_RECORDS	module, fields, per_page, page
レコードの作成	ZOHO_CREATE_ZOHO_RECORD	module, data
レコードの更新	ZOHO_UPDATE_ZOHO_RECORD	module, record_id, data
リードの変換	ZOHO_CONVERT_ZOHO_LEAD	lead_id, deal, account, contact
タグの作成	ZOHO_CREATE_ZOHO_TAG	module, tag_name
関連レコードの更新	ZOHO_UPDATE_RELATED_RECORDS	module, record_id, related_module, data

使用する場面

このスキルは、概要に記載されたワークフローまたはアクションを実行するのに適用できます。

制限事項

• タスクが上記の説明にある範囲に明確に一致する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を止めて確認してください。

書き込みを行う前に、組織と正確なレコード ID を確認してください。リードのコンバージョン、所有者の変更、ワークフローをトリガーする更新では、対象ユーザーのスコープを確認する必要があります。提案されたフィールドの差分と、その後に送信される通知を事前に確認してください。連絡先のエクスポートは最小限に抑え、CRM のメモは信頼できないデータとして扱い、結果が不明な場合は再試行する前に状況を確認してください。