salesforce-automation

Rube MCP による Salesforce の自動化

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

前提条件

• Rube MCP に接続済みであること（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット salesforce を指定した RUBE_MANAGE_CONNECTIONS による、アクティブな Salesforce 接続
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。実際の MCP 認証、Salesforce 組織、スコープを確認してください。エンドポイントを追加しただけではアクセスできません。

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

レコード変更の境界

対象の組織、オブジェクト、レコード ID を正確に特定し、所有権、キャンペーン、割り当ての一括変更をプレビューして、ユーザーが許可したフィールドのみを適用します。自動化ルールによって、他のユーザーに通知が送られたり、そのユーザーに影響が及んだりする場合があります。レコードを読み取っただけで、通信を行う権限があると判断しないでください。作成結果が不確かな場合は、リードの重複を避けるため、再試行する前に作成状況を確認してください。

主なワークフロー

1. リードを管理する

使用する場合：ユーザーがリードの作成、検索、更新、一覧表示を希望する場合

ツールの実行順序：

1. SALESFORCE_SEARCH_LEADS - 条件を指定してリードを検索 [任意]
2. SALESFORCE_LIST_LEADS - すべてのリードを一覧表示 [任意]
3. SALESFORCE_CREATE_LEAD - 新しいリードを作成 [任意]
4. SALESFORCE_UPDATE_LEAD - リードのフィールドを更新 [任意]
5. SALESFORCE_ADD_LEAD_TO_CAMPAIGN - リードをキャンペーンに追加 [任意]
6. SALESFORCE_APPLY_LEAD_ASSIGNMENT_RULES - 割り当てルールを適用 [任意]

主なパラメーター：

• LastName：リード作成時に必須
• Company：リード作成時に必須
• Email、Phone、Title：一般的なリードのフィールド
• lead_id：更新するリードの ID
• campaign_id：キャンペーン操作に使用するキャンペーン ID

注意点：

• リードの作成には LastName と Company が必須です
• リード ID は 15 文字または 18 文字の Salesforce ID です

2. 取引先責任者と取引先を管理する

使用する場合：ユーザーが取引先責任者と関連する取引先の管理を希望する場合

ツールの実行順序：

1. SALESFORCE_SEARCH_CONTACTS - 取引先責任者を検索 [任意]
2. SALESFORCE_LIST_CONTACTS - 取引先責任者を一覧表示 [任意]
3. SALESFORCE_CREATE_CONTACT - 新しい取引先責任者を作成 [任意]
4. SALESFORCE_SEARCH_ACCOUNTS - 取引先を検索 [任意]
5. SALESFORCE_CREATE_ACCOUNT - 新しい取引先を作成 [任意]
6. SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT - 取引先責任者を取引先にリンク [任意]

主なパラメーター：

• LastName：取引先責任者の作成時に必須
• Name：作成する取引先の名前
• AccountId：取引先責任者に関連付ける取引先 ID
• contact_id、account_id：関連付けに使用する ID

注意点：

• 取引先責任者には少なくとも LastName が必要です
• 取引先の関連付けには、有効な取引先責任者 ID と取引先 ID の両方が必要です

3. 商談を管理する

使用する場合：ユーザーが営業商談の追跡や管理を希望する場合

ツールの実行順序：

1. SALESFORCE_SEARCH_OPPORTUNITIES - 商談を検索 [任意]
2. SALESFORCE_LIST_OPPORTUNITIES - すべての商談を一覧表示 [任意]
3. SALESFORCE_GET_OPPORTUNITY - 商談の詳細を取得 [任意]
4. SALESFORCE_CREATE_OPPORTUNITY - 新しい商談を作成 [任意]
5. SALESFORCE_RETRIEVE_OPPORTUNITIES_DATA - 商談データを取得 [任意]

主なパラメーター：

• Name：商談名（必須）
• StageName：営業ステージ（必須）
• CloseDate：予想クローズ日（必須）
• Amount：取引額
• AccountId：関連する取引先

注意点：

• 作成には Name、StageName、CloseDate が必須です
• ステージ名は Salesforce で設定されているものと完全に一致する必要があります

4. SOQL クエリを実行する

使用する場面：ユーザーがカスタム SOQL で Salesforce データをクエリしたい場合

