Skip to main content

Open in AthenaHQ

app.athenahq.ai/settings/integrations

​
Purpose

The Integrations page is where customers connect Athena to the third-party tools they already use: analytics platforms, content management systems, reporting destinations, and Slack. Once connected, those tools feed data into Athena (so AI Search traffic can be attributed, branded search coverage can be tracked, keyword data can sharpen prompts) and let Athena push data back out (publishing content directly into the customer’s CMS, sending scheduled reports to Slack, exposing data through Looker Studio). This page sits inside the Settings area, scoped to the currently selected website for most integrations. A few are organization-wide: most notably the Slack bot, which is an Enterprise-plan feature that operates across the entire org. The Slack reports integration is per-website (each website can be wired to its own Slack workspace and channels). Customers typically land here during onboarding (to wire up GA4, GSC, and their CMS), then return whenever they want to swap an account, fix a broken connection, or add a new destination such as Slack or Looker Studio. It’s also where they go to disconnect an integration when rotating credentials or off-boarding a team.

​
What’s on the page

The page is split into five labelled sections. Each section header has a short tagline that explains the value of the integrations underneath it. Inside each section is a grid of tiles: one tile per integration.

​
Measure & Attribute

Tagline: “Analytics sourced directly from search for Olympus and Traffic.”
  • Google Analytics 4. “Attribute AI Search traffic, revenue, and conversions.” When connected, the tile shows the selected GA4 property name and a description like example.com · Property ID: 12345. When not connected, the description reads “Connect to begin attributing AI Search performance.”
  • Google Search Console. “Monitor branded search impressions and clicks.” When connected, the tile shows the active property URL and “Switch properties anytime from Manage.” When not connected: “Connect to surface which prompts trigger branded search coverage.”
  • Google Ads. “Keyword data for smarter prompt generation.” When connected, shows the selected customer (account) name and Customer ID. When not connected: “Connect to use keyword data for smarter prompt generation.”

​
Create & Publish

Tagline: “Publish content and capture share-of-voice improvements faster.”
  • Shopify. “Publish content to your blog and attribute revenue.” When connected, shows the store name plus its primary domain and a “Last verified” date. Otherwise: “Connect to publish AI Search-ready content directly to Shopify.”
  • Webflow. “Sync CMS collections and publish content.” Connected tile shows the Webflow site name, its domain, and last verified date. Otherwise: “Connect to sync collections and publish content straight from Action Center.”
  • Wix. “Publish blog posts and drafts to your Wix site.” Connected tile shows the Wix display name and last verified date. Otherwise: “Connect to publish and update blog posts on Wix.”
  • Framer. “Publish content to your Framer CMS collections.” Connected tile shows the project name and last verified date. Otherwise: “Connect to publish content directly to your Framer site.”
  • WordPress. “Publish and update blog posts on WordPress.” Connected tile shows the site name, URL, and last verified date. Otherwise: “Connect to publish and update blog posts on WordPress.”
  • Payload CMS. “Publish content to any self-hosted Payload instance.” Connected tile shows the API URL and last verified date. Otherwise: “Connect to publish content to any Payload CMS instance.”

​
Monitor & Visualize

Tagline: “Custom dashboards and reports for AI Search performance.”

​
Reports

Tagline: “Per website. Deliver reports to Slack channels and DMs.”
  • Slack reports. “Send weekly reports to Slack channels and direct messages.” Scoped to the current website.

​
Organization

Tagline: “Org-wide. Enterprise plans only.”
  • Slack bot. “Answer customer product questions in your Slack channels.” Org-wide; Enterprise plans only.

​
What each tile shows

Every tile displays:
  • A logo or icon
  • The integration title
  • A one-line outcome statement
  • A status dot (green = connected, orange = error loading, grey = not connected, pulsing = loading)
  • A “Beta” badge on integrations marked as beta
  • A status label and description that update based on connection state (e.g., the selected property name, last sync date, or a prompt to connect)
  • If the user is a viewer, a footer note that says “You need editor access to manage integrations.”
When a status fetch fails, the tile shows an orange dot and an inline error such as “We couldn’t load your Google Analytics status.” (or “Couldn’t load status” as a generic fallback).

