Обновить настройки Widget канала

PATCH

/api/channels/widget/{id}/settings

Обновляет визуальные и функциональные настройки виджета.
Требуется право can_manage_channels.

Что можно обновить:

theme — визуальные настройки (позиция, приветствие, цвета кнопки)

allowed_domains — разрешённые домены для CORS

features — функциональные настройки (загрузка файлов, голосовые, эмодзи)

Все поля опциональны — передавайте только то, что хотите изменить.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Настройки обновлены

Body

🟠400Bad Request

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/channels/widget//settings' \
--header 'Accept-Language;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "theme": {
        "position": "bottom-right",
        "theme_mode": "light",
        "width": 400,
        "height": 600,
        "border_radius": 12,
        "welcome_message": {
            "ru": "Здравствуйте! Чем могу помочь?",
            "en": "Hello! How can I help you?"
        },
        "toggle_button": {
            "light": {
                "background": "#3B82F6",
                "icon": "#ffffff"
            },
            "dark": {
                "background": "#3B82F6",
                "icon": "#ffffff"
            }
        },
        "button": {
            "position": "bottom-right",
            "light": {
                "background": "#3B82F6",
                "icon": "#ffffff"
            },
            "dark": {
                "background": "#3B82F6",
                "icon": "#ffffff"
            }
        }
    },
    "allowed_domains": [
        "example.com",
        "*.example.com",
        "www.example.com"
    ],
    "features": {
        "file_upload": true,
        "voice_messages": false,
        "emoji": true
    },
    "config_source": "remote",
    "name": "Мой виджет",
    "avatar_url": "https://avatars-ai.senler.ru/channels/550e8400.../avatar.jpg"
}'

Response Example

{
    "success": true,
    "widget_code": "<script src=\"...\"></script>",
    "iframe_url": "https://widget.aibot.local/550e8400-e29b-41d4-a716-446655440000"
}

Modified at 2026-02-21 16:01:50

Создать Widget канал

Preview кода виджета