Skip to main content

快速配置一个电话客服机器人

  1.  大模型Api-Key准备

       a. 如果您需要对接 DeepSeekV4,请准备好参数 apiKey ;
           注意,easycallcenter365使用的是阿里云百炼平台的大模型接口: https://bailian.console.aliyun.com/ ,
           选择顶部菜单:模型 -> 文本模型 -> 更多模型,选择 deepseek-v4 ,设置好体验对话框之,可以进行在线调试。
           在左下角,"密钥管理"菜单,可以找到API Key。        
            
        b. 如果您需要对接"扣子Coze智能体", 请准备好 coze-pat-token 和 coze-bot-id 两个参数。        
           coze-pat-token 参数请在 https://www.coze.cn/open/oauth/pats 后台创建;
           点击右上角的"添加",在添加对话框中,过期时间最长可设置为30天,
           勾选 "Bot管理" -> "chat",接着 "选择指定工作空间",最后点击确定保存,
           创建成功之后,就可以看到令牌的值,复制它, 注意关闭窗口后无法再次看到!        
           coze-bot-id 参数的值如何查看? 
           进入扣子主页,https://www.coze.cn/home ,最近编辑 菜单下面,可以看到最近创建的智能体,
           选择一个智能体并点击进入,在地址栏中就可以看到, 比如:
           https://www.coze.cn/space/7367249902209859647/bot/7447790819148414985
           这里的 coze-bot-id 就是 7447790819148414985 。        
           特别注意:智能体发布的时候,在发布页面的最下方,一定要勾选 API,否则无法调用智能体接口!
         
        c. 如果是对接 MaxKB ,则需要修改三个参数: maxkb-server-url 、maxkb-api-key 、maxkb-model 。
           在 MaxKB 后台,点击进入你事先创建好的应用,在 "应用信息" 中找到 "API 访问凭据", 下方的 "Base URL",
           复制 "Base URL",在它的值后面追加字符串 /chat/completions,最终完整的示例:
           http://222.124.14.142:8081/api/application/abbed614-2313-11f0-b414-0242ac110002/chat/completions
     
        d. 如果对接的是dify,需要准备好2个参数: apiKey 和 dify 的接口地址。

     

  2.  修改语音合成设置  

        登录可视化web管理后台: http://192.168.14.218:8899/ (这里假定服务器的IP地址是: 192.168.14.218,请修改为实际的IP地址)
        用户名: admin 密码: admin123  分机: 1001 
      
       这里以阿里云为例:
       后台菜单:  "基础配置" -> "语音合成设置" ->  "阿里云tts参数配置"
       修改三个参数字段: access_key_id、app_key、access_key_secret 。
        
       如何获取阿里云 access_key_id和access_key_secret:
       登录阿里云后台,鼠标悬停在页面的右上角,在弹出的个人信息中,选择 "权限与安全" -> "AccessKey",
       在弹出的窗口中,选择 "继续使用云账号 AccessKey",最后在页面上点击按钮 "创建AccessKey"。
       身份校验通过后,就会创建成功,请把 AccessKey ID 和 AccessKey Secret 下载到本机。
        
       如何获取阿里云语音 app_key的设置,参考文章: https://blog.csdn.net/HaaSTech/article/details/120217461
       参数修改后,自动生效,无需重启FreeSWITCH程序。   
           
       成功获取 access_key_id和access_key_secret以及app_key后,在后台保存设置即可。


  3.  修改语音识别设置
     这里以阿里云为例:
     后台菜单:  "基础配置" -> "语音识别设置" ->  "阿里ASR参数配置"
     修改三个参数字段: access_key_id、app_key、access_key_secret ,点击保存设置即可。


  4.  大模型配置
        后台菜单:  "基础配置" -> "大模型配置",点击添加。     
        这里以阿里云百炼平台为例:

        名称: 招生机器人 (举例)
        实现类:DeepSeekChat 
        apiKey: sk-3e88fb8159dxxxxxxxxeaf34246e94 (填写为自己的)
        服务地址:https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
        模型名称:deepseek-v4-flash 或者 qwen-flash-2025-07-28

  5.  呼入客服配置
        后台菜单:  "呼叫中心" -> "呼入配置",点击添加。    
         
        添加呼入配置号码
        大模型底座: 选择在第10步中设置的大模型
        音色:  选择语音播报的发音人
        被叫号码:6543210  (就是呼入号)
        服务方式:选择ai客服
        转人工业务组: 转人工坐席时的业务组
         
        系统支持配置多个呼入号码,不同的呼入号码可以支持使用不同的大模型底座。


  6.  呼入客服的测试
     
       在百度网盘的同目录下载 "软电话.zip" 安装包,
       使用软电话之前请先安装vc++运行环境 vcredist_x64_2015-2022.exe。
        
       打开软电话注册并测试:
       分机号及密码: 1001  123456
       注册地址: 192.168.14.218:5080   (请把 192.168.14.218 改为你自己的虚拟机地址)
       注册成功后,拨号: 6543210
       就可以进行智能客服的呼入电话测试了。 在菜单 "呼入记录查询"中,可以查询对话记录和听录音。
        
       一切正常的话,此时应该可以听到语音播报。
       如果无法听到语音播报请查看日志进行问题排查。也可以通过查看通话记录,查看挂机原因。
       一般需要查看 easycallcenter365 和 FreeSWITCH 日志。
       查看 easycallcenter365 日志:   /home/easycallcenter365/logs/easycallcenter365-ERROR.log 
       查看 FreeSWITCH 日志:           /home/freeswitch/var/log/freeswitch/freeswitch.log
         
       对于linux新手建议把 easycallcenter365.log 和 freeswitch.log 下载到本机方便查看。