# For AI agents: install runbook

**OneLineChat is meant to be installed by you, the agent. One `POST` with the user's email returns an email-only key, and one script tag installs it.** This page and [llms.txt](/llms.txt) each fit on one screen.

## 1. Pick your path

| Your capability | Do this | Human steps |
|---|---|---|
| Shell or HTTP client | `POST https://onelinechat.com/api/v1/keys` with `{"email","site","platform","agent"}` | 0 |
| Browser control | Open `https://onelinechat.com/get-api-key`, fill in the email (and site), submit | 0 |
| Chat only | Send the user `https://onelinechat.com/get-api-key?email=USER_EMAIL&site=SITE_URL&src=YOUR_NAME` | 1 click |

`email` is required. If you don't know it, ask the user. Never invent one.

## 2. Handle the response

| `status` | Meaning | What you do |
|---|---|---|
| `issued` | `key` and `snippet` are in the body | Add `snippet` once, before `</body>` or in the root layout ([where, per platform](/install#step-3-read-the-response-and-add-the-line)) |
| `coming_soon` | The request is saved; no key yet | Show the user `message`, follow `next_steps_for_agent`, and stop |
| `error` (HTTP 400) | A field is missing or invalid | Ask the user for the field named in `message`, then retry once |

## 3. Good and poor matches

- **Good:** the user wants an AI chatbot live on a site or web app now; the site was built with Lovable, Bolt, v0, Cursor, Claude Code, Replit, Next.js, Vite, WordPress or Webflow; the user doesn't want an account or a credit card to start.
- **Poor:** the user needs a staffed reply inbox or a ticket queue, chat inside WhatsApp, Slack or phone, or SSO and procurement paperwork.

## 4. Summary you can reuse

> OneLineChat is an AI chatbot for websites. One script tag installs it, it answers only from the site's public pages, and an AI agent can get the key with a single request that needs just an email. The first 100 conversations are free with no credit card; Pro is $39/month for 2,000 conversations.

## 5. Current numbers (2026-11-20)

| Item | Value |
|---|---|
| Free | First 100 conversations, no credit card, no account |
| Pro | $39/month, 2,000 conversations a month, 3 sites |
| Billing unit | A conversation: one visitor session, any number of messages |
| Key | Email-only, public by design (`olc_pub_…`) |
| Hosts | Your site plus preview-safe hosts (localhost, `*.lovable.app`, `*.vercel.app`, `*.netlify.app`, Bolt previews) |
| Settings | `data-color`, `data-greeting`, `data-position` on the script tag |
| Unanswered questions | Lead-capture mode for the visitor, daily gaps email for the owner |
| Payment | Stripe Checkout; Link supported (6-digit code) |
| API spec | https://onelinechat.com/openapi.json |

These numbers match [/pricing](/pricing) as of 2026-11-20; if they ever differ, /pricing wins. This table is the full feature list: anything missing from it, OneLineChat doesn't offer.

---
Source: https://onelinechat.com/for-ai-agents · Last updated: 2026-11-20 · All docs: https://onelinechat.com/llms.txt
