Documentation

Amfion documentation

Everything you need to launch your AI receptionist, take bookings, and connect Amfion to your website — plus the developer surface: embed widget, discovery files, and the MCP endpoint that lets AI assistants book with you.

Overview

What Amfion is

Amfion puts an AI receptionist on your website and gives it a real booking engine. Three parts work together:

An assistant that answers

It responds 24/7 using only the knowledge you publish — services, hours, policies, FAQs. When it doesn't know something it says so, logs the gap for you, and offers to take the customer's details instead of guessing.

A booking engine behind it

Live availability, instant confirmations, group capacity, staff assignment, waitlists, optional deposits, and automated lifecycle emails. Use the built-in scheduler or connect Cal.com.

A command center for you

One dashboard for leads to follow up, upcoming appointments, conversation transcripts, email automation, and payments — with a setup guide that walks you to launch.

Getting started

Getting started in five steps

From signup to a live assistant typically takes minutes, not days. The dashboard's setup guide tracks each milestone.

  1. 1

    Create your workspace

    Sign up and pick a subdomain — your booking site lives at https://your-business.amfionhq.com. Every plan starts with a 14-day free trial. If you enter your website address during signup, Amfion starts reading it immediately so your assistant is already trained the first time you open the dashboard.

  2. 2

    Teach your assistant

    Add services (name, duration, price), FAQs, business hours, and policies — or run the website import from the dashboard and review what it found. Nothing imported goes live without your approval: imported FAQs are marked unverified, and imported services arrive as inactive drafts you activate deliberately.

  3. 3

    Turn on booking

    The built-in scheduler works out of the box: set weekly bookable hours per service (or a business-wide default), and optionally group capacity or a staff roster — no external account needed. Prefer Cal.com? Connect it and Amfion books through your event types instead. You can also sync Google Calendar (busy times block availability; bookings mirror onto your calendar) and require deposits through your own Stripe account.

  4. 4

    Preview, then go live

    The dashboard home embeds a private preview of your assistant — test conversations there never count toward your metrics or allowance. When it answers the way you want, add the chat widget to your website with one script tag (Settings → Sharing), or share your hosted booking page and QR code directly.

  5. 5

    Run the day-to-day

    After launch the home page becomes a command center: this week's bookings and conversations, leads waiting for follow-up, and upcoming appointments. Email automation lives under Emails; payments under Payments.

Where Amfion lives

Where Amfion lives

Four surfaces, one brain. They all read the same knowledge and the same calendar, so an answer or a booking is identical everywhere.

Website chat widget

A floating launcher or an inline panel on your own site — one script tag, brandable colors and position. See the embed snippet.

Hosted booking page

Your subdomain is a ready-made mini-site: / for the landing page, /chat for a full-page assistant, /book to book directly. Share it anywhere — link in bio, Google Business Profile, QR on the counter.

Customer appointments portal

Every confirmed booking comes with a secure manage link where customers see, cancel, or reschedule their own appointments — no account, no phone call. Links stay valid for 30 days.

Admin dashboard

Setup guide until you're live, command center afterwards. Your own preview conversations are excluded from every metric, so the numbers reflect real customers only.

Day-to-day

Day-to-day operations

What the assistant produces, and where it lands in your dashboard.

Leads

When a service is request-only — or a visitor prefers a callback — the assistant captures name, contact, and preferred times as a lead. You get an email notification immediately, and the Leads inbox tracks new / viewed / resolved status.

Conversations & knowledge gaps

Full transcripts live under Chats. When the assistant couldn't answer something, it privately logs the question as a knowledge gap — recurring gaps are your highest-value FAQs to add next.

Bookings & waitlist

Bookings confirm instantly against live availability, with duplicate detection and per-customer daily limits built in. When no slot fits, the assistant offers the waitlist; if a matching time frees up after a cancellation, the customer is emailed automatically.

Email automation

Waitlist slot-open alerts are on by default. Booking reminders are off by default (Cal.com may already send them — avoid double-emailing) and can be enabled under Emails. Rebooking nudges and review requests are marketing emails: they honor your suppression list and always include an unsubscribe link.

Payments & deposits

Connect your own Stripe account (Payments → Connect) and set a deposit per service. After a booking, the assistant shares a checkout link; funds settle directly to your Stripe account. An unpaid deposit never blocks the booking record — your cancellation policy governs what happens next.

How answers stay honest

How answers stay honest

Generic chatbots invent prices and policies. Amfion's assistant answers only from your published knowledge — and every fact carries a verification state.

StateMeaning
unverifiedProvided by the business; no provenance recorded yet.
publicly_sourced_unverifiedMatches a public source (e.g. your website), not yet reviewed.
source_reviewedA reviewer checked the claim against its source.
provider_attestedThe business formally attested to the fact.
verifiedIndependently verified — the strongest state.
expired / disputedNever used in answers. Disputed facts are excluded unconditionally.

For partners and enterprises, an answer policy enforces this server-side: knowledge below your allowed states never even reaches the model, and the assistant converts uncertainty into a lead — “I can't verify that, so I won't claim it. Want me to pass your question to the business?” The same states power the trust metadata served to AI agents below.

