n8n-nodes-immybot

This is an n8n community node. It lets you use ImmyBot in your n8n workflows.

ImmyBot is an automated workstation deployment and management tool.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This node supports the following operations:

Tags

• Create: Create a new tag
• Delete: Delete a tag by ID
• Get: Get all tags
• Get by ID: Get a specific tag by its ID
• Update: Update an existing tag by ID

Provider Links

• Get Provisioning Package: Get a provisioning package URI with onboarding options

Maintenance

• Run: Run maintenance or software installation on specified computers with options for:
  • Maintenance parameters (session group, task mode, maintenance type, etc.)
  • Execution options (reboot preferences, scheduling, etc.)
  • Deployment options (deployment type, offline behavior, etc.)
  • Email notifications
  • UI customization
  • Target selection (computers, tenants, persons)

Credentials

To use this node, you'll need to set up an Entra App Registration and configure it with ImmyBot. Here's how:

1. Create an Entra App Registration:

   • Go to the Azure Portal
   • Navigate to Azure Active Directory > App registrations
   • Click "New registration"
   • Give your app a name
   • Select "Single tenant" for supported account types
   • Click "Register"

2. Configure the App Registration:

   • Note down the Application (client) ID
   • Create a new client secret:
     • Go to "Certificates & secrets"
     • Click "New client secret"
     • Add a description and select an expiration
     • Copy the secret value immediately (you won't be able to see it again)
   • Click on the "Enterprise applications" link in the left sidebar
   • Find your app in the list and click on it
   • Copy the Object ID from the Overview page

3. Configure ImmyBot:

   • In your ImmyBot tenant, go to Settings > Users
   • Add a new user
   • Use the Object ID from your Entra App Registration as the username
   • Assign appropriate roles to the user

4. In n8n:

   • Create new credentials for ImmyBot
   • Enter the Client ID and Client Secret from your Entra App Registration
   • For the Access Token URL, use: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
     (Replace {tenant-id} with your tenant ID from the app registration)
   • For the Scope, use: https://{subdomain}.immy.bot/.default
     (Replace {subdomain} with your ImmyBot subdomain)
   • Save the credentials

Compatibility

This node is compatible with n8n version 1.0.0 and above.

Resources

• n8n community nodes documentation
• ImmyBot Documentation
• ImmyBot Integration Guide