> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Order Alerts to Slack or Your Phone
> Send a Slack message or text when a big order lands, a delivery is placed or a POS dispatch fails, using storekit webhooks and a small rules engine.
A small app that watches your orders and tells the right person about the ones that matter: large orders, deliveries, and orders that never made it to the till. Rules are yours to edit from a settings page — no redeploy to change a threshold.
If you only want every order posted to a Slack channel with no rules, you do not need to build anything: storekit's webhooks portal can post straight to Slack. See [Slack Notifications](/docs/developers/webhooks/slack-integration). Build this recipe when you need filtering, texts, or different people for different events.
## How It Works
1. storekit sends `order.created` and `order.pos.dispatch.failed` to your app.
2. Your app checks each event against the rules you set (order value, order type, keywords in notes) and picks a channel.
3. It posts to Slack through an incoming webhook, and optionally sends a text through Twilio.
## What You Need
* Webhooks enabled on your storekit plan (**Settings** → **Developers**).
* A [Lovable](https://lovable.dev) or [v0](https://v0.dev) account. Both need a backend for the webhook endpoint — the prompt asks the builder to deploy one and give you its URL. [Replit](https://replit.com) also works and is the simpler choice if the builder struggles with the backend step.
* A Slack incoming webhook URL for the channel you want alerts in (create one from the "Incoming Webhooks" app in Slack's app directory, choose the channel and copy the URL).
* Optional, for texts: a [Twilio](https://twilio.com) account with a phone number. Texts cost money per message; Slack is free.
## Step 1: Build the App
Paste the whole block into the builder in a single message. Change the example rules under **MY RULES** to match your business first.
Either button opens the builder with the whole prompt below already filled in. Nothing starts until you press send, so read it through and edit the parts marked as yours first.
```text theme={null}
I want a small alerting app for my restaurant. storekit sends it a webhook whenever an order is placed or an order fails to reach my till, and it decides whether anyone needs to know and tells them on Slack or by text. It must never miss an alert, never send the same alert twice, and never make storekit wait for a reply.
Build it with a backend that has a public HTTPS URL for the webhook (deploy it and tell me the URL), a small database for rules and history, and a settings page I can use from my phone.
```
```text theme={null}
CONTEXT ABOUT STOREKIT
I run a hospitality business on storekit (storekit.com), an online ordering and payments platform for restaurants, cafés and bars. storekit can notify my own app about things that happen in my store by sending webhooks.
How storekit webhooks work:
- Each event is an HTTP POST with a JSON body to a URL I register in the storekit dashboard.
- The body always has the shape { "event": "", "data": { ... } }.
- Requests are signed with Svix. Every request carries the headers svix-id, svix-timestamp and svix-signature. Verify them with the official `svix` library for your language, using a secret I will provide in an environment variable called STOREKIT_WEBHOOK_SECRET. Reject anything that fails verification with HTTP 400.
- My endpoint must respond with a 2xx status within 15 seconds. Save the event to the database first, respond 200, then do the work from the saved copy.
- Once I have responded 200, storekit will not send that event again, so the work must not be lost: store each event with a status (pending, done, failed) and only mark it done after the work has actually succeeded. On startup and on a timer, pick up anything still pending or failed and retry it. Never do the work only in memory after responding.
- The same event can occasionally be delivered more than once. Use the svix-id header as the unique key for the saved event: a repeat of an event already saved is ignored, whatever its status.
- Any page or endpoint protected by a password must be served over HTTPS only; redirect or refuse plain HTTP.
- Money fields (total, tip, deliveryFee, discountTotal, item price, modifier price) are integers in minor units: 2500 means £25.00.
- orderType is one of Delivery, Pickup, InStore, Curbside, CateringDelivery, CateringPickup or Billpay.
- table and deliveryAddress can be null. notes can be null or empty.
Example order.created payload:
{
"event": "order.created",
"data": {
"id": "ord_abc123",
"code": "A1B2",
"asap": true,
"total": 2500,
"tip": 250,
"deliveryFee": 299,
"discountTotal": 0,
"orderType": "Pickup",
"createdAt": "2024-01-15T10:30:00Z",
"deliveryTime": "2024-01-15T11:00:00Z",
"notes": "Ring doorbell",
"customer": {
"firstName": "John",
"lastName": "Doe",
"email": "john@example.com",
"phone": "+44123456789",
"marketingConsent": true
},
"items": [
{
"name": "Margherita Pizza",
"price": 1200,
"quantity": 1,
"plu": null,
"posId": null,
"taxRate": null,
"modifiers": []
}
],
"venue": {
"id": 1234,
"name": "My Restaurant",
"slug": "my-restaurant",
"address": {
"street1": "123 Main St",
"street2": "",
"city": "London",
"postCode": "W1A 1AA",
"country": "UK",
"companyName": "My Restaurant Ltd",
"coordinates": { "latitude": 51.5074, "longitude": -0.1278 }
}
},
"table": {
"id": "tbl_123",
"name": "Table 5",
"covers": 4,
"posId": "pos_tbl_5",
"area": { "id": "area_1", "name": "Main Floor", "posId": null }
},
"deliveryAddress": {
"street1": "456 Oak Ave",
"street2": "Flat 2",
"city": "London",
"postCode": "E1 6AN",
"country": "UK",
"coordinates": { "latitude": 51.5155, "longitude": -0.0722 }
}
}
}
The full list of event types and payloads is at https://storekit.com/docs/developers/webhooks/webhook-events
```
```text theme={null}
THE SECOND EVENT: order.pos.dispatch.failed
storekit also sends this event when an order could not be pushed to my point-of-sale system. It has a different, smaller payload:
{
"event": "order.pos.dispatch.failed",
"data": {
"order": { "id": "ord_abc123", "code": "A1B2", "total": 2500 },
"venue": { "id": 1234, "name": "My Restaurant", "slug": "my-restaurant" },
"pos": { "name": "Zonal", "error": "Connection timeout: Unable to reach POS endpoint" },
"retryCount": 3
}
}
This one is always urgent: it means the kitchen may not know about a paid order.
WHAT TO BUILD
1. POST /webhooks/storekit — verify the Svix signature with the official svix library and STOREKIT_WEBHOOK_SECRET against the raw request body; 400 on failure. Save the event and return 200 immediately, then evaluate rules and send messages in the background. Ignore any svix-id already saved. Handle order.created and order.pos.dispatch.failed; save and acknowledge any other event type but do nothing with it.
2. A rules engine. Each rule has: a name, which event it applies to, conditions, one or more channels (Slack, SMS, or both), a message template, and an on/off switch. Conditions for order.created: minimum total (in pounds, convert to minor units when comparing), order type is one of a list, notes contain any of a list of words (case-insensitive, also check each item's notes), and a time window (only alert between HH:MM and HH:MM in TIMEZONE). order.pos.dispatch.failed has no conditions: it always alerts on all of its rule's channels. Every matching rule fires on every channel it has; a rule fires at most once per order per channel (order id + rule id + channel is unique).
3. Slack delivery through an incoming webhook URL stored per rule (SLACK_WEBHOOK_URL as the default). Format the message with Slack's mrkdwn: bold first line, then one line per detail.
4. SMS delivery through Twilio using TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN and TWILIO_FROM_NUMBER, to one or more numbers stored on the rule. If the Twilio variables are unset, the SMS channel is shown as disabled in the settings page and is skipped, not errored; the rule's other channels still fire. Keep texts under 160 characters.
5. GET /settings — protected by HTTP basic auth with ADMIN_PASSWORD. Lists rules with on/off toggles, lets me add, edit and delete rules, and has a "Send test" button on each rule that fires it with fake data. Below the rules, show the last 100 alerts sent: time, order code, rule, channel, and whether delivery succeeded (store the Slack or Twilio response).
6. If Slack or Twilio return an error, retry three times with a pause between attempts, then mark the alert failed in the history. Never retry a successful send.
7. GET /health that returns 200 and { "ok": true } and nothing else.
MESSAGE TEMPLATES
Templates use placeholders in curly braces: {code}, {total}, {orderType}, {customerFirstName}, {itemCount}, {items} (one line per item as "2 x Margherita Pizza"), {notes}, {deliveryPostcode}, {time} (createdAt in TIMEZONE, HH:MM), {posName}, {posError}, {retryCount}. Format {total} from minor units with the CURRENCY environment variable, e.g. "25.00 GBP". Never put the customer's email, full surname or full phone number in a message. If a placeholder is null, replace it with "-".
MY RULES (create these as the starting set)
- "Big order": order.created, minimum total 100.00, Slack. Template:
*Big order {code} — {total}*
{orderType} · {itemCount} items · {time}
{items}
- "Delivery placed": order.created, order type in Delivery, CateringDelivery, Slack. Template:
*Delivery {code} — {total}*
{deliveryPostcode} · for {time}
- "Allergy note": order.created, notes contain allergy, allergic, intolerance, coeliac, Slack. Template:
*Allergy note on {code}*
{notes}
- "Till failure": order.pos.dispatch.failed, channels Slack and SMS (SMS skipped until Twilio is configured). Template:
TILL FAILURE {code} {total} — {posName}: {posError}. Enter this order by hand.
DEFINITION OF DONE
- [ ] A signed order.created for a £120 pickup order sends exactly one "Big order" Slack message and nothing else.
- [ ] The same event delivered twice sends one message, not two.
- [ ] A bad signature returns 400 and sends nothing.
- [ ] A £30 Delivery order with the note "severe nut allergy" fires "Delivery placed" and "Allergy note", not "Big order".
- [ ] An order.pos.dispatch.failed event fires "Till failure" on Slack, and on SMS if Twilio is configured.
- [ ] Rules edited in /settings take effect on the next event without a redeploy.
- [ ] The example payload in the context (a £25.00 pickup with the note "Ring doorbell") sends nothing with the starting rules.
- [ ] A Slack URL that returns an error shows as failed in the history after three attempts, and the app keeps accepting events.
WHAT TO GIVE ME WHEN YOU ARE DONE
1. The public webhook URL (…/webhooks/storekit) and the /settings URL.
2. The environment variables to set (STOREKIT_WEBHOOK_SECRET, ADMIN_PASSWORD, SLACK_WEBHOOK_URL, CURRENCY, TIMEZONE, the three Twilio variables) and where to set them on this platform.
3. Confirmation that the backend stays up 24 hours a day and does not sleep between requests.
4. How to run the "Send test" button and what I should see in Slack.
```
Open `/settings`, press "Send test" on the "Big order" rule and check the message lands in Slack before connecting storekit.
## Step 2: Connect storekit
In the dashboard sidebar, go to **Settings** → **Developers** and click **Manage Webhooks** (it reads **Enable Webhooks** the first time). Webhooks are a subscription feature — if you see **Upgrade to enable webhooks**, [contact support](/docs/getting-started/contact-support) first.
In the embedded portal, add a new endpoint, paste the webhook URL your app builder gave you, and tick only the event types the recipe needs.
Open the endpoint you just created and copy its signing secret. In your app builder, save it as the environment variable `STOREKIT_WEBHOOK_SECRET` (builders call this "secrets" or "environment variables"). Redeploy if the builder asks you to.
Use the portal's test option on the endpoint to send a sample event. The delivery log shows the response code from your app. A `2xx` means your app accepted it; anything else, read the response body in the log — it is usually a missing secret.
Tick `order.created` and `order.pos.dispatch.failed` for this endpoint.
## Step 3: Test With a Real Order
Place an order on your own storefront above the "Big order" threshold (or lower the threshold to £1 in `/settings` for the test). The Slack message should arrive within a few seconds of the order confirmation. Put the threshold back afterwards.
To test the till-failure alert without breaking your till, use the test option in the webhooks portal and pick `order.pos.dispatch.failed` as the event type.
## Ideas
* **Different channels per shift**: add a day-of-week condition and route weekend alerts to a different Slack channel.
* **Daily count**: a rule with no conditions that increments a counter, and a 10 pm summary message.
* **Low ratings**: add `order.rating.updated` and alert the GM when a rating is 2 stars or lower.
* **Printer offline**: add `printer.status.offline` and text whoever is on shift; the payload has the printer's `name`.
## What This Does Not Do
* **It does not replace storekit's own alerts.** Order sounds in the dashboard, printer-offline emails and POS failure handling carry on as before.
* **It cannot accept, reject or fix an order.** Webhooks are one-way. The alert tells a person; the person acts in the dashboard.
* **Texts depend on Twilio**, including its sign-up checks and per-message pricing. Slack is free and immediate, which is why the starting rules use it.
* **It is your service.** storekit support can confirm an event was delivered to your URL and the response code; the rules and messages are yours.
## Related
Every order straight to Slack with no code.
The structure behind this prompt, and what to say when the builder gets it wrong.
The payload behind the till-failure alert.
What to do in the dashboard once the alert arrives.
## Related topics
- [Out-of-Stock Log and Morning Digest](/docs/guides/build/recipes/out-of-stock-log.md)
- [Build Your Own Tools on storekit](/docs/guides/build/overview.md)
- [Slack Integration](/docs/developers/webhooks/slack-integration.md)
- [Live Order Board for the Pass](/docs/guides/build/recipes/live-order-board.md)
- [Food Trucks & Pop-ups](/docs/guides/use-cases/food-trucks.md)
Build with Lovable