顶顶通-FreeSWITCH二次开发接口-CSDN博客

原创关于我

鼎鼎就职于顶顶通软件。专门从事呼叫中心软件开发，这个博客主要，介绍FreeSWITCH的一些知识以及开发的模块和软件。如果你对我发表的博文敢兴趣可以通过一下方式联系到我。联系方式微信：cdevelopQQ:1280791187网站：www.ddrj.comFreeSWITCH和呼叫中心相关的技术交流群：21596142下面介绍一下我从事呼叫中心开发的一下经历。大约2005年，找到了第一份程序员的工作，公司接了一个IVR导航系统的外包项目使用三汇语音卡进行开发的，..

2021-05-21 16:30:11 1825 2

原创顶顶通AICC打断设置

文章摘要：禁止打断放音节点用于开场白或长语音前几秒的防打断设置，但可通过“忽略禁止打断”选项在知识库或多轮对话响应时允许打断。打断模式支持多种触发条件（如检测声音、DTMF按键等），决定何时打断AI放音。完成设置控制流程跳转逻辑，未匹配关键词时默认等待超时（TIMEOUT），配置后可直接跳转（DONE）。重新匹配功能可在放音结束后处理用户打断内容，尤其适用于禁止打断场景下延迟响应的需求。大模型超时或未命中规则时需依赖重新匹配机制补充分析。

2026-04-19 17:23:51 338

原创 AICC 电话智能体之意向分类

重点：2种方式有什么区别，方式1用多轮对话提交给大模型，大模型有时候直接根据历史对话回答问题，不能理解需要总结的意图，所以添加了方式2支持，把历史对话内容直接放到用户提示词，让大模型更好的理解是需要对对话内容进行总结和分类，不是继续回答问题。\nuser:用户回答二。注意：大模型提示词里面的意向分类名字不要和系统预设的A-G冲突, 如果你的分类方法和系统预设的不一致，可以通过添加自定义分类标签，来添加你需要的，然后意向提示词里面的分类名字需要和自定义分类名字一致。"content": "用户提示词"

2026-04-09 18:57:52 395

原创复杂流程调用大模型技巧

请发掘客户需求，如果客户的需求在业务分类里面，请直接回答业务分类ID（注意只需要回答业务ID，ID，不要回答其他内容），否则请直接回答问题，一定要询问清楚客户的需求，比如是否要订房或者顶餐。比如酒店AI客服，有订房业务、订餐业务、订票业务、客房服务业务，如果我们把所有业务办理的规则，都放在一个提示词里面，会导致提示词非常长，大模型处理慢，消耗token多。先做一个普通放音节点，去询问用户需要办理的业务，如果用户需要办理的业务有专门的处理流程，就切换到对应的流程去执行。回复不要太罗嗦，要尽量简短。

2026-04-09 18:54:46 183

原创多轮对话提示词编写技巧

比较好的提示词语写法是，不需要告诉大模型每轮对话怎么说，只需要告诉大模型我们业务步骤或者流程，需要注意什么，常见问题的答案（faq），让大模型自己组织语言去对话。- 县区或者乡镇，如果听不清，或者用户说的地市不存在，如果让用户再说一次，如果用户说了2次，还是不对，可以把同音的或者对应地市下面最接近的几个问用户是哪个。- 如果用户说的地市听不清楚，或者用户说的地市不存在，可以类似这样回复：”你慢点说，是哪个省的的哪个市啊“。问：好的，是很美的美，都市丽人的丽，天上的天，成功的成，美丽天成小区对吧。

2026-04-09 18:53:16 411

原创 AICC 智能体（话术）设计介绍

摘要：顶顶通AICC提供多模式电话智能体编排方案，包含四种技术路径：1）传统关键词匹配（响应最快但准确性低）；2）大模型意图理解（速度较快但回答固定）；3）大模型直接生成（灵活性高但响应较慢且TTS成本高）；4）端对端音频模型（速度最优但成本过高）。其核心优势在于支持混合使用前三者：简单问题用关键词匹配，预设回答用意图理解，复杂流程用大模型生成。当前音频大模型因成本过高暂不适合商用。

2026-04-04 17:41:24 124

原创家电维修中心电话呼入AI接线案例

