{"versionId":"f6ddf71d-5906-4ba3-19a6-08de2ad71e6a","articleId":"a42b7aa5-41f1-4628-84af-08de1cbee49d","title":"Assistant answers: URL scanning ","tags":["GPT","All articles"],"content":"<html><head></head><body><p>URL scanning allows you to automatically discover and index content from websites by simply providing a list of starting URLs.&nbsp;</p>\n<p>For example, if you paste in&nbsp;<a href=\"https://theta.co.nz/\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz</a>&nbsp;the system will:</p>\n<ol>\n<li>Scan that page for content</li>\n<li>Find all links on that page</li>\n<li>Follow those links (if they're on the same website)</li>\n<li>Continue this process to build a comprehensive knowledge base, which can then be used by your chatbot's <a href=\"https://help.helpfruit.com/article/assistant-answers\" target=\"_blank\" rel=\"noopener\">AI assistant</a> to help answer user questions.</li>\n</ol>\n<div class=\"mce-toc\">\n<h2>In this article</h2>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m3n\">How it works</a>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m3o\">Starting the scan</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m3p\">Automatic content discovery</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1j9b6f0m5m3q\">What gets included vs excluded</a>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m3r\">✅ Pages that get scanned</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m3s\">❌ Pages that get ignored</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1j9b6f0m5m3t\">Exclusion patterns - advanced filtering</a>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m3u\">Exclude entire sections</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m3v\">Exclude by content type</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m40\">Exclude specific pages</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1j9b6f0m5m41\">Practical examples</a>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m42\">Example 1: Company website scan</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m43\">Example 2: Documentation site scan</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m44\">Example 3: Support portal scan</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1j9b6f0m5m45\">Scanning limits</a>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m46\">Free trial accounts</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m47\">Regular accounts</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1j9b6f0m5m48\">How the system handles problems</a>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m49\">Automatic recovery</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m4a\">What you see during scanning</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1j9b6f0m5m4b\">Recurring scans</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m4c\">Best practices</a>\n<ul>\n<li><a href=\"#mcetoc_1j9b6f0m5m4d\">Choosing starting URLs</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m4e\">Setting up exclusions</a></li>\n<li><a href=\"#mcetoc_1j9b6f0m5m4f\">Monitoring results</a></li>\n</ul>\n</li>\n</ul>\n</div>\n<h2 id=\"mcetoc_1j9b6f0m5m3n\">How it works</h2>\n<h3 id=\"mcetoc_1j9b6f0m5m3o\">Starting the scan</h3>\n<p>You provide a list of URLs to scan, one per line, for example:</p>\n<ul>\n<li><a href=\"https://theta.co.nz\">https://theta.co.nz</a></li>\n<li><a href=\"https://support.theta.co.nz/getting-started\" aria-invalid=\"true\">https://support.theta.co.nz/getting-started</a></li>\n<li><a href=\"https://docs.theta.co.nz/api\" aria-invalid=\"true\">https://docs.theta.co.nz/api</a></li>\n</ul>\n<p>The system will process each URL and automatically discover related content.</p>\n<h3 id=\"mcetoc_1j9b6f0m5m3p\">Automatic content discovery</h3>\n<p>When scanning&nbsp;<a href=\"https://knect.helpfruit.com/article/web-crawler-url-scanning-feature-user-guide0001\">https://theta.co.nz/products</a>&nbsp;the system will:</p>\n<ol>\n<li><strong>Extract the page content</strong>&nbsp;- All text, headings, and useful information</li>\n<li><strong>Find all links</strong>&nbsp;- Every clickable link on the page</li>\n<li><strong>Follow relevant links</strong> - Only links that meet the inclusion rules (see below)</li>\n<li><strong>Repeat the process</strong>&nbsp;- Continue scanning newly discovered pages</li>\n</ol>\n<h2 id=\"mcetoc_1j9b6f0m5m3q\">What gets included vs excluded</h2>\n<h3 id=\"mcetoc_1j9b6f0m5m3r\">✅ Pages that get scanned</h3>\n<p><strong>Same domain pages</strong>&nbsp;If you start with&nbsp;<a href=\"https://theta.co.nz/\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz</a>, these will be included:</p>\n<ul>\n<li><a href=\"https://theta.co.nz/about\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/about</a></li>\n<li><a href=\"https://theta.co.nz/products/overview\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/products/overview</a></li>\n<li><a href=\"https://theta.co.nz/support/faq\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/support/faq</a></li>\n</ul>\n<p><strong>Sub-path pages</strong>&nbsp;If you start with&nbsp;<a href=\"https://theta.co.nz/support\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/support</a>, these will be included:</p>\n<ul>\n<li><a href=\"https://theta.co.nz/support/getting-started\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/support/getting-started</a></li>\n<li><a href=\"https://theta.co.nz/support/faq\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/support/faq</a></li>\n<li><a href=\"https://theta.co.nz/support/tutorials/basics\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/support/tutorials/basics</a></li>\n</ul>\n<p><strong>Document files</strong></p>\n<ul>\n<li>PDF files:&nbsp;<a href=\"https://theta.co.nz/manual.pdf\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/manual.pdf</a></li>\n<li>Word documents:&nbsp;https://theta.co.nz/guide.docx</li>\n<li>Text files:&nbsp;https://theta.co.nz/changelog.txt</li>\n</ul>\n<p><strong>Processable extensions</strong>&nbsp;(downloaded and indexed):</p>\n<ul>\n<li>Documents:&nbsp;<code>.pdf</code>,&nbsp;<code>.doc</code>,&nbsp;<code>.docx</code>,&nbsp;<code>.txt</code></li>\n<li>Web content:&nbsp;<code>.html</code>,&nbsp;<code>.htm</code></li>\n</ul>\n<h3 id=\"mcetoc_1j9b6f0m5m3s\">❌ Pages that get ignored</h3>\n<p><strong>Different domains</strong>&nbsp;</p>\n<p>If you start with <code><a href=\"https://theta.co.nz\">https://theta.co.nz</a></code>, these will be ignored:</p>\n<ul>\n<li><a href=\"https://microsoft.com/\" target=\"_blank\" rel=\"noopener noreferrer\">https://microsoft.com</a>&nbsp;(completely different domain)</li>\n<li><a href=\"https://support.google.com/\" target=\"_blank\" rel=\"noopener noreferrer\">https://support.google.com</a>&nbsp;(different domain)</li>\n<li><a href=\"https://dash.theta.co.nz/\" target=\"_blank\" rel=\"noopener noreferrer\" aria-invalid=\"true\">https://dash.theta.co.nz</a>&nbsp;(different subdomain)</li>\n</ul>\n<p><strong>Parent Paths</strong>&nbsp;</p>\n<p>If you start with <a href=\"https://theta.co.nz/support/guides\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/support/guides</a>, these will be ignored:</p>\n<ul>\n<li><a href=\"https://theta.co.nz/about\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/about</a>&nbsp;(above the starting path)</li>\n<li><a href=\"https://theta.co.nz/products\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/products</a>&nbsp;(above the starting path)</li>\n<li><a href=\"https://theta.co.nz/manual.pdf\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/manual.pdf</a>&nbsp;(above the starting path)</li>\n</ul>\n<p><strong>Binary Files</strong></p>\n<ul>\n<li>Images:&nbsp;<a href=\"https://theta.co.nz/logo.png\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/logo.png</a></li>\n<li>Videos:&nbsp;<a href=\"https://theta.co.nz/demo.mp4\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/demo.mp4</a></li>\n<li>Software:&nbsp;<a href=\"https://theta.co.nz/installer.exe\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/installer.exe</a></li>\n<li>Archives:&nbsp;<a href=\"https://theta.co.nz/backup.zip\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/backup.zip</a></li>\n</ul>\n<p><strong>Excluded Extensions</strong>&nbsp;(skipped during crawling):</p>\n<ul>\n<li>Images:&nbsp;<code>.png</code>,&nbsp;<code>.jpg</code>,&nbsp;<code>.jpeg</code>,&nbsp;<code>.gif</code>,&nbsp;<code>.bmp</code>,&nbsp;<code>.tiff</code>,&nbsp;<code>.ico</code>,&nbsp;<code>.svg</code></li>\n<li>Spreadsheets:&nbsp;<code>.xls</code>,&nbsp;<code>.xlsx</code></li>\n<li>Archives:&nbsp;<code>.zip</code>,&nbsp;<code>.rar</code>,&nbsp;<code>.gz</code>,&nbsp;<code>.tar</code>,&nbsp;<code>.7z</code></li>\n<li>Media:&nbsp;<code>.mp3</code>,&nbsp;<code>.mp4</code>,&nbsp;<code>.avi</code>,&nbsp;<code>.mov</code>,&nbsp;<code>.flv</code>,&nbsp;<code>.wmv</code></li>\n<li>Executables:&nbsp;<code>.exe</code>,&nbsp;<code>.dll</code>,&nbsp;<code>.so</code>,&nbsp;<code>.bin</code></li>\n</ul>\n<p>Note: some PDFs can't be processed as they are image-type files</p>\n<h2 id=\"mcetoc_1j9b6f0m5m3t\">Exclusion patterns - advanced filtering</h2>\n<p>You can specify URLs to exclude using patterns. Here are practical examples:</p>\n<h3 id=\"mcetoc_1j9b6f0m5m3u\">Exclude entire sections</h3>\n<pre><a href=\"https://theta.co.nz/admin*\">https://theta.co.nz/admin*</a>\n\n</pre>\n<p>This will skip:</p>\n<ul>\n<li><a href=\"https://theta.co.nz/admin/dashboard\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/admin/dashboard</a></li>\n<li><a href=\"https://theta.co.nz/admin/users\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/admin/users</a></li>\n<li><a href=\"https://theta.co.nz/admin/settings/general\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/admin/settings/general</a></li>\n</ul>\n<h3 id=\"mcetoc_1j9b6f0m5m3v\">Exclude by content type</h3>\n<pre><code>*login*\n\n</code></pre>\n<p>This will skip any URL containing \"login\":</p>\n<ul>\n<li><a href=\"https://theta.co.nz/user/login\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/user/login</a></li>\n<li><a href=\"https://theta.co.nz/admin-login\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/admin-login</a></li>\n<li><a href=\"https://theta.co.nz/support/login-help\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/support/login-help</a></li>\n</ul>\n<h3 id=\"mcetoc_1j9b6f0m5m40\">Exclude specific pages</h3>\n<pre><code><a href=\"https://theta.co.nz/private\">https://theta.co.nz/private</a>\n*contact*\n*/temp/*\n\n</code></pre>\n<p>This will skip:</p>\n<ul>\n<li><a href=\"https://theta.co.nz/private\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/private</a>&nbsp;(exact match)</li>\n<li><a href=\"https://theta.co.nz/contact-us\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/contact-us</a>&nbsp;(contains \"contact\")</li>\n<li><a href=\"https://theta.co.nz/files/temp/draft.html\" target=\"_blank\" rel=\"noopener noreferrer\">https://theta.co.nz/files/temp/draft.html</a>&nbsp;(contains \"/temp/\")</li>\n</ul>\n<h2 id=\"mcetoc_1j9b6f0m5m41\">Practical examples</h2>\n<h3 id=\"mcetoc_1j9b6f0m5m42\">Example 1: Company website scan</h3>\n<p><strong>Starting URL:</strong>&nbsp;<a href=\"https://mycompany.com/\" target=\"_blank\" rel=\"noopener noreferrer\">https://mycompany.com</a></p>\n<p><strong>What Gets Scanned:</strong></p>\n<ul>\n<li>Homepage content and navigation</li>\n<li>About us, products, services pages</li>\n<li>FAQ and help sections</li>\n<li>Product documentation (PDFs)</li>\n<li>All sub-pages and nested content</li>\n</ul>\n<p><strong>What Gets Excluded:</strong></p>\n<ul>\n<li>Customer login portal</li>\n<li>Admin dashboard</li>\n<li>External social media links</li>\n<li>Any other external links</li>\n<li>Image and video files</li>\n</ul>\n<h3 id=\"mcetoc_1j9b6f0m5m43\">Example 2: Documentation site scan</h3>\n<p><strong>Starting URL:</strong>&nbsp;<a href=\"https://docs.myapi.com/v2/\" target=\"_blank\" rel=\"noopener noreferrer\" aria-invalid=\"true\">https://docs.myapi.com/v2/</a></p>\n<p><strong>What Gets Scanned:</strong></p>\n<ul>\n<li>All v2 API documentation</li>\n<li>Code examples and tutorials</li>\n<li>Reference guides</li>\n<li>Getting started guides</li>\n</ul>\n<p><strong>Exclusions You Might Add:</strong></p>\n<pre><code><a href=\"https://docs.myapi.com/v1/*\" aria-invalid=\"true\">https://docs.myapi.com/v1/*</a>    (exclude old version)\n*deprecated*                  (exclude deprecated content)\n*/examples/temp/*            (exclude temporary examples)\n\n</code></pre>\n<h3 id=\"mcetoc_1j9b6f0m5m44\">Example 3: Support portal scan</h3>\n<p><strong>Starting URL:</strong>&nbsp;<a href=\"https://support.theta.co.nz/\" target=\"_blank\" rel=\"noopener noreferrer\" aria-invalid=\"true\">https://support.theta.co.nz</a></p>\n<p><strong>What gets scanned:</strong></p>\n<ul>\n<li>All help articles</li>\n<li>Troubleshooting guides</li>\n<li>FAQ sections</li>\n<li>Tutorial videos (text descriptions)</li>\n<li>Downloadable manuals (PDFs)</li>\n</ul>\n<p><strong>Common exclusions:</strong></p>\n<pre><code>*ticket*          (exclude ticketing system pages)\n*private*         (exclude private customer content)\n*/admin/*         (exclude admin tools)\n\n</code></pre>\n<h2 id=\"mcetoc_1j9b6f0m5m45\">Scanning limits</h2>\n<h3 id=\"mcetoc_1j9b6f0m5m46\">Free trial accounts</h3>\n<ul>\n<li>Maximum 50 pages per scan</li>\n<li>If limit is reached, scanning stops and you're notified</li>\n<li>You can run another scan to continue from where it left off</li>\n</ul>\n<h3 id=\"mcetoc_1j9b6f0m5m47\">Regular accounts</h3>\n<ul>\n<li>Higher limits (varies by plan)</li>\n<li>Can process hundreds or thousands of pages</li>\n<li>Automatic retry if temporary issues occur</li>\n</ul>\n<h2 id=\"mcetoc_1j9b6f0m5m48\">How the system handles problems</h2>\n<h3 id=\"mcetoc_1j9b6f0m5m49\">Automatic recovery</h3>\n<ul>\n<li><strong>Slow loading pages</strong>: Tries different methods to determine when page is fully loaded</li>\n<li><strong>Temporary errors</strong>: Automatically retries failed pages up to 3 times</li>\n<li><strong>Blocked pages</strong>: Skips blocked content and continues with other pages</li>\n<li><strong>Large websites</strong>: Processes pages in batches to avoid overwhelming the system</li>\n</ul>\n<h3 id=\"mcetoc_1j9b6f0m5m4a\">What you see during scanning</h3>\n<ul>\n<li><strong>Status updates</strong>: Pending → Processing → Completed</li>\n<li><strong>Progress tracking</strong>: \"Processed 25 of 45 pages found\"</li>\n<li><strong>Final summary</strong>: Total pages processed, files uploaded</li>\n</ul>\n<p><strong>Note:</strong> If you are scanning multiple URLs, even if it says \"Scanning...\", a page may not yet have started processing</p>\n<p>&nbsp;</p>\n<pre>&nbsp;</pre>\n<h2 id=\"mcetoc_1j9b6f0m5m4b\">Recurring scans</h2>\n<p>You can set up automatic scanning to keep your knowledge base up-to-date:</p>\n<ul>\n<li><strong>Weekly scans</strong>: Automatically re-scan your URLs every week</li>\n<li><strong>Change detection</strong>: Only updates content that has actually changed</li>\n</ul>\n<h2 id=\"mcetoc_1j9b6f0m5m4c\">Best practices</h2>\n<h3 id=\"mcetoc_1j9b6f0m5m4d\">Choosing starting URLs</h3>\n<p>There are two ways of scanning, scan the full site - recommended, or scanning sub sites</p>\n<h4>Scan full site</h4>\n<p>This is the recommended approach for most scenarios as the scanning tool will find all sub links from the main site, giving the broadest set of information available to answer questions. Specific sections can be excluded e.g.&nbsp;<code>*/financial-reports/*</code>&nbsp;to exclude annual financial reports. Or use this technique to exclude other areas that would not be useful in answering users' questions.</p>\n<h4>Scan subsites</h4>\n<p>This is best used when your bot only answers a subset of the questions available. An example of this might be in a larger organisation where the bot is used for a specific purpose. e.g. a council who wants to use the bot to answer questions about an upcoming annual plan.</p>\n<p>In this case, provide multiple links and each will be scanned independently. Only sub-sites of these links will be included in the scan.</p>\n<p>You may also choose to run your first scan as a sub-site scan, to try it out with a more tightly bounded scope.&nbsp;</p>\n<h3 id=\"mcetoc_1j9b6f0m5m4e\">Setting up exclusions</h3>\n<ul>\n<li><strong>Be specific</strong>: Use exact URLs when possible</li>\n<li><strong>Use patterns wisely</strong>:&nbsp;<code>*admin*</code>&nbsp;catches more than&nbsp;<code>*/admin/*</code></li>\n<li><strong>Test exclusions</strong>: Verify your patterns work with example URLs</li>\n</ul>\n<h3 id=\"mcetoc_1j9b6f0m5m4f\">Monitoring results</h3>\n<ul>\n<li><strong>Check the URLs found</strong>: Review what's been scanned</li>\n<li><strong>Verify content</strong>: Spot-check that important pages were captured</li>\n<li><strong>Adjust as needed</strong>: Refine your URLs and exclusions based on results</li>\n</ul>\n<p>&nbsp;</p></body></html>","description":"","isMarkdown":false,"publishedOnUtc":"2025-11-25T03:04:45.5748639","modifiedOnUtc":"2025-11-05T22:58:53.6725147"}