Bitrix24 Bot Platform

Register application for chat

There are two types of applications: JS-command and IFRAME-application.

$result = restCommand('imbot.app.register', Array(

   'BOT_ID' => 62, // Bot ID of chat application owner
   'CODE' => 'echo', // Application code for chat
   'JS_METHOD' => 'SEND', 
   'JS_PARAM' => '/help', 
   'ICON_FILE' => '/* base64 image */', // Your application icon - base64
   'CONTEXT' => 'BOT', // Application context
   'EXTRANET_SUPPORT' => 'N', // Extranet users command accessibility, by default ‘N’   'LIVECHAT_SUPPORT' => 'N', // Online chat support
   'IFRAME_POPUP' => 'N', // iframe will open and will be able to move inside the messenger, transition between dialogues will not close such window.
   'LANG' => Array( // translations array; it is preferably to indicate minimum for EN       Array('LANGUAGE_ID' => 'en', 'TITLE' => 'Chatbot BUTTON', 'DESCRIPTION' => 'Send help command'),

   )

), $_REQUEST["auth"]);

Variants for JS_METHOD:

• PUT - insert command for chatbot in text area, JS_PARAM can contain only command text and parameters for it (permitted symbols: a-z 0-9 - + _ / ).
• SEND - send command to chatbot, JS_PARAM can contain only command text and parameters for it (permitted symbols a-z 0-9 - + _ / ).
• CALL - call to a phone number.
• SUPPORT - open technical support chatbot, operating via Open Channels. Open Channel JS_PARAM code must be indicated (32 symbols).

ICON_FILE application icon format:

• Base64 of your icon should returned to this field. Icon format is detailed in this documentation.
• Please note, if this field is not specified, the application will be accessible in the system dialogue "Applications for chat".

Application context CONTEXT:

• ALL - application will be accessible in all chats.
• USER - application will be accessible only in Person-to-person chats.
• CHAT - application will be accessible only in Group chats.
• BOT - application will be accessible only to chatbot that have installed the app.
• LINES - application will be accessible only in Open Channels chats.
• CALL - application will be accessible only in chats, created within Telephony framework.

Postfix -admin can be added to each context, then the application will be accessible in the required context only to Bitrix24 administrators.

$result = restCommand('imbot.app.register', Array(

   'BOT_ID' => 62, // Bot ID of chat application owner
   'CODE' => 'echo', // Application code for chat
   'IFRAME' => 'https://marta.bitrix.info/iframe/echo.php', 
   'IFRAME_WIDTH' => '350', // desired frame width. Minimum value - 250px  
   'IFRAME_HEIGHT' => '150', // desired frame height. Minimum value - 50px  
   'HASH' => 'd1ab17949a572b0979d8db0d5b349cd2', // token for access to your frame to check the signature, 32 symbols. 
   'ICON_FILE' => '/* base64 image */', // Your application icon - base64
   'CONTEXT' => 'BOT', // Application context
   'HIDDEN' => 'N', // application is hidden or not 
   'EXTRANET_SUPPORT' => 'N', // Extranet users command accessibility, by default ‘N’   'LIVECHAT_SUPPORT' => 'N', // Online chat support
   'IFRAME_POPUP' => 'N', // iframe will open and will be able to move inside the messenger, transition between dialogues will not close such window.
   'LANG' => Array( // translations array; it is preferably to indicate minimum for EN Array('LANGUAGE_ID' => 'en', 'TITLE' => 'Echobot IFRAME', 'DESCRIPTION' => 'Open Chatbot IFRAME app', 'COPYRIGHT' => 'Bitrix24'), 
   )

), $_REQUEST["auth"]);