会話の閲覧権限とリアルタイムイベント

連携側で会話の閲覧権限、リアルタイムイベント、未読数の整合性をどのように扱うかを説明します。

バックエンドの会話機能を連携する際は、「ユーザーがどの会話を閲覧できるか」を、一覧、未読数、リアルタイムイベントを同時に制約する一つの権限として扱ってください。一般メンバーには、自分が閲覧できる会話のイベントのみが配信されます。すべての会話を閲覧する権限を持つメンバーに限り、その会話プラットフォームの全イベントが配信されます。

RESTとリアルタイムイベントの違い

• 受信トレイのRESTレスポンスに含まれる未読数は、現在ログインしているメンバーが閲覧できる会話に基づいて計算されます。

• 会話のRESTレスポンスには、既存のAPIレスポンス形式を維持するため、引き続き受信トレイの未読数フィールドが含まれます。

• リアルタイムイベントには、組織全体で共通の未読数は含まれません。イベントを受信した後、連携側で受信トレイのデータを再取得してから、画面上の未読バッジを更新してください。

リアルタイムイベント内の受信トレイデータで個別の未読数を上書きしないでください。また、同じ組織のすべてのメンバーが同じ会話を閲覧できるとは限りません。

権限変更後の処理

リアルタイム接続を確立する際に、メンバーが受信できる会話の範囲が決まります。管理者がメンバーの会話閲覧権限を変更した後は、連携側でリアルタイム接続を再確立し、新しいイベント範囲を反映してください。RESTクエリは、リクエスト時点の権限に基づいてデータを返します。

連携チェックリスト

1. 一般メンバーとオーナーの両方でテストし、オーナーアカウントだけで検証しないでください。

2. 一般メンバーが、閲覧できない会話の作成、更新、イベント、既読通知を受信しないことを確認してください。

3. リアルタイムイベントの受信後に受信トレイのデータを再取得し、未読数と会話一覧が一致していることを確認してください。

4. 権限変更後に再接続し、イベント範囲をもう一度検証してください。

ロールと連絡先の権限の違いについては、ロール（Role）と連絡先（Contact）の違いを参照してください。