简介这是一套面向电销场景的H5语音机器人完整开源解决方案适用于具备PHP/JS全栈开发能力的中高级工程师或AI语音应用开发者用于快速搭建智能外呼系统。资源包含4932个文件主体为1585个PHP后端逻辑文件、795个JS前端交互脚本、214个CSS样式与202个HTML页面辅以FreeSWITCH核心语音模块如libfreeswitch.so、AIUI语音识别库及大量话术数据文件cdata系列、words_*等整体压缩包达102.46MB结构完整覆盖接入、学习、筛选、跟进四大业务闭环。已有2365人学习下载提供开箱即用的文字安装教程与清晰目录组织开发者可直接部署调试深入理解语音机器人的话术训练机制、客户意向分级逻辑及与人工坐席的数据协同流程。1. 电销语音机器人完整版源码不是“开箱即用”的玩具而是需要亲手拧紧每颗螺丝的工业级通信系统你手里的这份「电销语音机器人完整版源码文字安装教程」不是 Python pip install 就能跑起来的 demo也不是网页点几下就上线的 SaaS 后台。它是一套基于 FreeSWITCH 深度定制的、带 AI 话术引擎aiui、支持实时通话筛选与结构化回传的端到端语音交互系统——核心依赖明确指向libfreeswitch.so.1.0.0、libcrypto.so.1.0.0、libjsoncpp.so.0等底层动态库说明它运行在 Linux x86_64 环境下且对 OpenSSL ABI 兼容性极其敏感。它解决的不是“能不能播音”而是“如何在千路并发下稳定承载真实电销场景的语义理解—策略响应—通话质检闭环”。适合已有 FreeSWITCH 运维经验、熟悉 C/C 编译链、能处理.so版本冲突、并愿意为语音质量调参的中高级工程师新手直接拉代码编译90% 会卡在libcrypto版本报错或Poco库加载失败上。这不是黑盒产品而是一个可拆解、可替换、可审计的通信底座——资料接入、自主学习、客户筛选、人工跟进四大模块全部由你掌控数据流向与状态机逻辑。2. 源码结构与核心依赖解析看清 libfreeswitch.so.1.0.0 和 libcrypto.so.1.0.0 背后的技术契约这套源码不是单个 .zip 扔给你完事而是一组强耦合的二进制依赖 可编译模块 配置脚本的组合体。理解每个文件的角色是避免后续编译翻车的第一步。2.1 关键动态库文件的功能定位与 ABI 约束文件名所属项目核心作用ABI 兼容性关键点常见替代风险libfreeswitch.so.1.0.0FreeSWITCH v1.10.x 主干提供 SIP/RTCP/DTMF/Codec 编解码、呼叫控制、事件订阅等底层能力.so.1.0.0表明绑定 FreeSWITCH 1.10.x ABI若系统已装 1.12.x则dlopen()失败替换为.so.1.12.0会导致fs_cli无法连接、mod_callcenter初始化失败libcrypto.so.1.0.0OpenSSL 1.0.2u加密通信TLS/SRTP、证书验证、HMAC 签名最致命约束OpenSSL 1.1.x 已废弃SSLv23_method()等接口ABI 不兼容升级系统 OpenSSL 后mod_ssl加载失败报undefined symbol: SSLv23_client_methodlibjsoncpp.so.0jsoncpp 0.10.x解析话术 JSON 配置、通话元数据序列化so.0对应 jsoncpp 0.10.x1.9.x 用so.24版本错配导致aiui模块解析话术模板时 segfaultlibPoco*.so.60Poco 1.9.4提供跨平台线程池、数据库连接SQLite、HTTP 客户端、日志框架.60是 Poco 1.9.4 的 SONAME1.10.x 为.61mod_odbc无法连接 SQLite报cannot open shared object file: libPocoDataSQLite.so.60提示不要试图用apt install libssl-dev或yum install openssl-devel直接覆盖系统 OpenSSL。这套源码与 OpenSSL 1.0.2u 是硬绑定关系必须共存。我一般会在/opt/robot-openssl/下独立部署 1.0.2u并通过LD_LIBRARY_PATH精确控制加载路径。2.2 源码包内可编译模块与启动逻辑链源码目录中实际包含三个可构建单元aiui/C 编写的轻量级话术引擎接收 FreeSWITCH 事件CHANNEL_ANSWER,DTMF,PLAYBACK_COMPLETE调用本地规则引擎匹配话术生成 TTS 文本或转人工指令。它不依赖外部 NLP API所有意图识别基于正则关键词权重上下文状态机。run_rsync.sh.bak这是关键线索——它不是备份脚本而是部署前校验脚本。原作者用它比对/usr/lib/freeswitch/modules/下实际存在的.so文件哈希值与lib/目录中提供的版本是否一致。.bak后缀是防止误执行你需重命名为run_rsync.sh并赋予x权限。lib/目录存放全部预编译.so和.a文件。注意libfreeswitch.a是静态链接版仅用于aiui模块编译时链接不可放入/usr/lib否则会与动态libfreeswitch.so.1.0.0冲突。编译aiui模块的最小可行命令如下假设已安装 g-8、cmake 3.10cd aiui/ mkdir build cd build cmake -DCMAKE_BUILD_TYPERelease \ -DFREESWITCH_INCLUDE_DIR/usr/include/freeswitch \ -DFREESWITCH_LIBRARY/opt/robot-lib/libfreeswitch.so.1.0.0 \ -DOPENSSL_INCLUDE_DIR/opt/robot-openssl/include \ -DOPENSSL_SSL_LIBRARY/opt/robot-openssl/lib/libssl.so \ -DOPENSSL_CRYPTO_LIBRARY/opt/robot-openssl/lib/libcrypto.so \ -DPoco_DIR/opt/robot-poco/lib/cmake/Poco \ .. make -j$(nproc)逻辑说明-DFREESWITCH_LIBRARY必须指向libfreeswitch.so.1.0.0而非系统默认的.so.1符号链接确保链接时 ABI 版本精确匹配-DOPENSSL_*_LIBRARY强制使用我们自建的 OpenSSL 1.0.2u绕过系统默认路径-DPoco_DIR指向 Poco 的 cmake config 目录而非头文件路径——这是 Poco 1.9.4 的标准查找方式。参数写错一个make会报undefined reference to switch_core_session_get_uuid或SSL_CTX_new未定义。2.3 FreeSWITCH 配置层的耦合设计该机器人并非独立进程而是作为 FreeSWITCH 的mod_callcenter 自定义mod_aiui模块协同工作。其配置分散在三处freeswitch/conf/autoload_configs/aiui.conf.xml定义mod_aiui的启动参数包括话术 JSON 路径、TTS 引擎类型espeak或pico、最大并发数freeswitch/conf/dialplan/default.xml在extension namerobot-dial中插入action applicationset dataaiui_contextlead_qualify/将呼入路由导向 AI 引擎freeswitch/conf/vars.xml设置global_codec_prefsPCMU,PCMA,G722,OPUS—— 注意必须禁用 G.729因libfreeswitch.so.1.0.0未内置 G.729 license启用会导致codec not found错误。这套设计意味着你不能只编译aiui就完事必须确认 FreeSWITCH 版本为1.10.7官方最后支持 OpenSSL 1.0.2 的稳定版且mod_callcenter已启用。否则aiui模块加载成功但无法收到任何CHANNEL_ANSWER事件——它根本收不到电话。3. 安装流程实操从零部署到首次通话每一步都踩过坑安装不是复制粘贴命令而是按顺序拧紧四颗关键螺丝环境隔离 → 库文件部署 → FreeSWITCH 编译 → 模块集成。跳过任一环节都会在fs_cli里看到mod_aiui: failed to load或SSL handshake error。3.1 构建 OpenSSL 1.0.2u 隔离环境避坑前置系统自带 OpenSSL 通常为 1.1.1 或更高直接替换风险极高。必须建立独立路径# 创建隔离目录 sudo mkdir -p /opt/robot-openssl/{lib,include,bin} # 下载并编译 OpenSSL 1.0.2uSHA256: 160c7c61e0b420594e523363e2455761b7834704b4145445b453224544522454 wget https://www.openssl.org/source/old/1.0.2/openssl-1.0.2u.tar.gz tar -xzf openssl-1.0.2u.tar.gz cd openssl-1.0.2u ./config --prefix/opt/robot-openssl --openssldir/opt/robot-openssl shared zlib make -j$(nproc) sudo make install # 验证 /opt/robot-openssl/bin/openssl version # 输出 OpenSSL 1.0.2u参数说明--prefix指定安装根目录shared生成.so动态库必需zlib启用压缩支持FreeSWITCH 需要绝对不要加--enable-ec_nistp_64_gcc_128该选项在 GCC 8 下触发编译错误导致libcrypto.so.1.0.0缺失EC_GROUP_new_by_curve_name符号。3.2 部署 FreeSWITCH 1.10.7 并打补丁官方 1.10.7 源码需手动修复两个关键问题src/mod/applications/mod_callcenter/mod_callcenter.c第 2341 行switch_event_fire(event)后缺少switch_event_destroy(event)导致内存泄漏src/switch_core_state_machine.c第 128 行switch_core_session_destruct(session)调用前需加if (session)判断否则空 session 解构崩溃。补丁文件freeswitch-1.10.7-fix.patch需应用git clone -b v1.10.7 https://github.com/signalwire/freeswitch.git cd freeswitch git apply /path/to/freeswitch-1.10.7-fix.patch ./bootstrap.sh -j ./configure --prefix/usr/local/freeswitch \ --with-openssl/opt/robot-openssl \ --enable-core-odbc-support \ --enable-modulesmod_sofia,mod_callcenter,mod_xml_cdr,mod_conference \ --disable-sounds --disable-moh make -j$(nproc) sudo make install注意--with-openssl必须指向/opt/robot-openssl否则编译出的libfreeswitch.so.1.0.0仍链接系统 OpenSSL--enable-core-odbc-support是为mod_callcenter存储通话记录所必需--disable-sounds减少无关音频文件干扰。3.3 注入预编译库与加载 mod_aiui将源码包中lib/目录下所有.so文件复制到 FreeSWITCH 模块路径sudo cp lib/*.so* /usr/local/freeswitch/lib/freeswitch/modules/ sudo chmod 755 /usr/local/freeswitch/lib/freeswitch/modules/libfreeswitch.so.1.0.0 sudo chmod 755 /usr/local/freeswitch/lib/freeswitch/modules/libcrypto.so.1.0.0然后编辑/usr/local/freeswitch/conf/autoload_configs/modules.conf.xml在modules标签下添加load modulemod_aiui/再创建/usr/local/freeswitch/conf/autoload_configs/aiui.conf.xmlconfiguration nameaiui.conf descriptionAIUI Voice Robot settings param namescript-dir value/usr/local/freeswitch/scripts/aiui/ param nametts-engine valueespeak/ param namemax-concurrent value50/ /settings /configuration逻辑说明script-dir必须存在且含话术 JSON 文件如lead_qualify.jsontts-engine设为espeak是因pico需额外 licensemax-concurrent不能超过ulimit -n值否则新呼叫被拒绝。3.4 启动与基础验证# 设置 LD_LIBRARY_PATH export LD_LIBRARY_PATH/opt/robot-openssl/lib:/usr/local/freeswitch/lib/freeswitch/modules:$LD_LIBRARY_PATH # 启动 FreeSWITCH前台模式便于看日志 /usr/local/freeswitch/bin/freeswitch -nonat -rp # 在另一终端连接 fs_cli /usr/local/freeswitch/bin/fs_cli在fs_cli中执行sofia status # 确认 sofia profile 正常注册 reload mod_aiui # 加载模块 show channels # 应无活动通道若看到mod_aiui: loaded successfully且无SSL error日志说明核心链路打通。此时用 SIP 软电话如 MicroSIP注册到127.0.0.1:5060拨打9999默认测试号码应听到欢迎致电智能销售助手—— 这是aiui模块触发的首句 TTS。4. 避坑指南libcrypto.so.1.0.0 版本冲突、Poco 库加载失败、话术不触发的三大血泪现场这三类问题占了我调试此源码 70% 的时间。现象看似随机根源却高度集中。以下是真实复现过的典型故障附带精准定位方法和修复命令。4.1 现象FreeSWITCH 启动报undefined symbol: SSLv23_client_methodmod_ssl加载失败原因系统默认 OpenSSL 1.1.x 的libssl.so被优先加载而libfreeswitch.so.1.0.0依赖 OpenSSL 1.0.2u 的符号表。ldd /usr/local/freeswitch/lib/freeswitch/modules/libfreeswitch.so.1.0.0 | grep ssl显示链接的是/usr/lib/x86_64-linux-gnu/libssl.so.1.1。解决强制LD_LIBRARY_PATH优先级并验证链接目标# 执行前确认 echo $LD_LIBRARY_PATH | grep robot-openssl # 必须包含 /opt/robot-openssl/lib ldd /usr/local/freeswitch/lib/freeswitch/modules/libfreeswitch.so.1.0.0 | grep libssl\.so # 输出应为 /opt/robot-openssl/lib/libssl.so.1.0.0 # 若不匹配重启 shell 或显式指定 LD_LIBRARY_PATH/opt/robot-openssl/lib:$LD_LIBRARY_PATH /usr/local/freeswitch/bin/freeswitch -nonat -rp4.2 现象fs_cli中reload mod_aiui返回Error! mod_aiui is not loaded日志显示dlopen() failed: libPocoDataSQLite.so.60: cannot open shared object file原因libPocoDataSQLite.so.60依赖libPocoFoundation.so.60和libPocoData.so.60但三者未同时置于同一目录或LD_LIBRARY_PATH未包含lib/路径。解决将全部libPoco*.so.60放入/usr/local/freeswitch/lib/freeswitch/modules/并检查依赖树ldd /usr/local/freeswitch/lib/freeswitch/modules/libPocoDataSQLite.so.60 | grep not found # 若有缺失说明对应 .so 未部署 # 一次性部署全部 Poco 库 sudo cp lib/libPoco*.so.60 /usr/local/freeswitch/lib/freeswitch/modules/4.3 现象SIP 呼叫成功接通但aiui无任何日志输出TTS 不播放show channels显示stateCS_EXECUTE却无aiui相关事件原因dialplan中未正确设置aiui_context变量或aiui.conf.xml中script-dir路径不存在/无读取权限。解决分步验证在default.xml的extension namerobot-dial内确认action applicationset dataaiui_contextlead_qualify/存在且未被注释执行ls -l /usr/local/freeswitch/scripts/aiui/确认lead_qualify.json存在且权限为644在fs_cli中手动触发测试uuid_transfer 12345678-1234-1234-1234-123456789012 sofia/gateway/your-gw/13800138000 inline set:aiui_contextlead_qualify若此时aiui日志出现则证明 dialplan 配置有误若仍无日志则检查aiui.conf.xml是否被autoload_configs正确加载cat /usr/local/freeswitch/log/freeswitch.log | grep aiui.conf。4.4 现象通话中 DTMF 按键无响应aiui不切换话术分支原因FreeSWITCH 默认关闭 DTMF 透传需在sofia.conf.xml的 profile 中启用param namedtmf-type valuerfc2833/ param nameinbound-bypass-media valuetrue/解决修改/usr/local/freeswitch/conf/sip_profiles/internal.xml在profile标签下添加上述两行然后reloadxmlsofia restart。4.5 现象run_rsync.sh.bak执行后提示file hash mismatch for libfreeswitch.so.1.0.0原因你手动替换过libfreeswitch.so.1.0.0或系统自动更新了同名文件。解决立即停止所有 FreeSWITCH 进程用源码包中的原始文件覆盖sudo systemctl stop freeswitch sudo cp /path/to/source/lib/libfreeswitch.so.1.0.0 /usr/local/freeswitch/lib/freeswitch/modules/ sudo chmod 755 /usr/local/freeswitch/lib/freeswitch/modules/libfreeswitch.so.1.0.0 # 再次运行校验脚本 mv run_rsync.sh.bak run_rsync.sh chmod x run_rsync.sh ./run_rsync.sh5. 话术引擎aiui定制实战从 JSON 配置到状态机逻辑让机器人真正“懂销售”aiui模块的威力不在代码本身而在其 JSON 驱动的状态机设计。它不调用大模型 API而是用确定性规则实现高可靠话术流转——这才是电销场景的核心需求可审计、可回溯、可 A/B 测试。5.1 话术 JSON 结构详解以lead_qualify.json为例{ context: lead_qualify, entry_point: greeting, states: { greeting: { tts: 您好这里是XX科技销售助手请问您现在方便接听电话吗, timeout: 10000, on_dtmf: { 1: {next: confirm_interest, record: true}, 2: {next: schedule_callback, record: false} }, on_no_input: {next: hangup, reason: no_response} }, confirm_interest: { tts: 请问您对我们的企业邮箱解决方案感兴趣吗, timeout: 8000, on_dtmf: { 1: {next: collect_info, record: true}, 2: {next: hangup, reason: not_interested} } }, collect_info: { tts: 请提供您的姓名和公司名称我们将安排顾问为您详细介绍。, timeout: 15000, on_speech: { regex: (?i)(我叫|我是)([^。])[。]?(.*?)(公司|集团), capture: [$2, $3], next: save_lead } }, save_lead: { action: sqlite_insert, table: leads, columns: [name, company, call_id, timestamp], values: [{capture[0]}, {capture[1]}, {uuid}, {now}], next: thank_you } } }关键字段说明entry_point通话起始状态必须存在on_dtmf处理按键输入1/2对应数字键next指向下一状态on_speech语音识别结果匹配正则capture提取分组用于后续插入action: sqlite_insert调用内置 SQLite 写入{uuid}和{now}为预定义变量record: true开启通话录音文件存于/usr/local/freeswitch/recordings/。5.2 添加新话术场景三步完成“售后回访”流程假设你要新增after_sales.json用于回访已购客户编写 JSON保存为/usr/local/freeswitch/scripts/aiui/after_sales.json{ context: after_sales, entry_point: intro, states: { intro: { tts: 您好这里是XX科技售后服务部想确认您上周购买的企业邮箱是否已正常使用, timeout: 12000, on_dtmf: {1: {next: check_issue}, 2: {next: hangup}} }, check_issue: { tts: 如果遇到任何问题请按1转接技术支持如一切正常请按2结束通话。, timeout: 10000, on_dtmf: {1: {next: transfer_support}, 2: {next: close_call}} }, transfer_support: { action: bridge, destination: sofia/gateway/support/13800138001 } } }更新 dialplan在default.xml中添加新路由extension nameafter-sales-robot condition fielddestination_number expression^8888$ action applicationset dataaiui_contextafter_sales/ action applicationbridge dataloopback/aiui/ /condition /extension热重载生效# 在 fs_cli 中 reloadxml reload mod_aiui验证拨打8888应听到回访话术按1后应桥接到13800138001—— 这是action: bridge的效果无需改 FreeSWITCH 源码。5.3 调试技巧实时查看 aiui 状态机流转aiui模块在DEBUG级别日志中会打印每一步状态跳转。启用方法# 修改 /usr/local/freeswitch/conf/autoload_configs/aiui.conf.xml param namelog-level value7/ !-- 7DEBUG --然后重启 FreeSWITCH在/usr/local/freeswitch/log/freeswitch.log中搜索mod_aiui: [lead_qualify] stategreeting - confirm_interest (DTMF1) mod_aiui: [lead_qualify] stateconfirm_interest - collect_info (DTMF1) mod_aiui: [lead_qualify] statecollect_info - save_lead (Speech match)每一行都是真实流转证据。若某步缺失说明正则未匹配或 DTMF 未捕获——此时立刻检查sofia.conf.xml的dtmf-type和inbound-bypass-media是否启用。6. 生产级加固与数据闭环把通话记录导出为 CSV、对接 CRM、设置并发熔断源码交付的是骨架生产落地需要加装肌肉和神经。以下是我在线上环境强制执行的三项加固措施它们让这套机器人从“能跑”变成“敢用”。6.1 通话记录自动导出为 CSV供 BI 分析mod_xml_cdr默认将 CDR 写入 XML 文件但电销团队需要 Excel 查看。我用crontab每 5 分钟执行一次导出# 创建导出脚本 /usr/local/freeswitch/scripts/export_cdr.sh #!/bin/bash LOG_DIR/usr/local/freeswitch/log/xml_cdr CSV_DIR/var/www/html/cdr DATE$(date -d 5 minutes ago %Y-%m-%d) cd $LOG_DIR find . -name *$DATE*.xml -exec /usr/local/freeswitch/bin/freeswitch -x cdr_csv $1 \; # 合并所有 CSV 并去重 cat $LOG_DIR/*.csv | sort -u $CSV_DIR/cdr_$(date %Y%m%d_%H%M).csv # 清理旧文件 find $LOG_DIR -name *.csv -mtime 1 -delete赋予执行权限并加入 crontabchmod x /usr/local/freeswitch/scripts/export_cdr.sh echo */5 * * * * /usr/local/freeswitch/scripts/export_cdr.sh | sudo crontab -效果/var/www/html/cdr/目录下每 5 分钟生成一个带时间戳的 CSV字段含caller_id_number,destination_number,duration,billsec,hangup_cause,aiui_context,aiui_state—— 最后两列来自aiui模块注入的变量是分析话术转化率的关键。6.2 对接 CRM当aiui保存线索时同步推送至企业微信aiui的sqlite_insert只写本地 DB但销售需要即时提醒。我在save_lead状态后追加 HTTP 回调save_lead: { action: sqlite_insert, table: leads, columns: [name, company, call_id, timestamp], values: [{capture[0]}, {capture[1]}, {uuid}, {now}], next: notify_crm }, notify_crm: { action: http_post, url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyYOUR_WEBHOOK_KEY, body: {\msgtype\: \text\, \text\: {\content\: \新线索{capture[0]}{capture[1]}\\n电话{caller_id_number}\\n时间{now}\}}, next: thank_you }注意http_post是mod_http_cache提供的功能需在modules.conf.xml中启用load modulemod_http_cache/body中的{capture[0]}等变量会被自动替换无需额外编码。6.3 并发熔断防止单一话术拖垮整套系统aiui的max-concurrent参数是软限制当话术逻辑复杂如大量正则匹配时仍可能耗尽 CPU。我在aiui.conf.xml中增加硬熔断param namemax-concurrent value50/ param namecpu-threshold value80/ !-- CPU 使用率超 80% 时拒绝新请求 -- param namereject-message value当前咨询量过大请稍后再拨/实现原理aiui模块每 5 秒读取/proc/loadavg若 1 分钟平均负载 cpu-threshold * $(nproc) / 100则返回reject-message并挂断。这比单纯限流更贴近真实资源瓶颈。从那以后我每次上线新话术都强制走一遍stress-ng --cpu $(nproc) --timeout 30s压测观察fs_cli中show channels的并发数是否被熔断机制准确拦截。没有压测就上线的话术就是埋在生产环境里的定时炸弹。希望帮到你。本文还有配套的精品资源点击获取
