自研CRM三个月实战复盘：从客户管理到外呼工作台的系统设计与落地

DeskcommCRM听起来像个商业软件的名字实际是我们团队从零自研并真正用起来的客户关系管理系统。这个项目从需求梳理到上线前后大概三个月最大的收获不是写了几万行代码而是把销售、客服、外呼、数据看板这些原本散落在不同工具里的流程收拢到了同一个以客户ID为主线的工作台里。名字里的Deskcomm直译是“桌面通讯”我们想让坐席像操作一个桌面应用一样完成拨号、记录、转工单这些高频动作而不是在多个系统之间来回切换。如果你正在纠结要不要自研CRM或者买了现成系统却总觉得“差了点什么”这篇复盘值得你花几分钟看完。1. 项目整体设计DeskcommCRM到底在解决什么问题1.1 为什么选择自研而不是买现成CRM启动之前我们不是没调研过商业CRM产品。市面上成熟的SaaS系统功能很全客户管理、销售漏斗、工单、报表都有但真正往下推的时候就会卡住销售团队已经习惯了手上那套Excel加微信的跟进方式客服团队有自己特定的工单流程管理层想要的数据口径又和标准报表对不上。强行用标准产品意味着团队要改工作习惯去迁就系统上线阻力很大。然后再看定制成本。商业产品的二次开发要么按人天收费要么只能走官方提供的字段扩展和自动化规则。像“外呼接通后自动弹出客户卡片并生成一条通话记录”这种场景化需求标准产品很难做顺。我们内部算了笔账如果需求清单再膨胀一轮采购加定制的费用足够养一个小型研发小组。加上团队本身有前后端全栈能力自研变成了性价比更高的选择。这里要强调一点自研不是否定商业产品。如果你的业务场景就是标准销售流程买现成的确实省事。但我们的场景非常垂直——销售、客服、外呼高度耦合需要一个以“坐席工作台”为中心的轻量系统。这种垂直场景自研反而是最快路径。整个项目从0到上线三个月比商务采购流程还快。1.2 功能地图五条主业务线DeskcommCRM的核心功能可以拆成五条线全部围绕“客户ID”这个唯一主线展开客户管理客户档案、多联系人、标签分组、归属人、客户合并。商机管理阶段流转、金额、预计签单时间、赢单/输单原因。工单管理售后、投诉、内部协作独立状态机和SLA计时。外呼工作台软电话拨号、通话状态回调、通话记录自动挂接、录音存储。数据看板销售漏斗、跟进率、人效统计、到期未跟进提醒。每条线都不是孤立模块。客户详情页把五条线汇总在一个时间里坐席点开客户就能看到“这个人是谁、聊到哪一步、遇到过什么问题、最近一次通话讲了多久、下一步该干嘛”。这个体验才是DeskcommCRM真正的核心价值。我见过不少团队做CRM功能列表写得很漂亮最后做出来却是一堆表格的堆积。原因是他们把“模块”当成目标而不是把“一条完整的客户生命周期”当成目标。我们在设计之初就定了一个原则所有新增功能必须回答“这个功能帮坐席省了哪一次多余点击”。回答不上来的功能先不进开发队列。1.3 技术栈与团队约束用熟悉的工具做正确的事技术选型上我们没有追求新颖。前端用Vue3加Element Plus后端用FastAPI数据库用PostgreSQL缓存用Redis部署用Docker Compose。外呼网关这块对接的是基于SIP协议的通信中间件通过Webhook方式把通话状态推送回系统。整条链路主力都是团队已经很熟悉的技术目的是把交付风险降到最低。为什么不用微服务因为业务规模撑不起微服务的复杂度。CRM这个场景核心是数据模型和流程规则不是并发吞吐。PostgreSQL加一套良好的索引设计支撑几百人日常使用绰绰有余。我们连Kubernetes都没上两台云主机加Docker Compose通过Nginx做反向代理和负载均衡稳定运行至今。选型背后还有一个隐性的约束团队规模小每个人都是多面手。与其搞一个复杂的分布式架构不如把所有的业务逻辑收拢在几个核心服务里出了问题能快速定位。CRM这类企业内部系统可维护性永远比技术先进性重要。后面所有功能迭代都是在这个前提下推进的。2. 核心模块设计与实操要点2.1 客户档案的字段设计先想清楚这几个问题客户档案是CRM的地基地基打不好后面全是麻烦。最常见的错误是字段堆砌运营提一个需求就加一个字段最后客户表单有七八十个字段坐席根本不想填。我们把字段分成三类每类字段有明确的管理者字段类型含义示例更新权限基础字段客户固有属性不太变化客户名称、行业、地区、客户来源创建人/管理员业务字段随跟进状态变化意向等级、客户阶段、负责人、下次跟进时间归属销售/主管系统字段系统自动维护创建时间、最后跟进时间、更新时间只读系统写入客户和联系人是分开的一个客户下面可以有多个联系人这是很关键的一步。很多人以为客户就是一排Excel行一行一个姓名一个电话做出来之后发现一个公司五个人都在联系数据完全乱掉。客户表存公司主体联系人表存具体的人两个表通过客户ID关联这样既可以管理企业客户也能管理个人客户。标签字段我们用PostgreSQL数组类型不搞死字段。比如“高意向”“老客户”“退款风险”都是标签运营人员可以随时给客户打上后续做客户分群和自动营销都靠它。系统新增标签不需要改表结构只需在字典表里加一条配置这个灵活度在项目后期帮了大忙。还要做一个客户合并功能。无论是导入数据还是坐席手动录入都会有重复客户。重复判断的规则可以是统一信用代码、手机号、客户名称相似度系统出现疑似重复时自动提醒。合并时要把联系人、商机、工单、通话记录都归并到主客户ID下源客户标记为已合并并保留跳转链接防止历史单据丢失。2.2 商机阶段与跟进状态机流程不再靠人盯商机不是销售拍脑门想出来的它是对客户购买意向的结构化表达。一个客户可能只处于“需求确认”阶段也可能同时带着两个不同产品的商机在跑所以商机表独立于客户表一个客户对应多个商机。我们的商机阶段定义为初步接触、需求确认、方案报价、商务谈判、赢单、输单。这个流程看起来简单但背后的状态机规则才是关键阶段只能按顺序向前推进不允许跳过。不允许从后期阶段回退到更早期阶段除了管理员手动修正。赢单和输单是终止态一旦进入商机关闭不能再改回活跃状态。赢单和输单必须填写原因否则无法提交。阶段变更记录操作人、变更时间写进商机动态。跟进记录和阶段变更是两件事但在界面上要能一次完成。坐席跟进完一通电话可以在同一个弹窗里写跟进内容、调整阶段、设置下次跟进时间。后端一次性完成“插入跟进记录更新商机阶段更新客户最后跟进时间推送待办提醒”这四件事。一开始我们分开做结果坐席经常忘记改阶段漏斗数据越来越虚后来才改成一键联动。商机金额和预计签单时间也是必填项这直接关系到销售漏斗和业绩预测。如果允许空值看板上的商机总金额就没有参考价值。我们设定了一个规则进入“方案报价”阶段之前金额可以暂不填写进入之后必须填写。这样既能保证前期数据录入顺畅又能让管理层的预测报表有意义。2.3 工单模块的边界别让“救火”淹没销售线索工单和商机很容易搞混。我们的区分标准很简单客户有明确购买意向但还没落单所有推进动作走商机客户已经购买之后遇到问题或者内部需要跨部门协作解决某个任务走工单。商机是向前看的增量动作工单是向后看的服务保障。工单状态机是待受理、处理中、待客户确认、已解决、已关闭。和商机状态机不同工单允许从“待客户确认”回退到“处理中”因为客户可能对解决方案不满意要重新处理。优先级按紧急程度分为四档每档对应不同的首次响应时限优先级场景举例首次响应时限紧急系统故障导致客户业务停摆30分钟高服务异常但可临时绕行2小时中常规功能咨询8小时低建议、优化需求24小时工单关闭前必须填写解决方案否则不能提交。这不仅是记录要求更是沉淀知识库的手段。我们在工单关闭时增加了一个选项坐席可以一键把这次解决方案推送到团队知识库后续再遇到同类问题就不需要重复排查。这个功能上线后工单平均处理时长下降了不少因为新员工遇到问题先在知识库里搜一遍而不是直接问老同事。客户详情页里工单和商机、跟进记录一样以Tab形式展示。但工单有独立的编号、独立的处理和SLA计时不能混在跟进记录里。早期我们试过把所有事情都写进跟进记录结果一条客户时间线里既有商机推进又有售后问题看起来毫无章法后来才拆开。2.4 坐席外呼工作台Deskcomm的核心体验Deskcomm这个名字核心就在外呼工作台。坐席登录系统后默认进入工作台界面中央是软电话状态区左侧是待办客户列表右侧是客户详情。点客户列表里的电话按钮系统通过外呼网关发起呼叫坐席手上戴的耳麦直接响铃接通与此同时右侧自动弹出客户卡片。这个“自动弹卡片”的体验是整个系统最受一线欢迎的功能。以前坐席需要先查电话号码再拿起电话拨号接通后去另一个系统里手工录入通话记录。现在所有操作集中在一个页面通话状态自动展示空闲、振铃中、通话中、已挂断。通话状态我们用的是Webhook回调不是前端轮询。网关在状态变化时把事件推送到系统后端后端再通过WebSocket把状态推送给对应的坐席页面。用回调而不是轮询主要是减少无效请求也避免页面频繁刷新导致状态闪烁。但回调方案也有代价就是接口要做幂等和重试机制否则网络抖动会导致状态丢失。隐私脱敏这块一开始就要设计好。默认情况下电话在界面上显示为脱敏号码比如中间四位打码。坐席想查看完整号码需要单独授权。但外呼时网关必须拿到完整号码所以系统内部会在接口层校验当前用户是否有外呼权限并且把“谁在什么时间呼叫了哪个号码”写入操作日志。这样既能满足业务需要又能防止个人信息被无权限地批量抓取。录音文件不建议直接存服务器本地我们接入了对象存储服务通话结束后由网关异步上传录音文件回调里带上录音地址系统只保存路径。通话记录表需要记录呼叫方向、通话状态、振铃开始时间、接通时间、挂断时间、通话时长、未接通原因拒接、无人接听、空号、占线。这些字段是后面算“有效通话时长”和“接通率”的基础。3. 从零部署到上线完整落地流程3.1 初始化从一台空服务器到系统可访问假设你只有一台空服务器整个初始化流程大概下面几步每一步都值得仔细核对。服务器配置建议8核16G起步。开发环境可以单机部署生产环境建议至少两台应用节点加一台独立数据库节点。我们的实际配置是两台4核8G的应用服务器加一台8核16G的数据库服务器数据库开启流复制主从备份应用层走Nginx负载均衡。第一步安装Docker和Compose插件。这个没什么好说的直接用官方安装脚本。第二步准备HTTPS证书。因为外呼网关回调、浏览器访问都要走HTTPS证书可以用免费的Let’s Encrypt也可以买商业证书。关键是把Nginx的443端口配置好。第三步克隆项目代码修改环境变量配置文件。需要重点关注的环境变量有数据库连接串字符集设为UTF-8时区设为Asia/Shanghai。JWT密钥必须换成足够长的随机字符串。外呼网关回调回调URL必须是公网可访问的地址。Redis地址和密码。对象存储的Bucket名称和访问密钥。第四步启动依赖服务docker compose up -d第五步执行数据库迁移alembic upgrade head第六步初始化种子数据。包括管理员账号、默认角色、基础字典客户来源、行业分类、商机阶段、工单优先级、通话未接通原因等。这个环节容易被忽略但没做好后面所有下拉框都是空的。第七步导入组织架构。先建部门再建员工账号设置部门主管和汇报关系。注意企业微信或钉钉扫码登录可以后接初期先保证手机号加密码能登录。第八步配置外呼网关线路用真实号码测试拨打流程。重点检查拨号是否能接通、接通后是否自动弹客户卡片、挂断后是否生成通话记录、录音是否上传成功。我只能说如果没有完整的失败复盘习惯不要在初始化环节跳过任何一步。很多线上问题追到最后都是某个初始化步骤没做比如时区配置错了导致所有时间统计偏差8小时。3.2 权限模型先配好“看得见”和“碰得到”权限模型我总结为三句话菜单权限控制“能不能看到入口”数据权限控制“能看到哪些行的数据”字段权限控制“能看到哪些列的内容”。三条线缺一不可。角色我们预设了五类超级管理员、销售主管、销售、客服坐席、运营分析。销售主管可以看到本部门全部客户和商机审批商机阶段回退、客户转移、工单转派。销售只能看到自己名下的客户和商机跨部门客户默认不可见。客服坐席可以查看客户关联的工单和通话记录默认看不到商机金额。运营分析只读权限可以看全部数据但不能导出客户手机号除非单独开白名单。数据权限的落地方案是RBAC加数据范围字段。在用户表里增加一个scope字段值为self、department、all。每次查询客户列表时后端必须根据scope自动拼接过滤条件。这个逻辑我建议做成装饰器或中间件而不是在每个接口里手写。def apply_data_scope(query, user): if user.role admin or user.data_scope all: return query if user.data_scope department: return query.filter(Client.owner_dept_id user.dept_id) return query.filter(Client.owner_id user.id)这个函数会用在所有客户列表、详情、修改、转移接口上。说句经验之谈权限过滤一定要往下沉到数据访问层不要在前端隐藏按钮了事。我们内部做安全评审时第一个测试用例就是普通销售直接请求其他部门客户的详情接口期望返回404而不是返回数据。字段权限单独做了配置表比如客服角色默认看不到商机金额字段。前端根据权限配置渲染后端也会把无权访问的字段置空。两个地方都做才能保证接口返回的数据不会泄露。3.3 历史数据迁移实战清洗是第一优先级数据迁移是上线前最耗时也最烦的环节。我们的旧数据有一份Excel加另一个系统导出的CSV总共差不多三万多条客户记录。这个量级不大但脏数据够多。第一步先定义导入模板。模板字段为客户名称、联系人、手机号、客户来源、行业、负责人、当前阶段、下次跟进时间、备注。模板作为Excel文件上传到系统后端解析后进入数据清洗流程。第二步数据清洗。需要处理的问题包括手机号格式不统一、座机号混入、客户名称前后空格、统一信用代码缺失、同一客户被录入了多个不同名字。我们当时的做法是先按手机号去重手机号为空再按客户名称精确匹配加行业判断最后再考虑统一信用代码匹配。清洗结果会生成一份质量报告告诉操作人有多少重复、多少缺字段、多少可能属于同一客户。第三步小批量试导入。先导入50条人工核对一遍姓名、电话、归属人是否正确。这一步通过之后再做全量导入。第四步异步全量导入。导入跑在后台任务里前端不需要一直等待。导入完成后系统自动生成导入结果文件包括成功数、失败数、每一条失败的原因。失败的行不会直接丢弃可以下载错误清单修改后再导入。这里有一个容易忽略的点历史跟进记录和通话记录也要迁移不能只导入客户档案。如果客户进来了但历史库里空荡荡销售查看客户时间线时什么都看不到会觉得新系统还不如旧系统。我们迁移时尽量把旧系统能导出的跟进备注、通话时间和结果都整理进对应的通话记录表和跟进记录表。3.4 看板与统计口径数据能不能信全看这里做数据看板最容易犯的错是先画图再定义口径。不同的同事对“跟进率”的理解可能完全不一样如果口径不统一看板上线第一天就会遭遇各种质疑。我们在上线前专门开了一次会把关键指标的口径写死。常用指标定义如下指标定义口径备注客户总数按客户ID去重不含已删除和已合并合并后的子客户不计入新增客户数创建时间落在所选时间范围按天/周/月聚合跟进率有跟进记录的客户数 / 有归属的客户总数只算所选周期内有跟进动作到期未跟进数next_follow_at小于当前时间且商机未赢单/输单需要排除已经关闭的商机商机总金额所有未赢单且未输单商机的金额之和同一客户多商机只按商机总和计赢单率赢单商机数 /赢单商机数输单商机数不含还处于进行中的商机平均成交周期从商机创建到赢单状态的天数平均值只统计赢单商机坐席接通率接通通话数 / 外呼总数外呼总数不含来电这些指标在前端展示时会预聚合到一张日汇总表里凌晨定时任务跑一次。当天的实时数据走Redis缓存缓存五分钟自动失效。这样既保证了看板打开的速度又不会在高峰期拖垮数据库。看板还有个容易被忽略的点必须支持下钻。管理层看到某个指标异常能点进明细列表查看具体是哪些客户出了问题。否则看板就只是一个“好看但没用”的装饰。4. 上线后遇到的坑与排查实录4.1 跟进记录重复、时间线错乱上线第一周就有坐席反馈客户时间线里出现了两条一模一样的跟进记录但自己明明只保存了一次。排查过程很有意思。先看操作日志发现同一个时间段内有两次创建跟进记录的请求一次来自前端页面保存一次来自外呼网关的Webhook回调。原因是我们在外呼接通时系统自动生成了一条“通话已结束”的跟进记录而坐席挂断后又手动点了一次保存前端重新提交了一次。两个动作的接口路径不同都成功写入了数据库。解决办法是给跟进记录的创建入口加幂等控制。前端每次保存生成一个uuid作为幂等键后端对“幂等键”建立唯一索引。外呼回调里则使用网关的通话记录ID作为幂等键。数据库层面对(source, source_id, operator_id, record_date)加联合唯一索引重复提交直接返回已存在记录。这个问题的本质是多个数据入口同时写一条业务数据但没有一个统一的“事件ID”约定。真要排查类似问题时先看请求日志确认是不是双写再检查接口是否做了幂等不要上来就改框架。4.2 外呼状态回传不同步出现过一次生产事故坐席电话已经接通聊了两分钟工作台界面还一直停留在“振铃中”挂断后录音文件也迟迟不出现。排查后发现网关Webhook回调请求打到了负载均衡但负载均衡配置的回调地址是内网地址网关所在网络根本访问不到。这个属于部署配置错误。因为回调URL写的是内网IP我们调试时用同一内网环境没事网关在外部网络就完全失联了。解决方式分几层回调地址必须使用公网可达的HTTPS地址不能用内网IP调试。Webhook接收方不执行业务逻辑先落库再丢进消息队列异步处理。接收后立刻返回200业务处理失败时通过本地重试机制补偿。管理后台增加“通话状态排查页”能看到最近100条回调记录和推送失败原因。给通话表建立索引call_id唯一索引、(operator_id, started_at)组合索引。调试阶段建议使用临时公网映射工具把本地服务暴露出来模拟真实回调链路。我们当时就是用这种方式把Webhook链路彻底走通后才在服务器上正式部署的。4.3 数据越权问题排查安全测试阶段发现一个严重问题一个普通销售账号只要把请求里的客户ID改成其他部门的客户ID就能直接读取客户详情。列表页明明看不到这个客户详情接口却返回了数据。原因很典型列表查询时数据权限过滤生效了但客户详情接口里我们只判断了“登录用户是否有效”忘了判断“这个用户是否有权限访问这个具体客户”。换句话说权限过滤没有下沉到所有数据访问路径出现了“一处安全一处漏风”。修复方式是把客户访问权限检查抽成一个统一装饰器客户详情接口必须校验客户归属人或部门。客户更新接口同样校验。客户转移接口只允许销售主管和超级管理员调用。工单详情、商机详情、通话详情等关联接口也要通过客户权限校验。修复后我们写了自动化安全用例每次发布前自动执行普通用户访问非本部门客户的详情接口期望404客服角色访问商机金额字段期望被置空。这套用例后续救了我们很多次。4.4 上线后没人用怎么救系统上线第一个月后台数据显示80%的坐席一周登录不超过两次。跟进记录基本靠管理员手动补录整个系统形同虚设。当时心态确实崩了一下。我们没有马上加功能而是逐个找坐席聊问为什么不爱用。反馈整理下来很集中录入客户太麻烦表单太长填一个客户要两分钟。外呼后系统要填的东西太多坐席宁可在微信群里记录。手机上访问体验差销售在外不方便录入。团队主管不看系统周报依然是Excel收集。针对这些问题做了三件事第一做快速录入模式。客户详情页旁边放一个“快速新建”按钮弹窗里只有客户名称、联系人手机号、备注三个字段保存即创建。后续有空再补全资料。第二外呼挂断后如果坐席没有写跟进记录系统弹一个轻量提醒但不强制填写。提醒按钮可以直接调到快速跟进弹窗只需要填一句话按保存就好。第三主管日报由系统自动生成每天早上推送到钉钉/企微群列出本部门昨日外呼量、新增客户、到期未跟进客户。这样一来主管自己先依赖上系统才会要求团队用系统。效果是上线第三个月坐席周活跃率到了85%以上。核心原因是让一线觉得系统省事儿而不是系统在监督我。5. 给同样在规划CRM的团队的几点经验5.1 先梳理流程再写代码别把功能清单当需求我们最初的需求文档写得很长全是功能清单客户管理、商机管理、工单管理、报表……但开发到一半发现功能之间的关系很不清楚。后来我们花了两天时间把“客户从线索到成交再到售后的完整生命周期”画成流程图标注每一步由谁操作、数据落在哪个表、状态怎么流转。画完之后开发量大概砍掉了百分之三四十。很多功能在流程里根本不需要比如我们原本想做客户生日提醒和自动短信祝福后来发现这个动作不是业务流程的刚需纯粹是运营的“有即更好”需求就砍掉了。如果现在的你正在做一个CRM类系统我建议你先把核心流程梳理完再碰代码。流程里不存在的功能不要提前开放字段和配置否则上线即混乱。5.2 哪些模块可以借用现成方案别什么都自研做技术方案时我们差点连软电话都自己实现。后来调研发现自研软电话要处理信令协议、音频编解码、回声消除、网络抖动一系列问题投入产出比极低。最终选择对接成熟的外呼网关团队只需要处理回调数据和展示逻辑反而把上线时间缩短了一半。我的判断标准是真正值得自研的是“客户数据模型、跟进逻辑、权限体系、统计口径”这些业务核心资产呼叫信令、短信发送、对象存储、扫码登录这类能力直接接入成熟服务就行。区分核心资产和非核心能力能帮你省下非常多时间和精力。5.3 后续扩展方向分群营销、BI、移动端系统稳定运行后我们规划了三个扩展方向第一客户分群与自动营销。基于客户的标签、最后跟进时间、商机阶段等条件做自动分群比如“30天未跟进的高意向客户”系统自动提醒销售或者触发一次标准化的短信触达。第二BI对接。把关键指标输出到更专业的数据分析平台做趋势预测和团队绩效分析。这一步的前提是统计口径已经在内部系统里沉淀完整否则进了BI还是错的。第三移动端小程序。给销售外勤使用的移动端功能只保留三件事查看今天该跟进的客户、快速写跟进记录、查看自己的业绩完成进度。不要试图把桌面端的所有功能搬到移动端移动端的价值是“在路上也能响应客户”不是“在路上也能用完整CRM”。最后再分享一点真实体会项目上线两个月后有一个坐席找我说“如果以后换系统外呼后能自动弹出客户卡片这个功能一定要保留。”我当时就觉得这个项目成了。他说的不是某个复杂报表也不是什么高级自动化就是最基础的那个体验——打通了电话和客户资料之间的距离。后来我们确实在做下一期迭代想让通话录音自动转写成文字摘要再变成跟进草稿进一步减少坐席的记录负担。但这些都是锦上添花。判断CRM项目成功的标准始终只有一条一线团队是否每天都愿意打开它是否觉得它省力是否愿意把客户信息放心地托管在里面。管理层的报表只是副产品业务的确定性才是真正的答案。如果你也准备在团队里推动CRM项目别急着搭大架子。先从坐席一天里最频繁的操作开始做原型解决“打完电话怎么最快把信息记下来”这个问题再谈商机漏斗和数据大屏。这个顺序比任何提前规划都管用。