--- title: "Recipe: taking orders by chat" description: A Lampson agent that serves a bakery's customers on Telegram or WhatsApp and takes their orders from start to finish — the orders plugin, the catalog, the agent and a real conversation. --- # Recipe: taking orders by chat An agent that answers a business's chat and **takes the whole order**: what and how many, delivery or pickup, the address, the name, how they pay, the summary, the confirmation and the order number. The order is saved, the stock goes down and the customer is remembered for next time. It takes three files: the `orders` plugin (it ships with Lampson), your business's catalog and the agent. If you want your own tools instead of a plugin, with your database and the customer taken from your app's context, see [Recipe: a support agent](/en/docs/support). ## 1. The `orders` plugin It ships with Lampson in `~/lampson/plugins/orders/`. Turn it on once (`/plugins on orders` in the terminal, or the **plugins** pill on the web). Its tools: | tool | | |---|---| | `catalog` | the catalog: products, prices, stock, hours, delivery, payment methods | | `quote` | prices a cart **exactly**: promos, packs, delivery fee and total, and flags anything out of stock | | `place_order` | saves the order with a number (`P-0001`), saves the customer and lowers the stock | | `update_order` | changes an order that is still "new": items, delivery or pickup, address, payment, time; re-prices and moves the stock | | `cancel_order` | cancels a "new" order and puts the stock back | | `find_customer` | a returning customer: their address and last orders | | `order_status` | an order by its number | The plugin does the math, never the model: `place_order` prices everything again from the catalog, rejects a payment method you don't accept and won't save an order without an address or without stock. The plugin also brings its [instructions](/en/docs/plugins#instructions-the-plugin-brings-its-process): the process for taking an order (always price with `quote`, ask only for what's missing, summarize and wait for a "yes" before saving). That's why your agent's prompt doesn't have to explain it. ## 2. The catalog `.lampson/orders/catalog.json` in your project. Orders (`P-0001.json`…) and customers (`customers.json`) are saved next to it. ```json { "store": "Panadería Sol", "hours": "lunes a sábado de 7 a 20 h; domingos de 8 a 13 h", "delivery": {"area": "hasta 5 km del local", "fee": 1500, "free_from": 15000, "eta": "1 a 2 horas"}, "payment": ["efectivo", "transferencia", "tarjeta de débito"], "products": [ {"sku": "PAN-INT", "name": "Pan integral de masa madre", "price": 3200, "unit": "unidad (700 g)", "stock": 14, "second_half": true}, {"sku": "PAN-BLA", "name": "Pan blanco de campo", "price": 2400, "stock": 0, "notes": "vuelve mañana a las 7"}, {"sku": "MED-LUN", "name": "Medialunas de manteca", "price": 900, "stock": 60, "pack": {"qty": 12, "price": 9600}}, {"sku": "ALF-MAI", "name": "Alfajores de maicena", "price": 700, "stock": 40, "gluten_free": true} ], "policies": ["No hacemos descuentos fuera de las promos del catálogo."] } ``` - `pack`: a price per quantity (a dozen for $9,600). - `second_half`: buy 2, the second at half price. - `delivery.free_from`: free delivery from that subtotal. - `notes`, `policies` and any other field (`gluten_free`, `vegan`…) are read by the agent as they are. ## 3. The agent `.lampson/agents/tienda.agent.json`. Its prompt says **who it is** — the plugin brings the process: ```json { "id": "tienda", "description": "Atiende a los clientes de Panadería Sol por chat y toma sus pedidos", "base": "none", "system": "Eres quien atiende el chat de Panadería Sol, una panadería de barrio en Rosario. Los clientes escriben desde el celular. Tono: cálido, rioplatense (vos), breve. Sin markdown. Precios con punto de miles ($3.200). No hables de archivos ni herramientas.", "tools": [{"name": "plugin_orders_*", "approve": "auto"}], "permission": "strict", "steps": 10 } ``` `"approve": "auto"` lets **only** the `orders` tools run without anyone approving; everything else stays `strict`. → [Agents](/en/docs/agents) ## 4. Connect it ```sh lampson channel on telegram # or Chatwoot for WhatsApp/Instagram → /docs/channels lampson key add --agent tienda # or your app/bot through the API → /docs/api ``` ## A real conversation This is a real conversation with the agent above (model `glm-5.3-flash`), typed the way people type: several messages in a row, with pauses of 2 to 6 seconds. Each message came in on its own and the [mailbox](/en/docs/api#the-mailbox) put them together. It's in Spanish, as it happened — a neighborhood bakery in Rosario, Argentina. ```chat @cliente: hola @cliente: como estas? @cliente: te puedo pedir o ya cierran? @tienda: ¡Hola! Bien, ¿y vos? 😊 Sí, se puede pedir tranquilo: hoy viernes cerramos a las 20 h, así que estás a tiempo. ¿Qué te tienta? Tenemos pan integral de masa madre, medialunas, alfajores de maicena, torta de chocolate... @cliente: bien bien @cliente: queria pan blanco y medialunas @cliente: es para mañana temprano el desayuno @tienda: Uy, justamente el pan blanco se nos terminó hoy 😔 vuelve mañana a las 7, recién horneado. Te propongo: te guardo las medialunas para mañana temprano y pasás a buscarlas con el pan calentito, o te mando ahora las medialunas (llegan en 1 a 2 horas) y mañana temprano pasás por el pan. También tengo pan integral de masa madre si querés reemplazarlo, hoy hay stock. ¿Cómo lo preferís? Y las medialunas ¿sueltas o docena? La docena sale $9.600 😊 @cliente: uh que lastima @cliente: bueno mandame las medialunas ahora entonces, una docena @cliente: y sumale 2 integrales asi tenemos pan para mañana @cliente: cuanto sale todo con el envio? @tienda: Te sale así: 12 medialunas (docena): $9.600 2 panes integrales (el segundo a mitad de precio): $4.800 Envío: $1.500 Total: $15.900 🛵 Te llegan en 1 a 2 horas. ¿A qué dirección las mando, y con qué nombre? ¿Pago en efectivo, transferencia o débito? @cliente: uh me falta poco para el envio gratis no? @cliente: que me recomendas sumar @tienda: ¡Sí! Te faltaban $600 de productos para el envío gratis. Con un alfajor de maicena ($700) lo superás y hasta te conviene: el total te queda en $15.100, o sea $800 menos que antes 😄 ¿Te sumo uno? Igual sigo necesitando tu dirección, nombre y forma de pago para cerrar el pedido. @cliente: jaja dale sumame 2 alfajores mejor @cliente: Martín Ferreyra @cliente: Entre Ríos 845, 2do A @cliente: es al lado de la farmacia @cliente: pago con transferencia @tienda: ¡Perfecto, Martín! Te confirmo el pedido: Docena de medialunas: $9.600 2 panes integrales: $4.800 2 alfajores de maicena: $1.400 Envío a Entre Ríos 845, 2do A (al lado de la farmacia): gratis 🎉 Total: $15.800 Pago por transferencia (te la paso antes de que salga el pedido). Llega en 1 a 2 horas. ¿Confirmo? ✅ @cliente: siii confirmo @cliente: a que alias te transfiero? @tienda: ¡Listo, Martín! Pedido confirmado 🎉 Número de pedido: P-0001 Total: $15.800 Te llega en 1 a 2 horas a Entre Ríos 845, 2do A. Con la transferencia: no te puedo pasar el alias desde acá, te lo manda el local antes de que salga tu pedido, así que quedate atento al celu. ¡Buen provecho y que rico desayuno mañana! 🥐 @cliente: che perdon @cliente: me olvide, se puede agregar una torta de chocolate al pedido? @cliente: es el cumple de mi vieja mañana @tienda: ¡Qué lindo, feliz cumple para tu vieja! 🎂 Sí, hay stock. Como el pedido P-0001 ya está confirmado, te armo uno aparte con la torta: $18.500, con envío gratis también (llega en 1 a 2 horas). ¿La querés hoy junto con todo, o mañana a primera hora para el cumple? ¿Te confirmo con transferencia como el otro? @cliente: mañana tipo 8 así es sorpresa @cliente: sí, transferencia @cliente: dale confirmame @tienda: ¡Confirmado! 🎉 Pedido P-0002: torta de chocolate, $18.500, mañana sábado a las 8 h en punto (abrimos a las 7 así que sin problema). El alias te llega antes de que salga la torta, igual que con el otro pedido. Anotado que es sorpresa 😉 ¡Feliz cumple para tu vieja, Martín! 🎂 ``` What was saved: ```json // .lampson/orders/P-0001.json (abridged) {"id": "P-0001", "customer": {"name": "Martín Ferreyra"}, "delivery": "delivery", "address": "Entre Ríos 845, 2do A (al lado de la farmacia)", "payment": "transferencia", "lines": [{"sku": "MED-LUN", "qty": 12, "amount": 9600, "promo": "1 x pack of 12"}, {"sku": "PAN-INT", "qty": 2, "amount": 4800, "promo": "1 x second at half price"}, {"sku": "ALF-MAI", "qty": 2, "amount": 1400}], "delivery_fee": 0, "total": 15800, "status": "new"} ``` `P-0002` saved `"when": "mañana 2026-10-17 a las 8 h"` and the note about the surprise. The stock went down (whole-wheat 14 → 12, medialunas 60 → 48, alfajores 40 → 38). **What the conversation shows:** - **Bursts → one answer.** Each block of 2 to 5 messages got **one** answer that covers everything. In the fifth, the address came in four messages over 24 seconds: the ones that arrived while the agent was working joined the same turn, and if they arrive while it is already writing the answer, Lampson drops it and answers again with everything. - **No made-up math.** Every total came from `quote`, with the second-loaf promo, the dozen price and free delivery from $15,000. - **Out of stock, an alternative.** White bread had stock 0: it said so, said when it's back and offered options. - **What it doesn't know, it doesn't invent.** The account alias for the bank transfer isn't in the catalog, so it didn't make one up. Add it to `policies` and it will give it. - **Nothing is saved without a "yes".** It showed the summary and waited for the confirmation. - **Timing:** each answer came 14 to 25 seconds after the customer's last message: the 3 seconds the mailbox waits in case they keep typing, plus the model and the tools. ## A returning customer Ana had bought before (that order came from a web shop, see below). She writes again: ```chat @cliente: holaa @cliente: soy Ana Gómez, mi cel es 341 555 0101 @cliente: quiero lo mismo que pedí la otra vez @cliente: pero esta vez mandámelo a casa, Mitre 230 7mo C @tienda: ¡Hola Ana! 😊 Ya te encontré. Tu pedido sería: 1 pan sin gluten de arroz y mijo + 6 alfajores de maicena, a domicilio en Mitre 230 7mo C. El total con el envío queda en $9.800. ¿Cómo lo querés pagar: efectivo, transferencia o tarjeta de débito? @cliente: débito cuando llegue @cliente: si dale confirmá @tienda: ¡Listo Ana, confirmado! 🥖 Tu pedido es el P-0004: 1 pan sin gluten de arroz y mijo + 6 alfajores de maicena, $9.800 en total, a Mitre 230 7mo C. Pagás con débito al recibir y llega en 1 a 2 horas. ¡Gracias por elegirnos! 😊 ``` `find_customer` found her by phone, with her previous orders. ## No chat: an order coming from another system The plugin's same instructions cover the case with nobody on the other side: your web shop, a script or another agent sends the complete order through the [API](/en/docs/api), and the agent checks it and saves it. ```sh curl -X POST https://your-lampson/w/tienda/v1/messages -H "Authorization: Bearer lk_…" \ -d '{"to": "tienda", "thread": "web:881", "text": "Pedido de la tienda web #881 (ya pagado y confirmado por el cliente). Cliente: Ana Gómez, tel 341 555 0101. Items: 1 x PAN-SG, 6 x ALF-MAI. Retira en el local. Pago: tarjeta de débito. Respondé solo con el número de pedido y el total, o con el problema."}' ``` ```json {"text": "Pedido P-0003 registrado. Total: $8.300. Retira en el local (Av. Belgrano 1450), pago con tarjeta de débito.", "steps": 3, …} ``` ## Changing or cancelling an order While the order is `"new"` (the store hasn't started it), the customer can change or cancel it from the chat: `update_order` takes the whole new cart, re-prices it and moves the stock only by the difference; `cancel_order` sets it to `"cancelled"` and puts all the stock back. Every change goes into the order's `history`. Once the store moves it to another status (`"preparing"`, `"sent"`… by editing `status` in `.lampson/orders/P-NNNN.json`), the agent can't touch it anymore and tells the customer so. A real customer, with the same agent: ```chat @cliente: hola buenas @cliente: quiero 6 medialunas y 2 alfajores para retirar @cliente: soy Sofía, pago en efectivo @cliente: confirmado así nomás @tienda: ¡Listo Sofía! 😊 Tu pedido quedó registrado: 6 medialunas de manteca y 2 alfajores de maicena, para retirar por Av. Belgrano 1450. Total $6.800 en efectivo. Te esperamos, estamos de 7 a 20 h hoy. Número de pedido: P-0005. ¡Gracias! @cliente: ay perdón @cliente: mejor que sea una docena de medialunas @cliente: y al final mandámelo, San Martín 920 @tienda: No hay problema! Te queda así: 12 medialunas + 2 alfajores, envío a San Martín 920, pagás en efectivo al recibir. El total con el envío ($1.500) da $12.500 😊 ¿Confirmás? Y decime si es departamento o alguna referencia para el repartidor. @cliente: sí dale @cliente: es casa, portón verde @tienda: ¡Listo Sofía! Tu pedido P-0005 quedó actualizado: 12 medialunas y 2 alfajores a San Martín 920 (casa, portón verde), $12.500 en efectivo al recibir. Llega en 1 a 2 horas. ¡Gracias! 🥐 @cliente: uh me surgió algo y no voy a estar en casa @cliente: cancelame el pedido porfa, perdón! @tienda: ¡No hay problema Sofía! Cancelado el pedido P-0005, no te cobramos nada 😊 Cuando quieras volvés a escribir y te lo armamos de nuevo. ¡Que te vaya bien! ``` And Martín, once the store was already making the cake (`P-0002` in `"preparing"`): ```chat @cliente: che hola de nuevo @cliente: al final mi vieja no viene mañana @cliente: podés cancelar lo de la torta? @tienda: Ay, perdón Martín 😔 la torta ya está en preparación en el local, así que desde acá ya no puedo cancelarla. Vas a tener que hablar directo con el local (Av. Belgrano 1450) para ver si pueden hacer algo con esa torta. Lo de las medialunas, los panes y los alfajores (P-0001) queda igual, mañana a las 8 llega la sorpresa... digo, el desayuno 😄 ¿Algo más en lo que te pueda ayudar? ``` (In Martín's first conversation the agent placed a separate order for the cake: `update_order` didn't exist yet. Now it changes the existing order.) ## Limits today - The store changes an order's status (`preparing`, `sent`…) by hand in `.lampson/orders/`: there's no panel for that yet. - The store handles payment; the plugin doesn't charge. - For something else (appointments, bookings, quotes), copy the plugin's folder and change its tools and its `INSTRUCTIONS.md`: the same pattern works for any process.