# landing.repowidget.register

URL: https://chugunov.pro/api-bitrix24/vibe/landing-repowidget-register/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Добавить виджет на Вайб
Scope: `landing`
Кто может выполнять метод: любой пользователь

## Описание

Метод `landing.repowidget.register` добавляет виджет для Вайба. Возвращает ошибку или идентификатор `ID` добавленного виджета.

При добавлении выполняется проверка. Если виджет с кодом `code` уже зарегистрирован ранее, то происходит обновление его контента. Виджеты, уже размещенные на Вайбах, в случае обновления контента обновляются автоматически.

## Параметры

- `code` `string` — обязательный. Уникальный код виджета. Настоятельно рекомендуется использовать какой-либо уникальный префикс для своих виджетов, чтобы избежать риск совпадения кодов с виджетами других разработчиков
- `fields` `object` — обязательный. Значения полей для создания виджета

### Параметр fields

- `NAME` `string` — обязательный. Название виджета
- `PREVIEW` `string` — обязательный. URL картинки-обложки виджета для слайдера выбора виджетов
- `DESCRIPTION` `string` — необязательный. Описание виджета
- `CONTENT` `string` — обязательный. Верстка виджета с использованием конструкций Vue
- `SECTIONS` `string` — обязательный. Код раздела, в который будет добавлен виджет. Список доступных разделов:
  - `widgets_company_life` — Жизнь компании
  - `widgets_new_employees` — Новым сотрудникам
  - `widgets_team` — Команда
  - `widgets_automation` — Автоматизация
  - `widgets_events` — Встречи и события
  - `widgets_profile` — Профиль сотрудника
  - `widgets_tasks` — Задачи и проекты
  - `widgets_sales` — Продажи и клиенты
  - `widgets_hr` — HR
  - `widgets_other` — Другое
  - `widgets_separators` — Переходы и разделители
  - `widgets_text` — Текст
  - `widgets_image` — Картинки
  - `widgets_video` — Видео
