Skip to content
ConversionIQ Docs

Account – Channels – Review Platforms

Route

Section titled “Route”
  • Path: /account/channels/reviews (TBD)
  • Parent: channels.md

Purpose (business goal)

Section titled “Purpose (business goal)”

Connect and manage review platform sources so reviews can be ingested and responded to through Comment Responder.

User roles & permissions

Section titled “User roles & permissions”
  • Workspace Admin
  • Permissions: channels.connect, comment_responder.manage (TBD)

Reference: Roles & Permissions Model

Layout structure

Section titled “Layout structure”
  • Platform connectors list
  • Location/store mappings (if applicable)
  • Review ingestion status

Components used

Section titled “Components used”

States

Section titled “States”
  • Empty: no review platforms connected
  • Loading: connector + location load
  • Error: auth invalid / provider rate limit
  • Complete: connected platforms + mappings

Business logic (high-level)

Section titled “Business logic (high-level)”
  • Normalize reviews into a unified model.
  • Enforce reply policy via KB/compliance.

Domain refs:

API dependencies

Section titled “API dependencies”
  • GET /channels/review-platforms
  • POST /channels/review-platforms/connect

Enterprise constraints

Section titled “Enterprise constraints”
  • Strict workspace scoping for location mappings

Edge cases

Section titled “Edge cases”
  • Duplicate locations across brands

Security & compliance considerations

Section titled “Security & compliance considerations”
  • Audit connector changes

Reference: Security & Compliance

Analytics events (if applicable)

Section titled “Analytics events (if applicable)”
  • channel.connected

Reference: Analytics Events (MVP)