Bitrix24 插件
Bitrix24 插件将您的代理连接到 Bitrix24，作为内部员工即时消息通道。 员工以与同事聊天的方式给代理发送消息，代理在 Bitrix24 的聊天中回复。
[!WARNING] Bitrix24这里是一个 内部员工即时消息频道 — 像 Telegram 或 Slack 为员工。这是 不 客户全渠道：没有开放线路，没有 工单队列且没有操作员升级。不要使用此插件来前置 客户服务热线
该插件在宿主本地运行，并通过…与网关通信 aihummer.connector.v1 合同。终端用户渠道行为位于渠道页面 Bitrix24；本页涵盖插件本身。
下述媒体和共享 OAuth 行为需要已签名的 Core 1.4.15，以及在目录中单独发布、签名并更新的 1.1.1 连接器。已安装的 1.1.0 连接器不能证明这些功能已经可用。
事实
| 字段 | 价值 |
|---|---|
| 版本 | 1.1.1 |
| 港口 | 8810 |
| 运行时 | 主机本地 |
它是什么
Bitrix24 聊天与 AiHummer 之间的双向桥梁。代理显示为 类人身份 在 Bitrix24 中——每个代理使用自己的 OAuth 身份进行认证，而不是通用的机器人帐户——因此对话感觉就像在与同事交流。访问遵循组织的 部门树 ACL因此，代理的权限范围遵循您的 Bitrix24 结构。
在 BITRIX24_AGENT_USER_IDS 中配置专用门户用户，在 BITRIX24_PORTAL 中配置门户。部门路由限制员工访问；代理账号不会取代任务发起人。现有的可选自动配置使用 BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD。
在上述版本中，BITRIX24_VAULT_CONNECTIONS 选择已有、有效、处于自主模式且属于凭证所有者的 OAuth 凭证。通过受支持的原生凭证库和连接管理来管理它，并在工具绑定中复用同一凭证 ID。实际凭证所有者使用专用 connection-token 密钥，通过 /v1/admin/connections/channel 为相应工作区中正在运行的连接器注册。在秘密设置 BITRIX24_VAULT_CONNECTIONS 内按代理用户 ID 配置 endpoint 和 apiKey；不要放入代理资料或提示词。只有凭证库刷新令牌；工具仍检查操作用户和共享权限。参见 OAuth2。
它是如何使用的
- 入站：轮询器读取消息。媒体按实际字节下载，并通过
/v1/inbound/media注册；代理收到media_id，而不只是 URL 或文件元数据。 - 出站：
Deliver将 Markdown 转换为 BB-code，并通过im.v2.File.upload上传实际字节。确认媒体送达需要真实的FILE_ID和消息 ID；文本回复或链接不是文件送达凭据。
更新时保留持久的送达日志。已确认操作的重复请求返回原有凭据。部分完成或未知的效果不会自动重新发送；重试前先检查。
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24支持的功能
- 表情回应和 @-提及。
- 账号和提供商支持
im.dialog.writing与REPLY_ID时的输入指示和回复。 - 入站图片、音频、语音和文件，须满足上述版本要求。
- 编辑/删除消息仅适用于具有独立机器人身份的旧集成；普通 OAuth 用户不会声明这些能力。
限制
[!WARNING] 不支持交互式键盘、按钮和讨论线程。
文件已生成或已准备，不代表已确认送达。部分完成、失败和未知结果必须保持可见。
安装
在管理界面的市场中一键安装 Bitrix24。本地主机部署器会下载插件，运行其安装步骤，渲染沙箱化的 systemd 单元，并在标记为就绪之前等待健康检查——参见 安装与更新然后，您将连接每个代理的 OAuth 身份并映射部门树访问控制列表 (ACL)。
安全与限制
- 仅限内部员工即时消息 — 不是客户全渠道。
- 每个代理的人类化 OAuth 身份 ——代理不是通用机器人账户。
- 部门树 ACL — 尊重你的组织结构。
- 主机本地 — 在 systemd 下运行，而不是在容器中。