Pular para o conteúdo
Acessar conta

Consultar carrinho

GET/contacts/{contact_id}/cart
Gerada do contrato OpenAPI

Devolve o carrinho do contato: os itens, a quantidade de cada um, o cupom e os totais. Os totais vêm em centavos; o price de cada item, não.

Requisição
curl "https://app.nextagsai.com.br/api/contacts/123456789/cart" \
  -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY"

Autenticação

Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.

Parâmetros de caminho

contact_idintegerobrigatório

O ID do contato.

Respostas

200Sucesso

O carrinho.

Ver os 43 campos
order_idstring

O ID do pedido (texto).

page_idinteger

O ID da conta.

user_idinteger

O ID do contato.

currencystring

A moeda da loja, como BRL.

totalinteger

O total, em centavos.

subtotalinteger

A soma dos itens, em centavos.

total_itemsinteger

Quantos itens o carrinho tem.

coupon_discountinteger

O desconto do cupom, em centavos.

couponstring

O código do cupom aplicado (o Código de desconto da aba Cupons).

line_itemsarray de objeto Item do carrinho

Os itens do carrinho.

line_items[].idinteger

O ID do produto.

line_items[].namestring

O nome do produto.

line_items[].imgstring

O endereço da imagem do produto.

line_items[].pricenumber

O preço de uma unidade, na moeda da loja. Não é em centavos: 49.9 = R$ 49,90.

line_items[].amountinteger

A quantidade.

line_items[].descr_minstring

A descrição curta do produto.

line_items[].manufacturerinteger

O ID do vendedor do produto (aba Vendedores).

line_items[].variantstring

A variante escolhida, como o tamanho ou a cor.

line_items[].user_msgstring

O pedido especial que o contato anotou no item, quando o produto permite anexar notas.

contactobjeto Contato

O contato dono do carrinho.

contact.idinteger

O ID do contato: o contact_id das outras chamadas.

contact.page_idinteger

O ID da conta.

contact.first_namestring

O nome.

contact.last_namestring

O sobrenome.

contact.channelinteger

O canal atual do contato: 0 Messenger, 5 WhatsApp, 8 Telegram, 9 Webchat, 10 Instagram, 17 TikTok.

contact.profile_picstring

O endereço da foto de perfil.

contact.localestring

O idioma do contato, como pt_BR.

contact.genderinteger

O gênero: 0 feminino, 1 masculino, 2 desconhecido.

contact.timezoneinteger

O fuso horário do contato, em horas em relação ao UTC (-3 em Brasília).

contact.last_sentinteger

Quando a última mensagem foi enviada ao contato, em Unix timestamp em milissegundos.

contact.last_deliveredinteger

Quando a última mensagem foi entregue ao contato, em Unix timestamp em milissegundos.

contact.last_seeninteger

Quando o contato foi visto pela última vez (Visto pela última vez, no app), em Unix timestamp em milissegundos.

contact.last_interactioninteger

Quando o contato interagiu com a conta pela última vez, em Unix timestamp em milissegundos.

contact.subscribed_datestring

Quando o contato entrou na conta, em UTC, no formato 2026-10-12 14:40:00.

contact.subscribedinteger

1 inscrito; 2 inscrição cancelada (o contato saiu das transmissões e não recebe Broadcasts). Veja Contatos que pediram para sair das transmissões.

contact.tagsarray de objeto Etiqueta

As etiquetas do contato.

contact.tags[].idinteger

O ID da etiqueta.

contact.tags[].namestring

O nome da etiqueta.

contact.custom_fieldsarray de objeto Campo personalizado

Os campos personalizados do contato, com o valor de cada um.

contact.custom_fields[].idinteger

O ID do campo.

contact.custom_fields[].namestring

O nome do campo.

contact.custom_fields[].typeinteger

O tipo: 0 texto, 1 número, 2 data, 3 data e hora, 4 sim/não, 5 texto longo, 6 seleção única, 7 seleção múltipla.

Valores: 0 1 2 3 4 5 6 7

contact.custom_fields[].valuestring ou number

O valor do contato, no formato do tipo: texto nos campos de texto e de texto longo; número nos de número, de data e de data e hora (Unix timestamp, em segundos) e de sim/não (1 ou 0).

401Chave inválida

A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.

Relacionados

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.