维修中心一般在网络平台（比如58同城）发布信息，用户通过拨打平台的虚拟号码联系维修中心，维修中心询问用户的联系电话和所在地（精确到街道或者乡镇），然后派单给附件的维修点，让维修师傅电话联系给用户报价和上门维修。固定电话可以通过语音网关转换成SIP，就可以接入AI系统，SIM手机电话卡可以通过DTU设备转换成SIP，接入AI系统。维修中心一般就一个人接电话，同时多个来电接不过来，或者晚上下班了，没人接电话，为了解决这个问题，可以使用AI接线，降低人工成本，提高工作效率。

2026-02-12 20:31:26 186

原创顶顶通SIP电话客户

摘要：该SIP电话软件具备绿色免安装、多账号注册及并发通话功能，支持H264/VP8/VP9视频编码。提供WebSocket二次开发接口实现网页控制，支持无服务器的本地账户直连通话。具备完善的通话管理功能（自动应答/转接/保留/合并/多方通话），并开放SIP信令跟踪接口，便于开发调试。（98字）

2026-02-11 19:42:00 351

原创某政务中心市场监督局服务热线案例

大模型提示词设计，因为是政务场景，回答必须准确，不能出现大模型幻觉。所以我们应该只使用模型的理解功能，为了防止大模型乱回答，不能使用大模型生成式回复（也就是我们让大模型从知识库列表里面选择一个匹配的知识库ID，然后直接回答对应知识库的文本）。你是一个问题分类专家，根据问题理解意图，然后从问题分类列表里面选择一个符合的ID。注意：任何情况，都不要回答问题，只对问题进行分类，输出最符合的ID。时间组设置，创建一个非工作时间组，把非工作时间配置上。配置一个被动转人工多轮对话，被动转人工的时候执行。

2026-02-04 17:18:28 588

原创电话语音接入扣子介绍

实现思路扣子平台提供了双向流式语音对话接口，我们只需要把软交换FreeSWITCH的音频流推送到通过双向流式API推送到扣子平台，然后把扣子平台返回的声音发送给给软交换FreeSWICH,就可以实现电话语音和扣子通话了。扣子是非常流行的智能体开发平台，那么怎么把电话语音接入扣子，通过电话和扣子智能体进行语音通话。顶顶通AICC系统目前就已经实现了电话语音和各种智能体通话，就这一方便进行介绍。更详细的介绍，可以看我发的演示视频。第一步在扣子平台创建一个智能体。

2025-11-02 23:13:19 388

原创电话AI呼叫系统怎么集成扣子AI Agent

对接的具体原理就是，我在基于FreeSWITCH的mod_cti中间件，上面实现了一个通用推流和拉流的框架，然后在根据扣子的websocekt音频对接协议，抽象了一个连接层，把电话的音频流推送给扣子，把扣子平台返回的音频流推送到电话。这样就可以实现电话和扣子的 AI Agent 语音通话了。因为我们呼叫中心中间件是c开发的，直接对接weboscket协议更灵活，rtc必须使用扣子提供的SDK，不方便c语言集成，所以我们选择用webscoekt接口，根据协议对接，不使用扣子官的的SDK。

2025-10-01 23:04:06 522

原创顶顶通大模型电话机器人实现原理

没法精细控制对话流程，以及没办法精细意向分类，只能通话结束把整个对话记录提交给大模型让大模型做总结。如果候选回复没有合适的，请根据候选回复和对话上下文以及产品信息输出简短的回复。顶顶通话术引擎会根据大模型匹配设置，从当前流程关联的知识库、多轮对话、子流程中提取放音文字和意向。流对接，直接把音频流输出给大模型，大模型返回音频流。对话流程可控性低，无法精细控制对话流程和意向判断。对不起，你不符合赠送意外险条件，打扰你了，再见。技术让大模型根据专业领域知识输出回复。：让大模型更快的回复，和避开动态。

2025-06-22 15:08:50 1179

原创顶顶通AI呼叫软件(大模型电话机器人)介绍

大模型电话机器人

2025-06-22 14:33:18 710

原创顶顶通电话机器人功能列表

AI对话记录，可区分抢话，还是放音后用户说话，可显示放音多少秒用户开始说话。支持大模型回答后处理，就是大模型返回的内容和预设关键词匹配执行不同流程。嵌套式多轮对话时，就是多轮对话时可以回答主流程问题。挂机时使用大模型对通话内容进行分类和总结。未匹配到关键词也结束流程(仅放音结束后)未匹配到关键词也结束流程(包含放音时)使用大模型选择流程执行分支。大模型和关键词、正则表达式混合使用。提示词嵌入RAG查询结果。每个节点单独设置提示词。使用大模型优化流程回答。检测到声音就暂停放音。检测到按键就停止放音。

