Admin Guide

Calibrate & tune Odly

Once the basics work — channels connected, agents replying, mail routing — this is how you make Odly sound and behave like your team. Calibration is admin-facing tuning: a handful of settings you adjust after setup, plus a clear line between what you edit, what Odly learns, and what stays a fixed default. Do the earlier setup steps in the Product Guide first; come here to refine.

Every path below lives under Settings. Most tuning here needs Manage AI Prompts or admin rights — moderator/adminroles. If you don't see a section, you likely don't have the permission.

Voice

1 · Reply voice & style

The one place to shape how Odly's drafts sound. Manage AI Prompts

Reply voice is an editable template, not something Odly learns. Open Settings → AI → Prompts and write the template named reply_style (up to 2000 characters). Use it to set tone, greeting and sign-off conventions, formality, and any house phrasing rules.

Additive, not a replacement. Your reply_style layers on top of Odly's built-in reply guardrails — it refines the voice, it doesn't switch the guardrails off.
Inactive by default. A fresh org has no reply_style, so drafts read in Odly's default voice until you write one. Nothing changes until you do.
Org-wide, with department overrides. Set one voice for the whole organization, then override it per department where the tone should differ. A department template wins over the org-wide one.

The same Settings → AI → Prompts area also holds the analysis prompts — spam, message analysis, lead qualification, and follow-ups. Those steer how Odly reads incoming mail, separately from how it writes replies.

Routing

2 · Routing keys, skills & auto-assign

Control how conversations reach agents. Admin

Routing keys (skills). Define org-level skill keys used for auto-assignment in Settings → Organization. Optionally let agents self-edit their own skills with the self-edit-skills toggle.
Auto-assign mode. Choose whether Odly assigns incoming conversations to an agent automatically: off, match_only (assign only when a skill matches), or always (the default).
Brand terms. In Settings → Organization, list your product and brand words (up to 50) to exclude from learned routing keywords — so the learning engine never turns your own brand name into a routing rule.

Add brand terms early. Your company and product names show up in almost every message, so without this list the engine can mistake them for a routing signal.

Automation

3 · Auto-reply & lead qualification

Decide how much Odly does on its own. Admin

Auto-replycontrols whether the AI may draft and send automatically. It's set org-wide with per-department overrides — any department can turn auto-reply off. On Free, Odly only offers suggestions; automatic sending is a paid capability (Pro).

Lead qualification (Pro) tunes how Odly handles sales-shaped mail:

Required contact fields — which of name, email, phone, and company a lead must provide.
Qualification fields & categories — the questions and buckets used to score and sort leads.
Speed-to-Lead — a slow-lead threshold, your average lead value, and the recipients for the weekly digest.

Content

4 · Knowledge base & Confluence

The source material Odly draws answers from. Admin

Curate your knowledge-base sources so drafts cite the right material. Beyond answers you save from resolved conversations, you can connect Confluence Cloud as a live content source.

Provide the Confluence base URL, an email, an API token, and the space keys to include.
Odly syncs those spaces, pages, and folders into the knowledge base and keeps them current as your docs change.

5 · Vision & image analysis

Bring-your-own image analysis. Admin

In Settings → Organization, the vision config controls image analysis: enable it (on by default) and optionally set your own provider and model.

Vision is wired to Telegram image attachments and knowledge-base scanned-PDF / image processing — not to every channel. Enable it when those inputs matter to you.

Learning & limits

6 · The learning engine

Rules that Odly proposes from what your agents actually do. Admin

Routing and spam rules aren't hand-written — the engine proposes them by watching how your team works, and you review and approve them under Trust modes: Manual, Balanced, or Aggressive. The consistency of your team's day-to-day actions is what tunes this the most.

For the full review-and-approve workflow, see the learning-engine section of the Product Guide.

7 · What you can't tune

A precise note so you don't go looking for knobs that aren't there.

Most similarity and confidence thresholds are fixed code-level defaults, notadmin-editable settings. There is no UI slider for them — treat them as Odly's internal defaults, not something to tune.

One tunable example is a per-rule confidence threshold (default 0.75 on learned rules) that lives on each individual learned rule — a per-tenant, database-backed knob you can adjust rule by rule. Everything else in that family is a fixed default.