​
What you can do here

Open an integration’s management panel. Click any tile (except those disabled for viewers) to open a side drawer with the full connection workflow and details for that integration. The drawer is the only place where actual connect, disconnect, switch, and sync actions live: the tiles themselves do not have any other buttons. Deep-link to a specific panel. Loading the URL with ?provider=<id> (for example ?provider=ga4, ?provider=shopify, ?provider=slack-bot) opens that integration’s drawer automatically. The same deep link can be shared with teammates. Closing the drawer removes the query parameter from the URL. Inside each drawer the available actions depend on which integration it is: Google Analytics 4 drawer
  • Connect Google Analytics: launches Google OAuth in a popup.
  • Switch property: searchable dropdown of all properties on the connected Google account. Selecting one auto-applies it (no separate Save button).
  • Refresh properties (icon in the drawer header): re-fetches the property list from Google.
  • Open Google Analytics (icon in the drawer header, connected only): opens the GA4 property in a new tab.
  • Disconnect (left side of drawer footer): two-step: clicking shows a “Confirm disconnect” button next to a Cancel button.
Google Search Console drawer
  • Connect Search Console. Google OAuth popup.
  • Open GSC: opens search.google.com/search-console in a new tab.
  • Switch site: searchable dropdown; the active property is highlighted with “(selected)” if it’s not in the freshly-fetched list.
  • Refresh sites: re-fetches sites from Google.
  • Open Search Console (drawer header icon): opens the connected property in a new tab.
  • Disconnect: two-step confirmation.
Google Ads drawer
  • Connect Google Ads. Google OAuth popup.
  • Switch account: searchable dropdown of customers (manager accounts are flagged).
  • Refresh accounts: re-fetches from Google.
  • Open Google Ads (drawer header icon): opens the linked Ads account in a new tab.
  • Disconnect: two-step confirmation.
Shopify drawer Has tabs across the top: Connect (recommended Dev Dashboard method) and Legacy (existing custom-app token method). A “Quick Connect” tab exists in code but is hidden until Shopify approves Athena’s public app.
  • Connect (Dev Dashboard): fields for shop domain, Client ID, Client Secret; a collapsible “Step-by-step instructions” panel explains how to create the Shopify app.
  • Save Token (Legacy): fields for shop domain and Admin API access token. Includes a warning that legacy custom apps can only be used if they were created before Jan 1, 2026.
  • Default Blog (connected): dropdown to pick which Shopify blog new content publishes to.
  • Refresh store data (header icon): re-fetches blogs and metadata.
  • Disconnect: two-step confirmation.
  • Connected tile shows a small “Dev Dashboard” or “Legacy” badge depending on the auth method. If the connected token is missing required scopes (read_content, write_content, read_orders), an orange “Missing scopes” message is shown.
Webflow drawer Two-step flow:
  1. Verify token: paste the Webflow API token; the system validates it and fetches available sites. A collapsible “How to generate the Webflow API token” guide is included.
  2. Save connection: select a site from the dropdown and save. (Required scopes: Sites read, CMS read & write.)
  • Sync collections (header icon, connected only): re-fetches CMS collections and fields.
  • Open Webflow Dashboard (header icon): opens webflow.com/dashboard.
  • Disconnect: two-step confirmation.
  • Connected drawer lists each Webflow CMS collection as a collapsible row showing field counts and field details.
Wix drawer
  • Site ID, API key, Publish as (member) fields.
  • Load site members: calls Wix to populate the “Publish as” dropdown. Required before connecting.
  • Refresh members: re-fetches the member list.
  • Connect Wix: saves credentials after validation.
  • Edit settings (connected state): switches the drawer back to an edit form to rotate the API key, change site, or change the publishing member. Save changes / Cancel control the edit flow.
  • Sync (header icon, connected only): syncs Wix categories and recent drafts.
  • Disconnect: two-step confirmation.
  • Connected drawer shows site details, recent categories with post counts, and recent draft titles.