2025-06-11 19:37:00 877

原创顶顶通智能呼叫中心系统技术解析

顶顶通智能呼叫中心系统提供全方位的呼叫管理解决方案，涵盖坐席管理、呼入呼出、中继线路和质检等功能。系统支持多种终端接入方式，具备防盗打、通话控制、实时监控等安全特性。智能路由分配支持多梯队优先级，结合AI接听和人机耦合技术。外呼功能包括预测式外呼、AI外呼和智能并发控制。质检系统提供实时风险拦截和通话分析，确保服务质量和合规性。通过灵活的部门管理和工具条操作，提升客服工作效率和服务水平。

2025-06-11 19:34:03 913

原创现有预测式外呼系统如何接入AI系统，使用AI辅助，判断出意向客户再转人工

很多用户还在使用老旧的预测式外呼系统，只能外呼接通后播放一个提示音，播放完提示音后在转给人工坐席，如果重新部署一套AI外呼系统，涉及到业务系统的迁移，非常不方便。现在我就做一个如何让现有外呼系统，接入AI系统，使用AI辅助，判断出意向客户再转人工的原理图。外呼接通后转人工类型。播放提示音后转让南宫。

2025-05-11 18:33:12 560

原创如何让现有外呼系统无缝融合AI功能

AI辅助系统主要的特点就是只有判断到了被叫有意向，才对外呼系统应答，然后外呼系统直接转人工，把播放前置提示音用 AI对话替代。如果能把播放前置提示音这个流程改成通过AI 对话来判断客户意向，就可以实现让外呼系统无缝融合AI功能了。外呼系统 ➤ 发起呼叫 ➤ 电话接通 ➤ 播放前置提示音 ➤ 转人工。现在大部分外呼系统的工作流程如下。以下就是顶顶通AI辅助的方案。

2025-04-12 12:19:41 622

原创顶顶通呼叫中心中间件(mod_cti基于FreeSWITCH)-大模型电话机器人

如果没有匹配的回答分支，大模型会输出unmatch，话术引擎会忽略模型返回，继续执行兜底(any)匹配，如果设置了兜底流程就会进入兜底流程节点。如果有接近但不完全合适回答分支，大模型会输出回答ID，和输出优化后的回答内容，话术引擎切换到流程节点，播放大模型优化后的回答内容；如果有完全符合情境的回答分支，大模型会输出回答ID，不会优化回答内容，话术引擎切换到流程节点，播放节点预先设置的放音;如果有匹配的回答分支，大模型会输出回答ID，话术引擎切换到流程节点，播放节点预先设置的放音;

2025-02-28 16:18:30 1835

原创顶顶通电话机器人开发接口对接大语言模型之实时流TTS对接介绍

大语言模型一般都是流式返回文字，如果等全部文字返回了一次性去TTS，那么延迟会非常严重，常用的方法就是通过标点符号断句，返回了一句话就提交给TTS。随着流TTS的出现，就可以直接把大模型返回的文字灌给流TTS，实现低延迟的，文本到语音转换。下图是我们电话机器人接口适配流TTS的原理，完整的接口说明可以看请点击这里主要涉及到的技术点，就是FreeSWITCH通过websocket流TTS放音。

2024-12-06 16:12:49 1364

原创顶顶通呼叫中心中间件添加了FreeSWITCH防盗打功能

为了尽量减少误杀，影响正常使用，所以默认不是直接根据IP来封杀，是结合IP和账户来封杀。5. external的默认拨号方案，不允许为internal或者default. 防止用户配置错误。是人就有疏忽大意的时候，所以我们给顶顶通呼叫中心中间件添加了安全加强功能，用来减少盗打风险。4. external必须配置apply-inbound-acl。对每个客户，我们都反复强调注意盗打的风险，配置的时候要小心，密码要搞复杂点。1. 如果密码太短了，或者太简单了，直接返回认证失败，预防用户大意了。

2024-12-02 18:33:55 875

原创顶顶通软交换安装使用说明

执行命令 freeswitch 如果正确启动，就说明安装没问题了，关闭freeswitch命令是在启动的程序界面输入shutdown,注意不是bash执行。先在有网络的电脑下载fs.tar.gz和install.sh。把这2个文件上传到目标服务器同一个目录。执行这个命令自动下载和安装。

