# Facia Docs

> How to run a business on Facia, set it up (domains, email, AI keys), and build on it (blocks, apps, the partner API). For owners, teams, builders and developers.

Every page is also available as Markdown: add .md to its address. The whole docs in one file: https://docs.facia.chat/llms-full.txt

## Get started

- [Facia Docs](https://docs.facia.chat/index.md): Everything you can do on Facia, and how to do it. For business owners, teams, builders and developers.
- [What is Facia](https://docs.facia.chat/start/what-is-facia.md): A support chat and community app that a business runs under its own name, with your look, your domain and your rules.
- [Create a server](https://docs.facia.chat/start/create-a-server.md): Get your business on Facia, with or without a referral code, and sign in for the first time.
- [Your first hour](https://docs.facia.chat/start/first-hour.md): The checklist that takes a new server from empty to ready for clients.
- [Key ideas](https://docs.facia.chat/start/concepts.md): Servers, workspaces, roles, clients, tiers, chats, HQ and features, and how they fit together.
- [Set it up with AI](https://docs.facia.chat/start/setup-with-ai.md): Copy-paste prompts that let Claude, ChatGPT or any assistant plan your server, write your texts, set up your domain and email, and build apps with you.

## Run your business

- [Business settings](https://docs.facia.chat/business/settings.md): Name, logo, handle, welcome message, support links, perks, goal and the other settings of one business.
- [Look and style](https://docs.facia.chat/business/look.md): Presets, accent colours, corners and styles (Classic, Futuristic or your own) for your business, plus each person's own look.
- [Features](https://docs.facia.chat/business/features.md): Turn built-in parts of Facia on and off per business, with bundles, dependencies and per-feature settings.
- [Team and roles](https://docs.facia.chat/business/team.md): Invite staff, pick roles, choose businesses, set per-person permissions and manage devices.
- [The support inbox](https://docs.facia.chat/business/inbox.md): Answer clients: tabs, assigning, snoozing, resolving, notes, saved replies, tags, returning clients, merges, blocking and deleting.
- [Groups and channels](https://docs.facia.chat/business/community.md): Community groups where clients talk under random names, channels where only your team posts, invite links, mutes, tags and pins.
- [What clients see](https://docs.facia.chat/business/client-view.md): The client's side of Facia, from first message to saved account, settings, install and privacy.
- [Membership and tiers](https://docs.facia.chat/business/membership.md): Guest, Verified, VIP and Spam; the Get verified flow; perks; VIP by level or invitation; members-only groups and the membership hub.
- [Levels and coins](https://docs.facia.chat/business/levels-coins.md): Client levels from payments, level rewards, and per-client coin balances with a full ledger.
- [Games](https://docs.facia.chat/business/games.md): Hot Potato, High Card, raffle spins, the leaderboard, the Games & more page and game cards in the group chat.
- [Blocks](https://docs.facia.chat/business/blocks.md): Build pages, polls, announcements, missions and raffle spins without code, and place them where clients will see them.
- [HQ](https://docs.facia.chat/business/hq.md): The staff control room. Overview, Analytics, Clients, Payments, Team, Activity, Bots, Live TV and Settings.
- [The AI bot](https://docs.facia.chat/business/ai.md): Your business's AI. Ask it about the business, let it read receipts, suggest tags, propose improvements, and run it on your own provider key.
- [Voice calls](https://docs.facia.chat/business/calls.md): Voice calls between your team and clients, clients and each other, plus live voice rooms in groups.
- [Growth and invites](https://docs.facia.chat/business/growth.md): Share links, QR codes, campaign links, friend referrals, group invites, team invites, sources and referring other businesses.
- [Notifications and the app](https://docs.facia.chat/business/notifications.md): Push notifications, installing Facia on the home screen with your name and icon, and in-app browsers.

## Connect your stuff

- [Domains](https://docs.facia.chat/setup/domains.md): Your free yourhandle.facia.chat address, and connecting your own domain like chat.yourbrand.com with one DNS record.
- [Email (Resend)](https://docs.facia.chat/setup/email.md): Send sign-in and verification emails under your business name, from your own domain, or through your own Resend account.
- [AI provider keys](https://docs.facia.chat/setup/ai-keys.md): Run your business bot on your own Anthropic, OpenAI or OpenAI-compatible key, with a monthly spending cap.
- [Embed Facia](https://docs.facia.chat/setup/embed.md): Put your Facia chat on your own website with one script tag, or in an iframe or native app WebView, with theme and name hints.
- [Connect a website](https://docs.facia.chat/setup/connect-website.md): Link your Facia support chat to a partner website or platform with a one-time connect code.

## Build on Facia

- [Build on Facia](https://docs.facia.chat/build/overview.md): The ways to extend Facia (blocks, apps, the partner API and embeds) and which one to pick.
- [Your first app](https://docs.facia.chat/build/first-app.md): Build, run and register a Facia app in about 15 minutes, with a Node server, one page, token verification and a coin call.
- [The token](https://docs.facia.chat/build/token.md): The signed JWT Facia gives your app. Every claim, how long it lasts, and how to verify it in Node, Python, Go and PHP.
- [The frame bridge](https://docs.facia.chat/build/bridge.md): facia-app.js, the theme variables, safe-area insets and the postMessage protocol between your page and Facia.
- [Partner API](https://docs.facia.chat/build/partner-api.md): Every call your app's server can make to Facia (coins, scores, badges, group posts, push, missions) with bodies, responses, errors and limits.
- [Listing your app](https://docs.facia.chat/build/listing.md): Offer your app to every business on Facia. How review, installs, per-business secrets and turning off work.
- [Recipes](https://docs.facia.chat/build/recipes.md): Short, complete patterns for common apps. A coin raffle, a scored game, a daily check-in mission, a members-only shop and a staff tool.

## Reference

- [Roles and permissions](https://docs.facia.chat/reference/roles-permissions.md): Every role, every agent and manager permission with defaults, and the fixed rules about who sees what.
- [Feature reference](https://docs.facia.chat/reference/features.md): Every Facia feature, with its key, default, dependencies, scope, where it shows and its settings.
- [Limits](https://docs.facia.chat/reference/limits.md): Sizes, counts, time windows and rate limits across Facia, in one table.
- [Addresses and URLs](https://docs.facia.chat/reference/addresses.md): Every public address in Facia, from app routes and HQ tabs to settings pages, embeds, invites, API endpoints and docs files.
- [Glossary](https://docs.facia.chat/reference/glossary.md): The words Facia uses, in alphabetical order.
- [Docs for AI assistants](https://docs.facia.chat/reference/llms.md): How Claude, ChatGPT, Cursor and other assistants can read these docs, plus the ground rules they should follow when helping with Facia.
- [What's in beta](https://docs.facia.chat/reference/status.md): Which parts of Facia are in beta, what's coming next, and what isn't available yet.