Framer drawer Two-step flow:
  1. Verify connection: paste the project URL (or project ID) and API key; the system validates them.
  2. Save connection: persists the credentials.
  • Sync collections (header icon, connected only).
  • Open in Framer (header icon, connected only): opens the Framer project URL.
  • Disconnect: two-step confirmation.
  • Connected drawer lists Framer collections and their fields.
WordPress drawer
  • Site URL input + Detect connection method button.
  • After detection, the drawer either:
    • Shows app-password fields (Username, Application password) for self-hosted WordPress, followed by Back / Connect buttons; or
    • Shows a Connect with OAuth button for WordPress.com / Jetpack sites (with a Back button to change the URL). If the server isn’t configured for OAuth, an amber warning lists the missing configuration.
  • Sync (header icon, connected only).
  • Disconnect: two-step confirmation.
  • Connected drawer shows site name, URL, post count, recent categories, and an auth-method badge (“App password” or “OAuth”).
Payload CMS drawer Two-step flow:
  1. Verify connection: paste the Payload server URL (just the host, no /admin or /api suffix) and API key; the system validates them. Includes a collapsible “How to get your Payload API key” guide.
  2. Save connection.
  • The API key field has a show/hide eye toggle. A collapsible setup guide explains how to enable API keys on a Payload Users collection.
  • Sync collections (header icon, connected only).
  • Disconnect: two-step confirmation.
  • Connected drawer lists publishable collections (with read, create, update permission badges) and system collections.
Looker Studio drawer
  • Read-only setup-guide drawer. No connect or disconnect actions: it only contains step-by-step instructions for configuring the Looker Studio connector with an Athena API key.
Slack reports drawer
  • Connect Slack (not connected): redirects to Slack OAuth for the current website.
  • Disconnect (connected): two-step confirmation that removes the workspace connection.
  • Shows the connected Slack workspace name and the date it was connected.
Slack bot drawer (Enterprise only, org-wide)
  • Connect Slack: initiates Slack workspace install for the active organization.
  • Disconnect: opens a confirmation dialog: “Disconnect Slack workspace? Athena will stop posting to Slack. Your saved channel list and per-channel settings are kept and restored if you reconnect.” Saved channels survive disconnects.
  • Add channels: multi-select picker of available Slack channels (private channels Athena hasn’t been invited to don’t appear). Selecting public channels auto-joins them; the bulk-add shows live progress (“Adding 3 of 12…”). Errors are surfaced inline (e.g., “Couldn’t auto-join 2 channel(s). Invite @Athena from Slack.”).
  • Add by channel ID: collapsible manual entry for Slack Connect / shared channels, where the user pastes a raw channel ID (e.g., C01ABCD2EFG) and optional notes.
  • Enable / Disable toggle (per tracked channel): turns Athena’s responses in that channel on or off without removing it.
  • Remove (per tracked channel): un-tracks the channel. Does not remove the bot from Slack itself: the user must run /kick @Athena in Slack to fully remove it.
  • Non-Enterprise organizations see an “Available on Enterprise plans” message even if they reach the drawer.
Page-level error recovery If the page itself fails to render, an error card appears with Try again (reload the failed boundary) and Reload (full page reload). When available, an Error ID is shown to share with support.

​
Data shown

Everything on this page is derived from per-website integration status. For each integration tile, Athena queries that integration’s status endpoint to determine whether it is connected, what account/site/property is selected, when it was last verified, and whether any required scopes are missing. The Slack bot tile additionally pulls organization-wide workspace status. Account lists (GA4 properties, GSC sites, Google Ads customers, Wix members, Webflow sites) are fetched live from the respective provider when their drawer is opened, not cached aggressively, so the most recent state is always shown.

