> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaireonai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Industry Templates

> Pre-built starter kits for Banking (BFSI), Retail, and Telecom -- get a working next-best-action setup in minutes.

## Overview

Industry templates are ready-made starter kits that provision a complete next-best-action configuration for your vertical. Each template includes categories, offers, decisioning gates, a decision flow, sample customer data, and channel creatives so you can see KaireonAI in action immediately.

Apply any template with a single API call:

```bash theme={null}
curl -X POST https://your-instance.kaireonai.com/api/v1/starter-kits/{kit}/apply \
  -H "Content-Type: application/json" \
  -H "X-Tenant-Id: YOUR_TENANT_ID" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-Requested-With: XMLHttpRequest"
```

Replace `{kit}` with `banking`, `retail`, or `telco`. Additional verticals ship too — `insurance`, `healthcare`, `hospitality`, `utilities`, and `media` — list them all with `GET /api/v1/accelerators`.

***

## BFSI (Banking, Financial Services, Insurance)

### What is included

| Component             | Details                                                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Categories**        | Credit Cards, Deposits, Loans, Protection, Digital Services                                                                               |
| **Offers**            | 30 pre-configured offers (Premium Sapphire Card, Mortgage Refi 30-year, HELOC Flex Line, High Yield Savings 4.5%, 12-Month CD 5.0%, etc.) |
| **Decisioning Gates** | Income thresholds, credit score gates, existing product suppression, regulatory cooling-off periods                                       |
| **Decision Flow**     | Enrich (credit bureau + account data) -> Score (propensity + profitability) -> Rank (customer lifetime value weighted)                    |
| **Creatives**         | Web banner, mobile push, email, and SMS variants per offer                                                                                |
| **Sample Data**       | 500 synthetic customer profiles with account balances, tenure, and transaction history                                                    |

### Use cases

* **Cross-sell** -- recommend a credit card to savings-only customers based on spending patterns
* **Retention** -- surface loyalty rate offers to customers with declining balances
* **Upsell** -- upgrade existing cardholders to premium tiers based on usage thresholds
* **Insurance bundling** -- pair insurance products with loan disbursals

### Getting started

1. Apply the template:
   ```bash theme={null}
   curl -X POST https://your-instance.kaireonai.com/api/v1/starter-kits/banking/apply \
     -H "Content-Type: application/json" \
     -H "X-Tenant-Id: YOUR_TENANT_ID" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "X-Requested-With: XMLHttpRequest"
   ```
2. Open **Studio > Decision Flows** to review the pre-built flow.
3. Call the Recommend API with a sample customer ID to see ranked offers.
4. Customize decisioning gates and scoring weights to match your institution's policies.

***

## Retail

### What is included

| Component             | Details                                                                                                                                  |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Categories**        | Loyalty, Promotions, Abandonment, Lifecycle, Subscriptions, VIP                                                                          |
| **Offers**            | 30 pre-configured offers (Double Points Weekend, Birthday — Free Item, 3x Points on Beverage, Tier-Up Challenge, VIP Tier Upgrade, etc.) |
| **Decisioning Gates** | Loyalty tier gates, purchase recency filters, cart abandonment detection, seasonal date windows                                          |
| **Decision Flow**     | Enrich (purchase history + loyalty tier) -> Score (engagement propensity + margin) -> Rank (revenue-per-impression optimized)            |
| **Creatives**         | Web overlay, app push, email digest, and SMS alert variants                                                                              |
| **Sample Data**       | 500 synthetic shoppers with purchase history, browsing behavior, and loyalty status                                                      |

### Use cases

* **Loyalty program** -- reward high-value customers with exclusive double-points offers
* **Promotions** -- target discount-sensitive segments with flash sales during low-traffic periods
* **Cart abandonment** -- recover abandoned carts with time-limited incentives
* **Seasonal campaigns** -- automatically activate holiday and back-to-school offers within date windows

### Getting started

1. Apply the template:
   ```bash theme={null}
   curl -X POST https://your-instance.kaireonai.com/api/v1/starter-kits/retail/apply \
     -H "Content-Type: application/json" \
     -H "X-Tenant-Id: YOUR_TENANT_ID" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "X-Requested-With: XMLHttpRequest"
   ```
2. Open **Studio > Decision Flows** to explore the retail flow and adjust scoring weights.
3. Call the Recommend API to see personalized offers for different loyalty tiers.
4. Add your own product catalog offers alongside the template defaults.

***

## Telecom

### What is included

| Component             | Details                                                                                                                   |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Categories**        | Mobile Plans, Broadband, Bundles, Device Financing, Add-Ons, Retention                                                    |
| **Offers**            | 30 pre-configured offers (Unlimited Plus 5G, Postpaid 50GB, Family Plan 4 Lines, device financing, retention deals, etc.) |
| **Decisioning Gates** | Contract status checks, usage threshold gates, churn risk score filters, device eligibility rules                         |
| **Decision Flow**     | Enrich (usage data + billing history) -> Score (churn risk + ARPU uplift) -> Rank (retention priority weighted)           |
| **Creatives**         | App notification, SMS, IVR script, and retail store POS variants                                                          |
| **Sample Data**       | 500 synthetic subscribers with usage patterns, billing data, and device information                                       |

### Use cases

* **Plan upgrades** -- recommend higher-tier plans to subscribers consistently exceeding their data limits
* **Churn prevention** -- surface retention offers to customers flagged by the churn propensity model
* **Data pack offers** -- push targeted data booster packs during high-usage periods
* **Recharge reminders** -- trigger timely recharge nudges for prepaid subscribers approaching zero balance

### Getting started

1. Apply the template:
   ```bash theme={null}
   curl -X POST https://your-instance.kaireonai.com/api/v1/starter-kits/telco/apply \
     -H "Content-Type: application/json" \
     -H "X-Tenant-Id: YOUR_TENANT_ID" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "X-Requested-With: XMLHttpRequest"
   ```
2. Open **Studio > Decision Flows** to review the telecom-specific enrichment and scoring stages.
3. Test with the Recommend API using different subscriber profiles to see churn-aware ranking.
4. Connect your CRM or billing system via connectors to replace sample data with live subscriber information.

***

## Customizing templates

After applying a template, everything is fully editable:

* **Add or remove offers** in **Studio > Offers**
* **Adjust decisioning gates** in **Studio > Decisioning Gates**
* **Modify scoring weights** in the Decision Flow ranking stage
* **Replace sample data** by connecting real data sources in **Data > Connectors**
* **Create experiments** in **Algorithms > Experiments** to A/B test template defaults against your custom configuration

## Next steps

* **[SDK Quickstart](/tutorials/sdk-quickstart)** -- integrate the Recommend and Respond APIs from your application
* **[API Tutorial](/tutorials/api-tutorial)** -- detailed walkthrough of request/response formats
* **[Computed Values](/tutorials/computed-values)** -- add dynamic per-customer personalization formulas
