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| Задача | Открыть |
|---|---|
| Сообщения, вложения/клавиатура, создание чатов, участники, события | |
| Уведомления: типы, теги, удаление, подтверждение, настройки | |
Модульные боты и slash-команды; REST | |
| Несовместимые изменения, соответствие REST и PHP | |
适用范围:Bitrix24 本地部署 · 已验证:im 26.1300.0、main 26.1000.0
在编写 PHP 代码前,请先阅读一次 。
bitrix-framework| 任务 | 打开 |
|---|---|
| 消息、附件/键盘、创建聊天、参与者、事件 | |
| 通知:类型、标签、删除、确认、设置 | |
模块化机器人和 slash 命令;REST | |
| 不兼容变更、REST 与 PHP 兼容性 | |
Общие правила
通用规则
- Подключи перед классами мессенджера (
Loader::includeModule('im'),Bitrix\Im\V2\Chat,CIMChat…).CIMNotify - Передавай ID пользователей явно: ,
FROM_USER_ID,AUTHOR_ID, пользователь контекста. У агента/CLI нет авторизованногоTO_USER_ID.$USER - не проверяет права автора: сначала
Bitrix\Im\V2\Chat::sendMessage()либоcanDo(Action::Send), который проверяет права, еслиCIMChat::AddMessage()/SYSTEMне равныSKIP_USER_CHECK.Y - Push, счётчики, , боты выполняются фоном после ответа. В CLI вызывай
OnAfterMessagesAdd; обёртки$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和上下文用户。在 Agent/CLI 中没有已授权的TO_USER_ID。$USER - 不会检查作者权限:请先调用
Bitrix\Im\V2\Chat::sendMessage(),或者使用canDo(Action::Send);当CIMChat::AddMessage()/SYSTEM不等于SKIP_USER_CHECK时,后者会检查权限。Y - Push、计数器、和机器人会在响应后于后台执行。在 CLI 中调用
OnAfterMessagesAdd;$result->getPromise()?->wait()包装器默认会等待执行完成。CIM* - 通知使用 。在已验证的核心代码中,
CIMNotify::Add()仍然是占位实现。NotifyChat::sendMessage() - 设置 :使用相同标签会替换用户之前的通知,并允许将其删除。
NOTIFY_TAG - 通过自定义 和
ENTITY_TYPE绑定自身实体的聊天。不要直接写入addUniqueChat()。b_im_*