ChatMessageSeenUsers

Introduction

When a User has seen a ChatMessage, intratool tracks this as a ChatMessageSeenUser.

Model Definition

Relations

Key	Relation	Type	Relation Field(s)
user	User	Belongs to	user_id
chatMessage	ChatMessage	Belongs to	chat_message_id

List by message

List visible ChatMessageSeenUsers for a ChatMessage.

Definition

GET /api/chat/messages/{chatMessage}/seen-users

Route Parameters

Parameter	Type	Description
chatMessage	integer | string	ChatMessage ID or hash.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/chat/messages/1/seen-users', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

[
  {
    "id": 1,
    "user_id": 3,
    "chat_message_id": 1,
    "created_at": "2026-08-06 09:36:00"
  },
  {
    "id": 2,
    "user_id": 4,
    "chat_message_id": 1,
    "created_at": "2026-08-06 09:37:00"
  }
]

Create by conversation

Create ChatMessageSeenUsers for all unseen messages in a ChatConversation.

Definition

POST /api/chat/conversations/{chatConversation}/messages/seen-users

Route Parameters

Parameter	Type	Description
chatConversation	integer | string	ChatConversation ID or hash.

Behavior

The authenticated user is used automatically. Only messages that have not been deleted are included. Existing records are not duplicated, and notifications for the affected messages are marked as read.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/chat/conversations/1/messages/seen-users', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "user_id": 3,
      "chat_message_id": 1,
      "created_at": "2026-08-06 09:36:00"
    }
  ]
}

Create by message

Create a ChatMessageSeenUser for the current authenticated User and a ChatMessage.

Definition

POST /api/chat/messages/{chatMessage}/seen-users

Route Parameters

Parameter	Type	Description
chatMessage	integer | string	ChatMessage ID or hash.

Behavior

The operation is idempotent and marks notifications for the message as read.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/chat/messages/1/seen-users', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

{
  "status": "success",
  "data": {
    "id": 1,
    "user_id": 3,
    "chat_message_id": 1,
    "created_at": "2026-08-06 09:36:00"
  }
}