Before you start
You need a TeamGPS Public API key. A TeamGPS admin opens Admin Settings › Integrations › Public API’s, turns the Public API on and generates a key. TeamGPS keeps one key per account, and generating a new key replaces the old one. If another tool already reads TeamGPS with a key, give MSPortal that same key rather than generating a new one, or the other tool stops working.Connect and match companies
1
Enter and test the key
Open Settings > Integrations, select TeamGPS and open Connect. Paste the Public API key and click Test connection. A successful test shows how many answered reviews the key can read.
2
Save the connection
Click Save and continue. MSPortal starts reading your reviews in the background.
3
Match companies
Open Import or match companies. Each company a TeamGPS review names appears here with its review count. TeamGPS identifies companies by name only, so quick match suggests matches by name similarity against your MSPortal companies and the companies linked to your PSA. Review the suggestions before you apply them, or match each company yourself, or import it as a new company.Saved matches also attach existing ratings to the chosen company, so they appear in that company’s dashboards and reports.
4
Review and finish
Open Review, check each task and select Finish setup.
If you sent us your TeamGPS key before the sync was available, you do not need to enter it again. Open the TeamGPS connection and continue from Import or match companies once the first sync has listed your companies.
How TeamGPS ratings appear
- Scale: TeamGPS’s three ratings map to a 3-point scale: Negative is 1, Neutral is 2 and Positive is 3.
- Answered reviews only: TeamGPS also lists every survey it sent that was never answered. Those are not imported, so they do not count toward scores.
- Companies: a rating appears under a company only after its TeamGPS company is matched. Unmatched ratings are kept and attach as soon as you save the match.
- Technicians: TeamGPS lists each ticket’s team members with their PSA member identifier. A rating credits the first internal team member who matches exactly one technician in your PSA by identifier, email or name.
- Tickets: ratings link to the PSA ticket TeamGPS names (for example, the ConnectWise ticket number).
- Review queue: TeamGPS is a review-queue source. Ratings below your review threshold enter the CSAT review queue like your other CSAT sources. You can turn the source on or off in the review queue settings.
- Changes in TeamGPS: a rating or comment changed in TeamGPS updates on the next sync. A review deleted in TeamGPS is removed from MSPortal after the next weekly full read.
Syncing
New and changed reviews sync every two hours. A full read of every answered review runs weekly and refreshes the company list. Each page of reviews is saved as it is read, so a sync that is interrupted continues where it stopped. To sync sooner, open the connection’s More actions menu and select Run sync.Manage or troubleshoot the connection
Disconnect… in More actions removes the stored key, your company matches and the TeamGPS ratings in MSPortal. It does not change anything in TeamGPS. To stop MSPortal’s access entirely, also generate a new key in TeamGPS (and give it to any other tool that uses the old one).
To replace the key, for example after a TeamGPS admin generated a new one, open Connect, paste the new key and test it. MSPortal accepts a new key only when it reads the same TeamGPS account as the reviews already synced. To connect a different TeamGPS account, add a new TeamGPS connection.