AiTrillion

Get one email campaign's results: sent, delivered, opened, clicked, orders and revenue.

aitrillion_get_email_campaign_stats

One-shot breakdown of the store's email campaign counts, split into three groups: `regular` (the dashboard 'Campaigns' page), `api` (the 'Email sent log (API)' page — AI/direct sends), and `combined` (both). Each group has sent / draft / scheduled / pending / failed / total (matching the dashboard's tabs). Use this to answer 'how many campaigns / how many API emails have been sent' in a single call — the numbers match the merchant's dashboard exactly.

aitrillion_get_email_campaign_summary

Get a single email list by id.

aitrillion_get_email_list

List the customers in an email list (by list id).

aitrillion_get_email_list_customers

Fetch ONE customer segment's full details by id — name, description, type, default flag, and created/updated dates.

aitrillion_get_email_segment

Fetch one saved email template's subject and HTML content by id.

aitrillion_get_email_template

Get the storefront loyalty program (ways to earn/redeem, tiers). Pass a customer_id for the logged-in view, or omit for the public program.

aitrillion_get_loyalty_program

Get details of a single membership by its contract id.

aitrillion_get_membership_detail

Get the storefront membership language/label settings.

aitrillion_get_membership_language

Get a single order by id.

aitrillion_get_order

Order insights / analytics — orders enriched with loyalty points, tier and customer data. Best tool for sales/revenue reporting. Also exposes each order's `source_customer_id` (the Shopify customer id).

aitrillion_get_order_insights

Get the average rating for a single product.

aitrillion_get_product_average_rating

Get product recommendations (new_arrival, trending, recent_view, related_product, based_on_past_purchases, etc.).

aitrillion_get_product_recommendations

Get a single product review by id.

aitrillion_get_product_review

Store overview / summary metrics in a single call — includes the TOTAL number of customers (total_customers), geo distribution, and other aggregate figures. USE THIS for questions like 'how many customers do I have?' or 'give me a store overview' — it returns totals directly, so you never need to page through aitrillion_list_customers to count.

aitrillion_get_reports

Get the storefront review language & general settings.

aitrillion_get_review_settings

Get a single site/store review by id.

aitrillion_get_site_review

Storefront/public product reviews for one or more products, as shoppers see them. For the merchant/admin review list (all statuses), use aitrillion_list_product_reviews.

aitrillion_get_storefront_product_reviews

Get a single WhatsApp template by id.

aitrillion_get_whatsapp_template

List the LIVE products in a Shopify collection — the exact products (title, price, compare-at price, image, product URL) that would render in a 'collection_product' email block, fetched live from Shopify. USE THIS to answer 'how many products are in the X collection?' or 'what's in my Home page collection?' — the returned `count` is the number of products fetched. Pass `collection_id` = the collection's handle (e.g. "frontpage") or its id from aitrillion_list_collections (numeric ids are resolved automatically); optional `count` (default 10, max 50). Note: AiTrillion's stored collection product_count is not reliable — always use THIS tool for accurate collection product data.

aitrillion_list_collection_products

List the store's product COLLECTIONS (id, title, handle). When adding a 'collection_product' block to an email via aitrillion_send_campaign / aitrillion_send_direct_email, pass the collection's `handle` (e.g. "frontpage") as the block's collection_id — the numeric id also works and is resolved automatically.

aitrillion_list_collections

List a customer's memberships (by Shopify customer_id).

aitrillion_list_customer_memberships

List INDIVIDUAL customer records with filters (email, spend, orders count, marketing status, dates). Returns one page at a time (paginated) — do NOT use this to count total customers; for the total customer count or a store overview use aitrillion_get_reports instead. Each result's `source_customer_id` is the Shopify customer id — pass it to the storefront (front) customer tools like aitrillion_get_customer_loyalty_details.

aitrillion_list_customers

List the rules by which customers earn loyalty points.

aitrillion_list_earning_rules

