用途:该技能面向 HubSpot 营销自动化场景,覆盖联系人列表管理、表单提交处理、营销邮件相关操作、支持工单创建与跟进任务,是销售管道工作流(Workflow A)的补充。
主要能力:
- 创建静态与动态联系人列表,动态列表支持基于属性(如 lifecyclestage)的过滤条件。
- 通过 Forms API 提交表单并检索表单提交记录。
- 创建支持工单,设置管道、阶段、优先级,并关联联系人;可更新工单阶段至关闭状态。
- 创建跟进任务并分配负责人,关联联系人。
- 跨 CRM 对象(联系人、公司、交易、工单)搜索。
使用方式:基于 @hubspot/api-client,通过 accessToken 初始化客户端,调用对应 REST 路径,例如创建列表 POST /crm/v3/lists/,添加成员 PUT /crm/v3/lists/{listId}/memberships/add,提交表单 POST /submissions/v3/integration/secure/submit/{portalId}/{formGuid},创建工单 POST /crm/v3/objects/tickets,创建任务 POST /crm/v3/objects/tasks,搜索 POST /crm/v3/objects/{objectType}/search。
前置条件:需完成 hubspot-install-auth 设置;权限范围包括 crm.lists.read、crm.lists.write、content、forms、crm.objects.marketing.emails.read;营销邮件功能需 Marketing Hub Starter 及以上订阅。
限制与错误处理:常见错误包括 LIST_NOT_FOUND(404,列表 ID 无效)、FORM_NOT_FOUND(404,表单 GUID 无效)、INVALID_PIPELINE_STAGE(400,阶段不属于该管道,需先获取管道阶段)、SCOPE_MISSING(403,缺少 forms 或 content 权限)。具体价格、平台支持范围等资料暂未提供。