# Události košíků > Nové nebo změněné košíky a opuštěné košíky známých kontaktů. ## cart.updated > Odesílá se, když se košík vytvoří, nebo se změní jeho položky, celková částka, stav nebo kontakt, z API pro košíky nebo z měřicího skriptu. Alfaverze: otevřená jen týmu Emailitu. # cart.updated Odesílá se, když se košík poprvé uloží, nebo když se změní jeho položky, celková částka, měna, stav nebo kontakt. Košíky pocházejí z endpointu [Vytvoření nebo úprava košíku](/cs/docs/api-reference/carts/upsert/) nebo z příkazu `cart` měřicího skriptu, od kontaktů i od anonymních návštěvníků. Opakované odeslání stejného košíku událost neodešle. Viz [E-commerce](/cs/docs/commerce/#events). > **E-commerce je v alfaverzi:** Dokud E-commerce testujeme, je otevřené jen týmu Emailitu. Viz [Kdo může E-commerce používat](/cs/docs/commerce/#who-can-use-commerce). Úpravy košíků pocházejí z návštěvnosti webu, takže webhooky, které přijímají **All events**, tuto událost nedostanou. Událost `cart.updated` odebírejte podle názvu. Když košík kontaktu zůstane nečinný, Emailit místo ní odešle [`cart.abandoned`](/cs/docs/webhooks/events/cart/abandoned/). Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_3xbAvDuFw01rXuy7pQR7EK2oAu2", "type": "cart.updated", "object": { "object": "cart", "id": "crt_3Rx784H7VYWRTViadjbp5oKHRud", "external_id": "c-58f1a2", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "active", "currency": "USD", "total": 107, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" }, { "product_id": "8123456790", "variant_id": null, "sku": null, "title": "Merino running socks", "quantity": 2, "unit_price": 9, "total": 18, "url": "https://shop.example.com/products/merino-running-socks", "image_url": "https://shop.example.com/images/merino-running-socks.jpg" } ], "checkout_url": "https://shop.example.com/cart/recover/c-58f1a2", "source": "js", "abandoned_at": null, "converted_at": null, "converted_order_id": null, "created_at": "2026-10-08T12:12:47.630Z", "updated_at": "2026-10-08T12:28:51.902Z" }, "data": { "object": { "object": "cart", "id": "crt_3Rx784H7VYWRTViadjbp5oKHRud", "external_id": "c-58f1a2", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "active", "currency": "USD", "total": 107, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" }, { "product_id": "8123456790", "variant_id": null, "sku": null, "title": "Merino running socks", "quantity": 2, "unit_price": 9, "total": 18, "url": "https://shop.example.com/products/merino-running-socks", "image_url": "https://shop.example.com/images/merino-running-socks.jpg" } ], "checkout_url": "https://shop.example.com/cart/recover/c-58f1a2", "source": "js", "abandoned_at": null, "converted_at": null, "converted_order_id": null, "created_at": "2026-10-08T12:12:47.630Z", "updated_at": "2026-10-08T12:28:51.902Z" } } } ``` ## Pole - `event_id` (string): ID události (`evt_…`). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint [Načtení události](/cs/docs/api-reference/events/get/). - `type` (string): Vždy `cart.updated`. - `object` (object): Košík, kterého se událost týká. Jeho pole jsou uvedena níže. - `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`. ### Objekt košíku Stejný objekt, jaký vrací [Načtení košíku](/cs/docs/api-reference/carts/get/). - `id` (string): ID košíku (`crt_…`). - `object` (string): Vždy `cart`. - `external_id` (string): ID košíku nebo pokladny ve vašem obchodě. Košíky z měřicího skriptu bez vlastního ID používají `web:` a za ním anonymní ID návštěvníka. - `contact_id` (string | null): Kontakt, kterému košík patří (`con_…`), nebo `null` u košíku anonymního návštěvníka. - `email` (string | null): Kontaktní e-mail kupujícího. - `status` (string): `active`, nebo `converted`, jakmile objednávka košík převede. - `currency` (string | null): Třípísmenný kód ISO 4217 měny částek. - `total` (number): Hodnota košíku. - `items` (object[]): Položky košíku, každá s `product_id`, `variant_id`, `sku`, `title`, `quantity`, `unit_price`, `total`, `url` a `image_url`. - `checkout_url` (string | null): Odkaz, který kupujícího vrátí ke košíku. - `source` (string): `api`, nebo `js` u košíků z měřicího skriptu. - `abandoned_at` (null): Vždy `null`: úprava opuštěného košíku ho znovu aktivuje. - `converted_at, converted_order_id` (string | null): Kdy objednávka košík převedla a ID této objednávky (`ord_…`). Dokud je košík aktivní, `null`. - `created_at, updated_at` (string): Kdy byl košík poprvé uložen a kdy se naposledy změnil, ve formátu ISO 8601 v UTC. --- Zdroj: https://emailit.com/cs/docs/webhooks/events/cart/cart-updated/ ## cart.abandoned > Odesílá se, když košík kontaktu s položkami zůstane beze změny po dobu nastavenou pro opuštění košíku v nastavení E-commerce. Alfaverze: otevřená jen týmu Emailitu. # cart.abandoned Odesílá se, když se košík stane opuštěným: patří kontaktu, obsahuje aspoň jednu položku a neaktualizoval se po dobu `cart_abandon_minutes` z [nastavení E-commerce](/cs/docs/api-reference/commerce/get-settings/) (ve výchozím stavu 60). Emailit to kontroluje každou minutu. Košíky bez kontaktu se nikdy nestanou opuštěnými. Událost použijte ke spuštění automatizace pro opuštěný košík nebo k upozornění vlastních systémů. Viz [E-commerce](/cs/docs/commerce/#abandoned-carts). Událost se odešle jednou pokaždé, když se košík stane opuštěným. Pokud se košík později [upraví](/cs/docs/api-reference/carts/upsert/), je znovu aktivní a může se znovu stát opuštěným a událost se odešle znovu. Košík, který objednávka převedla, se nikdy nestane opuštěným. > **E-commerce je v alfaverzi:** Dokud E-commerce testujeme, je otevřené jen týmu Emailitu. Viz [Kdo může E-commerce používat](/cs/docs/commerce/#who-can-use-commerce). Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_3xbAvDuFw01rXuy7pQR7EK2oAu2", "type": "cart.abandoned", "object": { "object": "cart", "id": "crt_3Rx784H7VYWRTViadjbp5oKHRud", "external_id": "c-58f1a2", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "abandoned", "currency": "USD", "total": 107, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" }, { "product_id": "8123456790", "variant_id": null, "sku": null, "title": "Merino running socks", "quantity": 2, "unit_price": 9, "total": 18, "url": "https://shop.example.com/products/merino-running-socks", "image_url": "https://shop.example.com/images/merino-running-socks.jpg" } ], "checkout_url": "https://shop.example.com/cart/recover/c-58f1a2", "source": "js", "abandoned_at": "2026-10-08T13:31:04.118Z", "converted_at": null, "converted_order_id": null, "created_at": "2026-10-08T12:12:47.630Z", "updated_at": "2026-10-08T12:28:51.902Z" }, "data": { "object": { "object": "cart", "id": "crt_3Rx784H7VYWRTViadjbp5oKHRud", "external_id": "c-58f1a2", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "abandoned", "currency": "USD", "total": 107, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" }, { "product_id": "8123456790", "variant_id": null, "sku": null, "title": "Merino running socks", "quantity": 2, "unit_price": 9, "total": 18, "url": "https://shop.example.com/products/merino-running-socks", "image_url": "https://shop.example.com/images/merino-running-socks.jpg" } ], "checkout_url": "https://shop.example.com/cart/recover/c-58f1a2", "source": "js", "abandoned_at": "2026-10-08T13:31:04.118Z", "converted_at": null, "converted_order_id": null, "created_at": "2026-10-08T12:12:47.630Z", "updated_at": "2026-10-08T12:28:51.902Z" } } } ``` ## Pole - `event_id` (string): ID události (`evt_…`). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint [Načtení události](/cs/docs/api-reference/events/get/). - `type` (string): Vždy `cart.abandoned`. - `object` (object): Košík, kterého se událost týká. Jeho pole jsou uvedena níže. - `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`. ### Objekt košíku Stejný objekt, jaký vrací [Načtení košíku](/cs/docs/api-reference/carts/get/). - `id` (string): ID košíku (`crt_…`). - `object` (string): Vždy `cart`. - `external_id` (string): ID košíku nebo pokladny ve vašem obchodě. Košíky z měřicího skriptu bez vlastního ID používají `web:` a za ním anonymní ID návštěvníka. - `contact_id` (string): Kontakt, kterému košík patří (`con_…`). - `email` (string | null): Kontaktní e-mail kupujícího. - `status` (string): Vždy `abandoned`. - `currency` (string | null): Třípísmenný kód ISO 4217 měny částek. - `total` (number): Hodnota košíku. - `items` (object[]): Položky košíku, každá s `product_id`, `variant_id`, `sku`, `title`, `quantity`, `unit_price`, `total`, `url` a `image_url`. - `checkout_url` (string | null): Odkaz, který kupujícího vrátí ke košíku. - `source` (string): `api`, nebo `js` u košíků z měřicího skriptu. - `abandoned_at` (string): Kdy Emailit označil košík jako opuštěný, ve formátu ISO 8601 v UTC. - `converted_at, converted_order_id` (null): V této události vždy `null`. - `created_at, updated_at` (string): Kdy byl košík poprvé uložen a kdy se naposledy změnil, ve formátu ISO 8601 v UTC. --- Zdroj: https://emailit.com/cs/docs/webhooks/events/cart/cart-abandoned/