Repllyer Docs

Quickstart

1. Sign up at /signup with Google (no password) — you get 180 free credits.
2. Create Business → paste what you sell + upload PDFs or raw text (knowledge base).
3. Copy rply_live_... once. Regenerate anytime from Settings (you'll see prefix + ID).
4. Call POST https://repllyer.vercel.app/api/v1/session/init — no email/name needed. Our bot will ask the visitor if missing, or treat them as guest.
5. Call POST https://repllyer.vercel.app/api/v1/chat with session_id, message.
6. Validate with standalone file test-standalone.html or node scripts/test-client.js (set RPLY_KEY).

Auth

Send API key as x-api-key: rply_live_... or Authorization: Bearer rply_live_.... Keys are hashed, keep server-side.

POST /api/v1/session/init

No email/name required — bot retrieves it. Send empty body for guest.

curl -X POST https://repllyer.vercel.app/api/v1/session/init \
  -H "x-api-key: rply_live_..." -H "Content-Type: application/json" \
  -d '{}'
# optional: -d '{"name":"Aarav","email":"aarav@example.com"}'

# 200 { "session_id": "uuid", "expires_at": "...", "credits_remaining": 177, "guest": true }
# 401 invalid key, 402 credits exhausted

POST /api/v1/chat

curl -X POST https://repllyer.vercel.app/api/v1/chat \
  -H "x-api-key: rply_live_..." -H "Content-Type: application/json" \
  -d '{"session_id":"uuid","message":"my refund not received"}'

# auto-resolved
{ "status":"resolved","answer":"...","priority":"urgent","topic":"refund","confidence":0.88 }

# needs human
{ "status":"human_required","ticket_id":"uuid","priority":"urgent","topic":"refund" }
# Dashboard picks via inbox / CRM

1 credit per call. History (last 10) + knowledge base sent to AI securely.

Priority & Topic

• urgent: payment/refund/billing/legal
• high: product quality / bug / delivery failure
• medium: account / how-to
• low: general / greeting

Topics: billing, refund, product_quality, bug_report, shipping, account, technical, general. Sorted in Inbox.

Credits & Billing

180 free on first business. Each extra business costs 100 credits. Buy packs from Dashboard → Billing. Coupons are fixed Rs off (e.g. FLAT600 = ₹600 off, WELCOME500 = ₹500 off). Gift cards redeem credits directly.

Errors

401 invalid api key
402 credits exhausted / 100 credits needed for extra business
404 session not found
410 session expired, re-init

First login shows a one-time onboarding popup (create business → knowledge → test). You can also visit /onboarding anytime. Client test file: test-standalone.html.