---
title: "Action get_client_by_chat_room_id"
description: "Loads chat room client data into scenario constants."
---

# Action `get_client_by_chat_room_id`

> **System ID:** `action_get_client_by_chat_room_id`

## Description

Finds the client participant of a chat room and stores their data, contact channels, and participant in constants. You can then use placeholders such as `{{client.first_name}}`, `{{primary_channel}}`.

Stored among others: `participant`, `client`, `client_channels`, `primary_channel`, `primary_chat_id`, `client_chat_id`, `channels_count`.

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **success** | Client data retrieved and stored |
| **error** | Missing `chat_room_id`, no participant/client/channels, or other failure |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `chat_room_id` | number / string | yes | — | Chat room ID. Supports placeholders |

## Configuration example

```json
{
  "chat_room_id": "{{chat_room_id}}"
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)