AiHummer
中文▾
登录帐户
v1.1.x▾
v1.4.xstablev1.3.xstablev1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
频道/Bitrix24

Bitrix24

v1.1.x · 已更新 2026-10-14

Bitrix24 是一个内部员工即时通讯渠道 —— 就像 Telegram 或 Slack 对员工所扮演的角色一样。AiHummer 代理会出现在你公司的 Bitrix24 中，作为同事，员工可以向其发送消息和提及。

该频道作为一个运输渠道 来自产品内的连接器 市场 并且以宿主本地方式运行。它可以像任何其他通道一样从管理员界面进行配置。

[!NOTE] Bitrix24 频道需要一个活跃的 启动器, 商业 或者 企业 许可证。在社区计划中，安装连接器会返回 HTTP 402 “需要升级” (代码 plan_limit) — 参见 许可.

[!WARNING] Bitrix24 在这里严格是一个 内部员工即时消息频道. 它是 不 客户全渠道 不 Bitrix24 开放线路 不 一个票队列，以及 不 一个操作员升级界面。不要用它来路由外部 客户对话。

下述媒体和共享 OAuth 行为需要已签名的 Core 1.4.15，以及在目录中单独发布、签名并更新的 1.1.1 连接器。已安装的 1.1.0 连接器不能证明这些功能已经可用。

类人代理身份

在 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。

端口和运行时

端口 用途
8810 回环连接器服务：健康检查和 Deliver

消息如何流动

  • 入站：轮询器读取消息。媒体按实际字节下载，并通过 /v1/inbound/media 注册；代理收到 media_id，而不只是 URL 或文件元数据。
  • 出站：Deliver 将 Markdown 转换为 BB-code，并通过 im.v2.File.upload 上传实际字节。确认媒体送达需要真实的 FILE_ID 和消息 ID；文本回复或链接不是文件送达凭据。

更新时保留持久的送达日志。已确认操作的重复请求返回原有凭据。部分完成或未知的效果不会自动重新发送；重试前先检查。

支持什么

  • 表情回应和 @-提及。
  • 账号和提供商支持 im.dialog.writing 与 REPLY_ID 时的输入指示和回复。
  • 入站图片、音频、语音和文件，须满足上述版本要求。
  • 编辑/删除消息仅适用于具有独立机器人身份的旧集成；普通 OAuth 用户不会声明这些能力。

[!WARNING] 不支持交互式键盘、按钮和讨论线程。

文件已生成或已准备，不代表已确认送达。部分完成、失败和未知结果必须保持可见。

接下来去哪儿