← Back to FAQ

🌐 Customer Portals & Shared Links

YourAI gives your customers their own secure, branded web pages — for tracking work orders, viewing and paying invoices, approving quotes, and reading past conversations. Everything lives under your unique subdomain URL so it feels like your own product.

Your subdomain is your key. Every customer-facing page follows the pattern yourai.bot/o/{tenant}/..., where {tenant} is your unique subdomain (e.g. if your chatbot lives at acmerepair.yourai.bot, your tenant handle is acmerepair). You can find your subdomain in Account Settings → Chatbot Subdomain.
Quick Reference
URL Pattern Who Uses It Login Method
/o/{tenant}/portal Your customers — view work orders & invoices, pay bills Email OTP 6-digit code
/o/{tenant}/service Your field techs / staff — mobile WO dashboard Staff sub-user login
/o/{tenant}/quote/{token} A specific customer — approve or decline a quote No login (token in URL)
/o/{tenant}/c/{shortId} Anyone with the link — read a past chat conversation No login (token in URL)
The Four Portal Pages
🔒

Customer Self-Service Portal

yourai.bot/o/{tenant}/portal

The customer portal is a secure, branded page where your customers can view all of their work orders and invoices in one place — and pay outstanding balances directly. No app download, no account creation: they authenticate with just their email address and a one-time code sent to that inbox.

https://yourai.bot/o/{tenant}/portal
What customers see
🔧 Work Order status & history 📋 Invoice list with Pay Now button 📄 Line item breakdown 📄 File attachments from Drive ✅ Status badges (Open, Completed, Paid…)

If the customer has only work orders, the portal shows just the Work Orders tab. If they have only invoices, only the Invoices tab is shown. When both exist, a tab bar appears at the top so they can switch between the two views.

How customers log in
1
Customer visits yourai.bot/o/{tenant}/portal and enters the email address you have on file for them.
2
YourAI sends a 6-digit one-time code to that email (expires in 15 minutes).
3
The customer enters the code and is taken directly to their records. Their session stays active for 2 hours — they won't need to log in again until then.
Critical: email matching
⚠ The email used for login must exactly match the email stored on the customer's work orders and invoices. If a customer types a different address, they will receive a code but see no records. Always double-check emails when creating work orders or invoices in your dashboard.
How to share this link

You can paste this URL into any confirmation email, SMS, or invoice — or add a "View Your Orders" button to your website. Replace {tenant} with your actual subdomain. Example: yourai.bot/o/acmerepair/portal.

Required panels

Work Orders appear in the portal when the Work Order Tracking panel is enabled on your account. Invoices appear when the Invoice panel is enabled. At least one must be active for customers to see anything after login.

📱

Service Staff Portal

yourai.bot/o/{tenant}/service

The service portal is a mobile-first dashboard built for field technicians and service staff. It gives your team everything they need to manage work orders from the job site — without needing access to the full analytics dashboard. Large tap targets, swipeable status chips, and a native camera prompt make it practical to use with dirty or gloved hands.

https://yourai.bot/o/{tenant}/service
What techs can do
🔧 View all work orders 🔍 Filter by status ✅ Update work order status 📝 Add or edit internal notes 📷 Attach photos via camera 📂 Upload files to Google Drive ✍ Create new work orders
How techs log in
1
In your YourAI dashboard, go to Account Settings → Staff Logins and create a sub-user account for your technician with a username and password.
2
Share the service portal URL (yourai.bot/o/{tenant}/service) and their credentials with the technician.
3
The tech logs in with their sub-user credentials. Their session persists on that device — they only need to log in again if they sign out or switch browsers.
Google Drive attachments

If you have connected Google Drive in Manage Integrations → Google Drive, techs can tap the camera icon on any work order to snap a photo — it uploads directly to a YourAI folder in your Google Drive and appears as a link on the work order. No files are stored on YourAI's servers.

Required panels

The Work Order Tracking panel must be enabled on your account. Staff sub-user accounts are available on all Neural plans under Account Settings → Staff Logins.

📋

Quote Approval Page

yourai.bot/o/{tenant}/quote/{token}

When you send a quote from the Invoices panel → Quote, YourAI emails the customer a unique approval link. This page shows the full quote — your branding, itemized line items, any tax rates, and notes — with a prominent Approve or Decline button. No login is required: the token in the URL authenticates the customer automatically.

https://yourai.bot/o/{tenant}/quote/{token}

The {token} is a long, unique, random string automatically generated per quote. You never need to construct this URL manually — it is included in the email sent to the customer.

What the customer sees
🏭 Your business name & branding 📋 Itemized line items table 📈 Tax line(s) if configured 💰 Grand total ✍ Notes from you ⌛ Expiry date countdown
What happens after approval
Approved — The quote is instantly converted to an invoice and sent to the customer via your connected payment gateway (Stripe or PayPal). A "Pay Now" button appears on the confirmation screen. The invoice also appears in your Invoice History panel with status Sent.
Declined — The quote is marked as declined in your dashboard and a "Contact the Business" button shows the customer a mailto link to your business email. You'll see the decline reflected in your Quotes list immediately.
Expiry & resending

