API atual/Referência completa/Página do produto: conversão

Recursos de conversão

Lê e liga os recursos da página do produto que ajudam a vender mais: prova social, histórico de preço, compre junto, perguntas e respostas, mídia e pontos por avaliação.

Estes são os recursos de conversão da página do produto. Todos são opcionais e começam desligados: a loja liga um por vez.

Seção	O que faz na página do produto
`social_proof`	Selos como "vendidos nos últimos 30 dias", "vendidos hoje", "últimas unidades" e contagem regressiva de promoção.
`price_transparency`	Selo de histórico de preço e gráfico público da variação do preço.
`fbt`	"Compre junto": sugere produtos comprados em conjunto, com desconto na dupla.
`product_qa`	Perguntas e respostas públicas, com resposta provisória gerada automaticamente.
`pdp_media`	Reprises de transmissões ao vivo na página do produto.
`review_rewards`	Pontos de recompensa para quem escreve uma avaliação (com bônus por foto e vídeo).

Exigem o privilégio manage_settings.

Ler os recursos

GET/api/v1/admin/pdp-conversao/settingsAdmin

Ler as seis seções de conversão

Devolve as seis seções juntas, já com os padrões aplicados.

bash

curl "$BASE_URL/api/v1/admin/pdp-conversao/settings" \
  -H "Authorization: Bearer $TOKEN"

200Recursos de conversão

json

{
  "social_proof": {
    "sold_30d_enabled": true,
    "sold_today_enabled": true,
    "low_stock_enabled": false,
    "promo_countdown_enabled": true,
    "min_sales_to_show": 1,
    "low_stock_threshold": 10
  },
  "price_transparency": { "badge_enabled": true, "public_chart_enabled": true },
  "fbt": { "enabled": true, "discount_percent": 5 },
  "product_qa": { "provisional_answer_enabled": true, "max_per_day": 10 },
  "pdp_media": { "live_replays_enabled": true },
  "review_rewards": { "enabled": false, "base_points": 10, "photo_bonus": 5, "video_bonus": 5 }
}

Campos da resposta

social_proof.sold_30d_enabledboolean

Selo "vendidos nos últimos 30 dias".

social_proof.sold_today_enabledboolean

Selo "vendidos hoje".

social_proof.low_stock_enabledboolean

Selo de estoque baixo.

social_proof.promo_countdown_enabledboolean

Contagem regressiva do fim da promoção.

social_proof.min_sales_to_showinteger

Vendas mínimas para exibir os selos de venda. Padrão 5; zero ou menos volta a 5.

social_proof.low_stock_thresholdinteger

Quantidade de estoque que define "estoque baixo" para o selo. Padrão 5; zero ou menos volta a 5.

price_transparency.badge_enabledboolean

Selo de histórico de preço.

price_transparency.public_chart_enabledboolean

Gráfico público do histórico de preço.

fbt.enabledboolean

Liga o "compre junto".

fbt.discount_percentinteger

Desconto na compra conjunta, em porcentagem de 0 a 30. Padrão 5; fora da faixa volta a 5.

product_qa.provisional_answer_enabledboolean

Mostra ao público a resposta provisória (rascunho automático) marcada como "aguardando confirmação" até a equipe responder.

product_qa.max_per_dayinteger

Máximo de perguntas por pessoa, por produto, por dia. Padrão 5.

pdp_media.live_replays_enabledboolean

Mostra reprises de transmissões ao vivo.

review_rewards.enabledboolean

Liga os pontos por avaliação.

review_rewards.base_pointsinteger

Pontos por avaliação. Padrão 50.

review_rewards.photo_bonusinteger

Pontos extras se a avaliação tem foto. Padrão 25.

review_rewards.video_bonusinteger

Pontos extras se a avaliação tem vídeo. Padrão 75.

Gravar uma seção

PUT/api/v1/admin/pdp-conversao/settingsAdmin

Gravar os campos de uma das seis seções

Grava uma seção por vez, com os mesmos campos da leitura. A gravação mescla: só as chaves enviadas mudam.

Corpo da requisição

sectionstringobrigatório

social_proofprice_transparencyfbtproduct_qapdp_mediareview_rewards

Seção a gravar.

dataobjectobrigatório

Campos da seção a atualizar (os da tabela acima, sem o prefixo da seção).

bash

curl -X PUT "$BASE_URL/api/v1/admin/pdp-conversao/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"section":"fbt","data":{"enabled":true,"discount_percent":8}}'

200Seção gravada

json

{ "saved": true }

Erros

Status	Quando	Corpo de exemplo
400	Corpo que não é JSON.	`{"error":"invalid request body","detail":"..."}`
400	`section` fora das seis.	`{"error":"invalid section"}`
401	Sem token ou token expirado.	`{"error":"invalid or expired token"}`
403	Sem `manage_settings`.	`{"error":"insufficient privileges","required":"manage_settings"}`
500	Falha ao gravar ou ao ler.	`{"error":"failed to save settings","detail":"..."}`

