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

# Order Intent Detection — AI-Powered Inbox Intelligence

> Knead reads incoming messages and automatically detects delivery dates, products, quantities, and occasions — then tells you if you have capacity to take the order.

## Overview

When a customer emails you about a cake for their daughter's birthday on March 20th, Knead doesn't just show you the message — it reads it, understands it, and tells you whether you can take the order before you even reply.

This is **Order Intelligence**, and it works automatically on every inbound message in your Inbox.

<img src="https://mintcdn.com/kneadapp/tAFF3UYw11xPzKkb/images/communication/inbox-list.png?fit=max&auto=format&n=tAFF3UYw11xPzKkb&q=85&s=b62d1e2eea0ccbef2dcf6a286d22aa71" alt="Inbox showing conversations with unread badges, priority stars, and channel icons" width="1280" height="720" data-path="images/communication/inbox-list.png" />

## What Gets Detected

When a message arrives, Knead scans the text and extracts four things:

| What              | Example                                                                      |
| ----------------- | ---------------------------------------------------------------------------- |
| **Delivery date** | "March 20th", "next Friday", "June 7th"                                      |
| **Products**      | Fuzzy-matched against your catalog — "chocolate cake" → Chocolate Fudge Cake |
| **Quantity**      | "5 dozen", "2 cakes", "4 dozen cookies"                                      |
| **Occasion**      | Birthday, wedding, graduation, baby shower, corporate event                  |

When intent is detected, a card appears at the top of the conversation — right above the messages — so you see it the moment you open the thread.

## Capacity Verdicts

The intelligence card doesn't just tell you *what* the customer wants — it tells you whether you can realistically take it. Knead checks the requested date against your existing orders and capacity settings, then gives you a clear verdict.

### "You can take this."

Your schedule has room. The green accent means go. The **Accept & Create Order** button pre-fills the order form with the client, delivery date, and the detected products and quantities so you can confirm in seconds.

<img src="https://mintcdn.com/kneadapp/tAFF3UYw11xPzKkb/images/communication/intent-available.png?fit=max&auto=format&n=tAFF3UYw11xPzKkb&q=85&s=9dec742f60adb10d748c28fcfcf34255" alt="Conversation showing available capacity with green border and Accept & Create Order button" width="1280" height="720" data-path="images/communication/intent-available.png" />

### "Tight, but doable."

You're getting close to your limit for that date. Knead shows your current utilization and suggests nearby alternative dates in case you want to steer the customer to a less busy day.

<img src="https://mintcdn.com/kneadapp/tAFF3UYw11xPzKkb/images/communication/intent-tight.png?fit=max&auto=format&n=tAFF3UYw11xPzKkb&q=85&s=1c0f775da81c597230130a73f2d30318" alt="Conversation with tight capacity showing amber border, alternative date chips, and Suggest Alternative button" width="1280" height="720" data-path="images/communication/intent-tight.png" />

Notice the alternative date chips. Click **Suggest Alternative** to draft a friendly reply proposing a different date.

### "This would put you over capacity."

The requested date is already packed. Knead flags it in terracotta and shows alternative dates that have room.

<img src="https://mintcdn.com/kneadapp/tAFF3UYw11xPzKkb/images/communication/intent-over-capacity.png?fit=max&auto=format&n=tAFF3UYw11xPzKkb&q=85&s=c19c3fce0cc8d7c930de4127bc6ce690" alt="Conversation with over capacity showing terracotta border, Take It Anyway, Suggest Alternative, and Decline buttons" width="1280" height="720" data-path="images/communication/intent-over-capacity.png" />

Even when you're over capacity, you keep every option:

* **Suggest Alternative** drafts a friendly reply pointing the customer to an open date.
* **Take It Anyway** is the accept button — the same **Accept & Create Order** action, just relabeled to remind you you're going past your limit. It still pre-fills the order form.
* **Decline** drafts a polite no and tucks the card away (more on that below).

### Priority Customers Stand Out

If you've marked a client as a [Priority Customer](/customers/priority-customers) (the star icon), Knead flags them right on the card when capacity is tight or full — a visual nudge that this is someone worth squeezing in. The honest verdict still shows, and **Take It Anyway** lets you accept over your limit for the clients who matter most.