Set the "Valid Until" date when you create a quote. Once expired, the Approve button is disabled and a red notice tells the customer to contact you. You can resend an active quote from the Quotes modal at any time — a fresh email goes out with the same approval link.

Required panels

The Invoice panel must be enabled on your account. Payment gateway credentials (Stripe or PayPal) should be configured in Manage Integrations → Payments for the approved quote to automatically generate a payable invoice. Without a gateway, the invoice is still created but customers won't have an online payment link.

💬

Conversation Share Link

yourai.bot/o/{tenant}/c/{shortId}

Every chat session between a customer and your AI assistant gets its own permanent, shareable URL. These read-only conversation pages are useful for support escalation, dispute resolution, or simply letting a customer re-read what your AI told them.

https://yourai.bot/o/{tenant}/c/{shortId}

The {shortId} is a short alphanumeric code assigned to each conversation when it begins. These IDs appear in your Recent Requests log on the analytics dashboard.

What the link shows
💬 All messages in order (customer + AI) 📅 Date and time of each message 🏭 Your business name 🔒 Read-only — no interaction
Authentication

Conversation links require no login. Anyone with the link can read the conversation — so treat them like an email forwarded to a third party. Only share them with parties involved in or authorized to view the conversation.

How to find a conversation's link
1
Open your analytics dashboard and go to Recent Requests.
2
Click on any session row — the Session ID shown (e.g. a3f7b2) is the short ID for that conversation.
3
Construct the link manually: yourai.bot/o/{tenant}/c/{shortId}, or use the copy link button in the conversation detail view.
Setting Up Customer Emails
The customer portal uses email-based authentication. This means the email address entered at login must exactly match the email stored on the customer's records in your dashboard. Follow these practices to avoid customers being unable to log in.
One email, many records. A single customer email can be associated with multiple work orders and invoices. All records with that email will be visible in the portal when the customer logs in — so avoid entering a shared or business-wide email address on individual customer records.
Granting Additional Login Emails (Alias Access)
Alias access lets more than one email log in to the same customer's portal records. This is useful for businesses with multiple staff members, customers who have both a personal and work email, or shared accounts where a spouse or office manager also needs access. The customer's original records email stays unchanged; you're simply adding extra login credentials alongside it.
Common Use Cases
🏢
Business Customers
An auto shop customer uses their fleet@company.com for records, but the office manager (mgr@company.com) needs to approve invoices and pay balances.
👥
Multiple Contacts
A property management company has one billing email on file, but three site managers all need to view open work orders for their respective properties.
Dual Emails
A customer gave you their work email when dropping off their device, but they'd rather check the portal from their personal Gmail account at home.
How to Set Up Alias Access
1
Open the Work Order Tracking panel in your dashboard. In the top-right corner of the panel header, click the 👤 Portal Access button.
2
Fill in the two email fields. In the Customer's Records Email field, enter the email that's already on the customer's work orders and invoices (their primary record email). In the Additional Login Email field, enter the new email address you want to give portal access to.
3
Add an optional label. Give the alias a friendly description like "Office manager", "John's work email", or "Spouse". This label is only visible to you in the dashboard, to help you keep track of who each email belongs to.
4
Click "Add Access." The alias immediately appears in the grouped list below, nested under the customer's primary email. You can add as many aliases per customer as needed.
5
Share the portal URL with the alias holder. They navigate to your portal URL (e.g., yourai.bot/o/acmerepair/portal), enter their alias email at the login screen, and receive a one-time code just like any other customer. The portal shows the same records as the primary email.
Managing Existing Aliases

The Portal Access by Customer list in the modal groups every alias under its primary customer email so you can see at a glance who has portal access. Each alias shows the login email, your optional label, and a Remove button.

Removing an alias immediately revokes portal access for that email. They will no longer receive OTP codes and will be denied at login. The primary records email is never affected.

Alias access does not change records. Work orders and invoices are always linked to the primary customer email. Alias emails only add login access; they cannot be used to link new records and do not appear on documents. If a customer wants their records email changed, you must update it on each work order and invoice directly.
Sharing Portal Links with Customers

There are several natural places to share your customer portal URL. Replace acmerepair in these examples with your own subdomain.

Work Order Confirmation Email
Include the portal link when you notify a customer that their work order has been received: "Track your repair at yourai.bot/o/acmerepair/portal".
💳
Invoice Email Footer
Add the portal URL to your invoice email template so customers always know where to check their balance.
🌐
Your Website
Add a "Customer Login" or "Track My Order" link in your website header or footer pointing to your portal URL.
📱
SMS Text Messages
If you use the SMS Alerts panel, include the portal link in status update messages: "Your repair is ready — view details: yourai.bot/o/acmerepair/portal".
📌
QR Code at Your Counter
Generate a QR code that points to your portal URL and display it at your service desk. Customers can scan it with their phone to access their account on the spot.
🔒

Ready to connect with your customers?

Enable the Work Order Tracking and Invoice panels in your dashboard, then share your portal link with customers today.

Open Your Dashboard
← Back to FAQ