close-automation

Rube MCP 経由の Close CRM 自動化

Rube MCP 経由で Composio の Close ツールキットを使用して、Close CRM の操作を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/close

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS を利用可能）
• ツールキット close を指定した RUBE_MANAGE_CONNECTIONS 経由で、Close への接続が有効であること
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の入手方法：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

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

主なワークフロー

1. リードの作成と管理

使用する場面：新しいリードを作成する、または既存のリードレコードを管理する場合

ツールの呼び出し順序：

1. CLOSE_CREATE_LEAD - Close で新しいリードを作成します［必須］

主なパラメーター：

• name：リード／会社名
• contacts：リードに関連付ける連絡先オブジェクトの配列
• custom：キーと値のペアで指定するカスタムフィールドの値
• status_id：リードのステータス ID

注意点：

• Close のリードは個人ではなく、企業や組織を表します
• 連絡先はリードに含まれます。まずリードを作成し、その後に連絡先を追加します
• カスタムフィールドのキーには表示名ではなく、カスタムフィールド ID（例：'custom.cf_XXX'）を使用します
• リードの重複は自動検出されません。作成前に確認してください

2. 通話の記録

使用する場面：リードに対する電話の通話アクティビティを記録する場合

ツールの呼び出し順序：

1. CLOSE_CREATE_CALL - 通話アクティビティを記録します［必須］

主なパラメーター：

• lead_id：関連付けるリードの ID
• contact_id：通話相手の連絡先 ID
• direction：'outbound' または 'inbound'
• status：通話ステータス（'completed'、'no-answer'、'busy' など）
• duration：通話時間（秒）
• note：通話メモ

注意点：

• lead_id は必須です。通話はリードに関連付ける必要があります
• 通話時間の単位は分ではなく秒です
• 通話の方向はレポートや分析に影響します
• 追跡には contact_id の指定を推奨しますが、必須ではありません

3. SMS メッセージの送信

使用する場面：Close 経由で SMS メッセージを送信または記録する場合

ツールの呼び出し順序：

1. CLOSE_CREATE_SMS - SMS メッセージを送信または記録します［必須］

主なパラメーター：

• lead_id：関連付けるリードの ID
• contact_id：連絡先の ID
• direction：'outbound' または 'inbound'
• text：SMS メッセージの内容
• status：メッセージのステータス

注意点：

• SMS 機能を使用するには、Close の電話／SMS インテグレーションを設定する必要があります
• すべての SMS アクティビティで lead_id が必須です
• SMS の送信には、認証済みの送信番号が必要な場合があります
• 携帯電話会社によっては、メッセージの長さに制限がある場合があります

4. タスクの管理

使用する場面：フォローアップタスクを作成または管理する場合

ツールの呼び出し順序：

1. CLOSE_CREATE_TASK - 新しいタスクを作成します［必須］

主なパラメーター：

• lead_id：関連付けるリードの ID
• text：タスクの説明
• date：タスクの期限
• assigned_to：担当者のユーザー ID
• is_complete：タスクが完了しているかどうか

注意点：

• タスクは連絡先ではなくリードに関連付けられます
• 日付形式は ISO 8601 に従ってください
• assigned_to にはメールアドレスや名前ではなく、Close のユーザー ID が必要です
• 日付を指定していないタスクは「期限なし」セクションに表示されます

5. メモの管理

使用する場面：リードにメモを追加または取得する場合

ツールの呼び出し順序：

1. CLOSE_GET_NOTE - 特定のメモを取得します［必須］

主なパラメーター：

• note_id：取得するメモの ID

注意点：

• メモはリードに関連付けられます
• メモの取得にはメモ ID が必要です。メモの参照先を見つけるには、先にリードを検索してください
• メモではプレーンテキストと基本的な書式設定がサポートされています

6. アクティビティの削除

使用するタイミング：ユーザーが通話記録やその他のアクティビティを削除したい場合

ツールの手順：

1. CLOSE_DELETE_CALL - 通話アクティビティを削除します［必須］

主なパラメーター：

• call_id：削除する通話の ID

注意点：

• 削除は永続的で、元に戻すことはできません
• 通話を削除できるのは、通話の作成者または管理者のみです
• 通話を削除すると、すべてのレポートとタイムラインから削除されます

よくあるパターン

リードと連絡先の関係

Close data model:
- Lead = Company/Organization
  - Contact = Person (nested within Lead)
  - Activity = Call, SMS, Email, Note (linked to Lead)
  - Task = Follow-up item (linked to Lead)
  - Opportunity = Deal (linked to Lead)

ID の解決

リード ID：

1. Search for leads using the Close search API
2. Extract lead_id from results (format: 'lead_XXXXXXXXXXXXX')
3. Use lead_id in all activity creation calls

連絡先 ID：

1. Retrieve lead details to get nested contacts
2. Extract contact_id (format: 'cont_XXXXXXXXXXXXX')
3. Use in call/SMS activities for accurate tracking

アクティビティの記録パターン

1. Identify the lead_id and optionally contact_id
2. Create the activity (call, SMS, note) with lead_id
3. Include relevant metadata (duration, direction, status)
4. Create follow-up tasks if needed

既知の注意点

ID の形式：

• リード ID：'lead_XXXXXXXXXXXXX'
• 連絡先 ID：'cont_XXXXXXXXXXXXX'
• アクティビティ ID は種類によって異なります：'acti_XXXXXXXXXXXXX'、'call_XXXXXXXXXXXXX'
• カスタムフィールド ID：'custom.cf_XXXXXXXXXXXXX'
• 常に完全な ID 文字列を使用してください

レート制限：

• Close API には、利用プランに基づくレート制限があります
• 一括操作の間には遅延を設けてください
• レート制限の状態を確認するには、レスポンスヘッダーを監視してください
• 429 レスポンスが返された場合は、バックオフが必要です

カスタムフィールド：

• カスタムフィールドは表示名ではなく、API ID で参照します
• リードのステータスによって、必須のカスタムフィールドが異なる場合があります
• カスタムフィールドの種類（テキスト、数値、日付、ドロップダウン）によって、値の形式が制約されます

データの整合性：

• リードが主エンティティであり、連絡先とアクティビティはリードに紐付いています
• リードを削除すると、その連絡先やアクティビティも連鎖的に削除される場合があります
• 一括操作を実行する前に、ID を検証してください

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
リードを作成	CLOSE_CREATE_LEAD	name, contacts, custom
通話を記録	CLOSE_CREATE_CALL	lead_id, direction, status, duration
SMS を送信	CLOSE_CREATE_SMS	lead_id, text, direction
タスクを作成	CLOSE_CREATE_TASK	lead_id, text, date, assigned_to
メモを取得	CLOSE_GET_NOTE	note_id
通話を削除	CLOSE_DELETE_CALL	call_id

---

Composio 提供