get_alert_details
ChatGPTExplain one alert (alert_id from get_alerts): for rule alerts, the rule's name and conditions and a summary of the triggering event or order (no customer identity); for anomaly alerts, the related detected anomaly and whether that condition is still active; plus delivery status per channel. Use for 'explain this alert', 'is it still happening', then investigate_store_change with the alert_id for 'what happened around then'.
get_alerts
ChatGPTAlerts Eskopia sent for this store (rule matches on events or orders, anomaly alerts, digests), one entry per alert with delivery channels and status. Only anomaly alerts carry a severity; rule alerts are 'unclassified'. An admin sees all of the store's alerts; a regular user sees only alerts delivered to them. Use for 'what alerts do I have', 'did Eskopia alert me today', 'latest alert', 'critical alerts'. Use get_alert_details to explain one. This connection is read-only and cannot create or change alerts: if asked to, say so and use the result's alert_setup field, which lists exactly where and how alerts are set up in the Eskopia web app. Describe only what it lists; don't invent other fields.
get_anomalies
ChatGPTAnomalies detected by Eskopia's deterministic store monitors (no_orders, revenue_drop, traffic_drop, checkout_completion_drop, tracking_gap, abandoned_checkout_spike, webhook_gap): status (active/resolved), severity, when detected, last confirmed, when resolved, evidence, and how many times the same detector fired before (last 30 days). Each detector is a fixed rule with minimum samples, not a statistical model; there are no confidence scores. Use for 'anything unusual', 'what anomalies today', 'is it still happening', 'has this happened before'. Records marked retroactive came from Eskopia re-checking its stored history. current_checks gives each detector's state right now: an empty anomaly list with checks in insufficient_data means Eskopia could not check, not that nothing is wrong.
get_breakdown
ChatGPTGroup the store's visitors, activity, orders and revenue by one dimension, optionally narrowed by filters. Use for any 'by X' or 'from X' question: visitors or orders from a country, cities within a country (dimension=city with a country filter), traffic sources, mobile vs desktop, browser, landing pages, most viewed pages, new vs returning visitors or customers, and trends per hour, day, week or month. Each row has visitors, events, product viewers, add-to-cart visitors, checkouts started, orders, revenue, conversion rate, average order value and share of total. totals covers everything matching the filters, so a filter alone answers 'how many from X'. Countries are accepted as English names or ISO codes. Orders and revenue are null for page, product, collection and event_type (use get_product_sales for what each product sold). compare_to adds each row's change versus earlier windows.
get_busy_times
ChatGPTWhen the store is busiest: a weekday by hour-of-day grid (store timezone) for one metric over the last N days, with the busiest and quietest slots, totals per weekday and per hour. Metrics: visits (distinct visitors), orders, revenue, checkout_starts. Use for 'when are my peak hours', 'best day of the week for sales', 'when should I run a promotion or staff support', 'what time do people usually buy'.
get_checkouts
ChatGPTCheckouts started in a window and what became of each: summary (started, completed, abandoned, still in progress, completion rate, total abandoned cart value, where non-completed checkouts stopped, abandoned checkouts by country) and a list of individual checkouts with start time, status, furthest stage reached (started, contact info, shipping info, payment info, completed), cart value, country, city and minutes active. Filter the list by status; narrow everything by country or minimum cart value. Use for 'show me abandoned checkouts', 'how much money was left in abandoned carts today', 'biggest abandoned cart', 'is anyone checking out right now', 'at which step do people give up'. For step-by-step conversion rates and comparisons use get_funnel. Shopper names and contact details are never returned.
get_funnel
ChatGPTShopper funnel for a window: visitors -> viewed a product -> added to cart -> reached checkout -> completed purchase (distinct visitors), plus the checkout-stage funnel (started -> contact -> shipping -> payment -> completed) for checkouts started in the window, each step's conversion and drop-off, the biggest drop, and completed / not completed / still in progress checkouts. With compare_to it reports each step's change in percentage points and the largest worsening step. Use for 'where are customers dropping out', 'adding to cart but not buying', 'is the problem before or during checkout', funnel comparisons.
get_live_activity
ChatGPTWhat's happening on the store right now: visitors active in the last 60 seconds by activity (browsing, viewing a product, cart, checkout), top countries and cities, what happened in the last N minutes (visitors, events by type, orders, revenue), up to 5 recent orders (no customer details), open checkouts, and whether this window is below/within/above the same window on recent same weekdays. Use for 'what's happening now', 'is anyone shopping', 'any orders recently', 'last 10 minutes / last hour', 'where are my current visitors from', 'is it unusually busy or quiet'.
get_orders
ChatGPTOrders received in a window: a summary over every matching order (count, revenue, average, median, largest and smallest order, items sold, first-time vs returning customers, top countries, how many came through CSV import or without a pixel-tracked checkout) and a list of individual orders with time, amount, currency, country, region, city, number of items, the products in the order (name, variant, quantity) and first-time/returning. Filter by country, city, amount range or customer type; sort newest, oldest, largest or smallest. Use for 'show me today's orders', 'biggest order this week', 'orders over 500', 'orders from Kuwait', 'how many first-time customers'. Customer names, emails and order numbers are never returned (they are in the Eskopia web app and Shopify admin). For totals per product use get_product_sales.
get_performance
ChatGPTStore performance for a time window, optionally compared with earlier windows: visitors, orders, revenue, conversion rate (orders / visitors), average order value, checkouts started and checkout completion rate, with percent changes. With compare_to=last_4_same_weekdays it also gives the min/average/max range and whether each metric is below, within or above that range (Eskopia's notion of 'normal for this time'; not a statistical baseline). Use for sales/orders/conversion/AOV questions, 'today vs yesterday', 'this week vs last week', 'is this normal for this time of day', executive summaries. For the same numbers split by country, city, traffic source, device or page, use get_breakdown. series=hourly (windows up to 72h) or daily adds a time series.
get_product_engagement
ChatGPTProduct attention and view-to-add-to-cart performance: per product views, distinct viewers, add-to-cart visitors and add-to-cart rate, the store's weighted average rate, and flags (low add-to-cart vs store average, attention surge, attention drop) with comparison to earlier windows. Optional product_query filters by title. These are views and add-to-carts, not sales: never present them as product sales or purchase conversion. For units sold and revenue per product use get_product_sales. Use for 'which products get attention', 'views but no add-to-cart', 'did engagement with product X change'.
get_product_sales
ChatGPTWhat sold: units sold, number of orders and revenue per product for a window, from the product lines on each order, with each product's viewers, add-to-cart visitors and orders per 100 viewers alongside, share of product revenue, average selling price, and optional comparison with earlier windows. Use for 'best sellers', 'top products by revenue', 'how many units of X did I sell', 'which products get views but don't sell', 'did sales of X change'. coverage says how many orders in the window have product lines stored: orders received before Eskopia stored them, or imported without them, are not included, so say so when coverage is below 100%. Product revenue excludes shipping and tax and does not subtract refunds.
get_settings
ChatGPTHow the store and your own Eskopia notifications are set up: store name, timezone, Shopify domain and whether the order webhook is configured; your notification rules (name, conditions, channels), anomaly alert settings, scheduled digest, notification channels (type and label only) and quiet hours; your scheduled reports; and, for store admins only, the plan and subscription status, data retention and team size. Use for 'what alerts do I have set up', 'which channels am I notified on', 'what plan am I on', 'what timezone is my store using', 'do I have any scheduled reports'. Read-only: it also returns where in the Eskopia web app each thing is changed. Secrets, webhook URLs, channel configuration and other people's email addresses are never returned.
get_store_health
ChatGPTOverall operational health of the store right now: a rule-based overall_status (ok / limited_data / insufficient_data / attention / critical / not_ready; insufficient_data and limited_data mean some or all checks lacked enough data, which is NOT the same as healthy), prioritized findings, active detected anomalies, data-pipeline checks (pixel and order webhook activity), today vs the last 4 same weekdays, and a live snapshot. Use for 'is everything okay', 'what needs my attention', 'quick status', health reports and daily briefings. detail=brief for quick answers; full adds every detector's current state and recent rule-based insights.
get_visitor_retention
ChatGPTHow many visitors come back: weekly cohorts (visitors grouped by the week Eskopia first saw them) with the percentage who returned in each of the following 6 weeks, plus the average return rate. Use for 'do visitors come back', 'retention', 'how loyal is my audience'. For new vs returning visitor or customer counts in a period use get_breakdown with dimension=visitor_type or customer_type.
investigate_store_change
ChatGPTEvidence bundle for 'why' questions. Give an anomaly_id (from get_anomalies), an alert_id (from get_alerts), or a window (period/start/end). Returns current vs comparison metrics, a revenue decomposition into traffic / conversion / order value (arithmetic), funnel step changes, the hour a sustained drop started (fixed rule), hourly series, traffic-source / country / product changes, tracking health, overlapping anomalies and alerts, labeled findings (fact or detected_condition) and an explicit list of things Eskopia cannot observe. Eskopia does not determine causes: anything beyond the returned facts is inference and must be labeled as such. Window max 7 days.
list_stores
ChatGPTList the Eskopia stores this connection can access, with each store's id, timezone and setup readiness (ready / not_configured / awaiting_data / suspended / pending_subscription / cancelled). Use first when the store is unclear, or when another tool reports store_not_ready to explain what setup is missing. Setup itself is only done in the Eskopia web app.