For AI agents: markdown of this page — /docs-content-en/bots/messages/formatting.md documentation index — /llms.txt

Text formatting (BB-codes)

Message text supports BB-codes for styling. Use them in the fields.message field when sending and updating messages.

List of BB-codes

Code Description Example
[B]...[/B] Bold text [B]Important[/B]
[I]...[/I] Italic [I]note[/I]
[U]...[/U] Underlined [U]attention[/U]
[S]...[/S] Strikethrough [S]deprecated[/S]
[URL=link]text[/URL] Hyperlink [URL=https://example.com]Open[/URL]
[CODE]...[/CODE] Code block (monospace font) [CODE]console.log('hi')[/CODE]
[BR] or \n Line break —
[SEND=value]text[/SEND] Clicking sends the value as a message [SEND=/help]Help[/SEND]
[PUT=value]text[/PUT] Insert text into the input field (without sending) [PUT=/search ]Search[/PUT]
[IMG]link[/IMG] Inline image [IMG]https://example.com/pic.png[/IMG]
[CALL=number]text[/CALL] Call link [CALL=+12025550123]Call[/CALL]
[USER=ID]text[/USER] Employee mention [USER=7]John Smith[/USER]
[SIZE=number]...[/SIZE] Text size [SIZE=18]Heading[/SIZE]
[COLOR=color]...[/COLOR] Text color (HEX or name) [COLOR=#ff0000]Red[/COLOR]

Employee mention

ID is the numeric identifier of a Bitrix24 account employee. When a user replies to a message, the identifier arrives in the bot event, in the data.user.id and data.message.authorId fields. Use List participants for the chat roster and List employees for all Bitrix24 account employees.

Vibecode does not parse BB-code contents: the fields.message text goes to Bitrix24 as is. Bitrix24 decides how the mention renders, so take the ID from the sources above.

Example

JSON 
{
  "dialogId": "chat123",
  "fields": {
    "message": "[USER=7]John Smith[/USER], [B]Task #42[/B]\nStatus: [COLOR=#00aa00]done[/COLOR]\n[URL=https://portal.bitrix24.com/tasks/42/]Open task[/URL]\n\n[SEND=/status 42]Update status[/SEND]"
  }
}

See also