# Eventi dei carrelli > Carrelli creati o modificati e carrelli abbandonati di contatti noti. ## cart.updated > Inviato quando un carrello viene creato, oppure cambiano i suoi articoli, il totale, lo stato o il contatto, dall’API dei carrelli o dallo script di tracciamento. Alpha: aperto solo al team di Emailit. # cart.updated Inviato quando un carrello viene salvato per la prima volta, oppure quando cambiano i suoi articoli, il totale, la valuta, lo stato o il contatto. I carrelli arrivano da [Crea o aggiorna un carrello](/it/docs/api-reference/carts/upsert/) o dal comando `cart` dello script di tracciamento, sia dai contatti sia dai visitatori anonimi. Se invii di nuovo lo stesso carrello, l’evento non viene inviato. Vedi [E-commerce](/it/docs/commerce/#events). > **L’e-commerce è in alpha:** L’e-commerce è aperto solo al team di Emailit mentre lo testiamo. Vedi [Chi può usare l’e-commerce](/it/docs/commerce/#who-can-use-commerce). Gli aggiornamenti dei carrelli derivano dal traffico del sito, quindi i webhook che ricevono **All events** non ricevono questo evento. Sottoscrivi `cart.updated` per nome. Quando il carrello di un contatto diventa inattivo, Emailit invia invece [`cart.abandoned`](/it/docs/webhooks/events/cart/abandoned/). Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/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" } } } ``` ## Campi - `event_id` (string): ID dell’evento (`evt_…`). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con [Recupera un evento](/it/docs/api-reference/events/get/). - `type` (string): Sempre `cart.updated`. - `object` (object): Il carrello descritto dall’evento. I suoi campi sono elencati qui sotto. - `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`. ### Oggetto carrello Lo stesso oggetto restituito da [Recupera un carrello](/it/docs/api-reference/carts/get/). - `id` (string): ID del carrello (`crt_…`). - `object` (string): Sempre `cart`. - `external_id` (string): L’ID del carrello o del checkout nel tuo negozio. I carrelli dello script di tracciamento senza un ID proprio usano `web:` seguito dall’ID anonimo del visitatore. - `contact_id` (string | null): Il contatto a cui appartiene il carrello (`con_…`), oppure `null` per il carrello di un visitatore anonimo. - `email` (string | null): L’indirizzo email dell’acquirente. - `status` (string): `active`, oppure `converted` quando un ordine ha convertito il carrello. - `currency` (string | null): Codice ISO 4217 di tre lettere degli importi. - `total` (number): Valore del carrello. - `items` (object[]): Righe del carrello, ognuna con `product_id`, `variant_id`, `sku`, `title`, `quantity`, `unit_price`, `total`, `url` e `image_url`. - `checkout_url` (string | null): Link che riporta l’acquirente al carrello. - `source` (string): `api`, oppure `js` per i carrelli dello script di tracciamento. - `abandoned_at` (null): Sempre `null`: aggiornare un carrello abbandonato lo rende di nuovo attivo. - `converted_at, converted_order_id` (string | null): Quando un ordine ha convertito il carrello, e l’ID di quell’ordine (`ord_…`). `null` finché il carrello è attivo. - `created_at, updated_at` (string): Quando il carrello è stato salvato per la prima volta e quando è cambiato l’ultima volta, in ISO 8601 UTC. --- Fonte: https://emailit.com/it/docs/webhooks/events/cart/cart-updated/ ## cart.abandoned > Inviato quando il carrello di un contatto che contiene articoli resta invariato per il tempo di abbandono delle impostazioni e-commerce. Alpha: aperto solo al team di Emailit. # cart.abandoned Inviato quando un carrello diventa abbandonato: appartiene a un contatto, contiene almeno un articolo e non è stato aggiornato per i `cart_abandon_minutes` delle [impostazioni e-commerce](/it/docs/api-reference/commerce/get-settings/) (60 per impostazione predefinita). Emailit controlla ogni minuto. I carrelli senza contatto non diventano mai abbandonati. Usa l’evento per avviare un’automazione per il carrello abbandonato o per avvisare i tuoi sistemi. Vedi [E-commerce](/it/docs/commerce/#abandoned-carts). L’evento viene inviato una volta per ogni abbandono del carrello. Se in seguito il carrello viene [aggiornato](/it/docs/api-reference/carts/upsert/), torna attivo e può essere abbandonato di nuovo, e l’evento viene inviato di nuovo. Un carrello convertito da un ordine non viene mai abbandonato. > **L’e-commerce è in alpha:** L’e-commerce è aperto solo al team di Emailit mentre lo testiamo. Vedi [Chi può usare l’e-commerce](/it/docs/commerce/#who-can-use-commerce). Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/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" } } } ``` ## Campi - `event_id` (string): ID dell’evento (`evt_…`). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con [Recupera un evento](/it/docs/api-reference/events/get/). - `type` (string): Sempre `cart.abandoned`. - `object` (object): Il carrello descritto dall’evento. I suoi campi sono elencati qui sotto. - `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`. ### Oggetto carrello Lo stesso oggetto restituito da [Recupera un carrello](/it/docs/api-reference/carts/get/). - `id` (string): ID del carrello (`crt_…`). - `object` (string): Sempre `cart`. - `external_id` (string): L’ID del carrello o del checkout nel tuo negozio. I carrelli dello script di tracciamento senza un ID proprio usano `web:` seguito dall’ID anonimo del visitatore. - `contact_id` (string): Il contatto a cui appartiene il carrello (`con_…`). - `email` (string | null): L’indirizzo email dell’acquirente. - `status` (string): Sempre `abandoned`. - `currency` (string | null): Codice ISO 4217 di tre lettere degli importi. - `total` (number): Valore del carrello. - `items` (object[]): Righe del carrello, ognuna con `product_id`, `variant_id`, `sku`, `title`, `quantity`, `unit_price`, `total`, `url` e `image_url`. - `checkout_url` (string | null): Link che riporta l’acquirente al carrello. - `source` (string): `api`, oppure `js` per i carrelli dello script di tracciamento. - `abandoned_at` (string): Quando Emailit ha contrassegnato il carrello come abbandonato, in ISO 8601 UTC. - `converted_at, converted_order_id` (null): Sempre `null` in questo evento. - `created_at, updated_at` (string): Quando il carrello è stato salvato per la prima volta e quando è cambiato l’ultima volta, in ISO 8601 UTC. --- Fonte: https://emailit.com/it/docs/webhooks/events/cart/cart-abandoned/