API atual/Referência completa/Carrinhos abandonados

POSTEnviar e-mail de recuperação

Envia agora o e-mail que convida o cliente a retomar o carrinho.

Use quando quer dar um empurrão manual a um carrinho específico, por exemplo depois de um contato do atendimento. A plataforma usa o e-mail do cliente (ou o do visitante), renova a validade do link por mais 72 horas, gera um token novo se o registro não tinha e envia o modelo de e-mail abandoned_cart com os itens, o total e o botão para /recover?token=.... Cada envio soma 1 em recovery_emails_sent.

Enviar o e-mail

POST/api/v1/admin/abandoned-carts/{id}/send-emailAdmin

Envia o e-mail de recuperação de um carrinho abandonado

Parâmetros de caminho

iduuidobrigatório

Id do registro de carrinho abandonado.

Parâmetros de consulta

store_urlstring

Endereço da loja (http ou https, sem parâmetros) usado no link só quando a loja não tem endereço público configurado. Padrão: o host da própria requisição.

Exemplo de requisição: enviar

bash

curl -X POST "$BASE_URL/api/v1/admin/abandoned-carts/02981785-4f6f-43d4-adbf-4177a7490550/send-email" \
  -H "Authorization: Bearer $TOKEN"

Resposta: enviar

200E-mail enviado

json

{
  "message": "recovery email sent"
}

Erros: enviar

Status	Quando	Corpo de exemplo
401	Token ausente ou inválido.	`{"error":"authentication required"}`
403	O módulo `abandoned-cart` está desligado na loja.	`{"error":"module_disabled","module":"abandoned-cart"}`
403	Falta o privilégio `manage_abandoned_carts` (ou `manage_orders`). Vale também para leitura.	`{"error":"insufficient privileges","required":"manage_abandoned_carts"}`
400	`store_url` inválido (não é `http`/`https`, ou sem host).	`{"error":"invalid store_url","detail":"store URL must use http or https scheme, got \"ftp\""}`
500	O registro não existe, já foi recuperado, não tem e-mail, ou o envio falhou. O motivo vem em `detail`.	`{"error":"failed to send recovery email","detail":"cart already recovered"}`

Veja também