Vai al contenuto
Docs

Eventi dei carrelli

Carrelli creati o modificati e carrelli abbandonati di contatti noti.

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 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.

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.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

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.

typestring

Sempre cart.updated.

objectobject

Il carrello descritto dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto carrello

Lo stesso oggetto restituito da Recupera un carrello.

idstring

ID del carrello (crt_…).

objectstring

Sempre cart.

external_idstring

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_idstring | null

Il contatto a cui appartiene il carrello (con_…), oppure null per il carrello di un visitatore anonimo.

emailstring | null

L’indirizzo email dell’acquirente.

statusstring

active, oppure converted quando un ordine ha convertito il carrello.

currencystring | null

Codice ISO 4217 di tre lettere degli importi.

totalnumber

Valore del carrello.

itemsobject[]

Righe del carrello, ognuna con product_id, variant_id, sku, title, quantity, unit_price, total, url e image_url.

checkout_urlstring | null

Link che riporta l’acquirente al carrello.

sourcestring

api, oppure js per i carrelli dello script di tracciamento.

abandoned_atnull

Sempre null: aggiornare un carrello abbandonato lo rende di nuovo attivo.

converted_at, converted_order_idstring | null

Quando un ordine ha convertito il carrello, e l’ID di quell’ordine (ord_…). null finché il carrello è attivo.

created_at, updated_atstring

Quando il carrello è stato salvato per la prima volta e quando è cambiato l’ultima volta, in ISO 8601 UTC.

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"
    }
  }
}

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 (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.

L’evento viene inviato una volta per ogni abbandono del carrello. Se in seguito il carrello viene aggiornato, 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.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

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.

typestring

Sempre cart.abandoned.

objectobject

Il carrello descritto dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto carrello

Lo stesso oggetto restituito da Recupera un carrello.

idstring

ID del carrello (crt_…).

objectstring

Sempre cart.

external_idstring

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_idstring

Il contatto a cui appartiene il carrello (con_…).

emailstring | null

L’indirizzo email dell’acquirente.

statusstring

Sempre abandoned.

currencystring | null

Codice ISO 4217 di tre lettere degli importi.

totalnumber

Valore del carrello.

itemsobject[]

Righe del carrello, ognuna con product_id, variant_id, sku, title, quantity, unit_price, total, url e image_url.

checkout_urlstring | null

Link che riporta l’acquirente al carrello.

sourcestring

api, oppure js per i carrelli dello script di tracciamento.

abandoned_atstring

Quando Emailit ha contrassegnato il carrello come abbandonato, in ISO 8601 UTC.

converted_at, converted_order_idnull

Sempre null in questo evento.

created_at, updated_atstring

Quando il carrello è stato salvato per la prima volta e quando è cambiato l’ultima volta, in ISO 8601 UTC.

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"
    }
  }
}

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.

Esc

Popolari

↑↓per spostarti↵per aprireEscper chiudere