GHL CRM for Realtors
Use this skill when a user wants realtor CRM actions in GoHighLevel (GHL), including lead follow-up, pipeline movement, appointment booking context, and messaging workflows.
Required Environment
Set these variables before running the scripts:
- -
HIGHLEVEL_TOKEN (Private Integration token) - INLINECODE1 (sub-account location ID)
Optional runtime variables:
Setup
If the user asks to connect or set up GHL, run:
CODEBLOCK0
The wizard validates credentials and tests API connectivity.
Primary Script
Use the helper script for direct actions:
CODEBLOCK1
Common commands for realtor workflows:
- - INLINECODE3
- INLINECODE4
- INLINECODE5
- INLINECODE6
- INLINECODE7
- INLINECODE8
- INLINECODE9
- INLINECODE10
- INLINECODE11
- INLINECODE12
- INLINECODE13
- INLINECODE14
- INLINECODE15
Realtor-Focused Playbooks
New Lead Intake
- 1.
search_contacts to prevent duplicates. - If not found,
create_contact with source tags (for example: buyer, zillow, open-house). - Add next-step task/note using supported contact endpoints.
Pipeline Progress
- 1.
list_opportunities to inspect active deals. - Move stage using the opportunity update command path in
ghl-api.py. - Confirm stage and status in response payload.
Follow-Up Messaging
- 1. Resolve contact first (
search_contacts or get_contact). - Send message with
send_message. - Re-check conversation history with
list_conversations.
Appointment Assist
- 1. INLINECODE27
- INLINECODE28 for date range.
- Use the calendar endpoints in script for appointment creation if requested.
Safety Rules
- - Never print or echo raw tokens in chat output.
- Prefer dry informational reads before write actions when intent is ambiguous.
- Validate contact/opportunity IDs from GHL responses instead of guessing.
- If an API error returns 401/403, stop and ask for corrected scopes or token.
References
Load these only as needed:
- - INLINECODE29
- INLINECODE30
- INLINECODE31
- INLINECODE32
- INLINECODE33
面向房地产经纪人的GHL CRM系统
当用户需要在GoHighLevel（GHL）中执行房地产经纪人CRM操作时使用此技能，包括潜在客户跟进、销售管道移动、预约设置上下文和消息工作流。
所需环境
在运行脚本前设置以下变量：
- - HIGHLEVELTOKEN（私有集成令牌）
- HIGHLEVELLOCATION_ID（子账户位置ID）
可选运行时变量：
设置
如果用户要求连接或设置GHL，请运行：
bash
python3 scripts/setup-wizard.py
该向导将验证凭据并测试API连接性。
主脚本
使用辅助脚本执行直接操作：
bash
python3 scripts/ghl-api.py <命令> [参数...]
房地产经纪人工作流的常用命令：
- - testconnection
- searchcontacts [查询]
- getcontact [联系人ID]
- createcontact [JSON]
- updatecontact [联系人ID] [JSON]
- listopportunities
- listpipelines
- listconversations
- sendmessage [联系人ID] [消息]
- listcalendars
- getfreeslots [日历ID] [开始日期] [结束日期]
- listworkflows
- addto_workflow [联系人ID] [工作流ID]
面向房地产经纪人的操作手册
新客户导入
- 1. 使用searchcontacts防止重复。
- 如果未找到，使用来源标签（例如：buyer、zillow、open-house）创建联系人createcontact。
- 使用支持的联系人端点添加下一步任务/备注。
销售管道进展
- 1. 使用list_opportunities检查活跃交易。
- 通过ghl-api.py中的机会更新命令路径移动阶段。
- 在响应数据中确认阶段和状态。
跟进消息
- 1. 先解析联系人（searchcontacts或getcontact）。
- 使用sendmessage发送消息。
- 使用listconversations重新检查对话历史。
预约协助
- 1. listcalendars
- 使用getfree_slots获取日期范围内的空闲时段。
- 如有要求，使用脚本中的日历端点创建预约。
安全规则
- - 切勿在聊天输出中打印或回显原始令牌。
- 当意图不明确时，优先进行只读信息查询，再执行写入操作。
- 从GHL响应中验证联系人/机会ID，而非猜测。
- 如果API返回401/403错误，请停止并要求修正权限范围或令牌。
参考资料
仅在需要时加载：
- - references/contacts.md
- references/opportunities.md
- references/conversations.md
- references/calendars.md
- references/troubleshooting.md
