# RepairShopr

## Domotz RepairShopr Integration

Adding a New Team Member in Software Settings

1. Open the software dashboard and navigate to the 'Settings' section located in the upper navigation bar.
2. Select 'Team Management' from the drop-down menu.
3. Click the 'Add Member' button to initiate the process of adding a new team member.
4. Enter the necessary details, such as name and email address, in the provided fields.
5. Assign a role or permissions to the new member using the available options.
6. Click 'Save' to confirm the addition of the new team member.

Domotz [network monitoring system](https://www.domotz.com/?utm_source=domotz&utm_medium=help&utm_campaign=RepairShopr) integrates with [RepairShopr](https://www.repairshopr.com/) so you can monitor, manage, track and resolve issues with your network and devices.

This integration aims to help MSPs have better tracking and troubleshooting of network and device issues that are discovered by Domotz.

## Setting up Domotz RepairShopr Integration

You can connect your RepairShopr account to Domotz. It will become one of the Contact Channels available when creating a Shared Alert. This means that you can create or update a RepairShopr ticket when a specific event occurs in Domotz.

You’ll need:

- RepairShopr Domain Name
- RepairShopr API Token

### RepairShopr API Token creation

For RepairShopr API token creation go to your **RepairShopr Portal page**, under **Admin Setting**, and then under **API**, click on **API Token**. You will land on a page with the following URL:

https://{yoursubdomain}.repairshopr.com/api_tokens

Create a **New Token.**
Add **Domotz** as a name to the **Custom Permissions** schema:

Creating a New Token in RepairShopr

1. Access the "New Token" section from the navigation menu.
2. Review the "Token Types" information to understand the difference between "App Integration" and "Custom" tokens.
3. Read the "App Integration Tokens Disclaimer" about data sharing and third-party risks.
4. Navigate to the tab section, where "App Integration" and "Custom Permissions" are featured.
5. Under "Custom Permissions," notice that available selections are based on current user permissions.
6. Enter the desired name for the token in the "Name" field, such as "Domotz Connection."
7. Set the expiration date for the token in the "Expiration" field.
8. Use "Edit API Permissions" to customize available permissions or select "Show all permissions" to view all options.
9. Click the "Back" button to return to the previous screen if necessary.

Select the necessary permissions to allow the integration to work:

- Customers – List/Search
- Tickets – View Details
- Tickets – Create
- Tickets – Edit

Confirm API Token Permissions

1. Enter the desired name for the API token in the "Name" field.
2. Under "Edit API Permissions," verify or modify the permissions by checking the appropriate boxes:
   - "Customers - List/Search"
   - "Tickets - View Details"
   - "Tickets - Create"
   - "Tickets - Edit"
3. To view more permission options, click "Show all permissions."
4. Once the necessary permissions are selected, click the "Create API Token" button to finalize the process.

Press on **Create API Token**.
Once the **API Token** has been created, copy it in your clipboard and you will use it in Domotz.

Creating a New Custom API Token

1. A confirmation message indicates that the API key was successfully created.
2. The title reads "New Custom API Token Created."
3. A warning section advises to copy the displayed API token immediately, as it will not be shown again.
4. Information about the key includes:
   - Owner: Giancarlo Fanelli
   - Creation date and time: Wed 03-10-21 07:24 AM
   - Token type: Custom
   - Expiration status: Indefinite
   - Partial key: T3e895639143a4416a–***
5. A "Done" button is available to complete the process.

This is your API Token you will use inside Domotz to connect to your RepairShopr Account.

### RepairShopr Contact Channel creation

Now that you have your RepairShopr API token created, you can proceed with connecting it to Domotz.
Click on the **Connect Account** button under the **Shared Alerts and Ticketing Systems** section on Domotz:

Connecting RepairShopr Account

1. Locate the RepairShopr logo and name on the left side of the screen.
2. On the right side, find the "Connect Account" button.
3. Click "Connect Account" to begin linking your RepairShopr account.

Type in RepairShopr URL in the following format https://{subdomain}.repairshopr.com and paste your **API token**, then click **Save**:

RepairShopr Integration Interface

1. Enter the RepairShopr API URL by substituting '{subdomain}' with your specific subdomain.
2. Input the RepairShopr Bearer Token in the appropriate field.
3. Click "Save" to apply the changes or "Cancel" to discard them.
4. Use "Remove integration" to disconnect the service if needed.
5. For additional guidance, review the "Domotz User Guide" linked at the bottom.

**Important Note:** the RepairShopr URL does NOT require the /api/v1 endpoint.
The accepted format is as follows:
**https://{subdomain}.repairshopr.com/**

Your RepairShopr account is now connected with Domotz.

Click on **Manage Agents** and select to which RepairShopr customer each Domotz Agent should create a support ticket on.

If you don’t select a RepairShopr customer for an Agent, the ticket won't be delivered.

Map Domotz Agents to RepairShopr Customers

1. Review the list of Domotz Agents on the left side. Each agent is identified by a name or code, such as "Agent 1" or "CRESTRON - 00:01:aa:bb:09".
2. Look at the right side labeled "RepairShopr Customer" to find potential customer mappings. Each customer is listed with a name and email, like "Test Customer 1 | customer@domotz.com".
3. To map an agent to a customer, select the checkbox next to the desired Domotz Agent name.
4. Ensure the corresponding RepairShopr customer is correct for the selected agent to facilitate support ticket creation.
5. Use the search feature in the RepairShopr Customer column if needed to filter and find specific customers.
6. Click "Close" to finish the mapping process when all agents have been assigned.

**Important Note:**The Domotz Agent mapping is **mandatory**.
If no choice is done, events on Agents which are not mapped to any RepairShopr customers, won't be delivered.

You are now able to use the Contact Channel for RepairShopr, within the Shared Alert profile. Once the Shared Alert profile is created, apply the Shared Alert to the Agents and Device for which you are willing to automatically open tickets in your RepairShopr.