用途:在Bitrix24本地部署环境中,从PHP服务端操作即时通讯功能,包括收发消息、系统消息、附件与键盘、创建聊天与成员、im事件、通知、聊天机器人和斜杠命令。
主要能力:rules/messages-chats.md 覆盖发送消息、系统消息、附件/键盘、创建聊天、成员与im事件;rules/notifications.md 覆盖通知类型、标签、删除、确认按钮与用户设置结构;rules/bots.md 覆盖模块内聊天机器人与斜杠命令、REST imbot.v2、开放线路;rules/pitfalls.md 覆盖 im 26.700–26.900 的破坏性变更与 REST 到 PHP 的映射。已验证版本:im 26.900.0、imbot 26.400.0、main 26.800.0。
必要用法与约束:使用任何通讯类(Bitrix\Im\V2\Chat、CIMChat、CIMNotify 等)前须先 Loader::includeModule('im')。必须显式传入用户id(FROM_USER_ID、AUTHOR_ID、TO_USER_ID、上下文用户),代理与CLI没有 $USER。Bitrix\Im\V2\Chat::sendMessage() 不校验作者权限,应先调用 canDo(Action::Send),或改用默认校验的 CIMChat::AddMessage()(除非 SYSTEM/SKIP_USER_CHECK 为 Y)。发送后的推送、计数、OnAfterMessagesAdd 与机器人工作在响应后作为后台任务执行;CLI 脚本可调用 $result->getPromise()?->wait(),CIM* 包装器默认等待。通知只能使用 CIMNotify::Add(),NotifyChat::sendMessage() 在 im 26.900 中为桩实现。每条通知应设置 NOTIFY_TAG,用于去重(同一标签替换该用户的旧通知)与删除。绑定自定义实体的聊天使用自有命名空间的 ENTITY_TYPE 加 addUniqueChat(),不得直接写 b_im_* 表。
适用场景:需要在自建Bitrix24中集成消息、通知与机器人流程的PHP开发。限制:仅面向本地部署服务端,未提供安装命令、收费与平台等细节。