Last Modified: 13.05.2022
Sends message from chatbot
function is used here for illustration purposes only. It is taken from the EchoBot
example. You can send a REST command with your own function, or use the BX24.callMethod
These methods of message processing are usually employed when the user is typing something, that is why the ONIMBOTMESSAGEADD
event must be processed.
$result = restCommand('imbot.message.add', Array(
'BOT_ID' => 39, // ID of chatbot that sends request. Is optional, there is only one chatbot
'DIALOG_ID' => 1, // Dialog ID: it can be either USER_ID, or chatXX - where XX is chat ID, transmitted in events ONIMBOTMESSAGEADD and ONIMJOINCHAT
'MESSAGE' => 'answer text' // Message text
'ATTACH' => '' // Attachment, optional field
'KEYBOARD' => '' // Keyboard, optional field
'MENU' => '' // Context menu, optional field
'SYSTEM' => 'N' // Display messages as system messages, optional field, by default 'N'
'URL_PREVIEW' => 'Y' // Convert links to rich-links, optional field, by default 'Y'
You can post message on behalf of bot in private dialogues (they will be shown as system message). To do it, specify
USER_TO_ID instead of
MESSAGE_ID or an error.
||Chatbot not found.
|| Chatbot is not part of this application: you can only work with chatbots, installed within application framework.
||Dialogue ID is not transmitted.
||Message text is not transmitted.
||Complete transmitted object was not validated.
||Maximum permissible attachment size was exceeded (30 Kb).
||Complete transmitted keyboard object was not validated.
||Maximum permissible keyboard size was exceeded (30 Kb).
||Complete transmitted menu object was not validated.
||Maximum permissible menu size was exceeded (30 Kb).
||Something went wrong.