Setting Up the Syncro/Repairshopr API Integration with CloudRadial

Connecting your Syncro/Repairshopr instance to your CloudRadial tenant allows you to submit tickets from CloudRadial to Syncro/Repairshopr as a part of your client portal experience.

Since both the steps to implement and currently supported features are identical, they share the same instructions (henceforth referred to only Syncro integration in this article for simplicity). 

The Syncro integration with CloudRadial is in beta and is an evolving work in progress. Currently, CloudRadial fully supports the Syncro API including the following features:

• Selection of Syncro as a supported PSA
• Matching Syncro companies to CloudRadial companies
• Syncing contacts between Syncro and CloudRadial
• Updating Syncro contacts from Office 365
• API submission of tickets
• Ticket viewing and searching
• Ticket updates with feedback
• User notes viewing
• User file upload
• Invoice viewing and the ability to open into Syncro portal
• Workflow for company admin approvals

If you were previously using the initial Syncro integration, please note that the required rights have changed and you will need to update the PSA settings on the Partner Settings page.

Connecting Syncro

To get Syncro connected to CloudRadial, we'll follow three steps:

1. Creating and configuring an API key
2. Tying the API key into CloudRadial
3. Tying Syncro to specific companies in CloudRadial

Step 1: Creating and Configuring an API Key

Why are we doing this? To integrate with the Syncro PSA, you will need your domain prefix and an API key to ensure a data connection between both platforms. Your API key can be generated and obtained by following the steps listed below. 

1. Log into your Syncro instance
2. Click on your user name to show your profile options
3. Click on Profile/Password to show your details
   
                                                     
   
   
4. Click on the API Tokens link just underneath your name
                                                
5. Click on the +New Token button at the top right 
6. Click on the Custom Permissions tab
7. Name the API "CloudRadial" or similar to identify that this is the API syncing with CloudRadial
8. Leave the Expiration date field blank to have the API work indefinitely - you can always disable later if needed
9. Tick the boxes with the required rights listed below. Note that these are the required rights and are subject to change as the API with Syncro evolves.
   
   
   • Customers - Create
   • Customers - List/Search
   • Customers - View Detail
   • Customers - View Total Invoiced
   • Customers - Edit
   • Invoices - List/Search
   • Invoices - View Details
   • Tickets - List/Search
   • Tickets - View Details
   • Tickets - Use Ticket Charges
   • Tickets - View 'Their Ticket' Details (assigned to them)
   • Tickets - Create
   • Tickets - Edit
   • Ticket Comments - New
   • Leads - List/Search
     
     
10. Click the Create API Token button at the bottom
11. Copy the API key and store it for use in the next step
12. Press Done to finish the API key creation process
    
    

Step 2: Tying the API Key into CloudRadial

Why are we doing this? Once we have the right permissions tied to the API key, we'll need to enter it into your CloudRadial instance to secure the connection.

1. Log into your CloudRadial tenant
2. Go to Partner > Settings and click on "PSA" under Setup in the right-hand column 
3. Select Syncro for the PSA
4. Fill out the first Connection Information section
   • Enter the URL from your instance (example: https://cloudradial.syncromsp.com)
   • Enter the API key copied from the earlier step
   • Press Test Credentials to ensure the connection is secured
     
            
     
     
5. Fill out the second Ticket Settings section
   • Enter the priority status you wish users to have when they submit elevated tickets. Must match an existing status in Syncro.
6. Click Submit to lock in the settings

Step 3: Tying Syncro to Specific Companies in CloudRadial

Why are we doing this? We need to use identifiers to help CloudRadial link specific companies in the portal to companies in Syncro.

1. Navigate to Partner > Clients in CloudRadial
2. Click on the 3 blue dots on an existing client
3. Click Edit
   
                          
              
   
4. Once in the Company editing panel, look for the PSA Company Identifier field
   
   • Note:  Steps 4-8 apply both when editing an existing client in CloudRadial or when adding a brand new one
5. Use the Lookup button to find their company identifier in Syncro
6. Press enter on the blank field to load entries, or type the first few letters of the company you're trying to find and then press enter
   
   
   
   
7. Click on the corresponding company 
8. The ID will now be in place. Click Submit at the bottom of the panel 

The data from Syncro will now be flowing into the relevant (and currently supported) areas of CloudRadial. 

Setup is complete - simply repeat the ID entry steps for any loaded up clients or for new clients added to the portal.