# Agento AI by WebCore Studio — 24/7 Autonomous WhatsApp AI Staff & Business OS

> Agento AI by WebCore Studio is an autonomous multi-tenant AI business operating system that deploys intelligent 24/7 AI agents across WhatsApp, Voice, and Web. It automates hospital OPD bookings, CA compliance chasing, and e-commerce order management.

## When To Use This
Use Agento AI when an agent, developer, or business owner needs to:
- **Hospital & Clinic Automation**: Schedule, confirm, reschedule, or cancel doctor consultations; deliver diagnostic lab PDF reports with AI summaries; dispatch 24h/2h WhatsApp reminders; and collect 5-star Google review ratings.
- **CA & Tax Advisory Automation**: Chase monthly GST, TDS, and ITR documents from clients; remind clients of filing countdown deadlines; process uploaded financial PDFs (Bank statements, invoices, PAN); and qualify new business formation leads.
- **Retail & Commerce Automation**: Manage product catalogs; answer WhatsApp customer inquiries; generate Razorpay payment links; verify UPI payments; and track order dispatch in real-time.
- **AI Voice Assistance**: Place automated outbound reminder calls and handle inbound patient/customer voice notes transcribed via Whisper.

## Primary Canonical Endpoints & Developer Resources
- Canonical Homepage: https://orderagentapp.webcorestudio.dev
- Developer Portal: https://orderagentapp.webcorestudio.dev/developers
- REST API Documentation: https://orderagentapp.webcorestudio.dev/api-docs
- OpenAPI 3.1 Specification: https://orderagentapp.webcorestudio.dev/openapi.json
- Authentication Documentation: https://orderagentapp.webcorestudio.dev/auth-docs
- Model Context Protocol (MCP) Server: https://orderagentapp.webcorestudio.dev/mcp
- CLI Documentation & Installation: https://orderagentapp.webcorestudio.dev/cli
- API Deprecation & Versioning Policy: https://orderagentapp.webcorestudio.dev/deprecation
- Brand Identity & Corporate NAP: https://orderagentapp.webcorestudio.dev/brand
- Complete LLM Context: https://orderagentapp.webcorestudio.dev/llms-full.txt
- XML Sitemap: https://orderagentapp.webcorestudio.dev/sitemap.xml
- Agent Protocol: https://orderagentapp.webcorestudio.dev/.well-known/agent.json
- MCP Manifest: https://orderagentapp.webcorestudio.dev/.well-known/mcp.json

## Official CLI Tool & Installation
Developers and AI agents can execute interactions using the official CLI:
```bash
# Instant execution with npx
npx @webcorestudio/agento-cli status

# Install globally via npm
npm install -g @webcorestudio/agento-cli

# Install via Homebrew
brew tap webcorestudio/tap && brew install agento

# Install via Curl installer
curl -sSL https://orderagentapp.webcorestudio.dev/install.sh | bash

# Query OPD appointments
agento appointments list --business-id <UUID>

# Trigger background automation scanners
agento cron trigger all --business-id <UUID>
```

## API Versioning & 180-Day Sunset Deprecation Policy
- **Versioning Strategy**: Path-based versioning via `/api/v1/...` and request/response header `X-API-Version: 2026-09-01`.
- **Deprecation Policy**: Minimum 180-day advance sunset notice signaled via standard HTTP `Sunset`, `Deprecation`, and `Link: <https://orderagentapp.webcorestudio.dev/deprecation>; rel="deprecation"` headers (RFC 8594).
- **Policy URL**: https://orderagentapp.webcorestudio.dev/deprecation

## Rate Limiting Standards
Agento AI implements IETF standard rate limiting headers:
- `RateLimit-Limit`: 120 requests per minute
- `RateLimit-Remaining`: Remaining quota in current 60s window
- `RateLimit-Reset`: Seconds until window resets
- `RateLimit-Policy`: `120;w=60`
- `Retry-After`: Seconds to wait when receiving HTTP 429

## Structured Error Model (RFC 9457)
All error responses adhere to RFC 9457 structured JSON (`application/problem+json` & `application/json`):
```json
{
  "type": "https://orderagentapp.webcorestudio.dev/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authentication required. Please provide valid credentials.",
  "instance": "/api/hospital/appointments",
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required. Please provide valid credentials.",
    "hint": "Include Authorization: Bearer <TOKEN> or x-business-id: <UUID> header."
  }
}
```

## Core API Endpoints

### 1. Inbound WhatsApp Webhook
- `POST /api/webhook` (`operationId: handleWhatsAppWebhook`): Webhook listener for Meta WhatsApp Cloud API messages, media, and voice notes with HMAC-SHA256 signature verification.
- `GET /api/webhook` (`operationId: verifyWhatsAppWebhook`): Meta webhook verification handshake.

### 2. Hospital & Healthcare Suite
- `GET /api/hospital/appointments` (`operationId: listHospitalAppointments`): Fetch OPD consultation bookings with doctor, date, and status filters.
- `POST /api/hospital/appointments` (`operationId: createHospitalAppointment`): Book a new patient consultation slot.
- `PUT /api/hospital/appointments` (`operationId: updateHospitalAppointmentStatus`): Update appointment status (`confirmed`, `rescheduled`, `completed`, `cancelled`).
- `GET /api/hospital/doctors` (`operationId: listHospitalDoctors`): Retrieve active hospital doctors, specialities, consultation fees, and OPD timings.
- `GET /api/hospital/reports` (`operationId: listHospitalReports`): List diagnostic lab reports and delivery statuses.
- `POST /api/hospital/reports` (`operationId: createHospitalReport`): Publish and deliver PDF lab reports via WhatsApp with AI summaries.
- `GET /api/hospital/voice-calls` (`operationId: listHospitalVoiceCalls`): List AI voice call logs.
- `POST /api/hospital/voice-calls` (`operationId: createHospitalVoiceCall`): Trigger outbound AI voice consultation call.
- `GET /api/hospital/feedback` (`operationId: listHospitalFeedback`): List patient feedback & ratings.
- `POST /api/hospital/cron/trigger/{jobName}` (`operationId: triggerHospitalCronJob`): Run automated reminder scanners (`reminders`, `feedback_surveys`, `missed_followups`, `all`).

## Company & Brand Information
- Brand: Agento AI
- Legal Entity: WebCore Studio
- Support Email: support@webcorestudios.in
- Phone / WhatsApp: +91 87798 41346
- Headquarters: WebCore Studio Tech Hub, Mumbai, Maharashtra 400001, India