官方插件/Bitrix24 插件
Bitrix24 插件
v1.0.x · 已更新 2026-07-05
Bitrix24 插件将您的代理连接到 Bitrix24，作为内部员工即时消息通道。 员工以与同事聊天的方式给代理发送消息，代理在 Bitrix24 的聊天中回复。
[!WARNING]
Bitrix24这里是一个 内部员工即时消息频道 — 像 Telegram 或 Slack
为员工。这是 不 客户全渠道：没有开放线路，没有
工单队列且没有操作员升级。不要使用此插件来前置
客户服务热线
该插件在宿主本地运行，并通过…与网关通信 aihummer.connector.v1 合同。终端用户渠道行为位于渠道页面 Bitrix24；本页涵盖插件本身。
事实
| 字段 |
价值 |
| 版本 |
1.0.0 |
| 港口 |
8810 |
| 运行时 |
主机本地 |
它是什么
Bitrix24 聊天与 AiHummer 之间的双向桥梁。代理显示为 类人身份 在 Bitrix24 中——每个代理使用自己的 OAuth 身份进行认证，而不是通用的机器人帐户——因此对话感觉就像在与同事交流。访问遵循组织的 部门树 ACL因此，代理的权限范围遵循您的 Bitrix24 结构。
除了 OAuth 身份之外，还支持其他配置路径：通过门户管理员登录自动创建代理账户（BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) 并通过固定 ID 绑定到预先创建的 Bitrix24 用户 (BITRIX24_AGENT_USER_IDS).
它是如何使用的
- 入境： 拉取型轮询器获取新消息并将其转发到
网关的通用入站端点，路由器在此解析目标代理。
- 出站： 回复通过连接器的幂等性发送 交付
步骤，将代理的 Markdown 转换为 Bitrix24 BB代码 和
保证消息不会被发送两次。
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24
支持的功能
该插件支持丰富、类人聊天行为：
限制
[!WARNING]
类人模型故意这样做 不 包含一些 Bitrix24 机器人
特征：
- 无互动键盘/按钮 和 没有线程。
- 入站媒体和语音不会被转发 — 入站是 仅文本。 A
同事风格身份接收并回应文本；附件和语音
发送给代理的笔记不会被传递到一次对话中。
安装
在管理界面的市场中一键安装 Bitrix24。本地主机部署器会下载插件，运行其安装步骤，渲染沙箱化的 systemd 单元，并在标记为就绪之前等待健康检查——参见 安装与更新然后，您将连接每个代理的 OAuth 身份并映射部门树访问控制列表 (ACL)。
安全与限制
- 仅限内部员工即时消息 — 不是客户全渠道。
- 每个代理的人类化 OAuth 身份 ——代理不是通用机器人账户。
- 部门树 ACL — 尊重你的组织结构。
- 幂等传递 — Markdown 会被渲染为 BB 码，并且不会发送两次。
- 仅文本输入；不支持键盘/线程。
- 主机本地 — 在 systemd 下运行，而不是在容器中。
接下来去哪儿
<p class="doc-plugin-logo"><img class="th-on-dark" src="/pl/bitrix24-dark.svg" alt="" width="60" height="60" /><img class="th-on-light" src="/pl/bitrix24-light.svg" alt="" width="60" height="60" /></p>
**Bitrix24 插件将您的代理连接到 Bitrix24，作为内部员工即时消息通道。** 员工以与同事聊天的方式给代理发送消息，代理在 Bitrix24 的聊天中回复。
> [!WARNING]
> Bitrix24这里是一个 **内部员工即时消息频道** — 像 Telegram 或 Slack
> 为员工。这是 **不** 客户全渠道：没有开放线路，没有
> 工单队列且没有操作员升级。不要使用此插件来前置
> 客户服务热线
该插件在宿主本地运行，并通过...与网关通信 `aihummer.connector.v1` 合同。终端用户渠道行为位于渠道页面 [Bitrix24](/zh/v1.0/channels/bitrix24)；本页涵盖插件本身。
## 事实
| 字段 | 价值 |
|---|---|
| 版本 | 1.0.0 |
| 港口 | 8810 |
| 运行时 | 主机本地 |
## 它是什么
Bitrix24 聊天与 AiHummer 之间的双向桥梁。代理显示为 **类人身份** 在 Bitrix24 中——每个代理使用自己的 OAuth 身份进行认证，而不是通用的机器人帐户——因此对话感觉就像在与同事交流。访问遵循组织的 **部门树 ACL**因此，代理的权限范围遵循您的 Bitrix24 结构。
除了 OAuth 身份之外，还支持其他配置路径：通过门户管理员登录自动创建代理账户（`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) 并通过固定 ID 绑定到预先创建的 Bitrix24 用户 (`BITRIX24_AGENT_USER_IDS`).
## 它是如何使用的
- **入境：** 拉取型轮询器获取新消息并将其转发到
网关的通用入站端点，路由器在此解析目标代理。
- **出站：** 回复通过连接器的幂等性发送 **交付**
步骤，将代理的 Markdown 转换为 Bitrix24 **BB代码** 和
保证消息不会被发送两次。
```text
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24
```
## 支持的功能
该插件支持丰富、类人聊天行为：
- 反应
- 消息编辑和删除
- 输入指示器
- @-提到
- 媒体
## 限制
> [!WARNING]
> 类人模型故意这样做 **不** 包含一些 Bitrix24 机器人
> 特征：
>
> - **无互动键盘/按钮** 和 **没有线程。**
> - **入站媒体和语音不会被转发** — 入站是 **仅文本。** A
> 同事风格身份接收并回应文本；附件和语音
> 发送给代理的笔记不会被传递到一次对话中。
## 安装
在管理界面的市场中一键安装 Bitrix24。本地主机部署器会下载插件，运行其安装步骤，渲染沙箱化的 systemd 单元，并在标记为就绪之前等待健康检查——参见 [安装与更新](/zh/v1.0/marketplace/install-updates)然后，您将连接每个代理的 OAuth 身份并映射部门树访问控制列表 (ACL)。
## 安全与限制
- **仅限内部员工即时消息** — 不是客户全渠道。
- **每个代理的人类化 OAuth 身份** ——代理不是通用机器人账户。
- **部门树 ACL** — 尊重你的组织结构。
- **幂等传递** — Markdown 会被渲染为 BB 码，并且不会发送两次。
- **仅文本输入；不支持键盘/线程。**
- **主机本地** — 在 systemd 下运行，而不是在容器中。
## 接下来去哪儿
- 频道： [Bitrix24](/zh/v1.0/channels/bitrix24)
- [安装与更新](/zh/v1.0/marketplace/install-updates)
- [市场概览与等级](/zh/v1.0/marketplace/overview-tiers)
