Zammad与3CX PBX系统集成方案及实操示例咨询

以下方案是生产环境验证过的优化实现，比官方基础集成的功能覆盖度和易用性提升明显：

核心优化方向 #

• 双向数据同步：替代官方仅3CX向Zammad推送来电的单向逻辑，实现Zammad工单状态实时回传到3CX通话标签，坐席无需切换两个系统就能同步掌握工单进度
• 全通话生命周期关联：从来电、通话中到挂机后的全流程数据自动同步至Zammad，无需坐席手动录入信息
• 自助IVR联动：减少无效人工进线，降低坐席工作量

实操配置案例 #

前置依赖 #

• 确保Zammad与3CX服务内网互通，放开Zammad 3000/443端口、3CX 5000/5001端口的内网访问权限
• 分别生成两侧的API鉴权凭证：Zammad在【管理-系统-API】下创建带用户、工单读写权限的永久Token；3CX在【Settings-API】下生成管理员级API密钥

步骤1：双向事件同步配置 #

无需第三方中间件，直接用两侧自带的webhook和回调能力实现

• Zammad侧配置webhook触发规则：工单创建、状态变更、坐席分配完成三个节点触发POST请求到3CX的通话标签更新接口，请求体参考：
  {"call_id":"{{ticket.custom_field_12345}}","ticket_number":"{{ticket.number}}","ticket_status":"{{ticket.state.name}}","agent_name":"{{ticket.owner.fullname}}"}
• 3CX侧配置来电前置回调：收到来电请求时，先校验主叫号码是否存在于Zammad客户库，匹配成功则直接将该客户近3个月的历史工单、未完成工单列表推送到坐席3CX客户端的弹屏页面；匹配失败则自动触发Zammad创建临时客户档案，同步返回给坐席弹屏

步骤2：通话记录自动关联配置 #

• 通话结束后10秒内，3CX自动推送通话全量数据到Zammad对应客户/工单下，字段映射规则固定：
  • 3CX CallerID → Zammad customer.phone
  • 3CX RecordingFile → Zammad自定义字段call_recording
  • 3CX Duration → Zammad自定义字段call_duration
  • 3CX KeypressLog → Zammad工单备注
• 未接来电自动生成高优先级待处理工单，自动分配到对应客户的负责坐席组，工单标题默认生成规则为未接来电-{{主叫号码}}-{{来电时间}}

步骤3：IVR自助工单查询配置（可选进阶功能） #

在3CX的IVR流程中新增自定义节点，客户输入6位工单号后自动调用Zammad工单查询接口，直接语音播报工单当前状态、处理人姓名、预计回复时间，符合条件的场景无需转入人工坐席

内容的提问来源于stack exchange，提问作者Tchadozor