Привязать агента к диалогу

PATCH

/api/dialogs/{id}/agent

🔐 Требуется разрешение: can_manage_dialogs

Привязывает агента к диалогу.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

OAuth 2.0

Client Credentials

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: /api/apps/oauth/token

Scopes:

can_manage_dialogs-Manage dialogs

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Bad Request

application/json

Агент привязан к диалогу

Body

🟠400Unauthorized

🟠401Forbidden

🟠403Record Not Found

🟠404Server Error

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/dialogs//agent' \
--header 'X-Session-Id;' \
--header 'Accept-Language;' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "agent_id": "550e8400-e29b-41d4-a716-446655440002",
    "role": "primary"
}'

Response Example

200 - Example 1

{
    "id": "507f1f77bcf86cd799439011",
    "dialog_agents": [
        {
            "agent_id": "string",
            "role": "primary",
            "assigned_at": "2019-08-24T14:15:22.123Z",
            "assigned_by": "auto",
            "agent_info": {
                "name": "string",
                "avatar_url": "string",
                "status": "active"
            }
        }
    ],
    "channel_id": "550e8400-e29b-41d4-a716-446655440000",
    "project_id": "550e8400-e29b-41d4-a716-446655440000",
    "auto_assign_disabled": false,
    "status": "active",
    "dialog_type": "private_chat",
    "external_dialog_id": "vk_private_channel-uuid_12345",
    "space_id": "507f1f77bcf86cd799439012",
    "space_ids": [
        "507f1f77bcf86cd799439013",
        "507f1f77bcf86cd799439012"
    ],
    "tags": [
        "возврат",
        "товар"
    ],
    "priority": "low",
    "traffic_source": "widget",
    "traffic_medium": "organic",
    "device_type": "mobile",
    "utm_source": "vk",
    "utm_medium": "cpc",
    "utm_campaign": "promo2025",
    "utm_term": "возврат товара",
    "utm_content": "banner_blue",
    "duration_seconds": 300,
    "first_response_time_seconds": 45,
    "started_at": "2025-12-25T10:00:00Z",
    "completed_at": "2025-12-25T12:30:00Z",
    "last_event_at": "2025-12-25T12:30:00Z",
    "created_at": "2025-12-25T10:00:00Z",
    "updated_at": "2025-12-25T12:30:00Z",
    "is_test": false,
    "total_events": 42,
    "messages_count": 30,
    "operator_unread_count": 5,
    "lead_unread_count": 3,
    "primary_lead_id": "507f1f77bcf86cd799439014",
    "display_info": {
        "name": "Иван Петров",
        "avatar_url": "https://vk.com/images/camera_200.png",
        "source_type": "lead",
        "platform_type": "vk"
    },
    "summary": "Клиент уточнил условия доставки и подтвердил заказ.",
    "summary_generated_at": "2025-12-25T12:30:00Z",
    "reply_target": {
        "channel_type": "tg",
        "kind": "telegram_chat",
        "data_tg": {
            "chat_id": "-1001234567890",
            "linked_chat_id": "-1001234567000",
            "chat_type": "private",
            "chat_title": "Поддержка клиентов",
            "chat_username": "support_chat"
        }
    },
    "first_message": {
        "content": "Здравствуйте! Подскажите по возврату товара.",
        "lead_id": "507f1f77bcf86cd799439011",
        "sender": {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "type": "lead",
            "external_id": "123456789",
            "profile": {
                "first_name": "Иван",
                "last_name": "Петров",
                "username": "ivan_petrov",
                "avatar_url": "https://example.com/avatar.jpg",
                "platform_type": "vk"
            }
        },
        "timestamp": "2025-12-25T10:00:00Z",
        "action_type": "message_created",
        "attachments": [
            {
                "type": "photo",
                "count": 2
            },
            {
                "type": "document",
                "count": 1
            }
        ]
    },
    "last_message": {
        "content": "Привет! Как дела?",
        "lead_id": "507f1f77bcf86cd799439011",
        "sender": {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "type": "lead",
            "external_id": "123456789",
            "profile": {
                "first_name": "Иван",
                "last_name": "Петров",
                "username": "ivan_petrov",
                "avatar_url": "https://example.com/avatar.jpg",
                "platform_type": "vk"
            }
        },
        "timestamp": "2026-01-09T16:25:49.680Z",
        "action_type": "message_created",
        "attachments": [
            {
                "type": "photo",
                "count": 2
            },
            {
                "type": "document",
                "count": 1
            }
        ]
    },
    "service_actor": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "type": "lead",
        "external_id": "123456789",
        "profile": {
            "first_name": "Иван",
            "last_name": "Петров",
            "username": "ivan_petrov",
            "avatar_url": "https://example.com/avatar.jpg",
            "platform_type": "vk"
        }
    },
    "is_sound_muted": false
}

Modified at 2026-04-19 06:23:17

Получить участников диалога

Отвязать агента от диалога