Google Business Profile Integration

demeterrr syncs Google reviews using a tiered approach depending on your connection status:

The GBP OAuth connection provides the most complete data. Without it, you're limited to the 5 most relevant reviews that Google surfaces publicly. Connecting with OAuth unlocks your complete review history.

Before connecting, ensure you have:

1. A Google Business Profile account with at least one verified business location
2. Owner or Manager access to the GBP account (not just listing access)
3. A Google account that's at least 6 months old (Google's OAuth verification requirement)
4. Locations set up in demeterrr (Settings > Locations) with the Google Place ID configured for each location you want to sync

If your locations don't have Google Place IDs configured yet:

1. Go to Settings > Locations in demeterrr
2. Edit each location
3. Use the place search to find and link your Google business listing
4. The Place ID is automatically saved when you select your business from Google's results

1. Navigate to Settings > Integrations
2. Find the Google Business Profile card
3. Click Connect

This initiates the Google OAuth flow. You'll be redirected to Google to authorize demeterrr.

1. Sign in with the Google account that owns or manages your business listings
2. Review the permissions demeterrr requests (read access to your business reviews and location data)
3. Click Allow to grant access

After authorization, you're redirected back to demeterrr's Google Setup page.

The setup page shows two lists side by side:

• Left: Your Google Business Profile locations (fetched from your GBP account)
• Right: Your demeterrr locations (configured in Settings > Locations)

For each GBP location, select the matching demeterrr location from the dropdown. This mapping tells the sync job which reviews belong to which location.

Important mapping rules:

• Each GBP location can only be mapped to one demeterrr location (no duplicates)
• You don't have to map every location. Unmapped locations are skipped during sync.
• Pre-existing mappings are auto-detected and pre-filled

Click Save Mappings to complete the setup. The system will:

1. Store the location mappings
2. Trigger an initial review sync
3. Show a success confirmation with the number of locations mapped

After setup, verify everything is working:

1. Check Reviews page: Navigate to Reviews and confirm Google reviews are appearing. The first sync happens shortly after setup, then every 4 hours.
2. Verify location attribution: Reviews should be tagged with the correct location name.
3. Check review counts: If you have an existing review history, the first sync should pull in your complete backlog (with GBP OAuth).
4. Test the Reports page: The GBP Metrics section in Reports should start showing data.

For each Google review, demeterrr stores:

• Reviewer name and profile photo URL
• Star rating (1-5)
• Review text (in the original language)
• Review date
• Your reply (if you've already responded on Google)
• Platform identifier (set to "google")

The sync job runs every 4 hours via a cron schedule. It processes all organizations with connected Google locations in a single batch. New reviews appearing between sync cycles will be picked up on the next run.

When new reviews are synced, demeterrr automatically generates a suggested reply using AI. These suggestions appear in the Reviews inbox ready for you to review, edit, and send. The AI considers the star rating, review text, and your brand voice when crafting responses.

The sync job identifies existing reviews by their unique Google review ID. Reviews that have already been imported are skipped, not duplicated. If a reviewer updates their review text or rating on Google, the sync will update the corresponding record in demeterrr.

If no reviews show up after connecting:

1. Check connection status in Settings > Integrations. The Google card should show "Connected".
2. Verify location mapping in the Google Setup page. Unmapped locations are not synced.
3. Confirm Google Place IDs are set on your demeterrr locations (Settings > Locations).
4. Wait for the next sync cycle (up to 4 hours). The initial sync should happen quickly, but subsequent syncs follow the 4-hour cron schedule.

If you see only a handful of reviews instead of your full history, you likely don't have GBP OAuth connected. The public Places API only returns Google's "most relevant" reviews (typically 5). Connect with GBP OAuth to get your complete review history.

If reviews were syncing but stopped:

1. Re-check credentials: Google OAuth tokens can expire if you change your Google password, revoke access, or if Google's security policies flag the connection.
2. Re-authorize: Go to Settings > Integrations, disconnect Google, and reconnect with fresh OAuth authorization.
3. Check location changes: If you added new GBP locations or renamed existing ones, the mappings may need updating.

If reviews are showing up under the wrong location:

1. Go to the Google Setup page
2. Review your location mappings
3. Correct any mismatched pairs
4. Save. The next sync will use the updated mappings.

Google requires OAuth-connected accounts to be at least 6 months old for API access. If you get this error, you'll need to use a different Google account or wait until the account meets the age requirement. In the meantime, reviews will still sync via the Places API (limited to 5 most relevant).

To disconnect the Google integration:

1. Go to Settings > Integrations
2. Click the disconnect option on the Google card
3. Confirm the disconnection

Disconnecting stops future review syncs but does not delete reviews already imported into demeterrr. Your historical review data is preserved.

After disconnecting, reviews will fall back to syncing via the public Places API (5 most relevant reviews only) if your locations still have Google Place IDs configured.

Set up the GBP integration as one of your first steps after creating your demeterrr account. The sooner you connect, the sooner you start building a complete review history for reporting and trend analysis.

Don't skip locations during mapping. Every unmapped location means missed reviews. If you open a new business location, remember to add it to demeterrr (Settings > Locations) and update your GBP mappings.

Check your Reviews inbox daily. Quick responses to Google reviews (especially negative ones) signal to both the reviewer and potential customers that you care about feedback. The AI-generated suggestions make this fast.

The Reports section includes GBP-specific metrics. Monitor your average rating, review volume, and response rate over time. A declining average rating is an early warning signal that deserves investigation.

To learn how to manage synced reviews in demeterrr, see Google Reviews Integration.

For responding to reviews, see Replying to Reviews.

To understand your review metrics, see Reviews Report.