> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Yeastar

Yeastar P-Series PBX（云端版、软件版或设备版）会保留运营商和号码，并将选择的通话发送至 Reception.ai。入站路由、IVR 和分机决定哪些通话由接待员接听。请选择以下选项之一。

| 选项                                      | 工作量 | 通话如何到达 Reception.ai                                                                               |
| --------------------------------------- | --- | ------------------------------------------------------------------------------------------------- |
| [转接至接待员](#forward-to-your-receptionist) | 低   | 通过运营商中继，转至接待员的电话号码                                                                                |
| [连接 SIP 中继](#connect-a-sip-trunk)       | 高   | 通过 [SIP 中继](/docs/zh/reception-ai/phone-numbers/bring-your-own-number#sip-trunk) 连接至 Reception.ai |

## 转接至接待员

接待员通过自己的 Reception.ai 号码接听，Yeastar 则通过现有出站路由将其作为外部号码拨打。

### 获取接待员号码

前往 **Receptionists**，选择 **Phone** 磁贴并获取号码。请参阅[电话号码](/docs/zh/reception-ai/phone-numbers/overview)。

### 选择哪些通话转至接待员

在 Yeastar Web 门户中，选择以下一种方式：

* **拨打某个号码的所有通话：** 前往 **Call Control** → **Inbound Route**，编辑 DID 对应的路由，并将目标设为使用接待员号码的 **External Number**。使用时段条件目标，仅在营业时间外转接通话。
* **IVR 选项：** 前往 **Call Features** → **IVR**，打开 **Key Press Event** 标签页，将某个按键设为 **External Number**。
* **某个分机的通话：** 前往 **Extension and Trunk** → **Extension**，编辑该分机并打开 **Presence** 标签页。在 **External Calls** 下，将 **Always**、**No Answer** 或 **When Busy** 转接至接待员号码。

如果出站路由会移除前缀，也请在 **Prefix** 字段中输入该前缀。

### 关闭 Call Confirmation

对于将通话发送给接待员的所有转接规则，请保持 **Call Confirmation** 关闭。它会要求接听者确认通话，而接待员无法按键。

### 传递来电者号码

在运营商中继上，前往 **SIP Headers**，并将 **From User Part** 设为 **Originator Caller ID**（如果运营商接受此设置）。否则，接待员会在每次通话中看到 Yeastar 号码。

转接通话会占用运营商中继的 2 个通道，运营商可能会对出站这一段收费。将通话转接至外部号码的分机需要获得使用出站路由的权限，否则转接会失败。

## 连接 SIP 中继

Yeastar 通过对等中继将通话直接发送到 Reception.ai，因此第二段通话不会经过运营商。此操作需要熟悉 Yeastar 中继、路由和防火墙的人员完成。

### 在 Reception.ai 中添加 SIP 中继

前往 **Integrations**，选择 **Add integration**，然后选择 **SIP Trunk**。在 **Inbound allowed addresses** 下，添加 PBX 的公网 IP 地址。对于云端版，请使用 Yeastar 在下方创建的对等中继中显示的 **Static IP Address**。入站用户名和密码请留空：对等中继无需身份验证。

### 添加号码

前往 **Receptionists**，选择 **Phone** 磁贴，输入来电者拨打的号码及其国家/地区代码，然后选择 **Add SIP Trunk number**。Reception.ai 会显示用于发送通话的 SIP 服务器主机地址。

### 启用 TCP

Reception.ai 不接受 UDP。前往 **PBX Settings** → **SIP Settings** → **General** → **Basic**，确保已启用 **SIP TCP Port**。更改后，使用 TCP 的分机必须重新注册。

### 创建对等中继

前往 **Extension and Trunk** → **Trunk**，然后选择 **Add**。将 **Select ITSP Template** 设为 **General**，然后：

| 字段                                       | 值                                                  |
| ---------------------------------------- | -------------------------------------------------- |
| **Trunk Type**                           | **Peer Trunk**。云端版请选择 **Peer Trunk (Port Based)**。 |
| **Transport**                            | **TCP**                                            |
| **Hostname/IP**                          | Reception.ai SIP 服务器主机地址                           |
| **Port**                                 | `5060`                                             |
| **Domain**                               | 相同的主机地址                                            |
| **From User Part**（位于 **SIP Headers** 下） | **Originator Caller ID**，以便接待员看到每位来电者自己的号码         |

选择 **Save** 和 **Apply**。

### 添加发送 +E.164 格式号码的出站路由

前往 **Call Control** → **Outbound Route**，然后选择 **Add**。添加一个拨号模式，将 **Pattern** 设为 `999.`、**Strip** 设为 `3`、**Prepend** 设为 `+`，并且只选择 Reception.ai 中继。这样，拨打 `99914155550123` 时，中继会以 `+14155550123` 发出，这是 Reception.ai 要求的格式。请将此路由移到其他路由上方，确保优先匹配。

### 将通话发送至 Reception.ai

使用[转接至接待员](#forward-to-your-receptionist)中的任一目标，将 **External Number** 设为 `999` 加上不含 `+` 的 E.164 格式号码，例如 `99914155550123`。如果有 **Prefix** 字段，请在其中输入 `999`，其余号码填入号码字段。

### 检查防火墙

对于软件版和设备版，请在防火墙中开放 PBX 的 RTP 端口范围（UDP），使来自 Reception.ai 的音频能够到达。

### 测试

用另一部手机拨打 DID，确认接待员会接听，然后打开 **Inbox**，确认对话中显示的是手机号码。请参阅[测试](/docs/zh/reception-ai/receptionist/testing)。

## 限制

* **转接。** 接待员会通过向 SIP 中继集成的 **Outbound SIP address** 发起新通话来转接通话。请将其指向接受用户名和密码的 SIP 运营商账户。此处不涵盖将转接路由回 Yeastar：对等中继按源地址匹配通话，而 Reception.ai 的呼叫来自不断变化的地址池。
* **云端版限制。** Yeastar P-Series 云端版最多支持 5 个基于端口的对等中继。
* **每次通话占用 2 个通道**，一个来自运营商，另一个通往 Reception.ai，因此请检查并发通话限制。

## 故障排除

| 问题                    | 检查内容                                                                                                                              |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| 接待员接听后，通话随即中断         | 转接规则中已启用 **Call Confirmation**。请将其关闭。                                                                                             |
| 通过 SIP 中继的通话在响铃前失败    | 检查中继传输协议是否为 **TCP**、端口是否为 `5060`，以及是否已启用 **SIP TCP Port**。                                                                        |
| 通过 SIP 中继的通话被拒绝       | 将 PBX 的公网 IP 或云端版的 **Static IP Address** 添加到 **Inbound allowed addresses**，并检查出站路由是否在完整号码前添加 `+`。                                 |
| 通话改由运营商发出             | 确保外部号码以 `999` 开头，并且 Reception.ai 路由位于其他出站路由上方。                                                                                    |
| 接待员将 Yeastar 号码视为来电号码 | 在承载该通话的中继上，将 **From User Part** 设为 **Originator Caller ID**。                                                                      |
| 单向音频或无音频              | 在防火墙中开放 RTP 端口范围。                                                                                                                 |
| 接待员接听前，来电者被要求按键       | [垃圾来电防护](/docs/zh/reception-ai/receptionist/call-handling#verify-caller-identity)会要求号码未验证的来电者按键。转接通话可能以未验证状态到达。如果这会影响真实来电者，请将其关闭。 |