## Форматирование текста (BB-коды)

Текст сообщений поддерживает BB-коды для стилизации. Используйте их в поле `fields.message` при отправке и обновлении сообщений.

## Список BB-кодов

| Код | Описание | Пример |
|-----|---------|--------|
| `[B]...[/B]` | Жирный текст | `[B]Важно[/B]` |
| `[I]...[/I]` | Курсив | `[I]примечание[/I]` |
| `[U]...[/U]` | Подчёркнутый | `[U]внимание[/U]` |
| `[S]...[/S]` | Зачёркнутый | `[S]устарело[/S]` |
| `[URL=ссылка]текст[/URL]` | Гиперссылка | `[URL=https://example.com]Открыть[/URL]` |
| `[CODE]...[/CODE]` | Блок кода (моноширинный шрифт) | `[CODE]console.log('hi')[/CODE]` |
| `[BR]` или `\n` | Перенос строки | — |
| `[SEND=значение]текст[/SEND]` | Клик отправляет значение как сообщение | `[SEND=/help]Помощь[/SEND]` |
| `[PUT=значение]текст[/PUT]` | Вставка текста в поле ввода (без отправки) | `[PUT=/search ]Поиск[/PUT]` |
| `[IMG]ссылка[/IMG]` | Встроенное изображение | `[IMG]https://example.com/pic.png[/IMG]` |
| `[CALL=номер]текст[/CALL]` | Ссылка-звонок | `[CALL=+79161234567]Позвонить[/CALL]` |
| `[USER=ID]текст[/USER]` | Упоминание сотрудника | `[USER=7]Иван Петров[/USER]` |
| `[SIZE=число]...[/SIZE]` | Размер текста | `[SIZE=18]Заголовок[/SIZE]` |
| `[COLOR=цвет]...[/COLOR]` | Цвет текста (HEX или имя) | `[COLOR=#ff0000]Красный[/COLOR]` |

## Упоминание сотрудника

`ID` — числовой идентификатор сотрудника портала. При ответе на сообщение идентификатор приходит в [событии бота](/docs/bots/events/bot-events), в полях `data.user.id` и `data.message.authorId`. Состав чата — [Список участников](/docs/bots/chats/user-list), все сотрудники портала — [Список сотрудников](/docs/entities/users/list).

Содержимое BB-кодов на стороне платформы Вайбкод не разбирается: текст поля `fields.message` уходит в Битрикс24 как есть. Отображение упоминания определяет Битрикс24, поэтому `ID` берите из источников выше.

## Пример

```json
{
  "dialogId": "chat123",
  "fields": {
    "message": "[USER=7]Иван Петров[/USER], [B]Задача #42[/B]\nСтатус: [COLOR=#00aa00]выполнено[/COLOR]\n[URL=https://portal.bitrix24.ru/tasks/42/]Открыть задачу[/URL]\n\n[SEND=/status 42]Обновить статус[/SEND]"
  }
}
```

## Смотрите также

- [Отправить сообщение](/docs/bots/messages/send)
- [Клавиатура](/docs/bots/messages/keyboard)
- [ATTACH-блоки](/docs/bots/messages/attach)