MSP Integration Setup: Difference between revisions

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
Line 63: Line 63:
|1. Search for: Record ID<br>2. between RECID: and , (same as you defined in the n-able template).
|1. Search for: Record ID<br>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'''<br>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 [[MSP Integration Setup#Use Customer's ID|Use Customer's ID]].
'''Option 2'''<br>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 [[MSP Integration Setup#Use Customer's Email Address|Use Customer's Email Address]].
====Use Customer's ID====
'''N-central™ settings'''<br>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:
#Go to the Main company settings
#Open the '''Customers''' window (Setup > Customers)
#Click each customer, and go to the '''Notification tab'''.
#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|center]]
'''Commit Email Connector Settings for working with N-able™'''<br>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.
{| class="wikitable"
|-
! Rules category
! Rules
|-
| Automated Emails Detection Rules
| 1.'''Sender Email Address''' = N-central@n-able.com<br>2.'''Word/phrase''' = The phrase you setup in the Alert subject template in N-central™.
|-
| Account Record Detection Rules
|1.Search for: Record ID<br>2. between RECID: and , (same as you defined in the n-able template).
|}
Go to ServerConfig > Email Connector > Automated Emails:
#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™.<br><br>[[File:Commit_email_connector_setup_automated_n_able_rules_subject2.zoom85.png|center]]<br><br>
#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|center]]
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|center]]
====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:
#Go to the Main company settings
#Open the Customers window (Setup > Customers)
#Click each customer, and go to the '''Notification tab'''.
#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 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|center]]
'''Commit Email Connector Settings for Working with N-able™'''<br>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.
{| class="wikitable"
|-
! Rules category
! Rules
|-
| Automated Emails Detection Rules
| 1.'''Sender Email Address''' = N/A<br>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:
#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™.<br><br>[[File:Commit_email_connector_setup_automated_n_able_rules_subject.zoom86.png|center]]<br><br>
#Select "Search for a Commit Account that has the sender email address of the automated emails".<br><br>[[File:Commit_email_connector_setup_processing_automated_n_able_rules.zoom93.png|center]]
==Level Platforms™ Managed Workspace™==
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'''<br>There are no special settings required in Level Plaforms™ side.
'''Commit Email Connector Settings for working with Level Platforms™'''<br>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.
{| class="wikitable"
|-
! Rules category
! Rules
|-
| Automated Emails Detection Rules
| 1.'''Sender Email Address = alert@levelplatforms.com'''<br>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|center]]
In order to work with Level Plaforms™ alerts, we recommend defining the following rules:
#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'''”
#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)
#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.

Revision as of 07:51, 29 July 2009

This section includes a recommended setting for the supported MSP systems. Configuring N-able™ Configuring Level Platforms™ Managed Workspace™

N-able™ N-central™

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:
  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:
    • 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

Level Platforms™ Managed Workspace™

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.