Widget for the IM_SIDEBAR

// This snippet is an ES module: top-level await requires type="module" or a bundler.
        // $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
        import { Text } from '@bitrix24/b24jssdk'
        import type { B24Frame } from '@bitrix24/b24jssdk'
        
        declare const $b24: B24Frame
        
        try {
          const response = await $b24.actions.v2.call.make<boolean>({
            method: 'placement.bind',
            params: {
              PLACEMENT: 'IM_SIDEBAR',
              HANDLER: 'https://your-domain.com/widgets/im-sidebar-handler.php',
              TITLE: 'My sidebar item',
              LANG_ALL: {
                ru: {
                  TITLE: 'My sidebar item',
                },
                en: {
                  TITLE: 'My sidebar item',
                },
              },
              OPTIONS: {
                iconName: 'fa-file-text-o',
                context: 'ALL',
                role: 'USER',
                extranet: 'N',
                color: 'LIGHT_BLUE',
              },
            },
            requestId: Text.getUuidRfc4122()
          })
        
          // The payload is available only on a successful response
          if (!response.isSuccess) {
            console.error(response.getErrorMessages().join('; '))
          } else {
            const result = response.getData()!.result
            console.info('Placement bound successfully:', result)
          }
        } catch (error) {
          // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
          console.error(error)
        }
        

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
        <script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
        <script>
          async function bindImSidebar() {
            try {
              // Initialize the SDK inside a Bitrix24 frame
              const $b24 = await B24Js.initializeB24Frame()
        
              const response = await $b24.actions.v2.call.make({
                method: 'placement.bind',
                params: {
                  PLACEMENT: 'IM_SIDEBAR',
                  HANDLER: 'https://your-domain.com/widgets/im-sidebar-handler.php',
                  TITLE: 'My sidebar item',
                  LANG_ALL: {
                    ru: {
                      TITLE: 'My sidebar item',
                    },
                    en: {
                      TITLE: 'My sidebar item',
                    },
                  },
                  OPTIONS: {
                    iconName: 'fa-file-text-o',
                    context: 'ALL',
                    role: 'USER',
                    extranet: 'N',
                    color: 'LIGHT_BLUE',
                  },
                },
                requestId: B24Js.Text.getUuidRfc4122()
              })
        
              // The payload is available only on a successful response
              if (!response.isSuccess) {
                console.error(response.getErrorMessages().join('; '))
                return
              }
        
              const result = response.getData().result
              console.info('Placement bound successfully:', result)
            } catch (error) {
              // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
              console.error(error)
            }
          }
        
          document.addEventListener('DOMContentLoaded', bindImSidebar)
        </script>
        

try {
            $response = $b24Service
                ->core
                ->call(
                    'placement.bind',
                    [
                        'PLACEMENT' => 'IM_SIDEBAR',
                        'HANDLER' => 'https://your-domain.com/widgets/im-sidebar-handler.php',
                        'TITLE' => 'My sidebar item',
                        'LANG_ALL' => [
                            'de' => [
                                'TITLE' => 'Mein Sidebar-Element',
                            ],
                            'en' => [
                                'TITLE' => 'My sidebar item',
                            ],
                        ],
                        'OPTIONS' => [
                            'iconName' => 'fa-file-text-o',
                            'context' => 'ALL',
                            'role' => 'USER',
                            'extranet' => 'N',
                            'color' => 'LIGHT_BLUE',
                        ],
                    ]
                );
        
            $result = $response->getResponseData()->getResult();
            if ($result->error()) {
                error_log($result->error());
            } else {
                echo 'Success: ' . print_r($result->data(), true);
            }
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error binding placement: ' . $e->getMessage();
        }
        

BX24.callMethod(
            'placement.bind',
            {
                PLACEMENT: 'IM_SIDEBAR',
                HANDLER: 'https://your-domain.com/widgets/im-sidebar-handler.php',
                TITLE: 'My sidebar item',
                LANG_ALL: {
                    de: { TITLE: 'Mein Sidebar-Element' },
                    en: { TITLE: 'My sidebar item' }
                },
                OPTIONS: {
                    iconName: 'fa-file-text-o',
                    context: 'ALL',
                    role: 'USER',
                    extranet: 'N',
                    color: 'LIGHT_BLUE'
                }
            },
            function(result) {
                if (result.error()) {
                    console.error(result.error());
                } else {
                    console.log(result.data());
                }
            }
        );
        

require_once('crest.php');
        
        $result = CRest::call(
            'placement.bind',
            [
                'PLACEMENT' => 'IM_SIDEBAR',
                'HANDLER' => 'https://your-domain.com/widgets/im-sidebar-handler.php',
                'TITLE' => 'My sidebar item',
                'LANG_ALL' => [
                    'de' => [
                        'TITLE' => 'Mein Sidebar-Element',
                    ],
                    'en' => [
                        'TITLE' => 'My sidebar item',
                    ],
                ],
                'OPTIONS' => [
                    'iconName' => 'fa-file-text-o',
                    'context' => 'ALL',
                    'role' => 'USER',
                    'extranet' => 'N',
                    'color' => 'LIGHT_BLUE',
                ],
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';
        

// client and ctx are already created — see the Go SDK section
        res, err := client.Core().Call(ctx, "placement.bind", b24.Params{
        	"PLACEMENT": "IM_SIDEBAR",
        	"HANDLER":   "https://your-domain.com/widgets/im-sidebar-handler.php",
        	"TITLE":     "My sidebar item",
        	"LANG_ALL": b24.Params{
        		"ru": b24.Params{
        			"TITLE": "My sidebar item",
        		},
        		"en": b24.Params{
        			"TITLE": "My sidebar item",
        		},
        	},
        	"OPTIONS": b24.Params{
        		"iconName": "fa-file-text-o",
        		"context":  "ALL",
        		"role":     "USER",
        		"extranet": "N",
        		"color":    "LIGHT_BLUE",
        	},
        })
        if err != nil {
        	return fmt.Errorf("placement.bind: %w", err)
        }
        
        // The response arrives as json.RawMessage — unmarshal it into a struct
        // matching the response shape from the "Response Handling" section of the placement.bind page.
        fmt.Printf("%s\n", res.Result)