ツールの順序：

1. SALESFORCE_RUN_SOQL_QUERY / SALESFORCE_QUERY - SOQL を実行します［必須］

主なパラメーター：

• query：SOQL クエリ文字列

注意点：

• SOQL の構文は SQL と異なり、Salesforce のオブジェクト名と項目の API 名を使用します
• 項目の API 名は表示ラベルと異なる場合があります（例：Account Name ではなく Account.Name）
• 大規模なデータセットの結果はページ分割されます

5. タスクを管理する

使用する場面：ユーザーがタスクの作成、検索、更新、または完了を希望する場合

ツールの順序：

1. SALESFORCE_SEARCH_TASKS - タスクを検索します［任意］
2. SALESFORCE_UPDATE_TASK - タスクの項目を更新します［任意］
3. SALESFORCE_COMPLETE_TASK - タスクを完了としてマークします［任意］

主なパラメーター：

• task_id：更新するタスクの ID
• Status：タスクのステータス値
• Subject：タスクの件名

注意点：

• タスクのステータス値は、Salesforce の選択リストのオプションと一致している必要があります

よくあるパターン

SOQL の構文

基本クエリ：

SELECT Id, Name, Email FROM Contact WHERE LastName = 'Smith'

リレーションを使用する場合：

SELECT Id, Name, Account.Name FROM Contact WHERE Account.Industry = 'Technology'

日付で絞り込む場合：

SELECT Id, Name FROM Lead WHERE CreatedDate = TODAY
SELECT Id, Name FROM Opportunity WHERE CloseDate = NEXT_MONTH

ページネーション

• 大規模な結果を返す SOQL クエリには、ページネーショントークンが含まれます
• ページネーションには、nextRecordsUrl を指定して SALESFORCE_QUERY を使用します
• レスポンスの done フィールドを確認し、値が false の場合はページ取得を続けます

既知の注意点

項目の API 名：

• 表示ラベルではなく、必ず API 名を使用してください
• カスタム項目の末尾には __c が付きます
• カスタムオブジェクトを確認するには SALESFORCE_GET_ALL_CUSTOM_OBJECTS を使用してください

ID の形式：

• Salesforce ID は 15 文字（大文字と小文字を区別）または 18 文字（大文字と小文字を区別しない）です
• ほとんどの操作では、どちらの形式も使用できます

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
リードを作成	SALESFORCE_CREATE_LEAD	LastName, Company
リードを検索	SALESFORCE_SEARCH_LEADS	query
リードを一覧表示	SALESFORCE_LIST_LEADS	(filters)
リードを更新	SALESFORCE_UPDATE_LEAD	lead_id, fields
取引先責任者を作成	SALESFORCE_CREATE_CONTACT	LastName
取引先責任者を検索	SALESFORCE_SEARCH_CONTACTS	query
取引先を作成	SALESFORCE_CREATE_ACCOUNT	Name
取引先を検索	SALESFORCE_SEARCH_ACCOUNTS	query
取引先責任者を関連付け	SALESFORCE_ASSOCIATE_CONTACT_TO_ACCOUNT	contact_id, account_id
商談を作成	SALESFORCE_CREATE_OPPORTUNITY	Name, StageName, CloseDate
商談を取得	SALESFORCE_GET_OPPORTUNITY	opportunity_id
商談を検索	SALESFORCE_SEARCH_OPPORTUNITIES	query
SOQL を実行	SALESFORCE_RUN_SOQL_QUERY	query
クエリ	SALESFORCE_QUERY	query
タスクを検索	SALESFORCE_SEARCH_TASKS	query
タスクを更新	SALESFORCE_UPDATE_TASK	task_id, fields
タスクを完了	SALESFORCE_COMPLETE_TASK	task_id
ユーザー情報を取得	SALESFORCE_GET_USER_INFO	(none)
カスタムオブジェクト	SALESFORCE_GET_ALL_CUSTOM_OBJECTS	(none)
レコードを作成	SALESFORCE_CREATE_A_RECORD	object_type, fields
所有者を移管	SALESFORCE_MASS_TRANSFER_OWNERSHIP	records, new_owner

使用する場面

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

制限事項

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