Use this guide to set up your integrations with MSPbots and check if your connectors are working or have errors.
How do the integrations work?
Integrations or data connectors are applications that provide the information that the MSPbots bots feed on. These apps supply the data that help us create reports and widgets that will give you better visibility of your business status. Generally, the more information you provide our bots, the better they can work for your needs.
Start by setting the integrations for the apps you have supplied on the Get Started step when you signed up with MSPbots. If your app already has an existing integration with MSPbots and would like to have it disabled, the Get Started form will allow you to do so.
The available MSPbots integrations are under Integrations in the MSPbots app menu. The list of integrations is also found below in this article.
How to set up and verify a successful integration
1. Connect your software to MSPbots.
- Fill out the Get Started form. When done, your apps will be added to the list of available Integrations under the section Waiting to be Connected.
- Next, connect your apps to MSPbots by clicking the corresponding Config icon to set them up. You will be asked to provide information like an API key and to sync the integration.
Different apps will have different requirements. For specific setup instructions, refer to the Integrations setup page in our Help Center.
- Your apps will appear under the Connected section after the setup is complete.
2. Validate the success of your app's integration.
Check for the following indicators:
- A Success status
- Connected status - Your app is under the Connected section.
- Green play button - This button means that your app's connection to MSPbots is running.
On the other hand, your integration is not properly configured if you observe any of the following:
- A red number beside Integrations
- Red icon for API errors
- Error or warning message
Some errors and warnings have brief descriptions of the error's root cause. To resolve integration errors, go to How can I fix the red number alert on Integrations?
If your tools or apps are not on our list, click the Request for a new integration icon in the upper right corner of the screen, or submit a ticket to MSPbots Support.
What data does MSPbots collect once these tools are configured?
Connecting your apps to MSPbots will require you to allow MSPbots to collect some of your company's data. The data and permissions you will grant to MSPbots are limited to tickets, time entries, user data, and other data that will help us create reports and bots for your company. Once the integration is successfully set up, MSPbots will start data sync and use the data to generate datasets, widgets, dashboards, and bots.
List of integrations with setup instructions
The full list of MSPbots integrations is found at Integrations in the MSPbots app, and instructions for each integration can be found at the Help Center's Integrations.
What are the IP addresses of the MSPbots servers?
To give MSPbots secure access to your data, allow the following IP addresses through your firewall when setting up the API connection:
192.34.22.4
192.34.22.53-62
For most API connections, we recommend using ports 80 and 443.
What will happen to Integrations if you have not logged into MSPbots for over 30 days?
If you have not logged into MSPbots for more than 30 days, data synchronization will be paused due to inactivity for over 30 days. Without data synchronization, the dashboards and bots may not function properly.
When you log in again, you will receive the following message:
Dear *** Welcome back! Your data synchronization has been paused due to inactivity for more than 30 days. Without data sync, the dashboards and bots may not function properly. Please expand the integrations and click the "Sync" button to resume data syncing. Note: The data sync process may take anywhere from a few minutes to several hours, depending on the amount of data that needs to be synchronized. |
Follow the steps below to resume data synchronization:
- Click each integration you are using to open it.
- Click the Save and Sync or Sync button to re-authenticate the integrations.
- This way, your dashboards and bots will function properly, and you will no longer receive the prompt message when you log into MSPbots next time. Otherwise, you will continue to receive it.