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
Code[B]...[/B] DescriptionBold text Example[B]Important[/B]
Code[I]...[/I] DescriptionItalic Example[I]note[/I]
Code[U]...[/U] DescriptionUnderlined Example[U]attention[/U]
Code[S]...[/S] DescriptionStrikethrough Example[S]deprecated[/S]
Code[URL=link]text[/URL] DescriptionHyperlink Example[URL=https://example.com]Open[/URL]
Code[CODE]...[/CODE] DescriptionCode block (monospace font) Example[CODE]console.log('hi')[/CODE]
Code[BR] or \n DescriptionLine break Example—
Code[SEND=value]text[/SEND] DescriptionClicking sends the value as a message Example[SEND=/help]Help[/SEND]
Code[PUT=value]text[/PUT] DescriptionInsert text into the input field (without sending) Example[PUT=/search ]Search[/PUT]
Code[IMG]link[/IMG] DescriptionInline image Example[IMG]https://example.com/pic.png[/IMG]
Code[CALL=number]text[/CALL] DescriptionCall link Example[CALL=+12025550123]Call[/CALL]
Code[USER=ID]text[/USER] DescriptionEmployee mention Example[USER=7]John Smith[/USER]
Code[SIZE=number]...[/SIZE] DescriptionText size Example[SIZE=18]Heading[/SIZE]
Code[COLOR=color]...[/COLOR] DescriptionText color (HEX or name) Example[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