电话通信:自有 PBX
门店里的电话通常与其余一切彼此独立:号码在电信运营商处,听筒放在前台,谁来过电话——只有接起的人记得。“电话通信”板块把这变成实用工具:门店拥有自有 PBX——一台电话交换机,接听打到你号码的电话,按你的规则分给员工,录制通话并交给后续分析。
打开:管理后台 → 电话通信(admin.cenaly.com/telephony)。该板块通过扩展商店中的**“电话通信”**卡片启用——默认处于隐藏状态。
什么是自有 PBX#
**PBX 完全归属于你的门店。**这是云端的一台独立机器,有自己的静态 IP 地址和自己的连接地址:他人的语音不经过它,电信运营商的账户是你的,我们不发放也不转售号码资源。完全不会向新门店提供所有人共用的服务器。
| 项目 | 如何运作 |
|---|---|
| 订购服务器 | “服务器”标签页中的按钮。该服务收费,按日从账户余额中扣除——每日价格显示在区块顶部和每种服务器规格旁,创建前的确认会对此作出提示。按日扣费以折叠块形式直接显示在服务器卡片中(最近 7 日),并在“订阅”中以覆盖所有门店的日志呈现 |
| 算力 | 一档档预设,以同时通话数标注;变更算力无需停机,可以等到没有活跃通话时再进行 |
| 负载 | 服务器卡片中直接显示最近 1 小时 / 24 小时 / 7 天的处理器和网络图表 |
| 设置 | 自动保存,板块中没有“保存”按钮;每个区块都有“小时钟”——带回滚功能的设置历史 |
| 物理位置 | 云端按门店所在国家选择;俄罗斯门店仅在 Yandex Cloud(cenaly.ru)中服务 |
板块顶部是**“直到第一通电话”**清单,包含三个独立问题。设置——四个步骤(创建门店的 SIP 账户 → 接入呼入线路 → 配置呼入电话路径 → 至少分配一个内部分机号),计数“4 个中完成 3 个”只针对这些步骤,未完成的步骤是指向所需标签页的链接。测试电话——来自通话记录的标记:最后一通已接听的呼入电话;回声测试 *43 检查声音,但不检查电信运营商的线路,因此仅作为提示显示在旁边。通话录音——由你选择(关闭 / 开启并向来电者提示),它不计入“全部就绪”:不必为了一个绿色对勾而录音。当设置就绪且电话已接通,清单会折叠成一行绿色文字。
从哪里开始#
顺序如下,这也是电话路径的顺序——从外到内:
| № | 步骤 | 位置 | 详情 |
|---|---|---|---|
| 1 | 配置号码:电信运营商的 SIP 中继或带 SIM 卡的网关 | 电信运营商 → 线路 | 运营商号码、GSM 网关 |
| 2 | 给员工分配内部分机号 | 坐席 | 见下文 |
| 3 | 接入电话和软电话 | 分机号窗口中的凭据 | SIP 电话设置 |
| 4 | 配置呼入路由 | 路由、群组来电 | 见下文 |
| 5 | 如果员工需要对外拨打,启用呼出 | 呼出 | 见下文 |
| 6 | 启用通话录音 | 录音 | 见下文 |
步骤 1. 号码:电信运营商或网关#
呼入号码由你带来——凭你与电信运营商的合同。有三个来源,它们可以叠加:
| 来源 | 如何接入 | 重要事项 |
|---|---|---|
| 电信运营商的 SIP 中继 | “电信运营商”标签页:名称、SIP 主机、端口、传输方式、模式(REGISTER——PBX 在电信运营商处注册,或 IP-auth——电信运营商把电话发到我们的 IP)、登录名和密码。“检查连接”按钮会进行实时探测 | 号码作为线路在“线路”标签页中配置,线路有“接听电话”的工作开关。详解——接入运营商号码 |
| 带 SIM 卡、市话线或 ISDN 的网关 | 网关作为分机号注册到我们的 PBX,来电时它自行拨打内部分机号 | 网关会传带来电者号码——它显示在话机、通话记录和“电话”录音中。此类来电没有线路,路由规则不适用于它。详解——GSM 网关和市话线 |
| 内置网页通话线路 | 无需接入任何东西:访客从浏览器说话 | 一条线路,不需要单独号码——网站来电 |
中继和号码数量不受限制——这是你的机器和你在电信运营商处的账户;PBX 设置列表的总上限为 500 条记录。
第 2 步. 为员工分配分机#
“员工与群组”标签页——内部分机。分机有两种:我们的分机(在我们 PBX 上的账户,电话或软电话连接到该账户;号码由您设置——2–6 位数字,门店自己的编号方式,分机数量没有上限)和继承自电信运营商的号码——其背后是员工已有的号码:其他 PBX 的分机、手机或座机。此类分机不发放密码,电话通过所选通道接通到人。
| 功能 | 作用 |
|---|---|
| 绑定到员工 | 在“员工”列中点击姓名(或“无员工”)并选择人员——人员列表点击后展开,而不是挂在每一行中。号码显示在员工卡片中,离职时会自动在所有门店收回分机 |
| “分发给员工…” | 按职位筛选批量发放号码;已有号码的人会被跳过 |
| 凭据 | 密码只显示一次:带复制功能的字段、“复制全部设置”为文本以及用于 Zoiper 和 Linphone 的 QR 码。忘记了——点击“重置密码” |
| 号码完全复制 | 运营商处的号码以这样的方式接入:员工的电话注册到我们这里,同时电话也能打到他在运营商处的旧话机 |
| 通道是否在线 | 继承号码在“通道与 SIP”列中,通道名称旁有一个连接圆点:绿色——用于联系该员工的线路已在运营商处注册;灰色——未注册或 PBX 尚未报告;方形“停止”——线路已被您关闭。将鼠标悬停在圆点上:提示中会显示这是哪条线路、其状态以及观测时间。我们的分机没有单独的圆点——其连接状态由同一行左侧的圆点显示 |
| 硬件与日志 | 行中可以看到员工使用什么连接(“Yealink T31G”、“Zoiper”),灰色表示设备已关闭。名称旁有**“信号条”图标**:这是 PBX 到该设备的 ping(绿色——连接良好,琥珀色——明显延迟 150 ms 起,红色——300 ms 起,✕——设备不再响应检查)。数字“180 ms”仅在明显延迟时出现在图标旁,完整数字在悬停提示和卡片中。在卡片本身中,ping 位于状态行(“在线 · 地址 · 网络 · 最后连接”)——那里数字始终可见,且在卡片的任何部分都能看到,而小时、天和按小时的柱状图在“运行状况”标签页的“与 PBX 的连接”区块中。已关闭的设备没有图标:PBX 不检查它。点击打开设备卡片:24 小时/7/30 天的运行状况、连接历史、电话、连接检查以及设置——服务器、端口、传输、登录名和该电话的内部分机(即输入到设备本身的内容,可复制)以及 PBX 应用于它的精细 SIP 设置。那里没有密码:密码在发放时只显示一次。所有时间——在标签提示、卡片和分机日志中——均按门店的时区(卡片中在状态行下方标注);如果门店未设置时区——则按您设备的时钟,这也已标注 |
第 3 步. 电话与软电话#
同样的五个值(服务器、登录名、密码、端口 5060、传输 UDP)可输入到任何设备:桌面电话、服务员的 DECT 听筒、门禁对讲机、旧模拟电话的转接器,或电脑和智能手机上的软件电话。一个分机可以同时注册在多台设备上。
完整说明——SIP 电话设置:从哪里获取凭据、门店网络需要什么(出站 UDP 5060 和 10000–20000,路由器上关闭 SIP ALG)、何时需要将电话恢复出厂设置,以及 26 个设备系列的逐步说明。那里还有 回声测试 *43:拨打后听到自己的声音,通话记录中会出现该设备的丢包、抖动和延迟。
个人账户由每个人自行创建:设置 → “个人 SIP 账户”(admin.cenaly.com/settings?tab=sip-accounts)——这是个人在其他系统(电信运营商处、办公室 PBX)上的注册,或使用自己的分机。它们绑定到其登录名而非公司,仅对他可见,并且只会出现在其设备上 Cenaly 电话应用中——Android 版 Cenaly Admin(“电话”标签页)、Cenaly CRM(“更多” → “电话”)和 Cenaly SIP Phone。它们不会进入门店的 PBX、桌面电话和网页管理后台(参见设置)。
第 4 步. 来电路由#
“来电路径”标签页——即“来电时打给谁”的规则。规则自上而下依次检查,第一个匹配的规则生效;顺序即优先级,可用箭头调整。
| 规则维度 | 可选值 |
|---|---|
| 打到了哪里 | “线路(号码)”和“电信运营商(中继)”分组的芯片,可多选目标——任一命中即可 |
| 何时 | 星期几和门店时区的时间窗口 |
| 谁在打 | 来电者号码前缀 |
| 谁来接 | 所有拥有分机的人 · 按姓名芯片选择的员工 · 群组来电 · 按名称指定的 AI 助手(电话顾问、电话秘书、任意语音机器人) · 外部号码 |
| 如果无人接听 | 未接听提示语、自动应答、AI 助手、其他群组 |
轮询棋盘——一张网格,行是参与者,列是 5 秒:“前 10 秒打给迎宾,从第 10 秒起经理加入,从第 20 秒起迎宾停止”。用鼠标拖拽即可给单元格上色。最后一行是 AI:它不打电话,而是接听,因此从最后一个人打完的位置开始。
规则列表下方是默认应答:当没有任何规则匹配时会发生什么(问候语、自动应答、机器人)。同一处还有**“通话处理中”通知**开关,可选择语言并自定义文本——在部分国家该提示是强制性的,因此默认开启。
如果删除规则所指向的电信运营商,面板会先询问,并逐条说明每条规则会怎样:“将在没有该电信运营商的情况下继续工作”(条件中还有其他号码或电信运营商)、“将被关闭”(没有该电信运营商,条件会变得更宽)或“将被关闭并失去条件”。规则不会被删除——棋盘和备用方案都保留原处。没有任何剩余条件的规则会标记为**“无条件”**,其开关无法打开:否则它会拦截任何来电。请为它设置新条件(号码、电信运营商、时段或来电者前缀)再启用,或者删除该规则。
群组来电(“员工和群组”中的行,带“群组”标记)——一个内部号码(从 700 开始分配),有自己的分配方式:棋盘、简单的“同时呼叫所有人 / 依次呼叫”或带等待音乐、位置播报和时间上限的队列。参与者有“响铃”开关、个人工作时间、暂停(员工可在话机上自行设置:*71——暂时离开,*72——已返回)和自己的保持音乐;“优先打给已与客户交谈过的员工”开关会先试拨熟悉的员工几秒钟。进入群组有三扇门:用电话拨打其号码、路由规则,以及由 AI 电话秘书转接通话。在 Cenaly Phone 应用的此类来电界面上可以看到棋盘:当前打给谁、谁将在几秒后加入、谁占线。加载期间,该位置显示“拨号中…”。如果对方直接拨打您的分机,则没有棋盘:只打给您。当同事接起时,来电窗口还会显示几秒钟是谁接的。如何称呼接听者——按姓名、按姓名加分机、仅按分机,或简单显示“同事已接听”——由管理员选择:窗口“所有员工的规则”、“自己的电话”、“谁接听了来电——同事看到什么”。旁边是会议室(“会议”标签页):分机 600–649,带 PIN 和视频,从任何已注册设备拨打该号码即可加入共同通话。
第 5 步. 呼出电话#
呼出默认关闭,开启时需通过关于费用的文本确认:对外拨打使用的是您的运营商中继,发票由您的电信运营商开具。“呼出”标签页决定员工用自己电话拨出的电话从哪条线路出去——按解析顺序分三级:
- 智能规则“所拨号码模板 → 线路”:数字加
X(任意)、N(2–9)、Z(1–9)、尾部句点“任意多位数字”。规则可缩小到特定员工,在发送给电信运营商前截断或补加数字,并替换主叫号码; - 员工个人线路——“每人一条”;
- 默认共用线路。
反欺诈始终生效:每个门店和每位员工的并发呼出上限、拨号长度范围、无条件禁止付费和卫星方向(无法通过设置解除)以及每日通话分钟上限(默认无上限)。达到上限的 80%、上限用尽以及出现可疑夜间流量时,PBX 会向工作聊天发送带推送的警报——被盗账户会因夜间消耗的分钟数而被发现,而不是等到月底电信运营商的发票。
第 6 步. 通话录音和“电话”#
**“录音”**标签页:开启、选择范围(所有电话 / 仅来电 / 仅坐席)并决定是否删除超过 N 天的录音。默认录音无限期保存——期限由您设定,没有上限。
录下的通话不仅会进入电话系统的播放器,还会进入**“电话”**板块(admin.cenaly.com/calls)——录音处理中心:上传和接收文件、带筛选和已保存视图的表格、语音识别、AI 通话分析、标签、指标、规则和自动化、搜索及关联到订单。录音库和“电话”板块的保存期限分别配置。关于“电话”的详细文章正在准备中。
AI 电话秘书、通话教练和顾问#
电话系统是三个 AI 界面所依托的基础设施。它们各自有独立的设置页面,而 PBX 只负责决定“由谁接听电话”。关于电话秘书和通话教练的详细文章正在准备中。
| 界面 | 功能 | 位置 |
|---|---|---|
| AI 电话秘书 | 机器人以机构名义接听来电:人设和语气、时间表、问卷(预订、消息、申请)、转接给员工的规则、允许的操作、防垃圾来电和文本模拟器。从知识库中获取回答,在强制要求的国家,AI 接听声明无法关闭 | admin.cenaly.com/secretary |
| 坐席通话教练 | 通话过程中,员工的屏幕上会在实时转录文本上方自动出现来自知识库的回答卡片;通话中不调用语言模型——使用预先构建好的数据包 | admin.cenaly.com/call-assist |
| 电话顾问 | AI 助手作为分机列表中的普通一行:可以给它分配内线号码,放入“无人接听时”规则或接线板最后一行 | admin.cenaly.com/telephony?tab=extensions |
网站来电#
两个免费小部件运行在同一个 PBX 上,并按照相同的来电规则接入:网站来电——电话图标按钮,访客直接从浏览器通话,无需拨号,也无需安装应用;回拨——访客留下号码,PBX 自动拨打并接通机构,支持未接通时的重试和夜间队列次日早晨回拨。只需为自有电话系统付费——小部件本身免费。
“电话”板块的选项卡#
选项卡归入其上方的四个入口:今天(概览)、工作(控制台、通话记录、语音信箱、会议)、设置(线路、电信运营商、来电路径、员工和群组、去电、录音)和诊断(服务器)。这只是分组:选项卡的地址和侧边栏中的固定方式保持不变。**“全部功能”按钮一次显示所有选项卡,“查找功能”**字段也能用旧词(“中继”、“分机”、“坐席面板”、“IVR”)找到设置。板块按角色打开对应入口:所有者——“今天”,坐席——“工作”,配置人员——“设置”;自己的选择也可以在那里固定。选项卡上方是状态栏:更改是否已保存、PBX 是否已应用、哪些设置正等待其更新。
| 选项卡 | 内容 |
|---|---|
| 概览 | “首次通话前”检查清单、“来电将如何走”区块(根据已保存设置的预测,带“修改”和“检查号码”按钮,以及最近一次真实通话)、门店 SIP 账户摘要、“检查连接”按钮、故障邮件开关、PBX 连接历史 |
| 控制台 | 谁正在和谁通话:进行中的电话、分机、线路;“控制台 / 看板”切换——呼叫中心数字放大显示(等待应答——包括在队列中和群组电话振铃期间;空闲;今日服务水平),按状态排列的坐席,以及所有进行中的电话列表——谁在来电、正在和谁通话或正在打给谁、已等待多久、已持续多久;“全屏 (TV)”——用于墙上的电视 |
| 通话记录 | 所有 PBX 电话的历史,含状态和路由轨迹——见下文 |
| 语音信箱 | 来电者按信箱留下的消息:试听、指定负责人、标记为已处理、回拨;负责人可直接从消息进入“问候语和信箱设置”,并跳转到通话记录中的电话和“回拨”事项 |
| 线路 | 来电号码、“接听电话”勾选框、默认等待音乐(“试听并选择”按钮可试听整个目录,不做任何更改)以及内置网页电话线路 |
| 电信运营商 | 各运营商线路一行显示(状态、注册、检查),就地编辑凭据,“号码完全复制”子区块,“连接号码或线路”按钮(向导会先询问:号码在运营商处、另一台 PBX,还是通过网关的线路)以及运营商、外部 PBX 和网关的连接目录 |
| 来电路径 | 自上而下的来电规则、带号码检查的来电路径示意图,以及“如果没有任何规则匹配”的默认应答——与“电话”板块“电话顾问”卡片中相同的编辑器 |
| 去电 | “号码 → 线路”规则、个人线路和公共线路、总开关和限额 |
| 员工和群组 | 人员、群组和 AI 助手的统一列表(“人 / 群组 / AI”标记、“内部分机号”);员工卡片以“主要”选项卡打开——他如何接听电话,以及“连接电话”或“检查”按钮;下方以折叠行显示——电话硬件、桌面电话、电话簿、驻留和内部通话、语音信箱、门店之间的连接 |
| 会议 | 600–649 号房间:名称、PIN、视频、参与人数上限 |
| 录音 | 开启、录音范围、保存期限 |
| 服务器 | PBX 主机和 PC 上的网桥、容量和负载、SIP 精细设置、线路诊断(SIP 交换记录) |
“SIP 精细设置”会自我说明。 该协议有三十来个兼容性参数,而“连不上”的电话通常恰好卡在其中一个上。因此此窗口中每项设置都有一个**“设置详情”折叠项,分三部分:“何时需要”——究竟是否需要动它(“电话在路由器后面时保持开启”、“仅在运营商要求时”);“会有什么变化”——开启和关闭时会发生什么,包括代价(“通话录音和通话教练提示会消失:PBX 不再听到这个声音”);“如何检查”**——具体操作及其预期结果(“用话机拨打 *43——回声测试应返回您的声音”、“点击‘呼叫话机’——它应振铃”、“打开‘PBX 连接历史’”)。空字段是默认值,就写在旁边;可能完全中断连接的设置(直接音频交换、协议集、来电识别、加密)带有图标标记。如果电话能正常工作——这里无需改动任何内容。
通话记录:所有电话,而不只是已录音的#
“通话记录”选项卡(?tab=log)显示自己 PBX 的所有电话历史,包括没有录音的:已接、未接、占线、放弃、由机器人接听。行中显示——时间、谁来电、打到哪条线路、电话在谁那里响过(分机标签)、谁接起、文字状态和时长。
点击打开**“电话如何走”**弹窗:触发的路由规则、每次拨打及每个目标的结局(“5 秒后接起”、“响了 29 秒,未接”、“占线”、“已拒绝”)、兜底和最终提示语。转接给同事——是同一通电话的事件,而不是新记录:轨迹中出现“转接通话”步骤,通话被切成片段(“访客 ↔ 分机 101 安娜——0:16”、“访客 ↔ 分机 102 鲍里斯——0:20”)。音频和 AI 分析——在“电话”板块的“录音”选项卡中:电话卡片中的“打开录音”按钮直接跳转到那里。
通话记录中的时间——按门店时区,而不是按您查看所用设备的时钟。在电话卡片中,时区标注在日期行下方——“时间——按门店时区(Europe/Moscow · GMT+3)”——电话路由的所有时间也都按它显示:各步骤、“在……振铃”、通话片段。如果门店未设置时区,时间按您设备的时钟走,这一点也有说明。“复制给支持”文本会连同时间一起写入时区。
线路诊断(SIP 追踪)#
当“电话打不通”,而设置看起来都正确时,争论没有意义——需要看看我们的 PBX 和电信运营商到底交换了什么。为此,在 “服务器” 标签页中有一个 “线路诊断(SIP 追踪)” 区块。
SIP 是用于协商通话的服务性消息:REGISTER(电话或中继声明自己)、INVITE(有人来电)、响应码(200 OK、401、403、488……)以及内部的 SDP 块,其中标明了编解码器和音频地址。追踪就是这段交换的记录,即服务器所看到的内容。
如何抓取:
- 电话 → “服务器” → “线路诊断”区块。按钮 “录制 15 分钟” 会打开录制窗口(旁边显示“开放至……”;窗口上限为 2 小时)。
- 窗口打开期间,重复那通电话——追踪只显示窗口打开期间发生的事情。
- 按钮 “刷新” 会拉取最新的交换尾部;行会出现在按钮下方的深色窗口中。提示“PBX 尚未上传交换”意味着“请等一分钟”——机器按自己的周期上传尾部,这不是错误。
- “停止” 会提前关闭窗口;窗口本身无论如何都会关闭:交换中包含来电者号码,即个人数据,因此“开了就忘”在这里不可能——这是有意为之。
关于内容需要了解:授权头(Authorization、WWW-Authenticate)的值会从行中被删除——追踪中没有密码;显示的是交换的尾部,如果开头放不下,会在文本正上方说明。在独立 PBX 上,交换还会持续写入并在机器上保存一天,因此“一小时前通话没有声音”的投诉仍可事后分析——面板中目前没有区间选择,过去一小时的切片需要支持团队来提取。
如何解读典型情况:
| 交换中看到的内容 | 说明什么 |
|---|---|
REGISTER → 401/407,然后再次 REGISTER → 200 OK |
正常的两步注册(digest 验证),本应如此 |
REGISTER → 403 Forbidden(或 404) |
电信运营商拒绝了:登录名、密码或域名不对,而按 IP 授权时——来电不是来自该地址 |
完全没有响应,408 Request Timeout |
数据包没有到达:端口或传输不对,网络或电信运营商侧的过滤,IP 认证时——没有登记我们的地址 |
INVITE → 488 Not Acceptable Here(或 606) |
编解码器不匹配:我们的 PBX 支持 G.711 A-law、µ-law 和 G.722,不支持 G.729、Opus 和 AMR |
INVITE → 200 OK,但没有声音或只听到一方 |
信令通过了,问题在音频流(RTP):路由器上的 SIP ALG、UDP 10000–20000 被关闭或 NAT——在 SDP 块(c=、m=audio)中可以看到各方声明的地址 |
INVITE → 480/486/603 |
用户不可达、占线或拒绝了来电——这是对端的响应,不是故障 |
INVITE → 503 Service Unavailable |
电信运营商拒绝了:通道用尽、余额不足或方向被其关闭 |
应答后立即 BYE |
会话被某一方中断——通常是中间节点的会话计时器或 keep-alive |
INVITE 与第一个响应之间的停顿 |
可以看到 PBX 在哪一步等待电信运营商——正是那个“外呼前的静默” |
交给支持团队什么。 面板中没有文件导出:在追踪窗口中选中文本并附在邮件中(或截图),注明通话时间和号码——这足以进行分析。如果更方便,在设置中开启 “支持访问”,员工会自行查看交换;如何联系支持——这里。
⚠️ 诊断仅在独立 PBX 上可用:Asterisk 中的日志命令是全局的,在共享服务器上它会写入其他租户的交换。在共享层级上开启会被拒绝。
API 和 MCP:CRM、自有程序与 AI 助手#
自有 PBX 不仅可以在面板中管理。在“电话”板块顶部的 “API 和 MCP” 按钮(账户所有者可见,需 PBX 已连接)会签发用于外部程序的密钥:CRM、自有报表脚本或 Claude、Cursor 等 AI 助手。
如何签发密钥。 “创建密钥” → 名称(“CRM”、“Claude”)→ 权限集:“CRM”(通话记录、录音、一键拨号、分机)、“AI 助手”(同上,另加呼叫转移、“免打扰”和谁当前空闲)、“只读”或“全部”——也可自定义勾选。三项权限只能单独勾选,不属于任何权限集,连“全部”也不包含:“修改通话规则”、“导出配置”和“从表格导入配置”。接下来是门店(全部或指定)和有效期(永久、30、90 或 365 天)。形如 cpx_… 的密钥只显示一次:请立即复制,我们只保存指纹。权限可随时更改,“撤销”会使密钥从下一个请求起失效。
API 能做什么。 带筛选的通话记录(未接、按分机、按号码、按时间段)和含路由的通话详情卡;录音链接和来自“通话”的带结论转录文本;从指定分机发起的一键拨号(先呼叫该分机,再拨号码);分机和群组、个人呼叫转移和“免打扰”;谁空闲、谁在通话;号码及呼入/呼出规则及其变更历史。拥有“修改通话规则”权限的密钥可逐条创建、修改、删除和重排呼入与呼出规则(只更改传入的字段——不会影响相邻规则),启用和停用呼出,并将规则回滚到上一版本。向员工分配来电(排班表、队列、“所有人”)在面板中配置——API 规则以群组号码将电话接入该群组;呼出国家和防欺诈限额不能通过密钥更改。拥有配置权限时,可导出和导入与 Excel/CSV 文件相同的表格:先预览“将新增/更改/删除什么”,再应用。密码和登录名绝不通过 API 返回——新分机的密码仅在面板中可见。
如何连接 AI 助手。 同一密钥可用于 MCP 服务器 https://api.cenaly.com/pbx-api/mcp(streamable HTTP)。在“如何连接”选项卡中有 Claude Code、Claude Desktop 和 Cursor 的现成配置——粘贴密钥,助手即可回答“今天谁打来但没接通”、“用安娜的电话回拨这位客人”或“帮我把呼叫转移到手机”。助手只能看到密钥所允许的工具。
ChatGPT 和 claude.ai——无需密钥。 云端助手通过 OAuth 连接同一 MCP 服务器:将 https://api.cenaly.com/pbx-api/mcp 添加为连接器,登录 Cenaly 账户并勾选允许该应用做什么——窗口会显示哪个应用在请求访问。该连接会出现在密钥列表中并带有 OAuth 标记,也在那里撤销。详细说明、示例和限额见帮助 “自有 PBX 的 API 和 MCP”。
面向开发者。 REST——https://api.cenaly.com/pbx-api/v1,密钥放在请求头 Authorization: Bearer <ключ>;OpenAPI 3.1 描述和文档页面见窗口中的链接(/pbx-api/v1/openapi.json、/pbx-api/v1/docs)。每个密钥的限额:每分钟 120 次请求、每天 20 000 次,一键拨号每分钟 10 次、每天 300 次。通话事件(每通已录音电话及其转录文本和解析)通过 webhook 推送——来源为 “通话” 板块中的“Webhook”。通过密钥所做的每次更改都会在操作日志中显示密钥名称。
限制#
- 暂不支持通过网关呼出。 带 SIM 卡或市话线路的网关将电话接入 PBX;无法从面板通过它向外拨号——呼出规则只指向电信运营商的线路或中继。并且路由规则不适用于来自网关的电话:此类呼叫没有线路,因此在网关设置中直接指定群组或员工的号码。
- 电信运营商中继加密(TLS + SRTP)——需 2026 年 10 月起的 PBX 更新(如何启用);尚未在真实电信运营商上验证,不支持带客户端证书的双向 TLS。电话的加密通过专用机器的精细设置启用(证书由它自行签发)——这部分尚未在真实设备群上验证。
- 部分功能仅专用机器具备:外呼群组和队列、会议室、通话录音、双向回拨到重复号码、SIP 交互诊断。通过网桥在自有 PC 上搭建的 PBX 和共享服务器的剩余资源无法执行这些功能;呼出和路由规则同样由拥有中继的一方收集。
- 编解码器——G.711 A-law、µ-law 和 G.722;不支持 G.729、Opus 和 AMR。没有按 MAC 地址的电话自动配置(provisioning)——设备通过分机窗口中的字段或您自己的配置服务器进行设置。
- PBX 不可用的国家(需要当地许可证或受制裁):土耳其、白俄罗斯、中国、埃及、阿联酋、卡塔尔、阿曼、科威特、伊朗、朝鲜、古巴、叙利亚。在俄罗斯,专用 PBX 仅在 Yandex Cloud 中获准并运行——在
cenaly.ru上,共享服务器在那里已关闭。 - 合成器语音取决于云端:在
cenaly.ru上,通知语言列表中只有本地合成器支持的语言(六种)。队列位置用俄语和英语播报——其他语言下队列可运行,但不播报位置。 - 会议 v1:只能从内部进入房间(外部电话无法转入),视频显示当前发言人且需要 VP8 编解码器;没有参会名单、主持和会议录音。
- 我们不销售号码。 中继和号码由您自行向电信运营商购买——号码无法“迁入”平台内部,它仍属于电信运营商。
故障排查#
| 症状 | 检查项 |
|---|---|
| 电话无法注册 | 登录名是否完整输入(sip-…-<号码>,而不是号码本身)、密码是否被重置、服务器地址是否取自弹窗、传输协议是否为 UDP。完整列表见 SIP 电话设置 |
| 有电话但无声音,或只能听到一方 | 用该设备拨打 *43:有回铃音但听不到自己的声音——检查路由器上的 SIP ALG;完全静音——UDP 10000–20000 端口被关闭 |
| 来电无法接入 | “概览” → “检查连接”:它会依次检查服务器 → 线路 → 路由 → 分机,并指出第一个断开的环节。检查号码的“接听电话”勾选项以及中继的注册状态 |
| 去电被拒,提示“禁止” | 去电开关是否开启、每日分钟数上限是否已用尽、是否为 premium 方向 |
| 电话被拒且原因不明、中继“跳变”、接通前长时间静音 | 在“服务器”标签页打开线路诊断并重拨:从交互中可以看到哪一方在应答以及使用什么代码 |
| 电话停止接通,但无人察觉 | “概览”中的“电话停止接通时发送邮件”开关默认开启:如果故障持续 10 分钟,就会收到邮件 |
按症状的总体排查——故障排查;如果都没有帮助,请联系我们——如何获取帮助。
常见问题#
开始使用需要外部号码吗?#
不需要。没有号码时,PBX 已经可以接听来自网站和应用的电话,员工之间通过内部分机互拨。只有当访客需要从普通电话拨入时,才需要号码。
可以接听员工手机上的电话吗?#
可以,有两种方式。继承号码——分机号在我们这里,电话通过所选通道转接到其手机(该员工不会获得我们的账户)。完整号码复制——员工的电话注册到我们这里,然后他与其他成员一样参与群组、排班表和规则。
电话功能多少钱?#
PBX 本身是付费服务:专用服务器按日从账户余额中扣费(完整工作日按套餐价格,不完整按时间比例,以 UTC 计算日期),创建前的确认提示会对此进行提醒。扣费项目和对应日期可在服务器卡片(“按日扣费”)和“订阅”部分查看。通话费用按您的电信运营商的费率支付——我们不是这条链中的中间商。“网站来电”和“回拨”小部件免费。
相关章节#
- 连接运营商号码 — SIP 中继:注册或按 IP 授权
- GSM 网关、市话线路或 ISDN — 将 SIM 卡和模拟线路接入您的 PBX
- SIP 电话设置 — 分机凭据、网络、回声测试
*43、各品牌说明 - 硬件:可连接哪些设备 — 电话、DECT 基站和网关在门店硬件全景中的位置
- 网站来电 和 回拨 — 访客无需号码即可来电
- 员工与班次 — 向谁发放分机
- 设置 — “个人 SIP 账户”标签页及其他账户设置
- 需要关注 — 未接来电和电话故障在统一任务列表中的展示