List email campaigns with headline counts — these MATCH the merchant's dashboard 'Campaigns' page exactly. By default (source='regular') API/AI-sent campaigns are EXCLUDED (they appear under source='api', shown in the store's 'Email sent log (API)' view). Use source='api' for AI/direct sends only, or source='all' for both. So a plain 'how many sent campaigns' returns the same number the merchant sees on their dashboard. Use aitrillion_get_email_campaign_stats for one campaign's full results.

aitrillion_list_email_campaigns

List ALL of the store's active discount rules — the same set shown on the dashboard's 'Discount codes' page (both real-time and bulk). Each item has: coupon_rule_id, name (the rule's label — NOT a usable checkout code), discount_type/amount, available_codes/total_codes, and — importantly — `type` ('realtime' or 'bulk') and `usable_in_email_block`. ONLY rules with usable_in_email_block=true (type='realtime') can be placed in an email coupon block: put a {{ait_block:<id>}} token in the template HTML and pass { id:'<id>', type:'coupon', coupon_rule_id:<coupon_rule_id> } to aitrillion_send_campaign, and a unique checkout-valid code is generated per recipient at send time. type='bulk' rules are shown for reference but CANNOT go in an email coupon block and their codes must not be hardcoded into a mass email (each is single-use). NEVER type a made-up discount code into the HTML.

aitrillion_list_email_coupons

List email marketing lists.

aitrillion_list_email_lists

List selectable customer SEGMENTS for targeting an email campaign. Each item has id, title, description, is_default (true for built-in segments), and created/updated dates. Returns a `total` count. Built-in (default) segments come first, then the merchant's custom ones. Pass the `type` filter ('default' or 'custom') to narrow, or `search` to filter by name. For plain lists, use aitrillion_list_email_lists instead.

aitrillion_list_email_segments

List the {{merge tags}} you can put in email subject/HTML for personalization (e.g. {{first_name}}, {{shop_name}}, loyalty points, this shop's custom fields, and the required {{unsubscribe_content}}). If the store has a logo, the list also includes {{shop_logo_url}} — the logo's image URL to use as <img src="{{shop_logo_url}}">. It also returns `store_url` — the store's ready-made https:// URL to use DIRECTLY as the href for any Shop-Now/store button (do NOT use {{front_shop_url}} for links; it is empty unless a custom storefront is configured and breaks the link). Call this BEFORE writing template/email HTML so you only use tokens that actually get replaced at send time.

aitrillion_list_email_shortcodes

List email templates available to the merchant (id, title, subject, type). Each has a `type`: 'custom' = the merchant's own dashboard templates, 'prebuilt' = AiTrillion's ready-made template library, 'api' = templates created via this connector. Returns a `total` count. By default returns the merchant's own + pre-built templates; pass type='prebuilt' to count/list only the ready-made ones, or type='custom'/'api' to narrow. Use before aitrillion_send_campaign / aitrillion_send_direct_email to reference a template by id.

aitrillion_list_email_templates

List LOYALTY program members with their points, tier and rewards. Use this for loyalty/points questions. For the store's full customer list (not just loyalty), use aitrillion_list_customers instead. Supports filters and pagination (page_info cursor).

aitrillion_list_loyalty_customers

List the store's active membership plans.

aitrillion_list_membership_plans

List new-arrival products.

aitrillion_list_new_arrival_products

List orders with filters (status, customer, order number, price, dates). Supports pagination.

aitrillion_list_orders

Merchant/admin view of product reviews — all statuses (pending, approved…), with filters (product, rating, status, verified). For the public reviews a shopper sees on the storefront, use aitrillion_get_storefront_product_reviews.

aitrillion_list_product_reviews

List product questions & answers with filters (product, status).

aitrillion_list_question_answers

List a customer's recently viewed products.

aitrillion_list_recently_viewed_products

List site/store reviews with filters (rating, status, verified).

aitrillion_list_site_reviews

List trending products.

aitrillion_list_trending_products

List WhatsApp message templates with filters (status, category, type).

aitrillion_list_whatsapp_templates