CitadexDocs

AI Assistant: answers from your own data, actions you confirm

The AI Assistant is the main screen of Citadex: you land in a chat after signing in. It reads your account’s real data, tells you what to click next, prepares actions that run only after you confirm, searches the Help Center, contacts support and walks you through Revenue Attribution connections.

AI Assistant & API19 min read

What the AI Assistant is

The AI Assistant is a chat panel built into Citadex. It reads the real data in your current project (visibility, prompts, competitors, citation sources, AI traffic, revenue attribution and more) to answer questions, and tells you the exact page and button to use. It is made for questions like "what does this page mean", "how did we do this week" and "what should I do first".

You land in a chat

  1. After signing in you are in the AI Assistant's chat: the sidebar on the left, the question box in the middle, common requests and My plan (the tasks Citadex found plus the ones you saved with Add to plan under an answer, split into To do and Done; click the circle to mark one done) below it. If the account has no project yet, New project opens first.
  2. Click a page in the sidebar (Dashboard, Prompt Tracking, Citation Sources…) and the full page opens next to the sidebar, which stays; New chat or a recent chat brings the chat back. A link straight to a page (a bookmark, a link in an email) opens it the same way, next to the sidebar. A reload brings you back to what you were looking at.
  3. The assistant knows the page you are on and answers with it in mind; Ask AI on a page goes back to the chat and sends the question.

The AI Assistant: the sidebar (New chat, Results library, common pages, projects, recent chats) on the left, the question box and My plan in the middle

The AI Assistant: the sidebar (New chat, Results library, common pages, projects, recent chats) on the left, the question box and My plan in the middle

What to ask

A new chat starts with suggested questions for the page you are on; click one to ask it. Typical questions:

  • What does this page mean? What should I do first?
  • How did my brand do in AI answers this week?
  • Which prompts mention competitors but not me?
  • Which sites does AI cite most? Where should I get mentioned?
  • Why do pages get cited by AI but bring no visits?
  • Why doesn’t ChatGPT recommend us in the US (optionally for one product or category, e.g. perfume)?
  • Why did AI revenue change? Why don’t AI visits turn into orders?
  • Which prompts bring us orders? Which pages does AI read but not cite?
  • How do I add a new market (country and language)?

For these “why” questions the assistant checks your project’s data step by step and answers with specific numbers; when there is not enough data it says what is missing and how to add it. Once a revenue source or crawler logs are connected, the suggested questions on the chat home screen show these first. On Revenue Attribution and AI Traffic, a Why? button sits next to a clear revenue change and on rows with visits but no orders or pages read but not cited; it asks the assistant with the numbers on screen.

Under each answer, Data: labels show which data was read (for example AI visibility, Citation sources, AI traffic, Revenue attribution, This week’s tasks). You could also ask lists follow-up questions.

Answers come from your own data

  • The assistant only uses your account’s data and reads it before it states any number, prompt or competitor.
  • If something has no data yet (no scan yet, AI traffic not connected), it says so and tells you what produces it.
  • It never states credit amounts or prices; it links you to the credits or pricing page instead.

Actions: prepared first, run after you confirm

You can ask the assistant to do things, such as "Re-check my 5 weakest prompts" or "Make the edit checklists for this week’s pages". Nothing runs straight away. Under the answer you get a Confirm these actions card:

  1. 1

    Read each line

    Each line says what will happen, for example "Re-check n prompt(s)", "Write an article draft", "Track n new prompt(s)", "Make the edit checklist" or "Mark a page as updated and start a re-test", tagged Uses credits or Free. Adding prompts itself costs nothing, but the balance must cover their first check, or they are not added.

  2. 2

    Tick what you want

    Untick anything you don’t want.

  3. 3

    Click Confirm

    Nothing starts until you click Confirm. Click Cancel to drop it.

  4. 4

    Check the result

    The card becomes What was done, with a View link to the right page (Prompt Tracking, Content, Retests…).

Credit-using actions cost exactly what the same button costs in the app and are refunded if they fail. If your balance is too low, that action is left out of the card and the assistant tells you why and where to top up. The assistant never publishes articles, pays, or changes account or billing settings; you do those on the page itself. Viewers in a workspace cannot run actions.

What the assistant can do for you

All of it as a card you confirm first:

  • Prompts: add (straight into a group, and optionally check them right away), re-check, pause or resume, delete (to the recycle bin, restorable for 30 days), change how often they're scanned (daily / weekly / monthly), sort into groups, move to a group.
  • Competitors and markets: add or remove competitors, add a market (country and language).
  • Reports: the results report for this month, last month or the last 30 days, with a share link.
  • Content and pages: article drafts, edit checklists, which page answers which prompt, marking a page as updated and starting a re-test.

