Взаимодействие встройки с полем ввода мессенджера

Для работы с текстом в поле ввода чата используйте методы $b24.parent.message.send.
Это удобно, когда нужно:

• получить текущий текст из чата
• подставить подготовленный текст в поле ввода
• сделать это безопасно, без прямой работы с интерфейсом мессенджера

Формат вызоваФормат вызова

$b24.parent.message.send(method, params)

Что нужно перед вызовамиЧто нужно перед вызовами

1. Приложение должно быть запущено внутри фрейма Битрикс24.
2. SDK должен быть инициализирован через initializeB24Frame().

Пример:

const $b24 = await B24Js.initializeB24Frame()

Метод im:getImTextareaContentМетод im:getImTextareaContent

Метод im:getImTextareaContent возвращает текущий текст из поля ввода активного чата.

ПараметрыПараметры

Обязательные параметры отмечены *

ПримерПример

const responseGet = await $b24.parent.message.send(
    'im:getImTextareaContent',
    {
        requestId: B24Js.Text.getUuidRfc4122(),
        isSafely: true,
        safelyTime: 1500
    }
)

В responseGet придет текст из поля ввода.
Если возникает ошибка, в ответе приходит объект с полями:

• message — текст ошибки (системное сообщение JavaScript)
• requestId — тот же requestId, который был передан в запросе

Возможные причины ошибки:

• не удалось определить текущий диалог
• текстовое поле недоступно

Метод im:setImTextareaContentМетод im:setImTextareaContent

Метод im:setImTextareaContent вставляет текст в поле ввода активного чата.

ПараметрыПараметры

Обязательные параметры отмечены *

ПримерПример

const responseSet = await $b24.parent.message.send(
    'im:setImTextareaContent',
    {
        text: 'Hello from iframe!',
        requestId: B24Js.Text.getUuidRfc4122(),
        withNewLine: false,
        replace: true,
        isSafely: true,
        safelyTime: 1500
    }
)

В responseSet придет результат вставки.
Если возникает ошибка, в ответе приходит объект с полями:

• message — текст ошибки (системное сообщение JavaScript)
• requestId — тот же requestId, который был передан в запросе

Возможные причины ошибки:

• не удалось определить текущий диалог
• текстовое поле недоступно

Пример реализацииПример реализации

Пример встройки, демонстрирующей оба метода — скачать.

Как устроен примерКак устроен пример

1. SDK подключается в браузере через UMD-скрипт @bitrix24/b24jssdk.
2. При загрузке страницы вызывается B24Js.initializeB24Frame().
3. Кнопка Get text отправляет im:getImTextareaContent и получает текущий текст поля ввода.
4. Кнопка Set text отправляет im:setImTextareaContent и вставляет текст в чат.
5. Флаги withNewLine и replace берутся из чекбоксов в форме.
6. Результаты запросов выводятся в блок #log и в console.