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

POST

/api/channels/{id}/widget-code/preview

Генерирует код виджета на основе переданных настроек БЕЗ сохранения в базу.
Используется для preview в реальном времени при редактировании настроек.

config_source (обязательный параметр):

local — все настройки вшиты в скрипт (theme, features, allowed_domains)

remote — минимальный скрипт, настройки загружаются с сервера через /init

Поля настроек (опциональные):

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

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

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

identity_verification — HMAC-верификация в сгенерированном коде

language — язык виджета (ru | en | auto)

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Preview кода сгенерирован

Body

🟠400Bad Request

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/channels//widget-code/preview' \
--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?"
        },
        "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
    },
    "identity_verification": false,
    "language": "auto",
    "config_source": "local"
}'

Response Example

{
    "success": true,
    "data": {
        "widget_code": "<script src=\"...\"></script>"
    }
}

Modified at 2026-03-16 08:18:51

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

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