​
Common workflows

  1. Connect Google Analytics 4
    1. Click the Google Analytics 4 tile.
    2. Click Connect Google Analytics and complete the Google OAuth popup.
    3. If multiple properties exist, pick one from the dropdown (a single property is auto-selected).
    4. The tile updates to a green dot with the property name.
  2. Connect a CMS (Webflow example)
    1. Click the Webflow tile.
    2. Paste the Webflow API token and click Verify token.
    3. Pick the target site from the dropdown and click Save connection.
    4. The tile shows a green dot with the site name.
  3. Disconnect an integration
    1. Click the tile.
    2. Click Disconnect in the drawer footer.
    3. Click Confirm disconnect.
    4. The tile reverts to a grey dot.
  4. Set up Slack reports for a website
    1. Click the Slack reports tile.
    2. Click Connect Slack and complete the Slack OAuth flow.
    3. Return to the panel; the connected workspace name appears.
    4. Configure individual recipients in the Reports area of the app.
  5. Deep-link straight to a panel
    1. Send or open a URL like /settings/integrations?provider=ga4.
    2. The matching drawer opens on page load.
    3. Close the drawer; the URL resets to /settings/integrations.

​
Empty, loading, and error states

  • No website selected: the page shows the message “Select a website to manage integrations.”
  • Website still loading: a skeleton grid of tile placeholders is rendered.
  • Individual integration error: that tile shows an orange status dot and a one-line error such as “We couldn’t load your Google Analytics status.” The tile remains clickable so the user can open the drawer and retry. If no specific message is available, the tile shows the fallback “Couldn’t load status.”
  • Whole page error: an error card appears with the title “Something went wrong”, body text “The Integrations page failed to load. You can try again. If the problem persists, please contact support.”, Try again and Reload buttons, and an Error ID for support.
Linked from
  • The Settings navigation sidebar (Integrations item)
  • The Settings breadcrumb in the page header (Settings ▸ Integrations)
  • Any link or share that uses the ?provider=<id> deep-link pattern
Links to (opens in a new tab unless noted)
  • Google Analytics: analytics.google.com (the connected GA4 property)
  • Google Search Console: search.google.com/search-console
  • Google Ads: ads.google.com
  • Webflow dashboard: webflow.com/dashboard
  • The connected Framer project URL
  • Shopify Dev Dashboard: dev.shopify.com
  • Slack app management: slack.com/apps/manage
  • Athena Looker Studio docs: docs.athenahq.ai/api-reference/looker-studio
  • Provider help docs: GA4, GSC, Google Ads, Webflow, Framer, Payload, Wix, WordPress, Shopify
  • Wix API keys page: manage.wix.com/account/api-keys

​
Common support questions

“Why can’t I click any of the buttons on this page?” You likely have a viewer role on this website. Viewers can see every integration tile but cannot open the management drawers or take any action. The tile footer shows the message “You need editor access to manage integrations.” An admin on the website needs to upgrade your role. “Why is the Slack bot tile telling me Enterprise only?” The Slack bot is an Enterprise-plan feature and is org-wide. Customers on Lite, Growth, or other plans can see the tile but the drawer will surface an “Available on Enterprise plans” message. The separate “Slack reports” tile is not restricted by plan and is per-website. “I disconnected the Slack bot from a channel but Athena is still in our Slack workspace.” Removing a channel from Athena’s tracked list only stops Athena from responding there: it does not kick the bot out of Slack. To fully remove the bot from a channel, run /kick @Athena in Slack. To uninstall it from the entire workspace, use the Slack workspace’s app management page. “My GA4 / GSC / Google Ads tile has an orange dot.” That means Athena couldn’t load the integration’s status: usually a temporary issue with the provider’s API or a revoked OAuth token. Click the tile to open the drawer and try refreshing the account list, or disconnect and reconnect. “Why can’t I find the Quick Connect option for Shopify?” It’s intentionally hidden. The Shopify drawer currently only exposes the Connect (Dev Dashboard) and Legacy (existing custom-app token) methods. The one-click Quick Connect path will appear once Shopify approves Athena’s public app. “Wix says my Member ID is invalid.” Wix requires a real Member ID, not a Contact ID. Click Load site members first to populate the “Publish as” dropdown, then pick the member from the list: don’t paste an ID from the Contacts URL. If you pasted a Contact ID, Athena will tell you which member it corresponds to so you can pick the right one. “How do I share a link straight to a specific integration?” Append ?provider=<id> to the page URL: for example /settings/integrations?provider=webflow. The matching drawer opens automatically on load. The provider IDs match the tile names (ga4, gsc, google-ads, shopify, webflow, wix, framer, wordpress, payload, slack-reports, slack-bot).