hubspot-log-email

用途

hubspot-log-email 是一个专门用于在 HubSpot CRM 中记录电子邮件互动的技能。它适用于需要将已发送或已接收的邮件作为互动记录写入 HubSpot 的场景，例如销售跟进、客户沟通留痕等。当用户说出“log email”“record email”“add email”“email sent”等指令时，该技能会被加载。

主要能力

该技能可以将一封邮件记录到 HubSpot CRM 中，支持指定邮件主题、正文、方向和时间戳。方向可选 EMAIL（表示已发送）或 INCOMING_EMAIL（表示已接收）。记录成功后返回记录 ID 以及邮件的主题、正文、方向、状态和时间戳等属性。

使用方式

运行前检查

在执行记录操作之前，需要先运行配置检查脚本：

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

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

必填参数

--subject：邮件主题行（必填）
--body：邮件正文内容（必填）

可选参数

--direction：EMAIL（已发送）或 INCOMING_EMAIL（已接收）
--timestamp：ISO 格式时间戳（默认为当前时间）

示例

记录已发送邮件：

python 00-system/skills/hubspot/hubspot-master/scripts/log_email.py \
  --subject "Follow up on proposal" \
  --body "Hi John, following up on our conversation about the enterprise package..." \
  --json

记录已接收邮件：

python 00-system/skills/hubspot/hubspot-master/scripts/log_email.py \
  --subject "Re: Proposal" \
  --body "Thanks for sending over the details..." \
  --direction "INCOMING_EMAIL" \
  --json

输出格式

{
  "id": "14389550562",
  "properties": {
    "hs_email_subject": "Follow up on proposal",
    "hs_email_text": "Hi John, following up on...",
    "hs_email_direction": "EMAIL",
    "hs_email_status": "SENT",
    "hs_timestamp": "2025-12-13T10:00:00Z"
  }
}

显示格式

✅ Email logged!
  ID: 14389550562
  Subject: Follow up on proposal
  Direction: Sent
  Status: SENT
  Timestamp: 2025-12-13 10:00

错误处理

错误	解决方案
401	令牌无效，重新运行设置
403	缺少 crm.objects.emails.write 权限范围
429	触发速率限制，等待后重试

适用场景

适用于需要将邮件沟通记录同步到 HubSpot CRM 的销售、客户成功或运营场景，帮助团队在 CRM 中保留完整的邮件互动历史。

限制

使用前必须完成 HubSpot 配置检查，且需要具备 crm.objects.emails.write 权限范围。该技能仅负责记录邮件互动，不负责发送邮件本身。关于收费、价格、平台支持范围等信息，资料中暂未提供。

技能介绍

用途