Configuration

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

SettingDescription
Tenant NameYour business name. Shown in the sidebar, portal header, emails, quotes, and invoices.
Your TradeThe 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 toolsShows 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.
ThemeAccent 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.

SettingDescription
LogoDisplayed 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 ColorAccent 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 URLOptional. 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.

SettingDescription
Next Ticket NumberThe 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 personEmails whoever is assigned to a scheduled ticket before the visit. See Appointment reminders.
Remind the clientEmails the client before their visit (only clients with Suppress emails unchecked).
Send remindersHow 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.

SettingDescription
Hourly Labor (per hr)Default rate pre-filled when adding a labor line item to a quote.
Service Call / DiagnosticDefault rate pre-filled when adding a service call line item to a quote.
Pricing notes for AIThe 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 BookYour 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.

SectionDescription
Payment LinksYour 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 RemindersWhen new invoices are due, and whether unpaid ones get reminder emails.

Portal

SettingDescription
Portal EnabledToggle the customer portal on or off. When off, magic link requests return an error.
Allow New TicketsControls whether customers can submit new service requests from the portal.
Hero TitleLarge headline shown on the portal landing page. Defaults to "Get Help Fast".
TaglineSubtitle text below the hero title.
Schedule URLOptional 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 BookingA 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 EmailWho gets notified when a customer submits a ticket or reply via the portal. Defaults to the first admin user's email.
Custom DomainServe your portal at a custom URL like support.yourdomain.com. Requires a DNS CNAME record; an SSL certificate is provisioned automatically on first visit.
โ„น๏ธ The Live Chat widget is configured on the Chat tab of this page. See the Live Chat docs for details.

Team

The Team tab is where you manage everyone with access to your Servelo account.

SettingDescription
Users listInvite admins and technicians, change roles, deactivate or reactivate, resend login links. See Users & Team for full details.
Show admins in technician listWhen 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 ratePublished 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 payment2.99%
Square card reader or Tap to Pay (in person)2.6% + $0.15 (Free plan)
Square online / payment links3.3% + $0.30 (Free plan)
Square Invoices (card)3.3% + $0.30 (Free plan)
Square keyed-in / card on file3.5% + $0.15
Stripe online card2.9% + $0.30
Stripe Terminal (in person)2.7% + $0.05
Venmo business payment1.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

Inbound Email (General tab)

Inbound email settings live on the General tab alongside Outbound Email, keeping all email configuration in one place.

SettingDescription
Your support email addressEvery account gets a dedicated {slug}@serveloapp.com address. Email sent there automatically becomes a new ticket. See Email Integration.
Notification emailWhere new-ticket and customer-reply alerts are sent. Leave blank to use the admin account email.
Auto-assign inbound emails toWhich team member new email tickets get assigned to by default. Prevents new tickets from sitting unassigned.
Sender blacklistOne 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

SettingDescription
From NameSender name shown in email clients. Defaults to Tenant Name if blank.
Support / Reply-To EmailUsed as the reply-to address on quotes. Ticket emails use a per-ticket reply address automatically.

Company Contact

SettingDescription
Company PhoneDisplayed in quote headers sent to customers.
Company EmailContact email shown on quote headers. Can differ from the outgoing email address.
Company AddressPhysical 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.

SectionUsed in
Expense CategoriesExpense entries โ€” e.g. Fuel, Software, Equipment
Payment Accounts"Account paid from" on expenses โ€” e.g. Business Chase, Business Amex, Cash
Work TypesRevenue category and ticket work type โ€” e.g. Repair, Installation, Consulting, Network
Payment MethodsHow clients pay on tickets โ€” e.g. Cash, Credit Card, Venmo
Customer SourcesWhere clients came from โ€” e.g. Google, Referral, Thumbtack
Asset TypesAsset tracking โ€” e.g. Laptop, Server, Printer

Integrations

Third-party integrations are managed under Settings > Integrations.

IntegrationWhat 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)

  1. Go to console.anthropic.com and sign in or create an account.
  2. Click API Keys in the left menu.
  3. Click Create Key, give it a name (e.g. "Servelo"), and copy the key immediately. It is only shown once.
  4. 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)

  1. Go to aistudio.google.com and sign in with your Google account.
  2. Click Get API key in the left menu.
  3. Click Create API key, select or create a Google Cloud project, and copy the key.
  4. 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

  1. Go to platform.openai.com and sign in or create an account.
  2. Click API keys in the left menu.
  3. Click Create new secret key, give it a name, and copy it immediately.
  4. 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.

  1. Click Enable MFA. A QR code appears.
  2. Scan the QR code with your authenticator app, or enter the secret manually.
  3. Enter the 6-digit code your app displays to finish enabling MFA.
  4. 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.

โ„น๏ธ Lost access to your authenticator and backup codes? A system admin can clear MFA for your account from the System Admin panel so you can set it up again.
โ„น๏ธ All settings are admin-only. Technician-role users can view settings but cannot make changes.
โ„น๏ธ If your tenant belongs to a multi-tenant group, a Cross-Tenant Clients section also appears on this Security tab. See Cross-Tenant Clients for details.

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.

PriorityTypical use
UrgentService completely unavailable or data loss occurring
HighMajor feature unavailable with no workaround
NormalIssue partially impaired, workaround available
LowGeneral 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.

โ„น๏ธ When SLA tracking is enabled, a public Service Level Agreement page is automatically available at /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.

โ„น๏ธ On a free trial, the Billing tab shows the date the trial ends. When it ends, Servelo asks you to email us to keep using it. Your data is kept.

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.