2024-08-16 11:50:14 1123

原创顶顶通手机助手拦截方案

在呼叫中心职场，外呼的流程一般是，先用外呼系统打通电话，然后播放一个前置广告语音，语音播放完成后，再转接给坐席。如果不把手机助手接通的电话拦截了，那么会导致人工坐席接到的大量是手机助手接通的电话。现在很多品牌的手机，都自带语音助手，比如我用的是小米手机，就自带小爱助手，可以自动接听各种广告营销电话。现在自动外呼系统拨打出去的电话，号码很容易给标注为广告营销，大部分的通话都是手机助手应答的。外呼电话中，大约有5%-10%是单通无声的，顶顶通语音助手拦截方案，可以把无声电话自动挂了，解决坐席接到很多无声电话。

2024-08-08 21:33:20 626

原创顶顶通语音信箱手机助手拦截方案

在电话自动外呼系统，常见的问题是被叫号码开通了语音信箱，或者运营商自动给开通了小秘书服务，一旦电话打不通，就会先播放一个类似这样的提示音，你拨打的电话已经开启了来电小秘书，请在滴声后留言。还有一个问题就是去电号码给标注成广告营销，手机的语音助手功能给自动应答，播放一个类似这样提示音，你好我是机主的小秘书，请问你找机主有什么事。总体可以分成2类。

2024-07-02 11:26:35 1384

原创顶顶通电话黑名单系统介绍

3 拦截条件可根据Ip，主叫，被叫设置拦截规则。5 可以和质检系统集成，质检风险通话自动加入黑名单。2 支持外部黑名单，并自动加入本地黑名单。4 拦截规则，支持高频拦截，靓号拦截。1 可批量导入黑名单，白名单。

2024-04-29 16:55:47 705

原创手机靓号正则表达式

0)){4}\d (倒序）88|99结尾 : 被叫号码中最后两位的数字是88或者99。AAA(3A) : 被叫号码中出现同一个数字连续出现三次的。AAAA(4A) : 被叫号码中出现同一个数字连续出现四次的。AAAAA(5A) : 被叫号码中出现同一个数字连续出现五次的。AAAAAA(6A) : 被叫号码中出现同一个数字连续出现六次的。如果不过滤重复数字可以直接用 (\d{2})\1。如果不过滤重复数字可以直接用 (\d{3})\1。如果不过滤重复数字可以直接用 (\d{4})\1。

2024-04-09 12:58:49 1625

原创顶顶通呼叫中心中间件如果实现座席签入、签出、小休功能

动态线路支持：线路名字设置为前缀set:集合名，就会通过redis的set中获取线路集合，方便动态修改线路组成员，线路成员集合修改后，需要执行配置改变通知，cti模块才会重新加载线路组成员。只需要把坐席线路动态加入排队关联的坐席线路组就可以实现签入签出排队的功能。小休就是座席暂停接电话，只需要把坐席线路的并发设置成0，就可以实现小休功能。签入签出一般是指签入到某个排队。

2024-03-21 14:26:28 647

原创顶顶通呼叫中心中间件（基于FreeSWITCH）对接mrcp asr 和 tts配置

顶顶通呼叫中心中间件通过asrproxy程序对接各种asr和tts,本文主要讲解 asrproxy程序对接 mrcp v1 和 mrcp v2的配置。

2024-03-05 11:06:42 1950

原创新一代电话机器人开源PHP源代码

使用easyswoole 框架开发的新一代电话机器人开源PHP源码。包含 AI外呼管理，话术管理，CRM管理，坐席管理等功能。包含线路管理，代理商管理等功能。

2024-03-02 22:10:34 3092

原创 ccadmin - 可免费试用的 FreeSWITCH web管理后台

顶顶通呼叫中心中间件Web后台管理系统简称CCAdmin-Web，用于管理和配置顶顶通呼叫中心中间件。因为顶顶通呼叫中心中间件是基于FreeSWITCH开发的，所以CCAdmin本质上也是一个FreeSWITCH管理后台，CCAdmin有windows版本,macos版本，和Web版本。本文主要介绍CCAdmin-Web版本。

2024-03-01 18:57:45 1746

原创 freeswitch sofia user(分机)掉线检测相关的配置

整理不易转载请注明来源于顶顶通博客。

2024-01-06 10:54:22 1776

原创 FreeSWITCH 拨打带分机号的电话之实现原理(即真人接听检测))