## Declining from the card

Not every request is a fit. Click **Decline** on the intent card and Knead drafts a polite decline reply for you to review and send. The card then collapses into a small chip so it's out of your way — with a **"Change your mind?"** option if you decide to un-decline and pick the order back up.

## Ambiguous Dates

Sometimes a customer mentions wanting an order but doesn't give a specific date — like "I need cookies for my best friend's baby shower" without saying when. Knead still detects the products, quantity, and occasion, but marks the date as ambiguous with a dashed border.

<img src="https://mintcdn.com/kneadapp/tAFF3UYw11xPzKkb/images/communication/intent-ambiguous.png?fit=max&auto=format&n=tAFF3UYw11xPzKkb&q=85&s=95ab3f2cf6a7dead9cbea4750fca17d8" alt="Conversation with ambiguous date showing dashed border and no action buttons" width="1280" height="720" data-path="images/communication/intent-ambiguous.png" />

No action buttons appear until the date is confirmed. Reply to the customer to nail down the date, and Knead will update the intent when they respond.

## When an Order Is Already Linked

Once you create an order from a conversation (or link one manually), the intelligence card collapses into a single line with a link to the order details. The conversation is still fully usable for follow-up messages.

<img src="https://mintcdn.com/kneadapp/tAFF3UYw11xPzKkb/images/communication/intent-order-linked.png?fit=max&auto=format&n=tAFF3UYw11xPzKkb&q=85&s=ffda6c121add3e57e966fe9c0073d48e" alt="Conversation with linked order showing collapsed card" width="1280" height="720" data-path="images/communication/intent-order-linked.png" />

## The Full Picture

On desktop, the Inbox shows everything in a three-column layout: conversation list on the left, the active thread in the center, and a client sidebar on the right with contact info, order history, allergens, and linked orders.

<img src="https://mintcdn.com/kneadapp/tAFF3UYw11xPzKkb/images/communication/inbox-full-desktop.png?fit=max&auto=format&n=tAFF3UYw11xPzKkb&q=85&s=eb5840ac0c75183f8fbc57a288f7ff2b" alt="Full desktop Inbox view showing conversation list, message thread with intelligence card, and client sidebar" width="1440" height="900" data-path="images/communication/inbox-full-desktop.png" />

## How It Works

Order Intelligence runs automatically when an inbound message arrives:

1. **Message received** — A customer emails your Knead inbox address (`yourbakery@inbox.kneadapp.co`)
2. **Client matched** — Knead checks the sender's email against your client list. New contacts are saved automatically
3. **Intent parsed** — The message text is scanned for dates, product names (fuzzy-matched against your catalog), quantities, and occasion keywords
4. **Capacity checked** — The detected delivery date is compared against your existing orders and capacity settings
5. **Card rendered** — The intelligence card appears with the verdict, alternative dates, and action buttons

All of this happens in under a second. No setup required — if you have products in your catalog and capacity configured, Order Intelligence just works.

<Note>Detection runs on every inbound message automatically. You do not need to enable or configure it.</Note>

## Tips

* **Keep your product catalog up to date.** If a customer says "chocolate cake" and you have "Chocolate Fudge Cake", it matches. Generic names like "Cake #1" won't match as well.
* **Set up your capacity.** The verdicts depend on your capacity configuration. Head to **Settings > Capacity** to set daily order limits.
* **Mark your VIPs as Priority.** Go to the client profile and toggle the priority flag so they stand out on the card when your schedule is tight.
* **Set up quick replies.** Save reusable snippets in **Settings → Templates** for common replies like suggesting alternative dates.

## Related Articles

* [Setting Up Your Inbox](/communication/setting-up-your-inbox)
* [Quick Replies](/communication/canned-responses)
* [Message Templates](/communication/message-templates)
* [Linking Conversations to Orders](/communication/linking-conversations-to-orders)
* [Priority Customers](/customers/priority-customers)
* [Using The Sweet Spot](/calendar-and-capacity/using-the-sweet-spot)

***

*Still need help? [Contact us](mailto:hello@kneadapp.co)*
