Guidance for each dashboard module. Browse sections below, or use the support chat for help.
- Review action items in the Locations card
- Connect platforms via Manage Integrations button
- Navigate to specific modules via sidebar
Dashboard
Receive inbound emails as tickets, escalate reviews, manage status, and troubleshoot blank messages or missing deliveries.
- Confirm recipient uses your org slug (slug@inbox.profilepilotapp.com)
- Set Resend webhook URL to your active environment domain + /api/webhooks/resend/inbound
- Send a test email and verify it appears in Open tickets
- Open /blog to view all published resources
- Open a specific article at /blog/[slug]
- Use section anchors in long articles for quick navigation
Dashboard
Create, edit, draft, schedule, and publish blog posts from the admin dashboard.
- Open Dashboard > Admin > Blog CMS
- Create a new draft post
- Add and reorder sections in the section builder
Tools
Use LocalSEO Grid and Competitor Benchmarking together with shared credits.
- Open Dashboard > Competitor Analysis > LocalSEO Grid
- Run a grid scan for the target keyword and area
- Open Dashboard > Competitor Analysis > Competitor Benchmarking
Tools
Interpret radar scores, metric bars, and competitor visibility in context.
- Confirm the selected grid, keyword, and scan date before analysis
- Use Visibility first to identify the dominant local competitor footprint
- Use Rank Score to validate who is winning placement quality
- Search locations by name or store code
- Filter by Google Business account
- Sort by accuracy score to find incomplete profiles
Developer API
Complete reference for pushing, listing, inspecting, and removing your organisation’s canonical store master records (/api/v1/locations) by store_code.
- Confirm Developer API Access and Locations & Reputation are active for the organisation
- Create a key with locations:read and locations:write in Settings → Developer API
- POST up to 100 stores per batch to /api/v1/locations and inspect ok + errors[]
Reports
Per-location table showing impressions, engagement, leads, reputation, and accuracy scores.
- Go to Reports → Locations tab
- Select Period Type: Month and pick the reporting month
- Optionally filter by a specific Google Business account
Reputation
Manage Google Business Profile reviews, track response metrics, and engage with customers from ProfilePilot.
- Filter reviews by star rating and date
- Reply to a Google review using quick responses or custom text
- Generate AI-powered response suggestions
Reputation
Google deprecated the My Business Q&A API; Q&A sync and answering are disabled.
- Review existing Q&A entries for context
- Use review replies to address customer questions instead
- Share deprecation notice with your team
- Run Incremental Reviews 2-3 times for regular updates
- Select an account for targeted incremental sync
- Use Backfill for initial setup or after 30+ day gaps
Reputation
Step-by-step guide for campaign specialists on when and how to sync Google reviews.
- Navigate to Admin > Integrations
- Select account for targeted sync
- Click "Incremental Reviews" button
Bulk Posts
Creating, scheduling, and managing posts across Google Business Profile, Facebook, and Instagram.
- Create a post using the Smart Post Wizard on the Posts list page
- Generate AI copy from a topic brief
- Schedule a post to multiple locations at once
Reports
Overview of all report types and the Combined Report PDF background export system.
- Go to Reports in the left sidebar
- Switch between Executive / Locations / Reputation / Listing Accuracy tabs
- Open Combined Export and choose theme + chapters
Locations
Find duplicate or unmanaged listings across Google and Meta; skips re-scanning the same candidates for 90 days.
- Run a scan for all platforms
- Filter to Google-only or Meta-only
- Open claim links for high-match results
Settings
Profile, integrations, notifications, widget, review perks, team onboarding, and subscription controls.
- Go to Settings in the left sidebar
- Connect Google Business Profile via Integrations
- Connect Meta (Facebook Pages) via Integrations
Settings
Admin-only tools for organization management, response time settings, and sync scope controls.
- Go to Admin → Settings
- Switch the active organization using the org selector
- Set business open and close times
Settings
Manage which campaign specialists have access to which client organizations from a centralized admin dashboard.
- Navigate to Admin > Campaign Specialists
- Find campaign specialist by email
- Click "Assign to Org" to add them to a new organization
Locations
Connect your Bing Places for Business account to sync locations from Google Business Profile.
- Connect Bing Places for Business account
- Enter correct Bing account email during OAuth
- Wait for automatic initial sync to complete
- Create perks link when responding to negative reviews
- Use Shift+Click to customize slug when copying review links
- Follow up with customers who submit emails via perks
Reports
High-level business performance summary with aggregated GBP metrics, AI narrative, review health, and social media overview.
- Go to Reports → Executive tab
- Select Period Type: Month and pick the reporting month
- Optionally filter by a specific Google Business account
Reports
Export Executive Summary, Location Performance, and Reputation Health as a single merged PDF.
- Go to Reports in the left sidebar
- Select an account (or leave blank for all)
- Choose Period Type: Month or Days
Reports
Review sentiment analysis, topic sentiment, staff mentions, trends, unresolved negatives, and response time metrics.
- Go to Reports → Reputation tab
- Select Period Type: Month and pick the reporting month
- Optionally filter by a specific Google Business account
Settings
Admin-only console for sync, diagnostics, invites, pricing, templates, and health checks.
- Run full data sync or incremental reviews
- Set business hours and holidays for SLA math
- Update account sync scope (include/exclude)
Reports
All locations ranked by listing accuracy score with status filtering, top missing fields summary, and CSV export.
- Go to Reports → Listing Accuracy tab
- Set Min Score 0, Max Score 49 to see only critical locations
- Click Run Report
- View your average accuracy score in the Locations report
- Filter the accuracy report by score range (below 50, 50-75, 75-90, 90+)
- Click a location to see its specific missing fields
Reputation
Create customizable response templates with smart filtering and variable substitution.
- Create a 5-star review response template
- Create a 1-2 star review response template
- Add variables to personalize responses
Social
Moderation hub for Facebook and Instagram comments: triage KPIs, Auto-Mod flags, escalate to Smart Inbox, and reply from one feed.
- Open Social Inbox from the dashboard menu
- Change the date range to see older posts
- Filter to a specific Facebook or Instagram page
Social
Understand where to view Facebook and Instagram post engagement and how to create new posts.
- View Facebook and Instagram post engagement in Social Inbox
- Filter posts by platform tab (Facebook / Instagram)
- Adjust the date range to see older post data
- Connect Facebook Pages via Settings → Integrations
- Authorise ProfilePilot to access your pages on the Facebook consent screen
- Refresh pages after connecting to sync all granted location pages
- Go to Billing in the left sidebar
- Add your billing email and company details in Billing Settings
- Add a payment method via Paystack
Billing
Compare monthly and annual plans, understand what each tier includes, and learn how to change your plan.
- Visit profilepilotapp.com/pricing to compare plans
- Contact support to switch from monthly to annual
- Upgrade plan mid-term (annual clients)
Reputation
Automatic detection and escalation of critical reviews requiring immediate attention.
- View all red flag alerts
- Filter alerts by level (Critical/Urgent/Attention)
- Mark an alert as resolved
Reputation
How Review Perks opt-ins become CS cases, how they link to Red Flags, and which surface to close so teams do not triple-resolve.
- Open Reputation → Customer Satisfaction
- Filter Pending Outreach and work the queue
- Investigate then Resolve with optional notes
Tools
Create a search grid around a store, run a scan, then read the map (your rank at each pin) and the competitor list (who else appears on those pins).
- Create a grid named after your Google listing
- Search and select the real store address
- Run a scan and wait until status is success
Settings
Turn on WhatsApp ordering, sync external catalogs, take payments, run the kitchen queue, and send receipts.
- Enable WhatsApp Commerce on Billing or Admin → Organizations
- Connect WhatsApp (create or attach a WABA) and approve Utility templates
- Save kitchen address, VAT, and billing email on the organisation
Settings
Opt-in audiences, approved Marketing templates, paced campaigns, carousels, Flow buttons, and STOP handling.
- Confirm marketing consent on Audience (not implied by orders)
- Create and approve MARKETING templates in WhatsApp Manager
- Sync templates in Marketing → WhatsApp
Settings
Which templates belong on each client WABA, library names for Orders, and why promos must not use Utility.
- On the client WABA, add Utility library templates for Orders
- Create MARKETING templates in Manager for campaigns
- Sync Marketing templates in ProfilePilot
Settings
Send and verify one-time passcodes on your WhatsApp Business number via ProfilePilot’s API for ecommerce login, account recovery, and staff portals.
- Confirm WA Auth is enabled for your organisation
- Connect WhatsApp (client-owned WABA) if not already connected
- Approve Authentication templates in WhatsApp Manager and Sync
Settings
Send email campaigns and newsletters from your own domain to contacts who agreed to hear from you, with deliverability checks, warm-up, and one report per campaign.
- Confirm Email is enabled for your organisation
- Add and verify a sending subdomain on Deliverability → Health
- Import consented contacts on Contacts → Import
Settings
Connect and verify the domain your marketing email sends from: DKIM, SPF, bounce MX, and DMARC records, then Verify.
- Pick a sending subdomain (for example news.yourcompany.com)
- Add it on Email → Health
- Publish 3 DKIM CNAMEs
Reports
How Combined Export works as the document builder, why Template Studio is an admin stub, and step-by-step themes, chapters (incl. WhatsApp / Insights / Marketing), and background PDF jobs.
- Open Reports → Combined Export on desktop
- Confirm organisation and account scope
- Pick Modern or Corporate Ledger theme
Agency
Find step-by-step guides for the agency portal — overview, clients, team, branding, wholesale billing, working in a client org, and offboarding.
- Open /dashboard/agency after login
- Use the header client switcher
- Follow the focused Agency how-to guides
Agency
Sign in to the agency portal, read the overview rollup, and use the header client switcher to work across managed clients.
- Accept invite and sign in
- Open /dashboard/agency and pick a horizon
- Use the header client switcher
Agency
Search and filter your client list, open a client drill-in, provision a new client org, and understand what agency staff can and cannot see.
- Open /dashboard/agency/clients
- Search or filter by status
- Work on this client via the header context
Agency
Invite agency staff, choose Agency Admin vs Agency Staff, set client scope (empty = all clients), deactivate safely, and respect the last-admin rule.
- Open /dashboard/agency/team
- Invite with role and client scope
- Edit scope on an existing member
Agency
Update logos, primary colour, support contacts, presentment currency, and analytics IDs. Connect a sender domain. Domain configuration is read-only for agencies.
- Open /dashboard/agency/branding
- Upload logos and set primary colour
- Save support and email identity fields
Agency
Read invoices, understand Starter–Enterprise per-storefront tiers and the base licence, pay via PayFast, and know what unpaid lock does.
- Open /dashboard/agency/billing
- Check tier and presentment totals
- Pay or regenerate a PayFast link
Agency
Select a client in the header, connect channels correctly, run Reputation / Locations / Social Inbox, and understand free Connect vs paid Insights Platform.
- Select the client in the header first
- Connect Google/Meta only for that client
- Use Reputation, Locations, Social Inbox as entitled
Agency
Platform-admin staged exit on /dashboard/admin/whitelabel/[id]/offboard: initiate grace (≥7d, default 30), disposition each client (transfer or suspend), then complete (cancelled + inactive + pro-rata). Different from unpaid lock. Clients never deleted.
- Open Admin → Whitelabel → agency → Offboarding
- Initiate with grace days (min 7, default 30)
- Disposition every client (transfer or suspend)
Developer API
Complete reference index for the ProfilePilot Developer & Reporting API (/api/v1/*) — authentication, scopes, 500,000 monthly call metering, and per-product endpoint guides.
- Enable Developer API Access under Settings → Usage & Add-ons
- Generate a scoped ppapi_ key in Settings → Developer API
- Monitor your 500,000 monthly call allowance via Settings or X-RateLimit-* headers
Developer API
Pull per-store Google Business Profile impressions, clicks, calls, direction requests, peak footfall days, Facebook/Instagram location metrics, and Local SEO Geo-Grid Share of Voice.
- Grant reports:read scope to your API key in Settings → Developer API
- Call GET /api/v1/reports/locations/metrics with startDate and endDate
- Use stores[].peak_days and per-store metric columns for location BI tables
Developer API
Query reputation KPIs, paginated customer reviews with business-hours response times, scoped Red Flag alerts, and Customer Satisfaction opt-in cases.
- Call GET /api/v1/reports/reputation/summary for star ratings, reply rate %, and BH response time
- Poll GET /api/v1/reputation/reviews?needsResponse=true for actionable unresponded reviews
- Poll GET /api/v1/reputation/red-flags?status=open for unresolved critical alerts
Developer API
Export WhatsApp Commerce orders, normalized SKU line items, paid GMV & fulfilment SLA analytics, metered WhatsApp message usage, Auth OTP challenges, and loyalty balances.
- Grant whatsapp:read scope to your API key
- Sync orders and SKU line items via GET /api/v1/whatsapp/orders and /api/v1/whatsapp/orders/{id}
- Pull GMV, period deltas, and queue SLA via GET /api/v1/whatsapp/reports/finance
Developer API
Export email subscriber counts, deliverability health, broadcast/newsletter campaign metrics, automation workflow enrollments, WhatsApp marketing campaigns, and social posts.
- Grant email:read and marketing:read scopes to your API key
- Pull active eligible contact counts and deliverability via GET /api/v1/email/reports/overview
- Export campaign and workflow performance via /api/v1/email/campaigns and /api/v1/email/workflows
Developer API
Pull Smart Inbox ticket volumes, priority/source breakdowns, and business-hours SLA metrics alongside Facebook & Instagram comment sentiment and actionable response rates.
- Grant inbox:read and social:read scopes to your API key
- Call GET /api/v1/inbox/reports/sla for ticket SLA compliance and business-hours response times
- Call GET /api/v1/social-inbox/reports for Facebook & Instagram comment sentiment and actionable reply rates
Developer API
Export paid media spend and conversions (Google Ads & Meta Ads), GA4 sessions and revenue, Google Search Console performance, and True Attribution outcomes.
- Grant insights:read scope to your API key in Settings → Developer API
- Call GET /api/v1/insights/overview with startDate and endDate
- Combine paid_media, ga4, search_console, and true_attribution in your executive BI models