MSP Integration Setup

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Revision as of 06:13, 2 October 2013 by Robert (talk | contribs)
Jump to navigation Jump to search
User Manuals > MSP Integration Setup

CommitCRM integrates with several MSP systems, via different platforms.

Supported MSP systems (by alphabetical order):

  1. GFI MAX Link - Using CommitCRM RMMServer service for Ticket integration.
  2. Kaseya™ - Using CommitCRM Email Connector's Automated Emails.
  3. LabTech™ - Using CommitCRM API and CommitCRM Online Services.
  4. Level Platforms™ Managed Workplace™ - Using CommitCRM Email Connector's Automated Emails.
  5. N-able™ N-central™ - Using CommitCRM Email Connector's Automated Emails.
  6. Zenith/Continuum Link - Using CommitCRM RMMServer service for two-ways Ticket integration.


Kaseya™

The CommitCRM integration with Kaseya includes Ticket creation out of incoming email alerts from Kaseya. This is done using CommitCRM 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 CommitCRM 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 CommitCRM.
Kaseya Settings for working with CommitCRM

  1. Setup Kaseya alerts to send the email to your CommitCRM support Public Email Address so it will arrive at the CommitCRM 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 CommitCRM 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





CommitCRM Email Connector Settings for working with Kaseya™
In CommitCRM 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 CommitCRM's Email Connector:

  1. Run ServerConfig from <server>\CommitCRM\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. 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 CommitCRM Online Services to sync data with CommitCRM.

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


Level Platforms™ Managed Workplace™

The integration described here includes Ticket creation out of incoming email alerts from the MSP system. This is done using the CommitCRM 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 Workplace™ settings
There are no special settings required in Level Plaforms™ side.

CommitCRM Email Connector Settings for working with Level Platforms™
In CommitCRM 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 CommitCRM.

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 CommitCRM 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 CommitCRM Email Connector's Automated Emails which allow analyzing the incoming alert's subject to find the customer in the CommitCRM database.

Tip
In addition to the Ticket creation integration, you can use CommitCRM Online Services to easily link with N-able to open Account and Asset information directly in N-central. See more details in Online Services for N-able™.


To setup the Ticket creation process via CommitCRM Email Connector, you should follow customization steps both in CommitCRM and N-able™.

Follow the setup instructions according to the N-central™ version you use:

Using N-able™ N-central™ version 6 or later
In order for the CommitCRM 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 CommitCRM Email Connector to analyze them correctly.

Option 1
For the CommitCRM 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 CommitCRM Email Connector. Set the alert's "From" email address per customer to contain the customer's email address (as it has been entered in CommitCRM). You can then teach the CommitCRM 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 CommitCRM 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 CommitCRM 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:
  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 CommitCRM RecID in each Customer record in N-central. The Account's Rec ID from CommitCRM. 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."

CommitCRM Email Connector Settings for working with N-able™ version 6 or later
In the CommitCRM 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 CommitCRM Email Connector to analyze them correctly.

Option 1
In order for the CommitCRM 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 CommitCRM 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 CommitCRM). You can then teach the CommitCRM 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 CommitCRM 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 CommitCRM. 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

CommitCRM Email Connector Settings for working with N-able™
In the CommitCRM 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 CommitCRM Email connector, make the following adjustments:
    • 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

CommitCRM Email Connector Settings for Working with N-able™
In the CommitCRM 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 CommitCRM 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 CommitCRM Account that has the sender email address of the automated emails".

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

Zenith Link

The CommitCRM-Zenith Integration automatically creates tickets in CommitCRM from alerts and service tickets generated by Zenith Infotech system, or from tickets created manually by the Zenith NOC. Users can then close the Ticket in CommitCRM, and it will be closed in Zenith. The integration works via CommitCRM RMMServer service which runs on your CommitCRM server.

The CommitCRM integration with Zenith includes:

  • Two-ways Ticket Integration.
  • The ability to link Account to Site in Zenith or create Account from Site.
  • The ability to link Asset to Device in Zenith or create Asset from Device.


>> Click for complete Zenith Link setup guide.

GFI MAX Link

CommitCRM-GFI MAX Link module provides an integration with the remote monitoring and management (RMM) solution designed for managed services providers (MSP) offered by GFI.

The CommitCRM-GFI MAX Link automatically opens Tickets in CommitCRM for failed checks from GFI MAX. Any updates to the ticket (i.e. check failed again or check succeeded) are automatically logged as Notes in the Ticket History in CommitCRM. When a failed check is resolved in GFI MAX (i.e. it does not fail anymore), it automatically updates the Ticket with a relevant note, and the Ticket in CommitCRM can be closed.

Each Ticket update that is a result of a check status change in GFI MAX pushes the Ticket into the Tickets Inbox, so technicians can easily see the updates. This integration helps you make sure you do not miss any events and always provide your customers with the best service.

The CommitCRM integration with GFI MAX includes:

  • Ticket creation from GFI MAX failed checks.
  • Link Accounts to Sites in GFI MAX or create Account from Site.
  • Link Assets to Products in GFI MAX or create Asset from Product.


>> Click for complete GFI MAX Link setup guide.

See Also