大部分手机也支持直接拨号 “虚拟号,分机号”，免去了手动输入分机号的麻烦,android的实现原理也是接通后延时1秒发送按键(DTMF)实现的。真人接通前可能出现的声音是彩铃，回铃音，呼叫失败的各种提示音，只要不符合以上特征就可以认为是真人接听了。为了解决隐私号不够用的问题，平台给一个虚拟号分配了4位的分机号，1个虚拟号就可以对应9999个真实的手机号了。2、平台转接真实的被叫后，真实的被叫拒接、无法接通、关机等情况，比如提示音”你拨打的电话正忙请稍后再拨”呼叫有分机号的虚拟号(隐私号)

2023-12-24 14:34:11 4284

原创预测式外呼如何解决播放开场白和转接人工无缝连接

顶顶通呼叫中心中间件，有一个播放背景音的功能，可以手机接通后，把开场白当背景音播放，然后进入排队，排队不用配置等待音乐，直接把开场白当等待音乐，坐席接通后，开场白如果还没播放完成，坐席和手机，都可以听到这个开场白，坐席可以通过按键终止播放开场白，直接和人工对话，这样就可以开场白和坐席说话无缝连接了。顶顶通呼叫中心中间件，可以让坐席预先录音，通话过程人工说话和播放录音可以随时切换，播放录音过程，手机和坐席都可以听到对方的声音和播放的录音的声音，可以快速无缝切换。

2023-12-22 23:58:53 1130

原创 FreeSWITCH回铃音补偿

回铃音就是拨打电话时，电话接通之前听到的嘟嘟的声音，如果拨打了开通了彩铃的手机，听到的是音乐声，彩铃也是一种回铃音，5G时代，又有了视频彩铃这样更新的回铃音方式了。

2023-12-21 00:00:44 3357 1

原创顶顶通电话实时质介绍

顶顶通电话实时质检系统包含了顶顶通语音识别系统，使用的是开源语音识别模型，如果对语音识别要求不是特别高，就不需要购买第三方语音识别了。如果对语音识别准确率要求比较高，也可以购买第三方语音识别，比如阿里云，科大讯飞等厂家的在线语音识别。以2000并发，接通率10%，200并发接通为例，建议配置是 2台服务器，CPU40核心起双路2个CPU(比如志强金牌6133)，内存16-24G，硬盘500G。可以购买二手服务器比较便宜。外呼系统 -> vos -> 质检系统 -> vos -> 落地。

2023-11-29 19:07:26 1235 1

原创 funasr适配windows之大坑静态库中的静态实例不初始化

昨天晚上funasr团队的大佬反馈windows下 funasr-wss-server 加载lm模型失败，今天一大早，我就开始研究为啥加载失败，先linux测试一下了一下，发现也是加载lm模型失败，我回退到适配 windows之前的版本测试，是正常加载的，唯一的修改就是把openfst由动态库改成了静态库，我改回编译动态库，加载正常。通过跟踪代码发现静态库的时候vector没有FstRegister，为啥没注册呢，又在哪里注册的呢，通过跟踪动态库的调用堆栈，发现是初始化的时候注册的。

2023-11-15 19:27:34 762

原创 FreeSWITCH 卡通道（通道死锁）完美解决

根据之前的分析，多个线程操作一个通道就有出现死锁的概率，因为fs的switch_core_session_read_frame和switch_core_session_write_frame的实现存在死锁的可能。就是把 switch_core_session_read_frame和switch_core_session_write_frame里面同步消息改成异步消息switch_core_session_queue_message。每天晚上呼叫结束，通过 status 命令，都可以看到几个无法释放的通道。

2023-11-12 17:03:31 1976

原创通过顶顶通呼叫中心中间件玩转FreeSWITCH媒体流

cti_unicast 通过media_bug挂了2个回调SMBF_READ_STREAM和SMBF_WRITE_REPLACE，其中 SMBF_READ_STREAM，用来把媒体流推送到远端UDP端口，SMBF_READ_STREAM用来把远端发送来的声音混音到fs的放音。很多人需要直接获取原始的声音流，然后自己处理，其实FreeSWITCH也是支持的，只是知道的极少，FreeSWITCH原生支持 unicast 通过udp 把声音流推送到一个UDP端口，和播放网络的声音流。用户说话停止自动停止推流。

2023-11-12 16:06:22 2660

开源语音识别 funasr windows版本二进制包

空空如也