HubSpot数据集成

技能简介

该技能通过REST API连接HubSpotCRM和CMS，支持联系人、公司、交易、负责人等核心对象的数据操作，适用于销售流程自动化和客户数据管理场景。

业务背景

销售团队常需在CRM与营销系统间手动搬运客户数据，耗时且易出错。该技能打通HubSpot核心数据接口，让联系人建档、公司信息更新、交易状态同步等操作自动化运行，减少重复录入，确保销售流程中各环节数据一致、实时可查。

落地案例：某B2B企业销售代表跟进新客户时，可直接通过指令查询该客户在HubSpot的完整档案，包括历史互动记录与关联公司信息；成交后自动创建交易条目并分配负责人，无需切换多个后台界面。市场部门也能按需导出特定标签的联系人列表，用于精准营销活动。

能做什么

• 创建、查询、搜索联系人信息
• 管理公司档案与关联关系
• 跟踪交易进度与金额
• 分配负责人到各业务对象
• 获取对象间的关联数据

使用说明

安装准备

需预先安装curl和jq命令行工具：

# macOS
brew install curl jq

# Ubuntu/Debian
sudo apt-get install curl jq

配置访问令牌

在HubSpot后台创建Private App并获取访问令牌，设置环境变量：

export HUBSPOT_ACCESS_TOKEN=pat-na2-xxxxx

基础调用格式

所有请求需携带Authorization头，基础地址为https://api.hubapi.com。POST/PUT/PATCH请求需附加Content-Type: application/json头。

输入与输出

见下方输入与输出表格。

风险提示

• 访问令牌需妥善保管，避免泄露至代码仓库
• API调用受HubSpot速率限制约束
• 生产环境建议配合错误重试机制
• 敏感客户数据需符合隐私合规要求

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/kwall1/hubspot/SKILL.md
来源类型：GitHub仓库