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

# Agent Marketplace

> Pre-built AI agent templates you can deploy in minutes

# Agent Marketplace

The Orbit Agent Marketplace offers production-ready agent templates for common use cases. Deploy a pre-built agent in minutes, then customize its behavior, tools, and knowledge base to fit your business.

## Browse Templates

```bash theme={null}
curl https://api.orbit.devotel.io/api/v1/agents/marketplace \
  -H "X-API-Key: dv_live_sk_..."
```

Filter the catalog with the `category`, `channel`, `search`, and `featured` query parameters:

```bash theme={null}
curl "https://api.orbit.devotel.io/api/v1/agents/marketplace?category=support&channel=whatsapp&featured=true" \
  -H "X-API-Key: dv_live_sk_..."
```

Fetch a single template by its `slug`:

```bash theme={null}
curl https://api.orbit.devotel.io/api/v1/agents/marketplace/customer_support_ecommerce \
  -H "X-API-Key: dv_live_sk_..."
```

## Available Templates

Use the `slug` shown below with the get, install, and detail endpoints. Channels list the
delivery surfaces each template ships with by default; you can add or remove channels after
install.

### Support

| Template                          | Slug                         | Description                                                                                                                         | Channels                      |
| --------------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| **Customer Support — E-commerce** | `customer_support_ecommerce` | Handles returns, shipping questions, and order status for online stores. Looks up orders and opens a ticket when a human is needed. | WhatsApp, Email, SMS, Webhook |
| **Refund Handler**                | `refund_handler`             | Processes refund requests with an approval flow — auto-approves small refunds and escalates larger ones to a supervisor.            | WhatsApp, Email, Webhook      |
| **Order Tracker**                 | `order_tracker`              | Answers "where is my order?" by looking up shipment status and returning a delivery ETA.                                            | WhatsApp, SMS, Email, Webhook |
| **FAQ Bot (Knowledge Base)**      | `faq_bot`                    | Answers questions from your linked knowledge base, cites the source, and refuses to speculate when the answer isn't there.          | WhatsApp, Email, SMS, Webhook |
| **Knowledge Agent (RAG)**         | `knowledge_agent_rag`        | Retrieval-backed Q\&A over your knowledge base. Cites a source on every answer and hands off to a human when it isn't confident.    | WhatsApp, Email, Webhook      |

### Sales

| Template               | Slug             | Description                                                                                                         | Channels                 |
| ---------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| **Lead Qualifier**     | `lead_qualifier` | Qualifies inbound leads with BANT discovery questions and books a meeting with the sales team when a lead is ready. | WhatsApp, Email, Webhook |
| **Outbound SDR Agent** | `outbound_sdr`   | Runs cold outreach sequences with qualification and automatic opt-out handling.                                     | WhatsApp, Email, SMS     |

### Scheduling

| Template                    | Slug                  | Description                                                                                                      | Channels                      |
| --------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| **Appointment Booking Bot** | `appointment_booking` | Schedules, reschedules, and cancels appointments, sends reminders, and offers alternatives when a slot is taken. | WhatsApp, SMS, Voice, Webhook |

### Voice

| Template                   | Slug                   | Description                                                                                                                           | Channels |
| -------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| **IVR Intake Specialist**  | `ivr_intake`           | Voice-first triage that greets callers, identifies intent, and routes to the right department or a human agent.                       | Voice    |
| **Voice Agent (Vocalize)** | `voice_agent_vocalize` | Inbound voice receptionist that qualifies intent, takes a callback number for urgent issues, and routes the rest to your ring groups. | Voice    |

### Retention

| Template                 | Slug          | Description                                                                                     | Channels             |
| ------------------------ | ------------- | ----------------------------------------------------------------------------------------------- | -------------------- |
| **Renewal Reminder Bot** | `renewal_bot` | Reaches out ahead of subscription renewals and handles upgrades, downgrades, and cancellations. | WhatsApp, Email, SMS |

### Feedback

| Template                                | Slug                 | Description                                                                                  | Channels             |
| --------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------- | -------------------- |
| **Post-Transaction Feedback Collector** | `feedback_collector` | Runs a short NPS survey after a transaction and asks targeted follow-ups based on the score. | WhatsApp, Email, SMS |

