AgentSkillsCN

hubspot-log-call

在HubSpot CRM中记录通话互动。当用户说‘记录通话’、‘录制通话’、‘添加通话’、‘已拨打电话’时加载。需要标题,可选正文和时长。

SKILL.md
--- frontmatter
name: hubspot-log-call
description: "Log a call engagement in HubSpot CRM. Load when user says 'log call', 'record call', 'add call', 'call made'. Requires title, optional body and duration."

Log HubSpot Call

Specialized skill for logging call engagements in HubSpot CRM.

Pre-Flight Check

Before running, execute config check:

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

If ai_action is not proceed_with_operation, follow hubspot-connect setup guide.


Usage

Required Parameters

  • --title - Call title (required)

Optional Parameters

  • --body - Call notes/summary
  • --duration - Duration in minutes (default: 0)
  • --direction - OUTBOUND or INBOUND (default: OUTBOUND)
  • --status - COMPLETED, BUSY, NO_ANSWER, etc. (default: COMPLETED)

Examples

Log completed call:

bash
python 00-system/skills/hubspot/hubspot-master/scripts/log_call.py \
  --title "Discovery Call with Acme" \
  --body "Discussed requirements, timeline, and budget. Next step: send proposal." \
  --duration 30 \
  --json

Log missed call:

bash
python 00-system/skills/hubspot/hubspot-master/scripts/log_call.py \
  --title "Follow-up attempt" \
  --status "NO_ANSWER" \
  --direction "OUTBOUND" \
  --json

Call Status Values

StatusMeaning
COMPLETEDCall connected
BUSYLine busy
NO_ANSWERNo answer
FAILEDCall failed
CANCELEDCall canceled

Output Format

json
{
  "id": "14772074448",
  "properties": {
    "hs_call_title": "Discovery Call with Acme",
    "hs_call_body": "Discussed requirements...",
    "hs_call_direction": "OUTBOUND",
    "hs_call_duration": "1800000",
    "hs_call_status": "COMPLETED",
    "hs_timestamp": "2025-12-13T10:00:00Z"
  }
}

Display Format

code
✅ Call logged!
  ID: 14772074448
  Title: Discovery Call with Acme
  Direction: Outbound
  Duration: 30 minutes
  Status: Completed
  Notes: Discussed requirements, timeline...

Error Handling

ErrorSolution
401Invalid token - re-run setup
403Missing crm.objects.calls.write scope
429Rate limited - wait and retry

Related Skills

  • hubspot-list-calls - List all calls
  • hubspot-get-associations - Link call to contact