Pular para o conteúdo
Docs

Eventos de carrinho

Carrinhos criados ou alterados e carrinhos abandonados de contatos conhecidos.

cart.updated

Enviado quando um carrinho é armazenado pela primeira vez, ou quando os itens, o total, a moeda, o status ou o contato dele mudam. Os carrinhos vêm de Criar ou atualizar um carrinho ou do comando cart do script de rastreamento, de contatos e de visitantes anônimos. Enviar o mesmo carrinho de novo não envia o evento. Consulte E-commerce.

As atualizações de carrinho vêm do tráfego do site, então os webhooks que recebem All events não recebem este evento. Inscreva o webhook em cart.updated pelo nome. Quando o carrinho de um contato fica parado, o Emailit envia cart.abandoned em vez disso.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre cart.updated.

objectobject

O carrinho que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de carrinho

O mesmo objeto que Obter um carrinho retorna.

idstring

ID do carrinho (crt_…).

objectstring

Sempre cart.

external_idstring

O ID do carrinho ou do checkout na sua loja. Os carrinhos do script de rastreamento sem um ID próprio usam web: seguido do ID anônimo do visitante.

contact_idstring | null

O contato a quem o carrinho pertence (con_…), ou null para o carrinho de um visitante anônimo.

emailstring | null

O endereço de e-mail do comprador.

statusstring

active, ou converted quando um pedido converteu o carrinho.

currencystring | null

Código ISO 4217 de três letras dos valores.

totalnumber

Valor do carrinho.

itemsobject[]

Itens, cada um com product_id, variant_id, sku, title, quantity, unit_price, total, url e image_url.

checkout_urlstring | null

Link que leva o comprador de volta ao carrinho.

sourcestring

api, ou js para os carrinhos do script de rastreamento.

abandoned_atnull

Sempre null: atualizar um carrinho abandonado o torna ativo de novo.

converted_at, converted_order_idstring | null

Quando um pedido converteu o carrinho, e o ID desse pedido (ord_…). null enquanto o carrinho estiver ativo.

created_at, updated_atstring

Quando o carrinho foi armazenado pela primeira vez e quando mudou pela última vez, em 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

Enviado quando um carrinho passa a ser abandonado: ele pertence a um contato, tem pelo menos um item e não foi atualizado durante os cart_abandon_minutes das configurações de e-commerce (60 por padrão). O Emailit verifica a cada minuto. Os carrinhos sem contato nunca passam a ser abandonados. Use o evento para iniciar uma automação de carrinho abandonado ou para notificar os seus próprios sistemas. Consulte E-commerce.

O evento é enviado uma vez cada vez que o carrinho é abandonado. Se o carrinho for atualizado depois, ele volta a ficar ativo e pode ser abandonado de novo, e o evento, enviado de novo. Um carrinho que foi convertido por um pedido nunca é abandonado.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre cart.abandoned.

objectobject

O carrinho que o evento descreve. Os campos dele estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de carrinho

O mesmo objeto que Obter um carrinho retorna.

idstring

ID do carrinho (crt_…).

objectstring

Sempre cart.

external_idstring

O ID do carrinho ou do checkout na sua loja. Os carrinhos do script de rastreamento sem um ID próprio usam web: seguido do ID anônimo do visitante.

contact_idstring

O contato a quem o carrinho pertence (con_…).

emailstring | null

O endereço de e-mail do comprador.

statusstring

Sempre abandoned.

currencystring | null

Código ISO 4217 de três letras dos valores.

totalnumber

Valor do carrinho.

itemsobject[]

Itens, cada um com product_id, variant_id, sku, title, quantity, unit_price, total, url e image_url.

checkout_urlstring | null

Link que leva o comprador de volta ao carrinho.

sourcestring

api, ou js para os carrinhos do script de rastreamento.

abandoned_atstring

Quando o Emailit marcou o carrinho como abandonado, em ISO 8601 UTC.

converted_at, converted_order_idnull

Sempre null neste evento.

created_at, updated_atstring

Quando o carrinho foi armazenado pela primeira vez e quando mudou pela última vez, em 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"
    }
  }
}

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.

Esc

Populares

↑↓para navegar↵para abrirEscpara fechar