Integration
How to connect ats analytics reporting help to a chat widget
How to connect ats analytics reporting help to a chat widget — answered from your own docs. How Applicant Tracking Software teams use Chatref (website widget, k
Connect your existing analytics-reporting help content to a website chat widget by uploading those articles, FAQs, and walkthroughs to a Chatref knowledge base, then dropping the embeddable widget snippet onto your applicant tracking software site. Visitors receive instant answers about reports, dashboards, and metrics – grounded in your own documentation, not generic guesses.
What connects to what
Your applicant tracking software’s help documentation on analytics and reporting (how to build a report, what metrics mean, how to pull a time-to-fill chart) is stored inside a Chatref knowledge base. The chat widget, placed on your ATS site, reads from that same knowledge base. When a user asks a question in the widget, Chatref searches your uploaded content and returns a direct answer that references your own docs – no hallucinations, no fallback to a public search engine.
The widget is the interface; the knowledge base is the brain. They stay connected automatically. Any time you update a document in Chatref – adding a new section about pipeline analytics, for example – the widget’s responses reflect that change immediately. You don’t rebuild anything.
How to set it up
- Sign up for a free Chatref account (no card required) and navigate to the Knowledge Base tab in your dashboard.
- Upload your analytics and reporting help content. Drag in PDFs of your user guides, paste deep links to specific help-center articles, or add plain-text FAQs. For ATS analytics, include:
- How to run standard reports (source effectiveness, EEO dashboards, time‑to‑fill)
- Metric definitions (application‑per‑opening rate, passthrough percentages)
- Troubleshooting: why a report might show zero results or stale data
- How to schedule recurring report emails
- Organize the content with clear titles. Each uploaded file or page becomes a retrievable source. Name them descriptively – “Run a pipeline analytics report,” “Understanding offer‑acceptance metrics” – so the AI can pull answers from the most relevant piece.
- Create your agent in the Agents area. Choose a name (e.g., “ATS Helpbot”), upload a small brand icon, and set the primary color to match your ATS site. Turn on Lead capture if you want to collect visitor details when someone asks a question beyond the widget’s scope.
- Connect the knowledge base to the agent. In the agent’s settings, select the knowledge base you built. The agent will now ground every answer in your own analytics docs.
- Get the widget snippet from the Widget tab. Copy the one‑line embed code.
- Paste the snippet into your applicant tracking software’s website – typically into the global
<body>tag or a site‑wide settings area of your platform (e.g., a CMS footer, a custom HTML block, or a theme configuration panel). The widget loads on every page where the snippet is present. - Allowlist your domain in Chatref’s widget settings. Enter the exact domain where your ATS lives (e.g.,
app.your‑ats.com). This prevents unauthorized embedding and keeps your credit spend secure.
After embedding, test by visiting any page on your ATS site and asking a question that maps to your uploaded content: “How do I view my time‑to‑fill report for the last quarter?”
What users see
A visitor on your ATS site sees a small chat icon in the corner. Clicking it opens the widget with your branding, colors, and agent name. They type a question like “Why is my candidate pipeline report showing no data?” and Chatref answers in a conversational thread, pulling the relevant steps or explanation directly from your uploaded documentation. The answer cites the source document so the user can drill deeper.
Behind the scenes, every conversation appears in the Chatref inbox, tagged with the topic (auto‑suggested as “reports” or “analytics”). If the agent cannot resolve the question, a member of your support team can step into the same thread, see the full history, and reply inline – all without leaving the widget experience. The visitor never knows they moved from AI to human.
For analytics‑specific questions, the widget understands context like “show me the last 30 days” because it reads your uploaded step‑by‑step guides. It does not guess; it pulls the exact procedure you documented.
Troubleshooting
Widget not appearing on the site
- Check that the snippet is placed inside the
<body>tag and not wrapped in a container that is hidden by CSS. Also verify that the domain is allowlisted in Chatref’s widget settings – a mismatch will block the widget from loading.
Answers don’t mention analytics or reporting
- Confirm that your knowledge base contains dedicated analytics/reporting documents. If you uploaded a general ATS help guide that merely mentions reporting in one paragraph, the answer quality will be thin. Upload specific articles – one per major reporting topic – so the retrieval has deep source material to work from. Use the “Playground” in Chatref to test retrieval before going live; it shows exactly which source the agent would use for a given query.
Widget answers feel generic or off‑brand
- Review the agent’s custom instructions, if any, in the agent settings. You can add a brief note like “Always respond in a professional but patient tone and reference the reporting section of the help center”. The knowledge base itself determines accuracy, but the agent instruction can steer voice. Also, make sure the uploaded content uses the same terminology your users see on the ATS platform (e.g., “passthrough rate” instead of “advancement percentage” if that’s the in‑product label).
High credit usage
- Each answer costs 1‑5 coins, depending on response length and retrieval depth. If analytics questions are complex and produce long answers, you may see higher spend. To keep costs aligned, trim overly verbose source documents to concise, question‑friendly steps. The pre‑paid balance never expires; you only pay when the widget delivers answers, so idle periods cost nothing.
User says “I already read that”
- The widget may be returning a document link instead of a direct answer if the knowledge base lacks step‑by‑step instructions. Replace long prose guides with short FAQ entries that each answer a specific question: “How to export a candidate‑source report” as a five‑step numbered list works better than a 2,000‑word overview.
Need a deeper dive on industry‑specific setups? See the full Applicant Tracking Software guide for operational patterns that fit ATS support workflows.
FAQ
What causes ats analytics reporting problems for Applicant Tracking Software?
Most reporting headaches stem from missing or incomplete data pipelines – candidates flowing into the ATS without a source tag, inconsistent job-stage logging, or sync delays between the ATS and external calendars. Users also struggle with report‑filtering logic: a report shows no data because the date range doesn’t overlap with actual application activity, or a permission setting hides certain pipelines. Common pain points include forgetting to mark a job as “active”, which excludes it from pipeline metrics, and not understanding that nested job categories affect roll‑up views.
How do I improve ats analytics reporting for Applicant Tracking Software?
Start by auditing the data that feeds your reports – standardize source‑tracking labels and require recruiters to log stage‑changes in the same way. In the reporting tool itself, create a short, searchable help entry for each core report that explains the exact filters, permissions, and required data fields. Then connect that help content to a widget that sits right where recruiters work; when they hit a reporting wall, they can ask “Why is my pipeline empty?” and get a diagnosis from your own troubleshooting guide. Finally, review the top‑asked reporting questions each month and refine your content – a small investment in documentation clarity pays back in fewer support tickets.
Related guides
Put this into practice
Chatref answers your customers from your own content, day and night. Add it to your site and go live in minutes – free to start.