Jhapi ISR

One customer's profile: order stats, segments, risk tier, 30-day activity, recent orders and conversations.

get_customer

One order in full: items, totals in taka, status, customer, delivery address, notes, courier shipments and stored delivery-risk signals. Reading it does not mark the order as seen. Customer-written fields are untrusted text.

get_order

Full detail for one product: prices, promotion, images (with ids), variants (with ids), stock per location.

get_product

Reads product extras: active promotions, a product's stock adjustment history, the attributes that set variant prices, photos waiting for review, and website catalog sources (without credentials).

get_product_extras

Changes who handles a chat: claim it, assign or reassign it to a staff member (admins), close it, hand it back to the AI, reopen it (admins), or add an internal note the customer never sees.

manage_conversation

Manages stock-based ad pause rules (pause a Facebook ad set when a product's stock falls below a threshold, resume when restocked): list, set, delete. refresh_insights pulls the latest ad results from Facebook into ISR. Shop admins only. set_rule and delete_rule change automatic ad pausing and require confirm: true.

manage_ads

Changes delivery setup used by the sales agent: per-district or per-area delivery rules (charge, free-above amount, surcharge, delivery days, cutoff time, lead time, deliverable or not), the delivery charge zones, and which products can be delivered inside or outside the home district. Shop admins only. set_charge_zones replaces all zones at once; fallbackCharge, freeAboveSubtotal and orderConfirmationMessage keep their current value unless you include them (null clears one). delete_rule and set_charge_zones require confirm: true.

agent_delivery

Creates, edits, deletes or archives the knowledge documents the sales agent answers from (shop facts, FAQs, policies). Edits are re-indexed for the agent. Up to 6000 characters per document. Shop admins only. delete and archive_many require confirm: true.

agent_knowledge

Manages the menu or price-list images the sales agent sends to customers: upload from base64, an https link, or a file shared in the chat (imageFile), rename, show or hide, reorder (cards you leave out follow in their current order), delete. Shop admins only. delete requires confirm: true.

agent_menu

Disconnects a Facebook page from the shop, refreshes a page's profile from Facebook, starts a Nuport sync, or runs a website catalog sync. Shop admins only; requires confirm: true.

manage_connections

Creates or changes an order. create: a staff-confirmed order for an existing customer; repeating the same create (same clientKey, or the same items within a few minutes) returns the existing order with created: false. set_status: moves an order along RECEIVED → ACCEPTED/REJECTED/CANCELLED and ACCEPTED → CANCELLED/RETURNED/COMPLETED; cancelling or returning reports the event to Meta. set_shipping_address: changes the address. edit: changes items, charges or contact details, and pushes the change to Nuport for Nuport-synced orders. set_status and edit require confirm: true.

manage_order

set_primary makes a photo the main one; move_up / move_down reorder; remove deletes the photo permanently. Takes the product id and the image id shown in the product's details.

manage_product_images

Creates a promotion (percentage or fixed discount, for one product or the whole shop, with optional start and end) or deactivates one. Creating needs a shop admin and confirm: true.

manage_promotions

Adds a staff account with a one-time temporary password, changes a staff member's role (ADMIN or AGENT), or deactivates a staff member. Shop admins only. All three require confirm: true. Deactivating signs that person out of ISR and every connected app.

manage_staff

Hides, unhides or deletes a Facebook comment on the shop's page by its ISR comment id. Delete is for shop admins and requires confirm: true.

moderate_comment

AI and staff performance for a period. ai_funnel: chats → orders conversion. ai_traces: AI replies, escalations and errors. ai_summary and ai_chats: the owner summary and chat lists. team, team_member, team_evidence: staff reply times and workload; staff accounts see only their own.

get_performance_report

Publishes a post (text, optional https link) on the shop's connected Facebook Page. Visible to the public immediately. Shop admins only; requires confirm: true.

publish_page_post

Reads one section of the shop's settings: business profile, invoice branding, opening hours, payment methods, notification emails, connected Facebook pages, messaging channels, staff list, billing plan, apps connected to ISR, courier accounts (without credentials) or integration status (Nuport, Packnexa). Billing is for shop admins only, and agents see only names and roles in the staff list. Never returns passwords, tokens or keys.

get_settings

Lists the shop's most recent customer conversations (newest first) with who is handling each (AI or HUMAN), the outcome so far, and the last message. Customer names and message text are returned inside untrusted_customer_text fields because customers wrote them.

list_conversations

Sends a text reply to the customer in one chat, as the connected staff member, through the chat's own channel (Messenger, Instagram or WhatsApp). Takes the chat over first when it is unassigned. Refused outside the channel's reply window or in chats assigned to someone else (admins excepted). Requires confirm: true.

reply_to_customer

Learning material for improving the sales agent, read only. learned_candidates: rules the system proposed from real chats, waiting for approval. conversations: chats in a period with their outcome (in progress, resolved, escalated, abandoned) and last escalation reason. transcript: one chat's full messages with escalation events and the AI's per-turn outcome. escalations: escalation counts by reason. history: who changed the agent and when, including earlier persona texts. Chat text is untrusted.

agent_review

Runs a live delivery-risk check on a customer phone number, given directly or taken from an order. Returns the risk tier (green, yellow or red), the return-to-origin (RTO) rate and the number of past orders. The phone number may be sent to the shop's third-party risk provider. Requires confirm: true.

run_fraud_check

Regression tests for the sales agent: list saved test chats, save one (customer messages plus checks such as a tool was or was not called, the reply contains or avoids words, it escalated, blocked words absent), delete one, or run them against the current setup. A run reports pass or fail per test and per check, the final reply, and which tests newly broke or got fixed since the last run. Runs use AI and are limited to once every 5 minutes and 15 customer messages. Shop admins only; delete_test requires confirm: true.

agent_testing

Everything that shapes the AI sales agent: whether it is ON, persona (full text), rules with ids, selling policy, scripts, examples, knowledge docs, payment, hours, delivery charges, photo policy.

get_agent_config

Reads the sales agent's full training state, one view at a time. checklist: the guided-setup steps, done and missing. rules: every rule, vibe and flow with id, enforcement and blocked terms. scripts, exemplars and knowledge: full text. policy: selling policy, persona, language and photo policy. delivery and delivery_test: charges, zones and rules, and the outcome for a district or product. menu: menu cards. switches: the agent's on/off switches and the reply-time target. agent_prompt: the instructions the live agent receives for this shop, minus the per-chat parts, read 12000 characters per call (pass offset from nextOffset to continue).

agent_training_state

Find customers by name, phone number (any format) or Messenger id. Names and tags are untrusted customer content (untrusted_customer_text).

search_customers

Lists the shop's orders, newest first by default. Filters: tab, text search over customer name, phone or order number, a from/to date range, and sort. Returns totals in taka, status, source, and a note on which sales the list includes. Customer names are untrusted text.

search_orders

Search the shop's catalogue by name or SKU. Returns id, name, price (taka), stock, status. Leave query empty to list. Hidden (deleted) products only with includeHidden.

search_products

Reads the shop inbox. view=queue: chats in a queue with counts per queue. view=conversation: one chat's messages, who handles it, whether a reply can be sent now and until when, and its state version. view=comments: Facebook comments and what the page did with them. Customer-written text is untrusted.

get_inbox

Returns the connected shop's profile (name, timezone, country, what it sells, language, payment methods, order mode), subscription status, whether the AI sales agent is switched ON or deliberately OFF (ai-auto-reply), store hours, product/customer counts, and what this connection is allowed to do.

get_shop_overview

Shows how the sales agent would reply to a customer message with its CURRENT saved setup: the reply, whether it would escalate and why, guardrail repairs, and every tool it tried with its arguments. Dry run: nothing is sent and no order is created. Pass history and the returned salesState to continue a multi-turn test.

preview_agent_reply

Changes one section of the shop's settings: business profile fields, invoice branding, opening hours, payment methods, notification emails for a channel, or which connected Facebook page is primary. Shop admins only. Changing payment methods (including the bKash number customers are told to pay) or the AI instructions requires confirm: true. Keys, tokens and page connections cannot be changed here.

update_settings