- `WIDGET_PARAMS` `object` — обязательный. [Параметры](#anchor-widget-params) для vue-шаблонизатора. Без них метод вернет ошибку `REQUIRED_FIELD_NO_EXISTS`
- `ACTIVE` `char` — необязательный. Активность виджета. Принимает значения: 
  - `Y` - виджет активен и доступен
  - `N` - виджет неактивен и недоступен
- `SITE_TEMPLATE_ID` `string` — необязательный. Привязка виджета к определенному шаблону сайта. **Только для коробочного Битрикс24!**

## Ответ

HTTP-статус: 200

```json
{
    "result": 10,
    "time": {
        "start": 1713949410.036288,
        "finish": 1713949411.632775,
        "duration": 1.596487045288086,
        "processing": 0.6458539962768555,
        "date_start": "2024-04-24T11:03:30+02:00",
        "date_finish": "2024-04-24T11:03:31+02:00",
        "operating": 0
    }
}
```

### Возвращаемые данные

- `result` `integer`. Идентификатор добавленного виджета
- `time` `time`. Информация о времени выполнения запроса

## Ошибки

HTTP-статус: 400

```json
{
    "error":"REQUIRED_FIELD_NO_EXISTS",
    "error_description":"Отсутствует обязательное поле CONTENT"
}
```

- `REQUIRED_FIELD_NO_EXISTS` — В параметре `fields` не передано обязательное поле: `NAME`, `PREVIEW`, `CONTENT`, `SECTIONS` или `WIDGET_PARAMS`. Имя поля подставляется в текст ошибки
- `REQUIRED_PARAM_NO_EXISTS` — В параметре `WIDGET_PARAMS` не передан обязательный параметр: `rootNode`, `handler` или `demoData`. Имя параметра подставляется в текст ошибки

## Примеры запроса

### JS (TS)

```ts
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

const content = '<div class="my-app-w-container"><!-- Vue template --></div>'

try {
  const response = await $b24.actions.v2.call.make<number>({
    method: 'landing.repowidget.register',
    params: {
      code: 'my_widget',
      fields: {
        NAME: 'My widget',
        PREVIEW: 'https://my-app.com/vibe_preview.jpg',
        CONTENT: content,
        SECTIONS: 'widgets_company_life',
        WIDGET_PARAMS: {
          rootNode: '.my-app-w-container',
          lang: {
            ru: {
              W_TITLE: 'People and their ages',
              W_EMPTY: 'No data',
            },
            en: {
              W_TITLE: 'People and their ages',
              W_EMPTY: 'Empty',
            },
          },
          handler: 'https://my-app.com/vibe.php',
          style: 'https://my-app.com/vibe.css',
          demoData: {
            desc: 'Just a test widget',
            count: 420,
            persons: [
              { name: 'Person 1', age: 21 },
              { name: 'Person 2', age: 42 },
              { name: 'Person 3', age: 123 },
            ],
          },
        },
      },
    },
    requestId: Text.getUuidRfc4122()
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const result = response.getData()!.result
    console.info('Registered widget ID:', result)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}
```

### JS (UMD)

```html
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function registerVibeWidget() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const content = '<div class="my-app-w-container"><!-- Vue template --></div>'

      const response = await $b24.actions.v2.call.make({
        method: 'landing.repowidget.register',
        params: {
          code: 'my_widget',
          fields: {
            NAME: 'My widget',
            PREVIEW: 'https://my-app.com/vibe_preview.jpg',
            CONTENT: content,
            SECTIONS: 'widgets_company_life',
            WIDGET_PARAMS: {
              rootNode: '.my-app-w-container',
              lang: {
                ru: {
                  W_TITLE: 'People and their ages',
                  W_EMPTY: 'No data',
                },
                en: {
                  W_TITLE: 'People and their ages',
                  W_EMPTY: 'Empty',
                },
              },
              handler: 'https://my-app.com/vibe.php',
              style: 'https://my-app.com/vibe.css',
              demoData: {
                desc: 'Just a test widget',
                count: 420,
                persons: [
                  { name: 'Person 1', age: 21 },
                  { name: 'Person 2', age: 42 },
                  { name: 'Person 3', age: 123 },
                ],
              },
            },
          },
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info('Registered widget ID:', result)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', registerVibeWidget)
</script>
```

### Python

```python
from b24pysdk.errors import BitrixAPIError, BitrixSDKException

content = '<div class="my-app-w-container"><!-- Vue template --></div>'

try:
    bitrix_response = client.landing.repowidget.register(
        code="my_widget",
        fields={
            "NAME": "My widget",
            "PREVIEW": "https://my-app.com/vibe_preview.jpg",
            "CONTENT": content,
            "SECTIONS": "widgets_company_life",
            "WIDGET_PARAMS": {
                "rootNode": ".my-app-w-container",
                "lang": {
                    "ru": {
                        "W_TITLE": "People and their ages",
                        "W_EMPTY": "No data",
                    },
                    "en": {
                        "W_TITLE": "People and their ages",
                        "W_EMPTY": "Empty",
                    },
                },
                "handler": "https://my-app.com/vibe.php",
                "style": "https://my-app.com/vibe.css",
                "demoData": {
                    "desc": "Some people...",
                    "persons": [
                        {
                            "name": "Person 1",
                            "age": 21,
                        },
                        {
                            "name": "Person 2",
                            "age": 42,
                        },
                        {
                            "name": "Person 3",
                            "age": 123,
                        },
                    ],
                },
            },
        },
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")
```

### PHP

```php
try {
    $response = $b24Service
        ->core
        ->call(
            'landing.repowidget.register',
            [
                'code'    => 'my_widget',
                'fields'  => [
                    'NAME'         => 'My widget',
                    'PREVIEW'      => 'https://my-app.com/vibe_preview.jpg',
                    'CONTENT'      => $content,
                    'SECTIONS'     => 'widgets_company_life',
                    'WIDGET_PARAMS' => [
                        'rootNode' => '.my-app-w-container',
                        'lang'     => [
                            'ru' => [
                                'W_TITLE' => 'Люди и их возраст',
                                'W_EMPTY' => 'Нет людей',
                            ],
                            'en' => [
                                'W_TITLE' => 'People and their ages',
                                'W_EMPTY' => 'Empty',
                            ],
                        ],
                        'handler'   => 'https://my-app.com/vibe.php',
                        'style'     => 'https://my-app.com/vibe.css',
                        'demoData'  => [
                            'desc'    => 'Just a test widget',
                            'count'   => 420,
                            'persons' => [
                                ['name' => 'Person 1', 'age' => 21],
                                ['name' => 'Person 2', 'age' => 42],
                                ['name' => 'Person 3', 'age' => 123],
                            ],
                        ],
                    ],
                ],
            ]
        );

    $result = $response
        ->getResponseData()
        ->getResult();

    echo 'Success: ' . print_r($result, true);
    // Нужная вам логика обработки данных
    processData($result);

} catch (Throwable $e) {
    error_log($e->getMessage());
    echo 'Error registering repowidget: ' . $e->getMessage();
}
```

### BX24.js

```js
const content = `
    <div class="my-app-w-container">
        <h2 class="w-title" :style="{borderBottom: '1px solid red'}">
            {{$Bitrix.Loc.getMessage('W_TITLE')}}
        </h2>
        
        <h3>Description: not_var{{desc}}</h3>
        
        <div v-for="(value) in persons">
            <p>
                <span class="w-name">not_var{{value.name}}</span>:
                <span class="w-age">not_var{{value.age}}</span>
            </p>
        </div>
        
        <div v-if="persons == null">
            {{$Bitrix.Loc.getMessage('W_EMPTY')}}
        </div>
        
        <h4>Just a number not_var{{count}}</h4>
        
        <div class="w-buttons">
            <button @click="fetch">Получить данные (без параметров)</button>
            <button @click="fetch({param: 'a'})">Данные для параметра 'a'</button>
            <button @click="fetch({param: 'b'})">Данные для параметра 'b'</button>
            <button @click="openApplication({param1: '1', param2: 'false'})">Открыть приложение</button>
            <button @click="openPath('/crm')">Открыть локальный адрес в слайдере</button>
        </div>
    </div>
`;

const data = {
    code: 'my_widget',
    fields: {
        NAME: 'My widget',
        PREVIEW: 'https://my-app.com/vibe_preview.jpg',
        CONTENT: content,
        SECTIONS: 'widgets_company_life',
        WIDGET_PARAMS: {
            rootNode: '.my-app-w-container',
            lang: {
                ru: {
                    W_TITLE: 'Люди и их возраст',
                    W_EMPTY: 'Нет людей',
                },
                en: {
                    W_TITLE: 'People and their ages',
                    W_EMPTY: 'Empty',
                },
            },
            handler: 'https://my-app.com/vibe.php',
            style: 'https://my-app.com/vibe.css',
            demoData: {
                desc: 'Just a test widget',
                count: 420,
                persons: [
                    {'name': 'Person 1', 'age': 21},
                    {'name': 'Person 2', 'age': 42},
                    {'name': 'Person 3', 'age': 123},
                ],
            },
        },
    },
};

BX24.callMethod(
    'landing.repowidget.register',
    data,
    (result) =>
    {
        if (result.error())
        {
            console.error(result.error());

            return;
        }

        console.info(result.data());
    },
);
```

### PHP CRest

```php
require_once('crest.php');

$content = <<<'HTML'
    <div class="my-app-w-container">
        <h2 class="w-title" :style="{borderBottom: '1px solid red'}">
            {{$Bitrix.Loc.getMessage('W_TITLE')}}
        </h2>
        
        <h3>Description: not_var{{desc}}</h3>
        
        <div v-for="(value) in persons">
            <p>
                <span class="w-name">not_var{{value.name}}</span>: 
                <span class="w-age">not_var{{value.age}}</span>
            </p>
        </div>
        
        <div v-if="persons == null">
            {{$Bitrix.Loc.getMessage('W_EMPTY')}}
        </div>
        
        <h4>Just a number not_var{{count}}</h4>
        
        <div class="w-buttons">
            <button @click="fetch">Получить данные (без параметров)</button>
            <button @click="fetch({param: 'a'})">Данные для параметра 'a'</button>
            <button @click="fetch({param: 'b'})">Данные для параметра 'b'</button>
            <button @click="openApplication({param1: '1', param2: 'false'})">Открыть приложение</button>
            <button @click="openPath('/crm')">Открыть локальный адрес в слайдере</button>
        </div>
    </div>
HTML;

$data = [
    'code' => 'my_widget',
    'fields' => [
        'NAME' => 'My widget', 
        'PREVIEW' => 'https://my-app.com/vibe_preview.jpg', 
        'CONTENT' => $content,  // Vue-разметка вынесена в отдельную переменную для удобства
        'SECTIONS' => 'widgets_company_life', 
        'WIDGET_PARAMS' => [
            'rootNode' => '.my-app-w-container',
            'lang' => [
                'ru' => [
                    'W_TITLE' => 'Люди и их возраст',
                    'W_EMPTY' => 'Нет людей',
                ],
                'en' => [
                    'W_TITLE' => 'People and their ages',
                    'W_EMPTY' => 'Empty!',
                ],
            ],
            'handler' => 'https://my-app.com/vibe.php',
            'style' => 'https://my-app.com/vibe.css',
            'demoData' => [
                'desc' => 'Just a test widget',
                'count' => 420,
                'persons' => [
                    [
                        'name' => 'Person 1',
                        'age' => 21,
                    ],
                    [
                        'name' => 'Person 2',
                        'age' => 42,
                    ],
                    [
                        'name' => 'Person 3',
                        'age' => 123,
                    ],
                ],
            ],
        ],
    ],
];

$result = CRest::call(
    'landing.repowidget.register',
    $data
);

echo '<PRE>';
print_r($result);
echo '</PRE>';
```

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/vibe/landing-repowidget-register.html