### Marketing

| Template                             | Slug                           | Description                                                                                                     | Channels             |
| ------------------------------------ | ------------------------------ | --------------------------------------------------------------------------------------------------------------- | -------------------- |
| **Marketing Segmentation Assistant** | `marketing_segmentation_agent` | Turns a plain-English audience description into a usable segment, quantifies reach, and recommends send timing. | WhatsApp, Email, SMS |

### HR & Recruiting

| Template                    | Slug                  | Description                                                                                                                                                            | Channels        |
| --------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| **HR Candidate Pre-Screen** | `hr_candidate_screen` | Runs a structured five-question pre-screen — interest, availability, compensation, and two role-specific questions — and books a recruiter call for strong candidates. | WhatsApp, Email |

### Loyalty & Engagement

| Template                    | Slug                   | Description                                                                                                  | Channels            |
| --------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------- |
| **Loyalty + Streaks Agent** | `gamification_loyalty` | Surfaces tier progress, point balance, and streaks, celebrates milestones, and runs limited-time challenges. | WhatsApp, SMS, Push |

### Industry Templates

Pre-configured for a specific vertical. Each ships with industry-appropriate guardrails and escalation rules that you can adjust after install.

| Template                       | Slug                         | Description                                                                                                                                                   | Channels               |
| ------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| **Banking Advisor**            | `banking_advisor`            | Handles balance, mini-statement, and OTP flows, and escalates immediately on any fraud, lost-card, or stolen-card signal.                                     | WhatsApp, SMS, Voice   |
| **Telecom Support**            | `telecom_support`            | Manages plan changes, top-ups, and outage status, with a retention-offer flow when a customer signals they want to leave.                                     | WhatsApp, SMS, Voice   |
| **Insurance FNOL Agent**       | `insurance_fnol`             | Walks a customer through First Notice of Loss intake, collects incident details and photos, and opens a claim before handing off to an adjuster.              | WhatsApp, Voice, Email |
| **Retail Post-Purchase Agent** | `retail_post_purchase`       | Confirms orders, tracks delivery, collects a CSAT and review, and recommends complementary products when the customer is happy.                               | WhatsApp, SMS, Email   |
| **Hospitality Concierge**      | `hospitality_concierge`      | Handles pre-arrival check-in details, on-stay requests, and post-stay review collection for hotels and short-term rentals.                                    | WhatsApp, SMS, Email   |
| **Healthcare Patient Intake**  | `healthcare_intake`          | Collects pre-appointment symptoms, medications, allergies, and insurance details, and escalates any clinical question to staff without giving medical advice. | WhatsApp, SMS, Email   |
| **Real-Estate Lead Qualifier** | `real_estate_lead_qualifier` | Qualifies listing enquiries on timing, budget, and financing, then books a viewing with the listing agent.                                                    | WhatsApp, Email, SMS   |

The live catalog is authoritative — call `GET /api/v1/agents/marketplace` for the current list, including any templates your organization has published.

## Deploy a Template

Install a marketplace template into your account by its `slug`. The template
is forked into your org as a new, fully editable agent; `name` and
`description` optionally override the template defaults:

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/agents/marketplace/customer_support_ecommerce/install \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Support Bot",
    "description": "Customer support bot for Acme Corp"
  }'
```

## Customize After Install

Every installed template is a fully editable agent. After installation you can:

* **Edit instructions** — refine the agent's personality and behavior
* **Add tools** — connect to your CRM, helpdesk, or internal APIs
* **Upload knowledge** — add product docs, FAQs, and policy documents
* **Adjust guardrails** — set content filters and escalation rules
* **Modify channels** — add or remove communication channels

## Publishing to the Marketplace

Build a reusable agent and share it with the Orbit community:

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/agents/marketplace/publish \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "my-custom-agent",
    "name": "My Custom Agent",
    "category": "support",
    "description": "A brief description of what this agent does",
    "system_prompt": "You are a helpful assistant for ...",
    "channels": ["whatsapp", "sms"]
  }'
```

The `slug` must be kebab/underscore-cased and unique across the marketplace
(a duplicate returns `409 Conflict`). Submissions land with `status: "pending"`
and are invisible to the public catalog until a moderator approves them.
