# Amomic-AI > Amomic-AI is a conversational AI platform for customer-facing teams in India. > One agent, grounded in your own knowledge base, answers on WhatsApp, on the > phone in English and Indian languages, and in a web chat widget — and the same > agent is reachable from your own backend over a REST API with signed webhooks. Every page below is also available as raw markdown by appending `.md` to its URL. The full corpus in one file: https://docs.amomic.in/llms-full.txt The machine-readable API contract: https://docs.amomic.in/openapi.json ## Get started - [Quickstart](https://docs.amomic.in/start/quickstart.md): Put a working AI agent on your website in about five minutes — no code, no card. - [Your first API call](https://docs.amomic.in/start/first-api-call.md): Mint a key, verify it, and send a real WhatsApp message from your own backend. - [What you can build](https://docs.amomic.in/start/what-you-can-build.md): Six things people actually ship on Amomic-AI, what each one takes, and an honest list of what this is not for. ## Concepts - [How it fits together](https://docs.amomic.in/concepts/architecture.md): The whole model in one page — workspaces, agents, versions, deployments, channels, and the two ways in. - [Workspaces & roles](https://docs.amomic.in/concepts/workspace.md): What a workspace owns, what owners, admins, and members can each do, and why API keys belong to the workspace rather than to you. - [Conversations & contacts](https://docs.amomic.in/concepts/conversations.md): What a conversation is across channels, how transcripts are structured, and how one person is recognised across WhatsApp, the web, and the phone. - [Glossary](https://docs.amomic.in/concepts/glossary.md): Every term in these docs, defined in a few sentences, with a link to the page that covers it properly. ## Build an agent - [Agents & versions](https://docs.amomic.in/build/agents.md): Create an agent, write a purpose that actually produces a good agent, and publish immutable versions you can roll back to. - [Knowledge bases](https://docs.amomic.in/build/knowledge.md): The five source types, how crawling and retrieval actually work, refresh schedules, and how to get good answers instead of confident guesses. - [Tools & actions](https://docs.amomic.in/build/tools.md): The built-in tools an agent can call, how to turn your own API or MCP server into one, and the policy that decides when anything is allowed to fire. - [Deployments](https://docs.amomic.in/build/deployments.md): A deployment is a version on a channel. The lifecycle, what activation does, why editing a live one clones it, and what pausing actually clears. - [Testing & publishing](https://docs.amomic.in/build/testing.md): What to actually test before an agent talks to customers, the two failure modes worth hunting, and the readiness checks that gate publishing. ## Channels - [Set up WhatsApp](https://docs.amomic.in/channels/whatsapp.md): Connect your own WhatsApp Business number through Meta and put an agent on it. - [The 24-hour window](https://docs.amomic.in/channels/whatsapp-window.md): When you can send free-form WhatsApp text, when you must use a template, and the 409 you get when you are wrong. - [Templates](https://docs.amomic.in/channels/whatsapp-templates.md): Write, submit and send the pre-approved WhatsApp messages that reach customers outside the 24-hour window. - [How voice works](https://docs.amomic.in/channels/voice.md): What happens when a call reaches your number — routing, the opening line, transcripts, recording, and every status and outcome a call can end in. - [Numbers & KYC](https://docs.amomic.in/channels/phone-numbers.md): Request a phone number, get through the compliance review, put an agent on it, and set the greeting, language, recording and time cap that number runs with. - [Languages](https://docs.amomic.in/channels/voice-languages.md): Call mode decides which languages your agent can follow; opening language decides which one it starts in. The difference, the eleven languages, and how to choose. - [Outbound calls](https://docs.amomic.in/channels/outbound-calls.md): Your agent calls the customer — what they hear first, which agent speaks, the guards that protect you, and the compliance that is yours to own. - [Install the widget](https://docs.amomic.in/channels/web-chat.md): One script tag puts your agent on your website. Where to paste it, the framework variants, the domain allowlist, and the errors a misconfigured install produces. - [Customise the widget](https://docs.amomic.in/channels/web-chat-config.md): Colours, greeting, launcher, position and image upload — everything you can change about the widget from the console, and the few things you cannot. - [Capture leads](https://docs.amomic.in/channels/web-chat-leads.md): Ask visitors for a name, email or phone number in the widget, turn the answer into a contact, and give the agent a number it can follow up on. ## API reference - [API overview](https://docs.amomic.in/api/overview.md): The base URL, the shape of every request, and the complete route table for the Amomic-AI REST API. - [Authentication](https://docs.amomic.in/api/authentication.md): API key format, the two header forms, the six distinct causes of a 401, and how to roll a key without downtime. - [Scopes](https://docs.amomic.in/api/scopes.md): The six scopes, exactly which endpoints each one unlocks, and why a new key can only read. - [Errors](https://docs.amomic.in/api/errors.md): One envelope, nine codes, and the complete catalogue of details.reason values with what to do about each. - [Rate limits](https://docs.amomic.in/api/rate-limits.md): 120 requests per key per minute on a fixed window, what the headers tell you, and how to back off without a Retry-After. - [Idempotency](https://docs.amomic.in/api/idempotency.md): Send an Idempotency-Key on the three POST endpoints that honour it and a retry replays the stored response instead of doing the thing twice. - [Pagination](https://docs.amomic.in/api/pagination.md): One envelope, one cursor, one rule — next_cursor is non-null only when the page came back full, and a short page ends the walk. - [Messages](https://docs.amomic.in/api/messages.md): Send a WhatsApp message from your own systems — free-form text inside the 24-hour window, or an approved template outside it. - [Calls](https://docs.amomic.in/api/calls.md): Place an outbound AI voice call, read its outcome, and hang it up — the three endpoints that drive the phone from your own systems. - [Conversations](https://docs.amomic.in/api/conversations.md): List conversations, read one, and pull its transcript — the read side of everything your agents say and hear. - [Tickets](https://docs.amomic.in/api/tickets.md): Open a support ticket from your own systems and read it back — including the deduplication that stops a retry becoming two tickets. - [Contacts](https://docs.amomic.in/api/contacts.md): Upsert a person into your workspace directory by email or phone, so the customer your CRM knows is the customer our inbox knows. - [Agents & channels](https://docs.amomic.in/api/discovery.md): Four read-only endpoints that tell your backend what this workspace has — which agents exist, which senders are connected, what your key can do, and the machine-readable contract. ## Webhooks - [Getting events](https://docs.amomic.in/webhooks/overview.md): Have Amomic-AI POST a signed JSON event to your server when a customer replies, a call ends, or a ticket opens. - [Verifying signatures](https://docs.amomic.in/webhooks/signatures.md): Every webhook carries a timestamped HMAC-SHA256 signature over the raw body. Verify it, in constant time, against the exact bytes you received. - [Event reference](https://docs.amomic.in/webhooks/events.md): All nine webhook event types with the exact fields each one emits, realistic payloads, and the omission rule that breaks naive consumers. - [Retries & failures](https://docs.amomic.in/webhooks/reliability.md): Four attempts over about a minute, which responses stop the ladder, the fifteen-failure auto-disable, and how to catch up when there is no replay endpoint. ## Recipes - [Send an order update on WhatsApp](https://docs.amomic.in/recipes/order-updates.md): The complete order-shipped flow — approved template, idempotent send, error branching, and the webhooks that tell you it landed and that the customer replied. - [Trigger an AI call from your CRM](https://docs.amomic.in/recipes/crm-call.md): Place an outbound AI call when a deal changes stage, wait for the outcome properly, and write a disposition back to the record. - [Sync conversations into your warehouse](https://docs.amomic.in/recipes/sync-conversations.md): A complete incremental sync job — the cursor loop done correctly, a watermark that survives restarts, transcript pulls, pacing against the rate limit, and the webhooks that make it fresh. - [Escalate a conversation to a ticket](https://docs.amomic.in/recipes/support-escalation.md): Open a ticket from your own system when a customer needs a human — requester details, choosing a priority, the dedupe that stops a retry becoming two tickets, and syncing status back with webhooks. ## Operate - [Going live](https://docs.amomic.in/operate/going-live.md): The pre-launch checklist for an integration that sends real messages to real customers — keys, scopes, idempotency, webhooks, error handling, the 24-hour window, and rate-limit headroom. - [Limits & plans](https://docs.amomic.in/operate/limits.md): The four plans and what each includes, which limits actually block a create, the 120-per-minute API rate limit, call concurrency, and every field and size bound in one table. - [Security & data](https://docs.amomic.in/operate/security.md): How API keys are stored and why they cannot be recovered, rolling versus revoking, the no-CORS posture, webhook signing, workspace isolation, what the request log keeps, call recording, and how to report a vulnerability. - [API versioning](https://docs.amomic.in/operate/versioning.md): What /api/v1 promises, which changes we may ship without notice, what would require a new version, and how to write client code that survives both. - [Troubleshooting](https://docs.amomic.in/operate/troubleshooting.md): Symptom-first index of every error the API returns — what you see, what it means, and how to fix it, including all six 401 reasons, both flavours of 429, webhook signature failures, and calls stuck in ringing. - [Changelog](https://docs.amomic.in/operate/changelog.md): What shipped and when, for anyone maintaining an integration against the public API, and how this changelog is maintained.