@ihazz/bitrix24 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ihazz/bitrix24",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Bitrix24 Messenger channel for OpenClaw",
   "type": "module",
   "main": "./dist/index.js",

package/skills/bitrix24/SKILL.md

@@ -63,9 +63,35 @@ When you see a message from a Bitrix24 user, you can react to acknowledge it bef
 
 **Important:** Do NOT invent or guess messageId values. Either omit `messageId` to react to the current message, or use a messageId that was explicitly provided to you.
 
+## Inline Buttons
+
+You CAN and SHOULD use inline keyboard buttons in Bitrix24. **Never say you cannot create buttons — you can.**
+
+Whenever your reply contains a list of options, choices, or suggestions that the user could pick from — **always** format them as inline buttons instead of a numbered or bulleted list. This applies to quizzes, polls, confirmations, recommendations, menus, and any other selection scenario.
+
+To add buttons, append a JSON line at the end of your message text using this exact format:
+
+`[[{"text":"Yes","callback_data":"yes"},{"text":"No","callback_data":"no"}]]`
+
+The system strips this markup from the visible text and renders native tappable buttons.
+
+Example — instead of writing:
+
+> Choose a type:
+> 1. String
+> 2. Keyboard
+> 3. Percussion
+
+Write:
+
+> Choose a type:
+> [[{"text":"String","callback_data":"s"},{"text":"Keyboard","callback_data":"k"},{"text":"Percussion","callback_data":"p"}]]
+
+Do NOT use `[[Text]]` format — only `[[{"text":"...","callback_data":"..."}]]` works.
+
 ## Writing Style (Bitrix24)
 
 - Direct, professional, moderate length.
-- **Always reply in the same language the user writes in.** If the user writes in Russian, reply in Russian. If in English, reply in English.
+- **Always reply in the same language the user writes in.** If the user writes in Polish, reply in Polish. If in English, reply in English.
 - Bitrix24 uses BBCode for formatting (conversion is automatic).
-- Inline keyboard buttons are supported for interactive responses.
+- Prefer inline buttons over numbered lists when presenting options.

package/src/channel.ts

@@ -538,7 +538,12 @@ export interface ChannelButton {
 /**
  * Convert OpenClaw button rows to B24 flat KEYBOARD array.
  */
-export function convertButtonsToKeyboard(rows: ChannelButton[][]): B24Keyboard {
+export function convertButtonsToKeyboard(input: ChannelButton[][] | ChannelButton[]): B24Keyboard {
+  // Normalize: accept both [[btn, btn], [btn]] (rows) and [btn, btn] (flat)
+  const isNested = input.length > 0 && Array.isArray(input[0]);
+  const rows: ChannelButton[][] = isNested
+    ? (input as ChannelButton[][])
+    : [input as ChannelButton[]];
   const keyboard: B24Keyboard = [];
 
   for (let i = 0; i < rows.length; i++) {