Key Takeaways
- A mattress-trial webhook fires when the in-home window actually closes — not when the bed was delivered.
- “Schedule pickup or keep” is operational. “See our pillows” is promo with STOP.
- Free is 1 device, 300 SMS lifetime, and 300 contacts. Developer is 25,000 SMS per year. Platform price is devices plus send volume.
- Account OTP stays off the trial radio.
- Idempotency is order-id plus window-end — CS re-exports after a date change.
Summary
Scenario 1141 is ecommerce webhooks for in-home mattress trial windows — not warranty replacements, not trade-in credits, not atelier QC, not recalls. Delivered is a hint. Window-end is the join. Service pricing is devices plus SMS send volume. You bring the phones and operator credit. Free is 1 device, 300 SMS lifetime, and 300 contacts.
Starter allows 2 devices: trial dual-SIM plus a spare. Uncapped platform volume is not unlimited carrier SMS. Confirm payloads in Developer Center.
delivered · window · SMS
order + window-end — CS date changes re-export
A trial-end notice is not a restock blast
Window copy names the date and pickup hold. Accessory merch lives elsewhere. Mixing them is how a sleeper STOPs the week they actually needed the pickup slot.
If merchandising fires “your trial” when the bed is delivered, the customer thinks the clock already ended. Join window-end. Suppress delivered-to-buyer templates.
Mattress webhook matrix
| Event | SMS | Failure |
|---|---|---|
| Delivered | None or receipt | “Trial ended” on day one |
| Window close | Date + pickup hold | Pillow stuffed in |
| Date change | Once after new end | Two end texts |
| Account OTP | Auth pool | OTP on the trial radio |
Join window close, not delivered
Persist order-id plus window-end. Signed webhooks. DLR. MCP wraps REST only.
Pickup vs catalog
The SMS is that order. A catalog carousel is marketing. FTC business guidance is not a reason to hide the hold hours behind a shop grid.
Devices, volume, and airtime
Promo weeks spike. We meter devices and platform sends. Free (1/300/300) is one order proof.
Trial operations
Charge the CS chassis before the close window. Setup, Downloads, pricing.
Decision guide
Ship when notice joins window-end. Delay if delivered texts “trial over.” Not a CodeCanyon mattress pack.
Trial checklist
- Window-end idempotency.
- Delivered silent as ended.
- Accessories off trial purpose.
- OTP off trial SIM.
- Developer Center fields confirmed.
Next steps
Scenario 1081 warranty, scenario 181 RMA.
Related product pages
Jump to the live product docs for this topic—not another long-form article.
- SMS webhook integrationInbound and status events
- transactional SMS for orders and alertsEvent-driven messages
- SMS API documentationLive endpoint reference
- PHP REST send samplesPHP code examples
