MSP Integration Setup

User Manuals > MSP Integration Setup

CommitCRM integrates with several MSP systems, via different platforms.

Supported MSP systems (by alphabetical order):

1. LabTech™ - Using CommitCRM API and Commit Online Services.
2. Level Platforms™ Managed Workspace™ - Using Commit Email Connector's Automated Emails.
3. N-able™ N-central™ - Using Commit Email Connector's Automated Emails.

Kaseya™

The CommitCRM integration with Kaseya includes Ticket creation out of incoming email alerts from the Kaseya. This is done using Commit Email Connector's Automated Emails which allows analyzing the incoming alert's subject to find the customer in the CommitCRM database. This is a one-way path Kaseya alert email is interpreted and creates a Commit ticket.

Kaseya email alerts are received from a single "From" email address (e.g. alert@mykaseyadomain.com), and should be configured to contain the customer ID in the email's subject.

You should also let the system know how to detect the Account name in the email subject. Make sure to use the exact same name as it appears in the Account's File As field in Commit.
Kaseya Settings for working with CommitCRM

1. Setup Kaseya alerts to send the email to your Commit support Public Email Address so it will arrive at the Commit Email Connector for processing.
2. In Kaseya go to each of the areas listed below, select Email Format, and add the following to the subject of each email template:
   “Site:<gr>.”

Where:

1. <gr> is the Kaseya variable for the Group ID.
2. You can change “.” To “:” if you wish to use Kaseya sub groups to link to the Commit account ie “site1.location5”

Perform the Email Format update in the following areas:

1. Monitor – Alerts (for each alert type in the pull down)
2. Monitor – Assign Monitoring
3. Patch Mgmt – Patch Alert
4. Backup – Backup Alert
5. Security – Security Alarms

Commit Email Connector Settings for working with Kaseya™
In Commit Email Connector settings, you need to set the system to identify Kaseya automated emails by the Sender/From email address you've set for your Kaseya system as well as by looking for a word in the email subject. To set this up use the serverconfig program to configure Commit's Email Connector:

1. Run ServerConfig from <server>\Commit\Server
   1. Go the Email Connector tab
   2. Scroll down to Email Processing Settings and select the Automated Emails tab.
   3. Set System State to On and click Automated Email Settings.
   4. Add a rule at the top in “Rules for detecting and identifying incoming emails as automated” and enter the email address your Kaseya uses for the From field of alerts and hit OK.

1. 1. Skip down to Account Record Detection Rules and create a rule:
      Account Name (file As … field )
      Located: between
      The Word/Phrase: “Site:”
      And “.” (replace “.” With “:” if using subgroups)
      

1. Modify the File As Field in the CommitCRM Account to contain the primary Kaseya group for the client:
   1. In CommitCRM go to the Account's General tab.
   2. Update the File As field to contain the Kaseya group ID.

Note that “.” Is used to terminate the subject search, subgroups in the <gr> will be ignored and should not be included in the File As field (.ie if <gr> = site1.location5 the rule above will return a File As value of site1). Case is significant!

LabTech™

The LabTech integration is based on a LabTech plug-in which uses CommitCRM API and Commit Online Services to sync data with CommitCRM.

For Setup and Installation instructions see LabTech-CommitCRM Integration Plug-In.

Level Platforms™ Managed Workspace™

The integration described here includes Ticket creation out of incoming email alerts from the MSP system. This is done using the Commit Email Connector's Automated Emails which allow analyzing the incoming alert's subject to find the customer in the CommitCRM database.

Level Plaforms™ email alerts are received from a single "From" email address (e.g. alert@mylevelplatformsdomain.com), and contain the customer name in the email's subject.

Level Platforms™ Managed Workspace™ settings
There are no special settings required in Level Plaforms™ side.

Commit Email Connector Settings for working with Level Platforms™
In Commit Email Connector settings, set the system to identify Level Platforms automated emails by the Sender/From email address you've set for your Level Platforms system as well as by looking for a word in the email subject.

You should also let the system know how to detect the Account name in the email subject. Make sure to use the exact same name as it appears in the Account's File As field in Commit.

Rules category	Rules
Automated Emails Detection Rules	1.Sender Email Address = alert@levelplatforms.com 2.Word/phrase = Alert for Site.
Skip Rules	Ignore Alerts which contain Alert Self Healed in the subject
Automated Emails Detection Rules	1.Take the Account name from the email's subject: between "Alert for Site" and ","

File:Commit email connector setup processing automated level platforms rules.gif

In order to work with Level Plaforms™ alerts, we recommend defining the following rules:

