房产中介的私域和其他行业不一样客户从咨询到成交少则三个月、多则半年。这带来两个行业特有的浪费——一是经纪人流动性大人一走他微信里几百个客户就等于丢了二是沉睡客户没人管三个月前咨询过的客户最近有购房资格了没人知道等他自己找上门可能已经跟别家签了。本教程用个人微信机器人开发 API 搭一套房产客户跟进系统新客需求自动采集 → 房源卡片精准推送 → 带看预约承接 → 沉睡客户定时唤醒。基于标准 HTTP Webhook 接口实现本文以 WTAPI 为例Python 代码所有接口路径与参数均已对照官方开发文档核实可直接作为搭建文档使用。一、链路设计围绕长周期建四层新客咨询MsgType1 → ① 需求采集预算/区域/户型 → 标签落库 → ② 房源匹配forwardUrl 推送房源链接卡片 → ③ 带看信号想看看/什么时候方便看→ 推经纪人承接 → ④ 沉睡唤醒30 天未互动客户 → 定向内容触达核心思路机器保证每个客户在 6 个月里都被有理由地联系着经纪人只出现在客户主动升温的时刻。二、承接层回调骨架官方开发文档回调规范3 秒内响应、去重键Appid Data.NewMsgId、文本消息MsgType1。标准三段式去重 → 入队 → 立即返回importjson,queueimportrequestsfromflaskimportFlask,request API_BASEhttps://wx.chuapi.comAPP_IDYOUR_APPIDHEADERS{X-finder-TOKEN:YOUR_TOKEN,Authorization:Bearer YOUR_JWT,# 部分环境需要Content-Type:application/json,}task_queuequeue.Queue()_seenset()appFlask(__name__)app.route(/wtapi/callback,methods[POST])defcallback():msgrequest.get_json(silentTrue)or{}ifmsg.get(TypeName)AddMsg:dmsg.get(Data,{})# 过滤本号发出的消息避免机器人回复自己ifd.get(FromUserName,{}).get(string)msg.get(Wxid):return,200keyf{msg.get(Appid)}:{d.get(NewMsgId)}ifkeynotin_seenandd.get(MsgType)1:_seen.add(key)task_queue.put(msg)return,200三、需求采集三句话问出客户画像新客首次咨询机器人不急着推房源先采需求——房产推荐错了方向客户直接流失defon_new_client(wx_id):post_text(wx_id,您好为给您匹配合适的房源先了解三点\n1️⃣ 大概预算区间如 300-400 万\n2️⃣ 考虑哪个区域\n3️⃣ 几室户型自住还是投资)defpost_text(to_wxid,content):官方发消息接口 postText参数仅 appId/toWxid/contentrequests.post(f{API_BASE}/finder/v2/api/message/postText,headersHEADERS,datajson.dumps({appId:APP_ID,toWxid:to_wxid,content:content}),timeout10,)客户回答后LLM 抽取结构化字段预算/区域/户型存入本地 CRM同时写微信侧标签预算-300-400万、区域-XX区、阶段-已采需求。标签接口用官方POST /finder/v2/api/label/modifyMemberList注意文档强调的全量修改语义已有标签 1、2 要新增 3labelIds必须传1,2,3只传新标签会把旧的冲掉先用POST /finder/v2/api/label/list拿labelName/labelId映射本地维护客户标签集合合并后全量提交。四、房源推送与带看承接匹配到房源后别甩裸链接。用官方链接卡片接口POST /finder/v2/api/message/forwardUrl参数appId/toWxid/xmlxml 为链接卡片结构以官方文档 message 模块为准推送房源详情页——有封面图、有标题的卡片打开率是裸链的几倍defpush_house(wx_id,house):post_text(wx_id,f按您{house[budget]}预算、{house[area]}的需求f新上一套{house[rooms]}单价{house[price]}比同小区挂牌低 5%详情)send_card(wx_id,titlehouse[title],urlhouse[url])# forwardUrl客户回复想看看“什么时候能看”立即转经纪人发一句已为您安排专属顾问约看马上联系您同时把客户画像、需求标签、聊天记录摘要推到门店群。带看是房产唯一的成交前置动作机器到此为止。五、沉睡唤醒本篇的核心竞争力30 天未互动的客户进入唤醒池。唤醒不是群发广告是带着客户标签的定向内容——他关心 XX 区就发 XX 区的新房源或成交行情defwakeup_task():# 每日定时任务捞 30 天未互动客户按标签定向触达forclientindb.get_sleeping_clients(days30):contentbuild_wakeup_content(client.tags)# 按标签生成定向话术post_text(client.wx_id,content)time.sleep(INTERVAL)# 串行发送控制频率两个工程要点频率红线同一客户每月自动触达不超过 2 次发送串行执行。唤醒的本质是让他记得你不是让他烦你客户池定期盘点经纪人离职时用官方接口POST /finder/v2/api/contacts/fetchContactsListbody 仅{appId}拉取该实例好友列表与 CRM 比对确保客户资产在公司系统里而不是个人微信里——这一条直接解决开头说的人走客户丢。六、调试与上线调试环境WTAPI 开发文档站weiti.apifox.cn提供 7 天接口调用权限后台附带 Demo 示例可供本地调试本文所有接口路径与字段以文档实时内容为准。建议先在控制台「微信实例」扫码拿 appId用toWxidfilehelper文件传输助手自测推送链路再接真实客户。上线前三个提醒房源话术过合规“绝版”“稳涨”学区房 guarantee 入学这类词进黑名单房源描述以实际挂牌信息为准唤醒内容必须有信息增量新房源/真实成交行情/政策变动空问候式唤醒等于骚扰新实例先养后接官方文档提示新设备部分功能有 1-3 天限制期刚登录先低频跑几天。合规声明本文自动化能力仅用于客户主动咨询后的服务响应与存量客户维护请遵守微信平台运营规范与房产中介行业监管要求不使用任何非官方破解协议不进行骚扰式批量营销。