hubspot-update-contact

用途

本技能用于更新 HubSpot CRM 中已存在的联系人记录。当用户表达“update contact”“edit contact”“modify contact”“change contact”等意图时触发。

主要能力

更新联系人的单个或多个字段，包括：邮箱（--email）、名（--firstname）、姓（--lastname）、电话（--phone）、公司（--company）。
更新前执行配置检查，确保 HubSpot 连接可用。
返回更新后的联系人属性及最后修改时间。
提供错误处理指引，覆盖 401、403、404、429 等常见错误。

使用方式

前置检查

运行前执行配置检查：

python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json

如果 ai_action 不是 proceed_with_operation，请按照 hubspot-connect 设置指南操作。

必需参数

--id：联系人 ID（必需）

可选参数（至少提供一个）

--email：新邮箱地址
--firstname：新名
--lastname：新姓
--phone：新电话号码
--company：新公司名称

示例

更新电话：

python 00-system/skills/hubspot/hubspot-master/scripts/update_contact.py \
  --id 12345 \
  --phone "+1987654321" \
  --json

更新多个字段：

python 00-system/skills/hubspot/hubspot-master/scripts/update_contact.py \
  --id 12345 \
  --firstname "Jonathan" \
  --company "New Corp Inc" \
  --json

查找联系人 ID

如果用户说“update John Doe”，先搜索联系人：

python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py --name "John Doe" --json

然后使用返回的 ID 进行更新。

输出格式

{
  "id": "12345",
  "properties": {
    "email": "john@example.com",
    "firstname": "Jonathan",
    "lastname": "Doe",
    "lastmodifieddate": "2025-12-13T10:30:00Z"
  }
}

显示格式

✅ Contact updated!
  ID: 12345
  Updated fields:
    - firstname: Jonathan
    - company: New Corp Inc

错误处理

错误	解决方案
401	无效令牌 - 重新运行设置
403	缺少 crm.objects.contacts.write 权限范围
404	联系人未找到 - 检查 ID
429	速率限制 - 等待后重试

适用场景

需要自动化更新 HubSpot 联系人信息的场景。
在客户数据维护流程中批量修改联系人字段。
与其他 HubSpot 技能配合，完成联系人查找、创建、更新等操作。

限制

必须提供联系人 ID，否则无法更新。
至少需要指定一个要修改的字段。
需要有效的 HubSpot 令牌及 crm.objects.contacts.write 权限。
受 HubSpot API 速率限制影响。

技能介绍

用途