Settings
All settings are per-tenant and configurable from the admin UI. No environment variables or server access required. Settings are stored in the tenant's database and take effect immediately.
Every setting on these tabs saves automatically a moment after you change it. A few actions that check something first, like your email login, a custom portal domain or an AI key, keep their own button. Things that are each person's own live in My Account instead: vehicle MPG, AI reply tone, which reminder and chat emails you get, and your push notification schedule.
Tenant
| Setting | Description |
|---|---|
| Tenant Name | Your business name. Shown in the sidebar, portal header, emails, quotes, and invoices. |
| Your Trade | The kind of work your business does, picked at signup. Changing it adds that trade's preset equipment types for client assets right away. Types from your previous trade stay so existing assets keep them, and you can delete the ones you don't use. Choosing IT support and MSP also turns on IT tools. Admins only. |
| Show IT tools | Shows device and network scans, network maps, ISP details on clients and sites, computer specs (System Info) on assets, and the IT support agreement starter template. On by default for IT support and MSP tenants and off for other trades. Turning it off hides these tools but keeps any data already saved. Admins only. |
| Theme | Accent color used throughout the app and portal. Auto-saves when selected. |
Branding
How your business looks to customers. These sit together in their own card on the General tab.
| Setting | Description |
|---|---|
| Logo | Displayed in the sidebar, customer portal header, and on quote/invoice PDFs. PNG or SVG, max 1 MB, landscape works best. Its preview shows it on your Document Color. |
| Document Color | Accent color for quote/invoice documents: the border around the white header and line items heading, header text and total dividers in the editors and on downloaded quote and invoice PDFs (white headers save ink when printed; a white or pale logo is recolored to this color there automatically), and the header band in the emails customers get (quotes, invoices, payment reminders, recurring invoices, review requests). Readable white or near-black text is picked automatically based on the color you choose. Leave unset to keep the default navy. |
| Website URL | Optional. When set, the logo on your customer portal header links to this URL (opens in a new tab). |
Terminology (General tab)
Use your own words for four things Servelo names for you: Technician, Ticket, Client and Quote. For example, a contractor might use Job, Customer and Estimate, and a staffing firm might call its technicians Recruiters. Type the word in the singular; Servelo makes the plural for you (Job and Jobs, Company and Companies). Leave a box blank to keep the default.
The new word shows up everywhere your team works (the sidebar, page titles, buttons, columns, filters, messages and Reports) and in your customer portal. It's a display change only: links, saved filters and your records stay the same, and you can change the words back at any time. Emails Servelo sends still use the default words for now.
Ticket Settings
Ticket-specific settings are on the Tickets tab of Global Settings (admin only), Service plans are set up on each client's page.
| Setting | Description |
|---|---|
| Next Ticket Number | The number to assign to the next new ticket. Useful when migrating from another system. Use leading zeros like 0645 to control zero-padding on all future tickets. Locks once your first ticket is created; use Reset numbering to jump the counter forward. |
| Gas Price ($/gal) | Current fuel price. Use the refresh button to pull the national average from the EIA automatically. |
| Remind the assigned person | Emails whoever is assigned to a scheduled ticket before the visit. See Appointment reminders. |
| Remind the client | Emails the client before their visit (only clients with Suppress emails unchecked). |
| Send reminders | How far ahead: 2, 4, or 12 hours, 1 day, or 2 days before. |
Labor rates and price book
Further down the Invoicing tab (admin only) are your labor rates and price book, used by quotes, invoices and the AI features.
| Setting | Description |
|---|---|
| Hourly Labor (per hr) | Default rate pre-filled when adding a labor line item to a quote. |
| Service Call / Diagnostic | Default rate pre-filled when adding a service call line item to a quote. |
| Pricing notes for AI | The AI planner and AI estimates treat the service call as covering the first hour, with the hourly rate after that. Add any other billing rules here, such as billing extra time in 30-minute blocks. |
| Price Book | Your saved services and parts with prices, added to quotes and invoices from the Price book menu; starred items get quick-add buttons. An item can also be a set of options the client picks from on an invoice (a preset, saved from an invoice's choice line), with notes that fill in the invoice notes. A preset can also have a Details page link (for example a plans page on your website), set on its second row here or on the invoice; customers see it as Compare the options. See Price book. |
Invoicing
The Invoicing tab (admin only) holds everything about getting paid. Changes save automatically.
| Section | Description |
|---|---|
| Payment Links | Your Venmo, PayPal and Square links, shown as payment buttons on invoices, and the Pay by Bank (ACH) option. See Setting up payment methods and Pay by Bank. |
| Payment Terms and Reminders | When new invoices are due, and whether unpaid ones get reminder emails. |
Portal
| Setting | Description |
|---|---|
| Portal Enabled | Toggle the customer portal on or off. When off, magic link requests return an error. |
| Allow New Tickets | Controls whether customers can submit new service requests from the portal. |
| Hero Title | Large headline shown on the portal landing page. Defaults to "Get Help Fast". |
| Tagline | Subtitle text below the hero title. |
| Schedule URL | Optional link to a booking page (Calendly, etc.) shown as a button in the portal. Replaced by the Request Service button when Online Booking is on. |
| Online Booking | A public Request Service page for new customers, off until you turn it on, with an intro line and an optional list of services. See Online booking. |
| Portal Notify Email | Who gets notified when a customer submits a ticket or reply via the portal. Defaults to the first admin user's email. |
| Custom Domain | Serve your portal at a custom URL like support.yourdomain.com. Requires a DNS CNAME record; an SSL certificate is provisioned automatically on first visit. |
Team
The Team tab is where you manage everyone with access to your Servelo account.
| Setting | Description |
|---|---|
| Users list | Invite admins and technicians, change roles, deactivate or reactivate, resend login links. See Users & Team for full details. |
| Show admins in technician list | When enabled, admins appear as options when assigning tickets. |
Payment Methods and Processing Fees (Invoicing tab)
Each payment method has its own processing fee rate, set under Global Settings > Invoicing > Payment Methods and Processing Fees. Enter the percent and flat amount your processor charges. Servelo uses them to estimate the Payment Fee when you close a ticket or mark an invoice paid, so your net revenue is tracked accurately. A method you add gets its own rate, and you can rename a method without affecting tickets that already use it.
Use a separate method for each processor you take cards through. Rates differ by processor and by how the card is taken, so one "Credit Card" rate can't be right for both, for example, PayPal Tap to Pay and Square invoice links.
Processor rates Servelo keeps current
Each method has a Processor rate picker. Choose the processor and way you take payment, and Servelo fills in its published rate. When a processor changes its pricing, Servelo updates the rate for every tenant following it, so you don't have to. Choose Custom rate, or just type a different rate, if you negotiated your own; Use Servelo's rate switches back. You can also pick a processor when adding a method, and the name fills in for you.
| Processor rate | Published US rate |
|---|---|
| PayPal Tap to Pay / card reader (in person) | 2.29% + $0.09 |
| PayPal Checkout (online) | 3.49% + $0.49 |
| PayPal standard card payment (online) | 2.99% + $0.49 |
| PayPal goods & services payment | 2.99% |
| Square card reader or Tap to Pay (in person) | 2.6% + $0.15 (Free plan) |
| Square online / payment links | 3.3% + $0.30 (Free plan) |
| Square Invoices (card) | 3.3% + $0.30 (Free plan) |
| Square keyed-in / card on file | 3.5% + $0.15 |
| Stripe online card | 2.9% + $0.30 |
| Stripe Terminal (in person) | 2.7% + $0.05 |
| Venmo business payment | 1.9% + $0.10 |
| No fee (cash, check, Zelle) | 0% |
Hiding methods you don't take
Square's rates are for its Free plan. On Square Plus or Premium your rates are lower, so choose Custom rate and enter yours.
The built-in methods (Cash, Credit Card, Check, Venmo, Zelle, Invoice Sent) can't be deleted, but any method can be hidden with Hide. Hidden methods drop out of the payment method pickers on tickets and invoices, except on a ticket or invoice that already uses one. They're listed under Hidden from pickers, where Show brings them back. Methods you added can also be deleted.
Keeping rates accurate
- Estimates are refreshed. When you open the close window, an estimated fee is recalculated from the current rates, so an estimate made under old rates never lingers.
- Real fees win. If you type the actual fee into a ticket's Payment Fee (from your processor's receipt), Servelo keeps it as the real fee and never replaces it with an estimate. Square payments through invoice links record Square's real fee automatically, replacing any estimate and correcting the matching Payment Fees expense.
- Suggested rates. Once a method has at least 3 real fees that its current rate misses, a suggestion appears under it, for example "Your last 5 real fees fit 2.29% + $0.09", with a Use these rates button.
Inbound Email (General tab)
Inbound email settings live on the General tab alongside Outbound Email, keeping all email configuration in one place.
| Setting | Description |
|---|---|
| Your support email address | Every account gets a dedicated {slug}@serveloapp.com address. Email sent there automatically becomes a new ticket. See Email Integration. |
| Notification email | Where new-ticket and customer-reply alerts are sent. Leave blank to use the admin account email. |
| Auto-assign inbound emails to | Which team member new email tickets get assigned to by default. Prevents new tickets from sitting unassigned. |
| Sender blacklist | One entry per line. Exact addresses (e.g. noreply@example.com) or entire domains (e.g. @example.com) are silently dropped without creating a ticket. noreply@, no-reply@, and Servelo addresses are always blocked automatically. |
Email Sending
| Setting | Description |
|---|---|
| From Name | Sender name shown in email clients. Defaults to Tenant Name if blank. |
| Support / Reply-To Email | Used as the reply-to address on quotes. Ticket emails use a per-ticket reply address automatically. |
Company Contact
| Setting | Description |
|---|---|
| Company Phone | Displayed in quote headers sent to customers. |
| Company Email | Contact email shown on quote headers. Can differ from the outgoing email address. |
| Company Address | Physical address shown on quote headers. |
Categories
Manage all dropdown lists in Settings > Categories. Categories are per-tenant and fully customizable. Preset entries cannot be deleted but can coexist with your custom entries. Add several at once by separating them with commas โ typing Business Checking, PayPal into Payment Accounts creates both in one submit.
| Section | Used in |
|---|---|
| Expense Categories | Expense entries โ e.g. Fuel, Software, Equipment |
| Payment Accounts | "Account paid from" on expenses โ e.g. Business Chase, Business Amex, Cash |
| Work Types | Revenue category and ticket work type โ e.g. Repair, Installation, Consulting, Network |
| Payment Methods | How clients pay on tickets โ e.g. Cash, Credit Card, Venmo |
| Customer Sources | Where clients came from โ e.g. Google, Referral, Thumbtack |
| Asset Types | Asset tracking โ e.g. Laptop, Server, Printer |
Integrations
Third-party integrations are managed under Settings > Integrations.
| Integration | What it does |
|---|---|
| Google Calendar | Connect your Google Calendar so scheduled tickets sync automatically. Each team member manages their own connection from My Account. When you set a date on a ticket, an event is created in the linked calendar. |
| Outlook Calendar | Connect your Microsoft Outlook Calendar so scheduled tickets sync automatically. Works alongside Google Calendar. Each person manages their own connection from My Account. |
| Square | Accept credit and debit card payments on invoices. Once connected, every sent invoice gets a prefilled Square checkout link. Invoices are marked paid automatically when the customer completes payment. Square is also used for deposit checkout links on quote acceptance. To connect: Go to Settings > Integrations > Square and click Connect Square. You will be redirected to Square to authorize Servelo. Sign in to your Square account and approve the permissions. You are then redirected back to Servelo and the integration is active. You need an existing Square seller account. Sign up at squareup.com if you don't have one. Square location: once connected, choose which Square location this tenant's payments go to. Customers see that location's business name on their receipt and card or bank statement. To run two businesses on one Square account (all paid out to the same bank), add a location for each in Square Dashboard > Settings > Locations, connect Square in each tenant, and pick that business's location. Disconnecting one tenant doesn't affect the other. Reconnect: when Servelo needs a new Square permission (for example saving cards for autopay), click Reconnect next to Square and approve again. It keeps your connection and your chosen location; nothing is disconnected. |
| QuickBooks Online | Push invoices to your books with one click. Customers are matched or created automatically. A "Push to QuickBooks" button appears on every invoice once connected. To connect: Go to Settings > Integrations > QuickBooks Online and click Connect QuickBooks. You will be redirected to Intuit to authorize Servelo. Sign in with your QuickBooks Online credentials and approve access. Once connected, a Push to QuickBooks button appears on every invoice. Clicking it creates or matches the customer in QuickBooks and pushes the invoice. You need an active QuickBooks Online subscription (Simple Start or higher). |
| Thumbtack | Automatically create a ticket and client when a new Thumbtack lead comes in. Customer messages sent via Thumbtack are appended as ticket comments. Setup: in Thumbtack go to Business settings → Integrations → Webhooks → Create a webhook and paste your Servelo webhook URL. Note: Thumbtack does not include the customer's email in lead webhooks. Add it to the client profile manually if needed. |
| AI assistants | Let your team use Servelo from Claude, ChatGPT, Gemini, or another assistant that supports MCP. Each person connects from their own assistant and gets only their own Servelo permissions. Admins choose who can connect (Everyone, Admins only, or Off) and see how many assistants are connected. Each person sees and disconnects their own connections in My Account. The card also has a copy button for the connector URL. See AI Assistants for setup. |
| AI Job Planner | Configure an AI provider for the Job Planner on tickets. Without a key, Servelo falls back to Groq (free tier, context limits apply). See AI Job Planner setup below for instructions on getting a key for each provider. |
Draft reply instructions
In My Account > Email and AI, you can tell the Draft reply button on a ticket how to write for you: how to open, pricing wording, what to ask, and how to sign off. They're your own, and if you belong to more than one business, each has its own. With instructions saved, drafts use the AI provider chosen below, with Groq as the fallback, and a reply on an ongoing ticket continues the conversation instead of introducing the business again. Leave the box empty for a short reply with no greeting or sign-off.
AI Job Planner
The AI Job Planner on each ticket uses a configurable AI provider. Other AI features (draft reply without your own instructions, quote assist, thread summarize) always use Groq and are not affected by this setting, except requests that include an image (e.g. quote assist from a photo), which are routed to Google Gemini instead. Groq currently has no vision-capable model, so any photo-attached request, whether from the Job Planner or these other features, is automatically sent to Gemini using a Servelo-managed key, not your own configured provider.
Without a configured provider, the planner falls back to Groq. Groq works well for short conversations but has token limits that can cause errors on longer or more complex planner sessions.
For the best experience, we strongly recommend connecting a Claude (Anthropic) API key. Claude handles long job histories, multi-step action plans, and nuanced follow-up drafts with significantly better accuracy than the free Groq tier. API costs for typical use are minimal.
You can configure up to three providers and switch between them at any time. The model selector lets you pick which model each provider uses without needing a code deployment.
Claude (Anthropic)
- Go to console.anthropic.com and sign in or create an account.
- Click API Keys in the left menu.
- Click Create Key, give it a name (e.g. "Servelo"), and copy the key immediately. It is only shown once.
- In Servelo, go to Settings > Integrations > AI Job Planner, click Setup, expand Claude, and paste the key.
Usage is billed by Anthropic per token. Recommended model: Sonnet 4.6 (balanced speed and quality). Use Haiku 4.5 if cost is a concern.
Gemini (Google)
- Go to aistudio.google.com and sign in with your Google account.
- Click Get API key in the left menu.
- Click Create API key, select or create a Google Cloud project, and copy the key.
- In Servelo, expand Gemini under AI Job Planner and paste the key.
Gemini's Flash-tier models have a generous free tier. Paid usage is billed through Google Cloud. Google periodically retires older model versions; if the planner starts erroring with a message like "model ... is no longer available," open the provider's Setup panel and pick a currently-listed model from the dropdown.
OpenAI
- Go to platform.openai.com and sign in or create an account.
- Click API keys in the left menu.
- Click Create new secret key, give it a name, and copy it immediately.
- In Servelo, expand OpenAI under AI Job Planner and paste the key.
Usage is billed by OpenAI per token. GPT-4o mini is the default and is fast and low cost. Use GPT-4o for more complex job planning.
Security (Two-Factor Authentication)
Each user can enable two-factor authentication on their own account from Settings > Security. Servelo uses time-based one-time passwords (TOTP), compatible with 1Password, Google Authenticator, Authy, and other standard authenticator apps.
- Click Enable MFA. A QR code appears.
- Scan the QR code with your authenticator app, or enter the secret manually.
- Enter the 6-digit code your app displays to finish enabling MFA.
- Save the 10 backup codes shown. Each one works once if you lose access to your authenticator.
Once enabled, you'll be prompted for a code (or a backup code) every time you sign in. To turn MFA off, go back to Settings > Security and enter your password plus a current code.
If you start setup and come back later, Servelo remembers your pending secret so you can finish with the same QR code you already scanned. Click Continue setup to enter a code, or Start over to generate a fresh QR.
SLA Tracking
Service Level Agreement tracking is configured under Settings > SLAs. When enabled, Servelo monitors every open ticket and emails a breach alert when a ticket exceeds its response or resolution target.
| Priority | Typical use |
|---|---|
| Urgent | Service completely unavailable or data loss occurring |
| High | Major feature unavailable with no workaround |
| Normal | Issue partially impaired, workaround available |
| Low | General questions, requests, documentation |
Set a response target (time to first reply) and a resolution target (time to close) for each priority level. Targets are counted in business hours. Configure the days and time window that match your working schedule.
Breach alerts are sent to the ticket's assigned technician and the org admin. Each breach type (response, resolution) alerts once per ticket so inboxes don't get flooded.
/portal/{slug}/sla and linked from your customer portal landing page. See Customer Portal → Portal SLA page.
Billing
The Billing tab shows where your account stands (free trial, active, cancelled, or past due) and the payment method on file. Every tenant has every Servelo feature, with no limit on users or tickets.
Your price is set with you, based on your team and what you need. To start paying, change how you pay, or ask about your bill, send us a message through our contact page.
Card and bank transfer
If you pay by card, Update card changes the card on file. Your card is stored by Square, so Servelo never sees the full number. Switch to bank transfer moves you off the card: each billing cycle, Servelo emails you a secure link to pay from your bank account instead of charging a card. Your bank's name and last 4 digits appear after your first bank payment.
Audit Log
The Audit Log records significant actions taken by your team: ticket and client creation, status changes, user invitations, settings updates, and more. Each entry shows the actor, the action, and the timestamp.
- Only admin-role users can access the Audit Log from the sidebar.
- Use the date range, actor, and action-type filters to narrow results.
- Export the visible log to CSV for compliance review or record keeping.