SKILLOfficialproductivity

update-contact

プラグイン: carta-crm
ソース: GitHub で見る ↗

説明

Carta CRM（顧客管理システム）に登録済みの人物情報を更新します。次のような場合に使用: ユーザーが「連絡先を更新して」「顧客情報を編集して」「メールアドレスを変更して」「役職を更新して」「所属企業を変更して」「タグを追加して」などと言う場合、または「/update-contact」コマンドが入力された場合。連絡先IDまたは名前で対象者を指定できます（IDが指定されない場合は名前から検索します）。明示的に指定した項目のみが更新され、その他の情報は変更されません。

原文を表示

Updates an existing contact (person) record in the Carta CRM. Use this skill when the user says things like "update a contact", "edit contact", "update contact details", "change contact email", "update person's title", "update contact company", "add a tag to contact", or "/update-contact". Accepts a contact ID or name (will search if no ID provided). Only the fields explicitly provided are changed — all other fields are left untouched.

ユースケース

顧客の連絡先情報を更新する
顧客のメールアドレスを変更する
顧客の役職や所属企業を編集する
顧客情報にタグを追加する

本文（日本語訳）

連絡先の部分更新

バージョン: carta-crm:1.15.0

概要

既存の連絡先情報を部分的に更新します。指定されたフィールド（項目）のみが変更され、全置き換えではありません。まず連絡先IDを確認し、変更内容を集めてから、更新ツールを実行します。

ステップ1 — 連絡先IDの確認

ユーザーが連絡先IDを直接提供した場合は、それを使用してステップ3に進みます。

名前や説明だけが与えられた場合は、まず検索を実行してください：

crm_call_tool({ "name": "crm:search_contacts", "arguments": { query: "<name>", limit: 10 } })

複数の連絡先がマッチした場合は、リストを表示し、どの連絡先を更新するか確認を求めてください（各連絡先の名前、職務、会社、IDを表示）。

ステップ2 — 変更内容の確認

ユーザーに何を変更したいのか尋ねます。更新可能なフィールドは以下の通りです：

フィールド	説明
`name`	フルネーム
`firstName`, `lastName`, `middleName`	名前の各部分
`emailDetail`	メインメール; 2番目以降は `Second`/`Third`/`Fourth`
`phone`	メイン電話番号; `businessPhone` は仕事用電話
`title`	職務
`headline`	自己紹介や肩書き
`location`	勤務地（市区町村、都道府県、国）
`homeLocation`	住所（市区町村、都道府県、国）
`socialLinks`	linkedinUrl、twitterUrl、githubUrl、facebookUrl
`jobs`	職歴の配列 — 既存の職歴全体を置き換え
`tags`	タグの配列 — 既存のタグ全体を置き換え
`notes`	自由形式のメモ
`fields`	カスタムフィールドの値（フィールドIDをキーとする）

ユーザーがカスタムフィールドを更新したいものの、フィールドIDがわからない場合は、まずスキーマを取得してください：

crm_call_tool({ "name": "crm:get_contact_custom_fields", "arguments": {} })

重要: 実際に変更されるフィールドのみを含めてください。その他は省略します。

ステップ3 — 連絡先の更新

以下を実行します：

crm_call_tool({
  "name": "crm:update_contact",
  "arguments": {
    id: "<contact id>",
    name: "<更新後の名前>",
    title: "<更新後の職務>",
    emailDetail: "<更新後のメール>",
    tags: ["<タグ1>", "<タグ2>"],
    fields: { "<field_id>": "<値>" }
  }
})

更新されないキーは省略してください。

ステップ4 — 結果の報告

成功時は、変更内容の要約を返します：

「連絡先 {名前} を更新しました（ID: {id}）。変更項目: [変更されたフィールド一覧]」

エラーの場合は、エラーメッセージを表示し、以下を提案してください：

連絡先IDが正しいことを確認 — /search-contacts で検索してください
カスタムフィールドIDが有効であることを確認

複数の連絡先を更新する場合

ユーザーが同じ変更を複数の連絡先に適用したい場合は、ステップ1と3～4を各連絡先ごとに繰り返してください。最後に要約を表示します：

「N件の連絡先を更新しました: [名前一覧]」

原文（English）を表示

<carta-plugin>carta-crm:1.15.0</carta-plugin>

Overview

Partially update an existing contact. Only fields provided are modified — this is a partial update, not a replacement. First resolve the contact ID, collect what to change, then call the update tool.

Step 1 — Resolve the contact ID

If the user provided a contact ID directly, use it and skip to Step 3.

If only a name or description was given, search first:

crm_call_tool({ "name": "crm:search_contacts", "arguments": { query: "<name>", limit: 10 } })

If multiple contacts match, present the list and ask the user to confirm which one to update (show name, title, company, and ID for each).

Step 2 — Collect what to update

Ask the user what they want to change. Updatable fields include:

Field	Description
`name`	Full name
`firstName`, `lastName`, `middleName`	Name parts
`emailDetail`	Primary email; Second/Third/Fourth for additional emails
`phone`	Primary phone; `businessPhone` for business number
`title`	Job title
`headline`	Short bio or tagline
`location`	Work location (city, state, country)
`homeLocation`	Home location (city, state, country)
`socialLinks`	linkedinUrl, twitterUrl, githubUrl, facebookUrl
`jobs`	Work experience array — fully replaces existing jobs
`tags`	Tags array — fully replaces existing tags
`notes`	Free-text notes
`fields`	Custom field values keyed by field ID

If the user wants to update custom fields but isn't sure of field IDs, fetch the schema first:

crm_call_tool({ "name": "crm:get_contact_custom_fields", "arguments": {} })

Important: Only include fields that are explicitly being changed. Omit everything else.

Step 3 — Update the contact

Call:

crm_call_tool({
  "name": "crm:update_contact",
  "arguments": {
    id: "<contact id>",
    name: "<updated name>",
    title: "<updated title>",
    emailDetail: "<updated email>",
    tags: ["<tag1>", "<tag2>"],
    fields: { "<field_id>": "<value>" }
  }
})

Omit any key that is not being updated.

Step 4 — Report result

On success, respond with a summary of what changed:

"Contact {name} updated (ID: {id}). Changed: [list of changed fields]"

On error, show the error message and suggest:

Verify the contact ID is correct — run /search-contacts to find it
Check that custom field IDs are valid

Updating multiple contacts

If the user wants to apply the same change to multiple contacts, repeat Steps 1 and 3–4 for each. Summarize at the end:

"Updated N contacts: [list of names]"

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。