Adicionar item na Vitrine
add_showcase_itemPublica uma oferta na Vitrine do bot (página pública, visível para qualquer visitante). O "link_url" é convertido no link de afiliado do bot antes de salvar; se a conversão falhar, nada é salvo. A mesma oferta postada há pouco (mesmo link) é mesclada no item existente em vez de duplicar. Exige permissão de escrita (bot:write).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hook | No | Opcional. Chamada curta, ex.: "SÓ HOJE COM FRETE GRÁTIS". | |
| price | No | Opcional. Preço, ex.: "R$ 99,90". | |
| title | Yes | Título do produto. | |
| coupon | No | Opcional. Código do cupom. | |
| destaque | No | Opcional. Destacar no início da Vitrine. | |
| link_url | Yes | Link do produto ou o affiliate_url de search_products (https://...). | |
| image_url | No | Opcional. Foto do produto (https://...). | |
| old_price | No | Opcional. Preço de antes. | |
| expires_at | No | Opcional. Quando o item sai da página (data ISO ou epoch). Ausente = prazo padrão da Vitrine. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | O item salvo, com o link de afiliado mintado em link_url. | |
| aviso | No | ||
| success | No | ||
| public_url | No | Página pública da Vitrine; null se não está publicada. |