Chat mode: the app opens in a chat

  • Citadex opens in Chat mode, like a chat app: Dashboard opens the chat, and a link to another page shows that page next to the sidebar.
  • On the left is one sidebar: New chat, Results library (reports, articles and lists the assistant made; before there are any, it says what it collects, with Have the assistant make the first one and three ready requests: write an article, make a report, set a goal), then your common pages (Dashboard, Prompt Tracking, Citation Sources and Competitors by default); other pages and Weekly are under More. Edit sidebar… at the bottom of More picks which pages stay outside. Below are Projects (click to switch, + for a new project; hover a project and click the trash icon to delete it, after typing its name) and Recent chats; the account menu is at the bottom: your plan badge (Agency for agencies), then settings, billing & plans or the agency subscription, team & roles, invite friends (white label for agencies), contact support, language and sign out. The sidebar can be hidden; on a phone, open it from the top left.
  • A new chat shows "What should we move forward today?" and a large question box. The grey text in the box cycles through a few example questions; once you type, the bottom left says Enter to send · Shift / Option + Enter for a new line (Alt on Windows), and while an answer is coming the send button becomes a square you can click to stop. The ready-made requests are under the + at the bottom left of the box. Under the box, 📁 project name opens a list to switch project or make a new one, and next to it is Connect apps.
  • Below the box is a row of common requests: click one to put it in the box, edit it and send; the row turns over by itself every few seconds (it pauses while your pointer is on it), and the button at the end (Show others) shows the next ones at once. Every set includes one traffic or revenue request, such as how many visits AI sends, which AI crawlers visit your site, or how much revenue AI brings. Then Before your project starts lists four things for the current project: add prompts (your own, not the ones made when the project was created), configure competitors (at least one on the competitor list), fill in Brand Knowledge (at least one source processed) and Market health & repair (at least one platform marked with progress). Add prompts opens the same Add prompts dialog as Prompt tracking right there, Configure competitors opens the competitor list and Fill in Brand Knowledge opens the Knowledge base tab of Brand info check right there; the others open their page; once all four are done the card no longer shows, and viewers don't see it. Last is My plan: the tasks Citadex found (tagged by type) and your own (saved with Add to plan under an answer, or typed into the box at the bottom), split into To do and Done. Click the circle to mark a task done or not done; click a task and the assistant takes it over; Evidence / Open shows its page on the right; × deletes one of your own.
  • The sidebar's navigation (pinned pages, pages under More, notifications, new project, the account menu) opens the full page next to the sidebar, and the sidebar stays as it is; New chat, a recent chat, Results library, the getting-started guide or Weekly bring the chat back. On a phone the page has a bar at the top whose left button opens the sidebar. Links in answers, Evidence and finished results open in a panel on the right, so you don't leave the chat; when a page in the panel opens a dialog, the dialog appears in the middle of the whole window. The panel holds several tabs; drag its edge to resize and click ✕ to hide it. Once hidden, the top shows the number of tabs; click it to bring the panel back. The ↗ Open full page button at the right of the tabs opens that page in the chat's place, and the sidebar stays.
  • For agencies, the getting-started guide is the first chat under Recent, Getting started, with its progress. The assistant walks you through each step: why, how, when it counts as done, and Take me to … opens that page on the right with the part to use ringed. When a step is done it says so in that chat and gives the next one. All steps at the top jumps to any step; ask questions right below.
  • With a chat open, its title (the first sentence of your first question) is at the top; click it to Rename or Delete chat.
  • On a phone the right-hand panel opens full screen; Back to chat returns to the conversation.
  • A page in the right-hand panel shows its tabs on the left of the bar across the top (the ones that don't fit under More ▾), or the project name on a page without tabs; the less-used buttons are under ⋯. Opened full-page, the bar shows "project / page" and all its buttons.

Connect apps: every connection in one place

  • In Chat mode, Connect apps under the question box, next to the project name, lists everything this project can connect: Search and analytics (Google, Bing IndexNow), AI traffic (Site tracking snippet, Cloudflare, Vercel, WordPress crawler plugin, Next.js · Netlify · other servers), Revenue attribution (HubSpot CRM, Salesforce, Stripe, Shopify orders, WooCommerce, Webhook / API), Publishing (Citadex Publisher extension, WordPress, Ghost, HubSpot CMS, GitHub, Shopify blog, Webflow, Wix, Zapier · Make · n8n, Hosted blog, Content API / RSS), and Alerts and AI tools (Slack, API & MCP), and AI models (your own API keys for OpenAI, Anthropic, Google Gemini, Perplexity, xAI and Qwen: they apply to every project you own, and checks on a model with your key use no credits).
  • Connected ones are at the top, and the button shows their logos and count; search at the top. Not finished means it is filled in but not tested yet, still waiting for its first data, or its domain is still verifying.
  • Click any of them to open its details: on the left, what it reads and where it is used; on the right, its own settings (connect, disconnect, pick a site or property, copy a snippet…), the same ones as on its page. Open the full page goes to that page.
  • Google is one connection: Search Console and GA4 share one authorization, and disconnecting removes both. Every plan can connect it; the workspace owner authorizes.
  • Publishing channels need a plan with one-click publishing. The cards on the Integrations page open the same details window, and so do the chips in the Data from line on AI Traffic and the Revenue from line on Revenue Attribution, right on that page.
  • When an answer needs data from something not connected yet (asking how much revenue AI brings with no store or CRM connected, for example), the assistant adds a Connect accounts card under its answer: one row per connection with Connect (the same details window) and the progress n / m; once connected, click Continue and the assistant answers the question again.

WordPress plugin: connect in one click

A WordPress site can run the Citadex plugin: download citadex.zip from Integrations → WordPress crawler plugin, install it in WordPress under Plugins → Add New → Upload Plugin and activate it, then open Settings → Citadex, click Connect to Citadex, sign in and pick this site's project. It connects on its own; there is no key to copy. Each feature has its own switch: report AI crawler visits to Citadex, add the Citadex site script (visitors from AI answers and the sales they lead to), serve the AI-optimized versions you switched on in Citadex to AI crawlers, and mark WooCommerce orders placed by AI agents (beta). A small card on the WordPress dashboard shows the share of AI answers mentioning you, AI crawler visits and AI visitors over 30 days. Everything works on a free account. Connected sites are listed under the WordPress download button.

HubSpot: AI source on records, the record card and Breeze agents

After connecting HubSpot by signing in (Integrations → HubSpot CRM), turn on Write AI source back to HubSpot. Citadex creates a "Citadex AI attribution" property group and writes each contact's first AI engine, first AI visit, AI visits, landing page and evidence grade, and each deal's AI revenue type, AI engine and the amount credited to AI. It writes after every sync (every 30 minutes) and only records that changed, so sales see it on the record and HubSpot reports can group by these fields. Allow the write permissions when asked; with a private-app token, add the write scopes to the private app.

With the Citadex app installed in HubSpot, contact and deal records show a "Citadex AI source" card: whether the record came from an AI answer, which engine, when and on which page, and for deals the amount credited to AI with its evidence grade. Breeze agents can add the Citadex tools to ask about AI visibility, run a diagnosis (why AI does not recommend us, why a competitor is ahead), and see AI revenue and a record's AI source. These tools only read and never spend credits. Data shows only when the HubSpot user's email can see the project in Citadex (owner or team member).

Memory: what the assistant keeps from you

Next to Connect apps under the question box is Memory, with how many things the assistant remembers for this project. It only keeps what you confirmed: say "Remember: we never say 'cheapest'" in the chat and a Remember card asks you first; or click Memory and add it yourself. There are three layers: the brand (shared by the workspace: names, what it sells, what never to say), the project (focus markets and engines, goals) and just you (for example, conclusion first). Suggestions you turned down in the weekly plan or updates are kept for 60 days so they are not suggested again. AI answers, web pages and passwords are never remembered. Click Memory to edit or delete anything; viewers can only change their own layer.

What you finish in Citadex (a weekly task marked done, a My plan task ticked, an approved fix, a published article, a re-test) is checked automatically about three weeks later: how AI recommends you before and after. Clear results are kept in the project's memory under What you did and how it went (you can delete them, not edit them), and with Assistant follow-ups on, the assistant tells you in the chat. Later suggestions build on them: what worked is suggested again, what did not is replaced with a different approach, and weekly tasks show the last result for the same prompt. It is a before/after comparison, not proof that this one change caused it. You can also ask the assistant "Did what we did work?".

Command library: common questions and actions

A new chat opens with a command library by scene: Popular, This page, Get started, Organize, Competitors, Content, Reports, Account. Each one says what it does and whether it's Free, Uses credits or Q&A; one click sends it. "This page" holds questions about the page you're on.

Several steps in one sentence

You can ask for several things at once, e.g. "the China market has too few prompts: add 20, check them, then make the monthly report". The assistant reads your data, explains why, and puts the steps in one card that you confirm together. A step that waits for checks (like "make the report when the checks finish") shows "Runs once the checks finish" after you confirm; it completes on its own and you get a notification in the bell.

History

  • Earlier chats are under Recent in the left sidebar; click one to continue it.
  • Hover a chat and click the trash icon to Delete it.
  • Click New chat at the top of the sidebar to start a new one.
  • Your weekly plan also arrives under Recent as a chat; a red dot marks it while unread.
  • With Automations → Weekly topics on, every Monday at 9:00 you get a topics report: up to 10 questions buyers are discussing in public, each with evidence links (Reddit threads, articles or research) and marked asked directly or inferred from discussions. The chat shows the top 3; See all opens the full report and past weeks. Each topic has Track it and Add to plan. An email comes too (switch it off in the same window). A few credits are charged, at the research's real cost and only when topics were found; they show under AI Assistant in your credit history.
  • With Automations → Ad watch on, when the ChatGPT ads next to your prompts change (a competitor starts advertising, a new advertiser appears, your own ads disappear), the assistant explains it in the chat with the next step, and the bell rings. The full view is Revenue attribution → AI ads.
  • What the assistant did for you (confirmed actions and their results) is in Results library in the sidebar.
  • Switch to Action log to see everything the AI Assistant has done: what, when, in which project and who confirmed it; finished ones have View to open the result. A project owner also sees what team members did through the assistant.

Help Center and support

  • For "how do I" and "where is" questions, the assistant answers from its built-in app guide; when that doesn’t cover it, it searches the Help Center, answers from the article and links it.
  • Contact support at the top opens the support form, which reaches a person. Use it for bugs, payment problems, or anything the assistant couldn’t solve.

Guided setup for Revenue Attribution

Open any revenue source on Integrations (HubSpot CRM, Salesforce, Stripe, Shopify orders, WooCommerce, Webhook / API, ChatGPT Ads…) and its dialog has two items:

  • Step-by-step expands the full click path.
  • Guided setup with the AI Assistant opens the assistant with the question already asked. It tells you where to click in the other tool, what to choose and what to copy back, and reminds you to install the site script first so revenue can be matched to AI visits.

For a Shopify store, the easiest way is the Citadex Shopify app: in Integrations → Shopify orders, enter the store address (your-store.myshopify.com), click Install the Citadex app and approve it in Shopify. There is no webhook or secret to copy. Paid orders then flow into Revenue Attribution (the last 60 days are read once), and products stay up to date daily and whenever you edit them. The assistant tells you which facts AI brings up when it recommends products like yours (price, material, size, warranty, returns, certifications, origin, who it is for, ratings and more), which of them your product pages leave out and on which products, and which competitors AI credits with them. You can also ask the assistant "What is missing from my product info?". Removing the app in Shopify disconnects it.

Agent-placed orders (Beta): when an AI agent (for example ChatGPT's agent mode) shops your store for someone, Citadex can count those orders on their own. In the Shopify orders dialog, click Set up next to Agent-placed orders (Beta) and deploy the generated code as a Cloudflare Worker with a route for your store's domain; the store needs the Citadex site script. Visits by signed AI agents are then counted there, and their orders appear under Agent-placed in Overview → AI revenue · six types. The signature shows which company runs the agent, not whom it shopped for, so this revenue is graded Likely and marked Beta. The assistant tells you in the chat when the first agent-placed order arrives.

Use Citadex in ChatGPT / Claude

Use Citadex in ChatGPT / Claude at the bottom of the question box's + menu starts a step-by-step walkthrough and suggests questions to ask once connected. See "Use Citadex in ChatGPT and Claude (API & MCP)".

FAQ

Does chatting with the assistant use credits? Yes. Each answer uses credits for the model work it actually took, and a failed answer is free. Every charge is listed under AI Assistant in your credit history; there is no prompt before each answer. Scans, articles and other actions still wait for you to click Confirm. When you run out of credits the assistant pauses until you top up.

Is there a question limit? Yes, a daily one. When you reach it you see "You’ve reached today’s question limit. Come back tomorrow."

Which language does it answer in? Your interface language. Prompts and brand names stay as they are.

I don’t see the AI Assistant button. If you use a client account from an agency, the agency may not have turned it on for you.

Was this article helpful?