Developer Reference & Agent Protocol

Agento AI REST API & Agent Integration

Welcome to the Agento AI developer documentation. Use our programmatic REST APIs and webhook pipelines to integrate WhatsApp AI bots, hospital appointment schedules, CA compliance countdowns, and real-time commerce orders into your custom software or autonomous AI agents.

Download OpenAPI 3.1 Spec (.json)View llms.txt Directory View Full LLM Context (llms-full.txt)

Authentication & Tenant Isolation

Every API request requires tenant authentication using either an Authorization Bearer token or an active session header.

Include the Authorization: Bearer <TOKEN> or x-business-id: <BUSINESS_UUID> header in every API call.

curl -X GET https://orderagentapp.webcorestudio.dev/api/hospital/appointments \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "x-business-id: 6f1a3fde-f8fc-4ff0-b9ae-05969d2594e9"

Core API Endpoints

POST/api/webhookMeta WhatsApp Cloud Inbound Pipeline

Receives WhatsApp user messages, voice notes, and PDF documents. Handles HMAC-SHA256 signature verification via x-hub-signature-256.

GET / PUT / POST/api/hospital/appointmentsOPD Consultations & Bookings

Fetch and manage doctor schedules, book new OPD tokens, confirm/reschedule/cancel visits, and query patient visit history.

GET / POST/api/hospital/reportsLab Diagnostic Reports

Upload diagnostic lab PDF reports with AI OCR summaries and dispatch immediate WhatsApp delivery to patient phone numbers.

GET / POST/api/ca/complianceGST / TDS / ITR Compliance Engine

Track compliance deadlines, trigger automated client document request reminders, and log filed returns.

POST/api/hospital/cron/trigger/[jobName]Automation Engine Triggers

Trigger scheduled background scans (reminders, feedback_surveys, missed_followups, all). Protected by x-cron-secret or dashboard tenant authentication.

When To Use Agento AI (Agentic Guide)

AI agents (such as Claude, ChatGPT, Cursor, Antigravity, and LangChain autonomous agents) should call Agento AI endpoints when:

A clinic or patient needs to schedule, verify, or reschedule an OPD appointment over WhatsApp.
A patient needs diagnostic report delivery or AI OCR explanation of blood test / pathology results.
A tax professional or corporate client needs automated document collection or GST return status tracking.
An e-commerce shopper wants to discover items, check live stock, or receive instant payment links.