Skip to main content

Help Center

Answers to common questions about dynamic QR codes, AI chat agents, smart routing, analytics, and billing. Can't find what you need? We're one message away.

Getting started

How do I create a dynamic QR code?

Sign in, click Create, and pick what the code should do — a redirect link, an internal hub, a contact card, a form, or an AI chat agent. We generate the code instantly and you can download it as PNG or SVG and print it once.

Can I change where a code points after printing?

Yes — that's the whole idea. Open the code in your dashboard and update its destination. The change is live immediately, no reprinting.

How many codes can I create on a free plan?

The Free plan includes 3 QR agents and 1,000 scans. Pro removes QR limits and lifts scans to 50K, plus 100 AI chat sessions. See the pricing page for full plan details.

Do I need a credit card to sign up?

No. Your first code is on us. Upgrade later only if you need more scans, AI chat sessions, or premium features.

AI chat & knowledge bases

What is an AI chat agent?

When someone scans your QR code, they can chat with an AI assistant that answers questions about the scanned object — an exhibit, a product, a piece of equipment, a manual. The agent is powered by RAG (retrieval-augmented generation) over your own knowledge base.

Which LLM powers the chat?

ScanAspect uses gpt-4o-mini via OpenRouter by default. Business and Enterprise plans can bring their own LLM API key.

How do knowledge bases work?

Upload documents or web pages to your organization. They are chunked, embedded using CF Workers AI (bge-small-en-v1.5, 384 dimensions), and stored in pgvector. When a scanner asks a question, the chat agent retrieves the most relevant passages to ground its answer.

What's the difference between hybrid modes?

Knowledge bases with fewer than 5 pages use text stuffing (the whole content is sent to the LLM). Once you cross 5 pages, ScanAspect switches automatically to RAG with semantic retrieval, so the agent stays fast and accurate at scale.

Can I brand the chat widget?

Yes. Each QR agent has its own accent colour, logo, and an optional 'Powered by ScanAspect' label. Business and Enterprise plans can white-label fully.

What are agent tools?

Agent tools let the AI chat call external actions — create a support ticket, send a notification, check a URL status, submit a form, or fetch external data. Tools are an Enterprise feature and are configured per organization.

Smart routing & access control

What is smart routing?

Smart routing lets one QR code send different scanners to different destinations based on rules you define. You can combine geography (geo-fencing), device type, time of day or day of week, access role, and scan-count limits.

How do access roles work?

Assign each scanner a role — staff, contractor, visitor, or guest. Different roles can land on different destinations from the same printed code, which is ideal for sites with mixed audiences.

Can I limit the number of scans?

Yes. Add a scan-count cap to a routing rule and the code will stop resolving (or fall through to a fallback) once the limit is reached — useful for promotions, single-use vouchers, and inventory-controlled items.

Custom domains & branding

Can I use my own domain for scan links?

Yes. Organizations can connect a custom domain (for example qr.company.com). Add a CNAME record pointing to scan.scanaspect.com and verify it in the dashboard. Scans then resolve through your branded domain.

What is a profile page?

Each user or organization member gets a Linktree-style public profile. Link one QR code to the profile and scanners can choose between your codes, links, and contact details.

Analytics

Where do I see my scan analytics?

Every code has an analytics view showing scans by time, location (country, region, city), device, and referrer. You can filter by date range to focus on a campaign or a single event.

Can I track AI chat analytics too?

Yes. In addition to scan events, you can see chat sessions and per-session message counts so you understand how people are interacting with each agent.

Is the analytics data privacy-safe?

Yes. IP addresses are hashed on ingest and we never collect the personal identity of the person scanning — only anonymous metadata.

API & webhooks

Does ScanAspect have an API?

Yes — a RESTful API under /api/ with API-key authentication. Create codes, update destinations, list scans, manage knowledge bases, and pull analytics programmatically.

What webhook events are available?

Webhooks push events to your endpoint in real time. Current events include scan.created, document.opened, and chat.message_sent. Point your webhook at Slack, n8n, or any HTTP backend.

How do webhook signatures work?

Every delivery includes a signature header computed from your webhook secret. Verify it before trusting the payload so you know the request genuinely came from ScanAspect.

Account & billing

How does billing work?

ScanAspect uses Polar.sh for subscriptions. Upgrade, downgrade, or cancel from the billing screen in your dashboard. We never hold your funds — payments are settled directly through Polar.

What are the plan limits?

Free: 3 QR agents, 1K scans. Pro ($19/mo): unlimited QRs, 50K scans, 100 AI chat sessions. Business ($49/mo): 1K AI chat sessions, bring-your-own LLM key, white-label. Enterprise: custom pricing and limits — contact us.

Can I switch plans later?

Yes, at any time. Upgrades take effect immediately; downgrades apply at the next renewal. Unused scan and chat quota does not roll over.

Still stuck?

Browse the getting-started guide or reach our team directly.

Contact support →
Help Center · ScanAspect