Veja também

Recursos de conversão

Lê e liga os recursos da página do produto que ajudam a vender mais: prova social, histórico de preço, compre junto, perguntas e respostas, mídia e pontos por avaliação.

Estes são os recursos de conversão da página do produto. Todos são opcionais e começam desligados: a loja liga um por vez.

Seção	O que faz na página do produto
`social_proof`	Selos como "vendidos nos últimos 30 dias", "vendidos hoje", "últimas unidades" e contagem regressiva de promoção.
`price_transparency`	Selo de histórico de preço e gráfico público da variação do preço.
`fbt`	"Compre junto": sugere produtos comprados em conjunto, com desconto na dupla.
`product_qa`	Perguntas e respostas públicas, com resposta provisória gerada automaticamente.
`pdp_media`	Reprises de transmissões ao vivo na página do produto.
`review_rewards`	Pontos de recompensa para quem escreve uma avaliação (com bônus por foto e vídeo).

Exigem o privilégio manage_settings.

Ler os recursos

GET/api/v1/admin/pdp-conversao/settingsAdmin

Ler as seis seções de conversão

Devolve as seis seções juntas, já com os padrões aplicados.

bash

curl "$BASE_URL/api/v1/admin/pdp-conversao/settings" \
  -H "Authorization: Bearer $TOKEN"

200Recursos de conversão

json

{
  "social_proof": {
    "sold_30d_enabled": true,
    "sold_today_enabled": true,
    "low_stock_enabled": false,
    "promo_countdown_enabled": true,
    "min_sales_to_show": 1,
    "low_stock_threshold": 10
  },
  "price_transparency": { "badge_enabled": true, "public_chart_enabled": true },
  "fbt": { "enabled": true, "discount_percent": 5 },
  "product_qa": { "provisional_answer_enabled": true, "max_per_day": 10 },
  "pdp_media": { "live_replays_enabled": true },
  "review_rewards": { "enabled": false, "base_points": 10, "photo_bonus": 5, "video_bonus": 5 }
}

Campos da resposta

social_proof.sold_30d_enabledboolean

Selo "vendidos nos últimos 30 dias".

social_proof.sold_today_enabledboolean

Selo "vendidos hoje".

social_proof.low_stock_enabledboolean

Selo de estoque baixo.

social_proof.promo_countdown_enabledboolean

Contagem regressiva do fim da promoção.

social_proof.min_sales_to_showinteger

Vendas mínimas para exibir os selos de venda. Padrão 5; zero ou menos volta a 5.

social_proof.low_stock_thresholdinteger

Quantidade de estoque que define "estoque baixo" para o selo. Padrão 5; zero ou menos volta a 5.

price_transparency.badge_enabledboolean

Selo de histórico de preço.

price_transparency.public_chart_enabledboolean

Gráfico público do histórico de preço.

fbt.enabledboolean

Liga o "compre junto".

fbt.discount_percentinteger

Desconto na compra conjunta, em porcentagem de 0 a 30. Padrão 5; fora da faixa volta a 5.

product_qa.provisional_answer_enabledboolean

Mostra ao público a resposta provisória (rascunho automático) marcada como "aguardando confirmação" até a equipe responder.

product_qa.max_per_dayinteger

Máximo de perguntas por pessoa, por produto, por dia. Padrão 5.

pdp_media.live_replays_enabledboolean

Mostra reprises de transmissões ao vivo.

review_rewards.enabledboolean

Liga os pontos por avaliação.

review_rewards.base_pointsinteger

Pontos por avaliação. Padrão 50.

review_rewards.photo_bonusinteger

Pontos extras se a avaliação tem foto. Padrão 25.

review_rewards.video_bonusinteger

Pontos extras se a avaliação tem vídeo. Padrão 75.

Gravar uma seção

PUT/api/v1/admin/pdp-conversao/settingsAdmin

Gravar os campos de uma das seis seções

Grava uma seção por vez, com os mesmos campos da leitura. A gravação mescla: só as chaves enviadas mudam.

Corpo da requisição

sectionstringobrigatório

social_proofprice_transparencyfbtproduct_qapdp_mediareview_rewards

Seção a gravar.

dataobjectobrigatório

Campos da seção a atualizar (os da tabela acima, sem o prefixo da seção).

bash

curl -X PUT "$BASE_URL/api/v1/admin/pdp-conversao/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"section":"fbt","data":{"enabled":true,"discount_percent":8}}'

200Seção gravada

json

{ "saved": true }

Erros

Status	Quando	Corpo de exemplo
400	Corpo que não é JSON.	`{"error":"invalid request body","detail":"..."}`
400	`section` fora das seis.	`{"error":"invalid section"}`
401	Sem token ou token expirado.	`{"error":"invalid or expired token"}`
403	Sem `manage_settings`.	`{"error":"insufficient privileges","required":"manage_settings"}`
500	Falha ao gravar ou ao ler.	`{"error":"failed to save settings","detail":"..."}`