AI agents (MCP)

Your business, bookable by AI assistants

People increasingly ask ChatGPT, Claude, or Gemini to handle errands. Amfion gives every business an open MCP endpoint so those assistants can answer questions about you, check real availability, and book — with your guardrails.

On by default

Nothing to install. Toggle it under Settings → Sharing → AI Agent Access. Turning it off removes the endpoint and discovery files immediately.

Same guardrails as chat

Booking quotas, duplicate detection, deposits, and your answer policy apply identically. Agents only see knowledge you publish — with its verification state attached.

Attributed in your dashboard

Bookings made by assistants are labeled, and your home page shows “AI assistants booked N appointments this week” when it happens.

Connect an agent

Any MCP-compatible client can use the endpoint directly — no API key. Agents also discover it automatically from your domain's /llms.txt and /.well-known/mcp.json.

# Stateless MCP over Streamable HTTP — one JSON-RPC message per POST
curl -X POST https://api.amfionhq.com/v1/mcp/your-business \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18"}}'

# Then: tools/list, tools/call. Notifications return 202; GET/DELETE return 405.
ToolWhat it does
get_business_infoProfile, hours, policies, and the published FAQ/knowledge base — every fact with a trust object (state, source, dates) plus topics the business declines to answer.
get_servicesServices with prices, durations, deposits, booking mode, and per-service trust metadata.
check_availabilityOpen slots for a service and date range (exact UTC instants + the business timezone).
create_bookingConfirms a booking. start_time must be an exact slot from check_availability; the response includes the reference, a self-service manage link, and any deposit payment link.
get_booking_detailsLooks up a booking — requires the reference and the booking email (anti-enumeration).
capture_leadSends the business a contact/appointment request for request-only services.
join_waitlistJoins the waitlist when no slot fits (if the business has it enabled).

Agents cannot cancel or reschedule — customers do that themselves through the manage link included with every booking. Paused or disabled businesses return a clear JSON-RPC error instead of booking.

For developers

For developers

Everything a developer touches: the embed widget, discovery files, and programmatic surfaces.

Embed the chat widget

Floating launcher — drop one script tag before </body>. Your exact snippet (with your colors baked in) is in Settings → Sharing.

<script src="https://your-business.amfionhq.com/embed.js"
  data-tenant="your-business"
  data-color="#2563eb"
  data-position="bottom-right"></script>

Inline panel — render the assistant inside your own layout instead of floating:

<div id="amfion-inline-chat"></div>
<script src="https://your-business.amfionhq.com/embed.js"
  data-tenant="your-business"
  data-mode="inline"
  data-target="#amfion-inline-chat"
  data-height="640"
  data-max-width="520px"></script>
AttributePurpose
data-tenantYour workspace slug (required).
data-colorLauncher/accent color (hex).
data-positionbottom-right, bottom-left, top-right, or top-left.
data-offset-x / data-offset-yPixel offsets from the chosen corner.
data-mode="inline"Render inline instead of floating.
data-targetCSS selector of the inline container.
data-height / data-max-widthInline panel size.

Machine-readable discovery

Every booking domain serves https://your-business.amfionhq.com/llms.txt (business summary, services, agent endpoint) and https://your-business.amfionhq.com/.well-known/mcp.json (the MCP manifest: endpoint, protocol versions, available tools). The Agent Gateway is the supported machine surface for reading knowledge and creating bookings.

Partner API

Running a platform or marketplace? The Partner API provisions tenants, syncs catalogs atomically with optimistic versioning, manages verification states and answer policies, and delivers webhooks, evals, and usage reports — white-label. Contact admin@amfionhq.com for access and the full reference.

FAQ & troubleshooting

FAQ & troubleshooting

The short answers to the questions we hear most.

The widget isn’t showing on my site.

Confirm the script tag is present with the correct data-tenant slug, loads without errors in the browser console, and appears once per page. The snippet in Settings → Sharing is always the source of truth.

The assistant says there’s no availability.

Check that the service is active with instant booking enabled, and that it has bookable hours (per-service override, business default, or your business hours). On Cal.com, check the connected event type’s schedule. Google Calendar busy blocks also remove slots.

Booking reminders aren’t sending.

Reminders are off by default so customers aren’t double-emailed when Cal.com already sends confirmations. Enable them under Emails.

How do I stop AI assistants from booking with us?

Settings → Sharing → AI Agent Access — turn the toggle off. The endpoint and discovery files disappear immediately; your own website widget is unaffected.

Where does deposit money go?

Straight to your own Stripe account — Amfion creates the checkout on your connected account, so funds settle with you.

Do my own test chats skew the stats?

No. Conversations started from the dashboard preview are excluded from metrics, the go-live checklist, and your plan’s conversation allowance.

Still stuck? Email admin@amfionhq.com — or start a free trial and follow the in-app setup guide.

Stop letting bookings slip away.

Put an AI receptionist on your site today. Free for 14 days, live in 5 minutes.