Before you start
You need two sets of details from SmileBack:- API credentials: in SmileBack, open Account › API Credentials and copy the client ID and client secret. Account administrators and CSAT/NPS managers can open this page.
- An API user: the SmileBack email and password of the user MSPortal signs in as. A user who normally signs in with ConnectWise SSO needs a SmileBack password first: use Reset password on the SmileBack sign-in page to set one.
app.smileback.io) or Europe (app.smileback.eu).
Connect and match companies
1
Enter and test the connection
Open Settings > Integrations, select SmileBack and open Connect. Choose the Region, then enter the Client ID, Client secret, API user email and API user password. Click Test connection. A successful test shows how many reviews the connection can read.
2
Save the connection
Click Save and continue. MSPortal starts reading your reviews in the background. The region cannot be changed after the connection is saved; connect again to use the other region.
3
Match companies
Open Import or match companies. Each company SmileBack names on a review appears here with its review count. Match each one to a company in MSPortal, or import it as a new company. Quick match suggests a 100% match when SmileBack’s company ID is the record ID or identifier of a company already linked to your PSA, and falls back to name similarity otherwise. Review the suggestions before you apply them.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.
How SmileBack ratings appear
- Scale: SmileBack’s three faces map to a 3-point scale: negative is 1, neutral is 2 and positive is 3.
- Companies: a rating appears under a company only after its SmileBack company is matched. Unmatched ratings are kept and attach as soon as you save the match.
- Technicians: a rating credits a technician when the SmileBack agent name matches exactly one technician in your PSA. A name shared by two technicians credits nobody.
- Tickets: ratings link to the PSA ticket when you have one PSA connection. With two active PSA connections, ratings keep the SmileBack ticket number but do not credit a technician.
- Review queue: SmileBack 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 SmileBack: edited ratings update on the next sync. A review deleted in SmileBack, or whose rating is cleared, is removed from MSPortal on the next sync.
Syncing
New and changed reviews sync every two hours. A full read of every review runs weekly and refreshes the company list. 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 credentials, your company matches and the SmileBack ratings in MSPortal. It does not change anything in SmileBack. To stop MSPortal’s access entirely, also change the API user’s password or remove its access in SmileBack.