System

System Architecture

ReviewPilot operates as a fully autonomous pipeline — from review detection to published response — with zero manual effort required.

Automated Pipeline

01

Google OAuth Authentication

You authorise ReviewPilot once via Google's secure OAuth 2.0 flow. We receive a scoped access token limited to your Google Business Profile reviews — no other data is accessible.

02

Hourly Review Polling

Every 60 minutes, ReviewPilot queries the Google Business Profile API for new unanswered reviews. Only reviews without an existing owner response are processed.

03

AI Response Generation

Each review is passed to our LLM engine with your brand voice profile. The model generates a 2–4 sentence response calibrated to your restaurant's tone, rating sentiment, and specific review content.

04

Integrity Filter

Every generated response is checked against a library of generic AI phrases. Responses containing clichés are automatically rejected and regenerated — ensuring every reply sounds authentically human.

05

Deployment or Approval Queue

In Autonomous Mode, responses are posted directly to Google. In Approval Mode, responses are held in your dashboard queue for your sign-off before publishing.

06

Email Notification

After each batch, you receive a digest summarising responses deployed. If Approval Mode is active, you receive an immediate alert with responses awaiting your review.

Technical Stack

Backend

  • FastAPI (Python)
  • PostgreSQL database
  • Render cloud deployment
  • APScheduler (hourly cron)

Integrations

  • Google Business Profile API v1
  • Google OAuth 2.0
  • Groq LLM (Llama 3.3 70B)
  • Lemon Squeezy payments

Security

  • bcrypt password hashing
  • JWT session tokens
  • TLS 1.3 in transit
  • AES-256 at rest

Technical Questions?

For integration enquiries, contact support@tryreviewpilot.com.