hubspot-create-contact

用途

该技能用于在 HubSpot CRM 中创建新的联系人记录。当用户表达“create contact”“add contact”“new contact”等意图时触发加载。

主要能力

• 在 HubSpot CRM 中创建联系人。
• 支持必填参数邮箱（--email）。
• 支持可选参数：名字（--firstname）、姓氏（--lastname）、电话（--phone）、公司名称（--company）。
• 以 JSON 格式输出创建结果，包含联系人 ID 及属性信息。
• 提供友好的展示格式，显示联系人 ID、姓名、邮箱、电话和公司。

使用方式

运行前需先执行配置检查：

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

如果 ai_action 不是 proceed_with_operation，则需按照 hubspot-connect 设置指南完成配置。

最小化创建（仅邮箱）：

python 00-system/skills/hubspot/hubspot-master/scripts/create_contact.py \
  --email "john@example.com" \
  --json

完整联系人创建：

python 00-system/skills/hubspot/hubspot-master/scripts/create_contact.py \
  --email "john@example.com" \
  --firstname "John" \
  --lastname "Doe" \
  --phone "+1234567890" \
  --company "Acme Corp" \
  --json

输出格式示例：

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

展示格式示例：

✅ Contact created!
  ID: 12345
  Name: John Doe
  Email: john@example.com
  Phone: +1234567890
  Company: Acme Corp

错误处理

• 401：令牌无效，需重新运行设置。
• 403：缺少 crm.objects.contacts.write 权限范围。
• 409：该邮箱的联系人已存在。
• 429：触发速率限制，需等待后重试。

相关技能

• hubspot-list-contacts：列出所有联系人。
• hubspot-search-contacts：查找已有联系人。
• hubspot-update-contact：更新联系人详情。

适用场景

适用于需要将联系人信息写入 HubSpot CRM 的自动化流程，例如在对话中根据用户指令快速创建联系人记录。

限制

使用前必须完成 HubSpot 配置检查与连接设置；邮箱为必填项；创建操作需要具备 crm.objects.contacts.write 权限范围；可能受到 API 速率限制。