ImmyBot integration

This document outlines the requirements and setup for the ImmyBot integration.

If you’re new to integrations in Rewst, read through our introductory integration documentation here.

ImmyBot does not suppot multi-instance integration. For more on this topic, see our documentation here,

What does the ImmyBot integration do?

Our ImmyBot integration enables the automation of remote machine management and monitoring. Use the ImmyBot API within Rewst workflows to gather detailed information and perform various operations on remotely managed machines, people, software, and scripts.

Set up the ImmyBot integration

Set up steps in ImmyBot

Before configuring the Rewst integration you must get the Application ID and Client Secret Value from your ImmyBot account.

Please refer to ImmyBot's Documentation for instructions on retrieving your API key information.

Set up steps in Rewst

1. Navigate to Configuration > Integrations in the left side menu of your Rewst platform.

2. Search for ImmyBot in the integrations page.

3. Click on the integration tile to launch the configuration setup page.

4. Enter your ImmyBot Hostname. Click Next.

5. Under Azure App Registration, enter the information copied from ImmyBot into the relevant fields:

   • Microsoft Tenant ID

   • Application ID

   • Client Secret

6. Click the link that appears on the integration configuration screen to navigate to ImmyBot's Persons Settings. Create a new Person for Rewst to use. Use your primary Tenant, and set the AD External ID field value.

7. Click Continue to create your user and assign the admin Role.

8. Click Test configuration.

Actions and endpoints

Category	Action	Description
Assignments	List Target Assignments	Get a list of target assignments (deployments) available
Assignments	List Recommended Assignments	Get a list of pre-configured target assignments (deployments) that can be approved or dismissed
Assignments	Create Target Assignment	Create a new target assignment (deployment) for a software or task
Assignments	Update Target Assignment	Updates an existing target assignment (deployment) for a software or task
Assignments	Delete Target Assignment	Delete an existing target assignment (deployment) for a software or task
Auth	Check Auth	Description coming soon...
Computers	List Computers	Get a list of computers
Computers	Get Computer	Get a computer by ID
Computers	Assign Person to Computer	Updates an existing target device with a primary user
Generic Request	ImmyBot API Request	Generic action for making authenticated requests against the ImmyBot API
Maintenance Actions	List Actions For Computer	Get a list of available maintenance actions for a given computer
People	List People	Get a list of People
Scripts	List Scripts	Get a list of scripts available in ImmyBot
Scripts	Get Script	Get a script by ID
Scripts	Get Script References	Gets any software, software versions or tasks referencing a given script
Scripts	Create Script	Creates a new script in ImmyBot
Scripts	Run Script	Runs a script defined in ImmyBot against a target computer
Scripts	Run Ad Hoc Script	Runs an on demand script against a computer in ImmyBot
Service	Run Immy Service	Allows you to run target assignments, maintenance actions, install software or onboard a list of computers
Sessions	List Sessions	Get a list of maintenance sessions
Software	List Software	Get a list of software
Software	Get Software	Get a software entry by ID
Software	Upload Software Installer	Upload a new software installer
Software	Analyze Software Installer	Analyze a software installer to automatically gather details about it in ImmyBot
Software	Fast Create Software	Create a software and a corresponding software version from an uploaded installer or URL
Software	Search Inventory Software	Searches across computer inventory for installed software matching the given name
Tasks	Create Task	Creates a new maintenance task in the local environment
Tenants	List Tenants	Retrieve a list of tenants from ImmyBot
Tenants	Get Tenant Preferences	Get preferences for a given tenant in ImmyBot