1. In the Automated Emails Detection Rules, add a new rule and set the Sender Email Address as alert@mylevelplatformsdomain.com, and the word/phrase to “Alert for Site”
2. In the Skip Rules section, add a new rule to ignore alerts which contain "Alert Self Healed" (do not open a new Ticket for these email alerts)
3. In the Account Record Detection Rules section, add a rule to take the Account name from the email's subject: between “Alert for Site” and “,”. The system will search for the Account in Commit and open a Ticket from this alert for this Account.

N-able™ N-central™

The integration described here includes Ticket creation out of incoming email alerts from the MSP system. This is done using the Commit Email Connector's Automated Emails which allow analyzing the incoming alert's subject to find the customer in the CommitCRM database.

The setup includes customization steps both in CommitCRM and N-able™.

When working with alerts in N-able™, you should set up N-central™ according to the version you use:

Using N-able™ N-central™ version 6 or later
In order for the Commit Email Connector to identify the CommitCRM Account for the incoming N-central Email notification, you should include the External Customer ID field in the email notification Subject. The External Customer ID in N-central will be used to store the parallel CommitCRM Account' RecordID per customer.

To do this, customize the N-central Email template for notifications to include the External Customer ID in the email subject automatically.

See more details in Using N-central™ version 6 or later

Using N-able™ N-central™ versions older than 6
When using older versions of N-central, you may consider two alternative options for setting up the email alerts in order for the Commit Email Connector to analyze them correctly.

Option 1
For the Commit Email Connector to identify the customer for the incoming email alert, the customer's ID must be in the email subject. For each customer, hard-code the CommitCRM Account's Record ID in the email template subject so the Email Connector will be able to detect the Account when processing the email.

Option 2
This option allows setting the customer's email address as the "From" email address of the incoming alert and use it as the customer's identifier for the Commit Email Connector. Set the alert's "From" email address per customer to contain the customer's email address (as it has been entered in Commit). You can then teach the Commit Email Connector to detect these alerts and open Tickets for the Account in CommitCRM based on the "From" email address.

This option requires your N-able™ server to allow relay in order for it to be able to send emails which will "originate" from the customer's email address. If your servers do not support relay, you should use the first option.

See more details under Using N-central™ versions older than 6

Using N-central™ version 6 or later

In order for the Commit Email Connector to identify the CommitCRM Account for the incoming N-central Email alert, you should include the External Customer ID field in the email alert subject. The External Customer ID in N-central will be used to store the parallel CommitCRM Account RecordID per customer.

This requires setting up CommitCRM and N-able:

N-central™ settings

To set up N-central, you should modify the default N-central Email template for notifications to include the External Customer ID in the email subject automatically.

When using templates, it is possible to add the {{ExternalCustomerID}} variable to the email subject templates. This will propagate the customer ID to the email alert's subject.

Here are the recommended steps for non-hosted N-able users:

