Use TopLeft in a ConnectWise Custom Menu Entry

Embedding TopLeft in ConnectWise in the left main menu

TopLeft boards can be embedded in ConnectWise Manage as a custom menu entry so managers and technicians don't need to leave ConnectWise to use it. They also don't need to log into TopLeft, as TopLeft uses authentication data provided by ConnectWise.

For more information on custom menu entries, review the ConnectWise documentation.

In the ConnectWise client for Windows, card drag and drop doesn't work. We believe this is due to a limitation in the internal design of the Windows client. Card drag and drop works fine from the ConnectWise Manage web application.

Adding a TopLeft Menu Entry to ConnectWise

To embed TopLeft as a custom menu entry in ConnectWise, follow these steps.

  1. Navigate to Setup Tables. In the main menu click System > Setup Tables.
    setup-tables-highlight

  2. Search for "Custom Menu Entry".
    menu_entry
  3. Click the plus icon.
    menu_entry_plus
  4. Enter a name for the menu entry in the Menu Caption field.
  5. Choose a location from the Menu Location dropdown.
  6. Set Origin to the URL of your TopLeft application. For example: "https://example.topleft.team/".
  7. In the Link field, enter the address of the TopLeft Kanban board you wish to embed in the menu entry. To get this URL, from the TopLeft application edit the board and click Actions, then click Embed in ConnectWise. A dialog showing the URL opens- copy the URL and paste it into the Link field.
  8. Select the locations that can use the menu entry and click the Include button to move them to the included column. Or click Include All if you want the entry available to all locations.
    include
  9. Click save.
  10. Refresh your browser window. ConnectWise requires the browser to be refreshed before it will show the new menu entry.
  11. Navigate to the menu where you added your entry and verify your TopLeft app loads.

In the TopLeft app, shift-click a card title to open it in the same browser/client tab. The page opens quickly because it uses the existing ConnectWise application context.

Further Reference

Refer to the ConnectWise documentation: https://docs.connectwise.com/ConnectWise_Documentation/090/020/070/039