Přejít na obsah
Dokumentace

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

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

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

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.

typestring

Vždy cart.updated.

objectobject

Košík, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt košíku

Stejný objekt, jaký vrací Načtení košíku.

idstring

ID košíku (crt_…).

objectstring

Vždy cart.

external_idstring

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

Kontakt, kterému košík patří (con_…), nebo null u košíku anonymního návštěvníka.

emailstring | null

Kontaktní e-mail kupujícího.

statusstring

active, nebo converted, jakmile objednávka košík převede.

currencystring | null

Třípísmenný kód ISO 4217 měny částek.

totalnumber

Hodnota košíku.

itemsobject[]

Položky košíku, každá s product_id, variant_id, sku, title, quantity, unit_price, total, url a image_url.

checkout_urlstring | null

Odkaz, který kupujícího vrátí ke košíku.

sourcestring

api, nebo js u košíků z měřicího skriptu.

abandoned_atnull

Vždy null: úprava opuštěného košíku ho znovu aktivuje.

converted_at, converted_order_idstring | null

Kdy objednávka košík převedla a ID této objednávky (ord_…). Dokud je košík aktivní, null.

created_at, updated_atstring

Kdy byl košík poprvé uložen a kdy se naposledy změnil, ve formátu ISO 8601 v 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

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

Událost se odešle jednou pokaždé, když se košík stane opuštěným. Pokud se košík později upraví, 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.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

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.

typestring

Vždy cart.abandoned.

objectobject

Košík, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt košíku

Stejný objekt, jaký vrací Načtení košíku.

idstring

ID košíku (crt_…).

objectstring

Vždy cart.

external_idstring

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_idstring

Kontakt, kterému košík patří (con_…).

emailstring | null

Kontaktní e-mail kupujícího.

statusstring

Vždy abandoned.

currencystring | null

Třípísmenný kód ISO 4217 měny částek.

totalnumber

Hodnota košíku.

itemsobject[]

Položky košíku, každá s product_id, variant_id, sku, title, quantity, unit_price, total, url a image_url.

checkout_urlstring | null

Odkaz, který kupujícího vrátí ke košíku.

sourcestring

api, nebo js u košíků z měřicího skriptu.

abandoned_atstring

Kdy Emailit označil košík jako opuštěný, ve formátu ISO 8601 v UTC.

converted_at, converted_order_idnull

V této události vždy null.

created_at, updated_atstring

Kdy byl košík poprvé uložen a kdy se naposledy změnil, ve formátu ISO 8601 v 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"
    }
  }
}

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.

Esc

Oblíbené

↑↓procházet↵otevřítEsczavřít