1. Login to the Admin console of your N-central server (i.e. https://192.168.1.1/admin)
2. Define the Notification settings. In order for the notifications to be automatically processed by Commit Email connector, make the following adjustments:
   1. Sender Email Address - set as the "N-able" email (e.g. n-central@n-able.com)
   2. Subject - create a template which will include:
      • A word/phrase which you can associate with alerts (e.g. "Alert:")
      • A word/phrase which you can associate with the External Customer ID (e.g. "RECID:")
        For example:
        Alert {{CustomerName}} RECID:{{ExternalCustomerID}}, Device: {{DeviceName}}... etc.
        
        

        File:Commit email connector setup processing automated n able templates admin.gif

3. Under the Product Settings section, click on Default Notification Templates and edit the templates.
   
   

   File:Commit email connector setup processing automated n able template.gif

4. Add the {{ExternalCustomerID}} to the email Subject in both the "Email – Long" and "Email – Short" notification templates
5. Click Save and Propagate
6. Make sure to define the Commit RecID in each Customer record in N-central. The Account's Rec ID from Commit. The RecID can be found on the Account's Notes tab, and can be taken by right-clicking the RecID label, and copying the Rec ID. Then paste it somewhere in the email subject template, with a phrase which will identify it, like "RECID: CRDIF9FPDJ4IHUMU2VWI."

Commit Email Connector Settings for working with N-able™ version 6 or later
In the Commit Email Connector settings, set the system to identify automated emails according to the sender's email address and the word/phrase in the subject. Then, let the system know how to identify the Account Record ID.

Rules category	Rules
Automated Emails Detection Rules	1.Sender Email Address = N-central@n-able.com 2.Word/phrase = The phrase you setup in the Alert subject template in N-central™.
Account Record Detection Rules	1. Search for: Record ID 2. between RECID: and , (same as you defined in the n-able template).

Using N-central™ versions older than 6

When using older versions of N-central, you may consider two alternative options for setting up the email alerts in order for the Commit Email Connector to analyze them correctly.

Option 1
In order for the Commit Email Connector to identify the customer for the incoming email alert, this requires including the customer's ID in the email subject. For each customer your should hard-code the CommitCRM Account's Record Id in the email template subject, so the email connector will be able to detect the Account when processing the email.

See more details under Use Customer's ID.

Option 2
This option allows setting the customer's email address as the "from" email address of the incoming alert, and use it as the customer's identifier for the Commit Email Connector. In this option you should set the alert's "From" email address per customer to contain the customer's email address (as it has been entered in Commit). You can then teach the Commit Email Connector to detect these alerts and open Tickets for the Account in CommitCRM based on the "From" email address.

This option is less recommended, and it requires your N-able™ server to allow relay in order for it to be able to send emails which will "originate" from the customer's email address. If your servers don't support this, you should use the first option.

See more details under Use Customer's Email Address.

Use Customer's ID

N-central™ settings
Customize the customer email notification in N-able™ to use the customer's email address in the "From" email address and set an identifying word/phrase in the subject. This is so that the system will know this is an alert, and not a "regular" email from the customer:

1. Go to the Main company settings
2. Open the Customers window (Setup > Customers)
3. Click each customer, and go to the Notification tab.
4. Here you define the Notification settings for alerts. In order for the notifications to be automatically processed by Commit Email connector, make the following adjustments:
   • Sender Email Address - set as the "N-able" email (e.g. n-central@n-able.com)
   • Subject - create a template which will include:
     • A word/phrase which you can associate with alerts (e.g. "Alert:")
     • The Account's Rec ID from Commit. The RecID can be found on the Account's Notes tab, and can be taken by right-clicking the RecID label, and copying the Rec ID. Then paste it somewhere in the email subject template, with a phrase which will identify it, like "RECID: CRDIF9FPDJ4IHUMU2VWI."

File:Commit email connector setup processing automated n able recid.gif

Commit Email Connector Settings for working with N-able™
In the Commit Email Connector settings, set the system to identify automated emails according to the sender's email address and the word/phrase in the subject. Then, let the system know how to identify the Account Record ID.

Rules category	Rules
Automated Emails Detection Rules	1.Sender Email Address = N-central@n-able.com 2.Word/phrase = The phrase you setup in the Alert subject template in N-central™.
Account Record Detection Rules	1.Search for: Record ID 2. between RECID: and , (same as you defined in the n-able template).

Go to ServerConfig > Email Connector > Automated Emails:

1. In the Automated Email Detection Rules, add a new rule and set the Sender email address as empty, and the word/phrase as the word/phrase you set in the Alert subject template in N-central™.
   
   

   File:Commit email connector setup automated n able rules subject2.zoom85.png

   
   
   
2. Add a Account Record Detection Rule by the Record ID, between "RECID" and "," (same as you defined in the n-able template above).

File:Commit email connector setup automated n able rules recid.zoom88.png

After you define all the rules, the rules window should look like this:

File:Commit email connector setup processing automated n able rules2.zoom90.png

Use Customer's Email Address

n this option, you should set N-able™ email alerts to use the customer's email address as the "From" email address, and tell the system that this is the Account identification.

N-central™ settings Customize the customer email notification in N-able™ to use the customer's email address in the "From" email address and set an identifying word/phrase in the subject, so the system will know this is an alert, and not a "regular" email from this customer:

1. Go to the Main company settings
2. Open the Customers window (Setup > Customers)
3. Click each customer, and go to the Notification tab.
4. Define the Notification settings for alerts. In order for the notifications to be automatically processed by Commit Email connector, make the following adjustments:

1. • Sender Email Address - set this to be the Customer's email address (rather than generic "n-able email")
   • Subject - create a template which will include a word/phrase which you can associate with alerts (e.g. "Alert:")

File:Commit email connector setup processing automated n able.gif

Commit Email Connector Settings for Working with N-able™
In the Commit Email Connector settings, set the system to accept automated emails with the customer's email address in the "From" email address, and tell the system how to detect the automated email subject.

Rules category	Rules
Automated Emails Detection Rules	1.Sender Email Address = N/A 2.Word/phrase = The phrase you setup in the Alert subject template in N-central™.
Account Record Detection Rules	Check the Search for a Commit Account that has the sender email address of the automated emails flag.

Go to ServerConfig > Email Connector > Automated Emails:

1. In the Automated Email Detection Rules, add a new rule and set the Sender email address as empty, and the word/phrase as the word/phrase you set in the Alert subject template in N-central™.
   
   

   File:Commit email connector setup automated n able rules subject.zoom86.png

   
   
   
2. Select "Search for a Commit Account that has the sender email address of the automated emails".
   
   

   File:Commit email connector setup processing automated n able rules.zoom93.png

See Also

• API by Email and MSP Integration
• Email Connector