bitrix24-im

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Мессенджер Битрикс24: серверный PHP

Bitrix24 即时通讯:服务端 PHP

Scope: Bitrix24 on-premise · Verified: im 26.1300.0, main 26.1000.0
Перед PHP-кодом один раз прочитай
bitrix-framework
.
ЗадачаОткрыть
Сообщения, вложения/клавиатура, создание чатов, участники, события
rules/messages-chats.md
Уведомления: типы, теги, удаление, подтверждение, настройки
rules/notifications.md
Модульные боты и slash-команды; REST
imbot.v2
, открытые линии
rules/bots.md
Несовместимые изменения, соответствие REST и PHP
rules/pitfalls.md
适用范围:Bitrix24 本地部署 · 已验证:im 26.1300.0、main 26.1000.0
在编写 PHP 代码前,请先阅读一次
bitrix-framework
。
任务打开
消息、附件/键盘、创建聊天、参与者、事件
rules/messages-chats.md
通知:类型、标签、删除、确认、设置
rules/notifications.md
模块化机器人和 slash 命令;REST
imbot.v2
、开放线路
rules/bots.md
不兼容变更、REST 与 PHP 兼容性
rules/pitfalls.md

Общие правила

通用规则

  • Подключи
    Loader::includeModule('im')
    перед классами мессенджера (
    Bitrix\Im\V2\Chat
    ,
    CIMChat
    ,
    CIMNotify
    …).
  • Передавай 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
    .
  • Push, счётчики,
    OnAfterMessagesAdd
    , боты выполняются фоном после ответа. В CLI вызывай
    $result->getPromise()?->wait()
    ; обёртки
    CIM*
    ждут по умолчанию.
  • Для уведомлений используй
    CIMNotify::Add()
    .
    NotifyChat::sendMessage()
    в проверенном ядре остаётся заглушкой.
  • Задавай
    NOTIFY_TAG
    : одинаковый тег заменяет прежнее уведомление пользователя и позволяет его удалить.
  • Чаты своей сущности привязывай через собственный
    ENTITY_TYPE
    и
    addUniqueChat()
    . Не записывай
    b_im_*
    напрямую.
  • 在使用即时通讯类(
    Bitrix\Im\V2\Chat
    、
    CIMChat
    、
    CIMNotify
    等)之前,调用
    Loader::includeModule('im')
    。
  • 明确传递用户 ID:
    FROM_USER_ID
    、
    AUTHOR_ID
    、
    TO_USER_ID
    和上下文用户。在 Agent/CLI 中没有已授权的
    $USER
    。
  • Bitrix\Im\V2\Chat::sendMessage()
    不会检查作者权限:请先调用
    canDo(Action::Send)
    ,或者使用
    CIMChat::AddMessage()
    ;当
    SYSTEM
    /
    SKIP_USER_CHECK
    不等于
    Y
    时,后者会检查权限。
  • Push、计数器、
    OnAfterMessagesAdd
    和机器人会在响应后于后台执行。在 CLI 中调用
    $result->getPromise()?->wait()
    ;
    CIM*
    包装器默认会等待执行完成。
  • 通知使用
    CIMNotify::Add()
    。在已验证的核心代码中,
    NotifyChat::sendMessage()
    仍然是占位实现。
  • 设置
    NOTIFY_TAG
    :使用相同标签会替换用户之前的通知,并允许将其删除。
  • 通过自定义
    ENTITY_TYPE
    和
    addUniqueChat()
    绑定自身实体的聊天。不要直接写入
    b_im_*
    。