Before you start
- You need permission to manage channel settings in OpenCX to connect or change the connection.
- You need a Google account that owns or manages the business profiles of your locations.
- Google reviews every request for Business Profile API access, which can take a few days. Request it first.
Set up your Google Cloud project
- In Google Cloud, create a project, or pick an existing one.
- Request Business Profile API access for that project. Wait for Google to approve it.
- Once approved, enable these three APIs in the project: My Business Account Management API, My Business Business Information API and Google My Business API.
- Set up the OAuth consent screen for the project.
- Under Credentials, create an OAuth client ID of type Web application. Leave this tab open: the next section gives you the redirect URI to add to it.
Connect in OpenCX
In OpenCX, go to Channels → Location reviews and choose Connect on the Google Maps card. The connection takes three steps.- Connect your Google Business Profile client. Copy the Authorized redirect URI and add it to the OAuth client’s authorized redirect URIs in Google Cloud. Paste the client’s Client ID and Client secret, then choose Save and continue.
- Sign in with Google. Choose Sign in with Google and sign in, in the window that opens, with the account that manages your business profiles. Allow pop-ups for OpenCX if the window does not open. When the window says Connected, close it: the dialog moves on to choosing locations. If signing in fails, the dialog shows why once the window closes.
- Choose locations. Tick the locations whose reviews should open sessions. Each one starts with its name on Google; edit it to the name your team knows the branch by. That name shows on the location’s sessions. Collect reviews from is optional: reviews submitted before that date never open sessions. Choose Save.
What happens after you connect
- OpenCX checks for new reviews every few minutes, and each check looks at reviews from the last two days. When you first connect, those two days are collected; a large backlog arrives over the next few checks rather than all at once. Reviews submitted while the connection is paused or signed out for longer than two days are not collected.
- Reviews that already have a reply from the business on Google Maps are skipped. If a review in the inbox gets answered on Google Maps directly, its session shows the reply published there once OpenCX sees it: on the next check while the review is under two days old, otherwise when someone tries to reply from OpenCX.
- A review with stars but no written feedback still opens a session, so you can thank the reviewer.
- The session’s side panel shows a Google Maps review card with the rating, the location, the reviewer’s name, when it was submitted and whether it is still awaiting its reply. Anonymous reviewers show no name.
- The reviewer’s contact carries the review in custom data, so a workflow can route or tag by it:
The card on Channels → Location reviews lists the connected locations and when OpenCX last
checked for reviews.
Replying
A review takes exactly one public reply from the business, up to 1,000 characters. The composer counts characters against that limit, and once the reply is published the composer locks: Google Maps shows one reply per review, so there is nothing to follow up with. Internal comments still work. Every reply shows publicly under the review on Google Maps, so write it for everyone reading your reviews, not only the reviewer. If Google refuses a reply, the review card says why and the session stays answerable. If OpenCX cannot tell whether Google published the reply, the card shows Not confirmed and the review locks, so it is never answered twice. Check the review on Google Maps, and if the reply is missing, answer it there. If the AI’s reply cannot be published, the session is handed to your team.Let the AI reply
What the AI does with a new review follows the Location Reviews row in AI Autopilot settings. The AI replies card on the channel page shows the current mode and links straight to that row.- Autopilot on: the AI writes and publishes the reply itself.
- Assist mode on: the AI drafts a reply in the session for a teammate to review and send. Assist mode wins when both are on, and it is on by default for Location Reviews, so new reviews get drafts until you turn it off.
- Both off: your team writes every reply.
Pause, switch, or disconnect
- Pause: turn off Open sessions for new reviews on the card. No new sessions open, and reviews already in the inbox stay answerable.
- Change locations: choose Manage connection, then tick or untick locations and rename them. Renaming a location changes only the reviews that arrive after it.
- Switch Google account: choose Manage connection, then Sign in again.
- Change the OAuth client: choose Manage connection, then Sign in again, then Change OAuth client. A new client pauses collection; signing in with it and saving the locations in the same dialog turns it back on. If you close the dialog after signing in, turn on Open sessions for new reviews once the locations are saved.
- Disconnect: deletes the stored credentials and the Google sign-in. New reviews stop opening sessions, and reviews already in the inbox can no longer be replied to.