bitrix24-im

Bitrix24 メッセンジャー（サーバー側）

対象範囲：Bitrix24 オンプレミス · 検証済み：im 26.900.0、imbot 26.400.0、main 26.800.0

タスク	参照
メッセージ、システムメッセージの送信、添付／キーボード、チャットの作成、メンバー、im イベント	rules/messages-chats.md
通知：タイプ、タグ、削除、確認ボタン、ユーザー設定のスキーマ	rules/notifications.md
モジュールからのチャットボットとスラッシュコマンド、REST imbot.v2、オープンライン	rules/bots.md
im 26.700–26.900 の破壊的変更、REST ↔ PHP のマッピング	rules/pitfalls.md

不変条件

• メッセンジャーのクラス（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) を呼び出すか、SYSTEM／SKIP_USER_CHECK が Y でない限り権限を確認する CIMChat::AddMessage() を使用します。
• 送信後の処理（プッシュ、カウンター、OnAfterMessagesAdd、ボット）は、レスポンス後にバックグラウンドジョブとして実行されます。CLI スクリプトでは $result->getPromise()?->wait() を呼び出します。CIM* ラッパーはデフォルトで待機します。
• 通知には CIMNotify::Add() のみを使用します。im 26.900 では NotifyChat::sendMessage() はスタブです。
• すべての通知に NOTIFY_TAG を設定します。これにより重複が排除され（同じタグの通知はユーザーに対して古い通知を置き換えます）、削除も可能になります。
• 独自のエンティティに紐づくカスタムチャットでは、独自の名前空間の ENTITY_TYPE と addUniqueChat() を使用します。b_im_* テーブルには書き込みません。