Cadastra (ou atualiza) cupons no bot. Para UM cupom, informe "code" (o código) OU "url" (cupom resgatável no link, sem código); para VÁRIOS, mande a lista em "coupons" (até 50 por chamada, cada item com os mesmos campos) numa chamada só, em vez de uma chamada por cupom. Opcionalmente loja (site/site_id), descrição, validade, início de vigência e os campos DETALHADOS do desconto (discount_type/discount_value/min_purchase/max_discount/is_cashback). O upsert deduplica por loja+code (ou loja+url quando sem código): não precisa de list_coupons antes para evitar duplicata na mesma loja. Com convert_url:true, a "url" vira link de afiliado antes de salvar (no lote, cada link distinto é convertido uma vez); se a conversão falhar, o cupom não é salvo. No lote, a resposta traz "results" com o que entrou e o que falhou por item (index, code, ok, error). Requer o módulo de Cupons ativo no bot.
View input schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Código do cupom (ex.: BLACK10). Opcional se informar \"url\"."
},
"site": {
"type": "string",
"description": "Loja ou marketplace do cupom (ex.: Shopee). Sem nome/ID, identifica pelo domínio mapeado do link."
},
"site_id": {
"type": "integer",
"description": "ID do site obtido em list_coupon_categories. Tem prioridade sobre o nome e a identificação automática."
},
"description": {
"type": "string",
"description": "Descrição/condições do cupom."
},
"url": {
"type": "string",
"format": "uri",
"description": "Link do cupom. Use sem \"code\" para um cupom resgatável direto no link."
},
"discount_type": {
"type": "string",
"enum": [
"percent",
"amount"
],
"description": "Opcional. Tipo de desconto: \"percent\" (em %) ou \"amount\" (em reais). Combine com discount_value."
},
"discount_value": {
"type": "number",
"description": "Opcional. Valor do desconto — em % quando discount_type=\"percent\", em reais quando \"amount\" (ex.: 15 = 15% ou R$15)."
},
"min_purchase": {
"type": "number",
"description": "Opcional. Valor mínimo da compra (em reais) para o cupom valer."
},
"max_discount": {
"type": "number",
"description": "Opcional. Teto do desconto (em reais). SÓ se aplica a discount_type=\"percent\" — em \"amount\" (ou sem tipo) é ignorado/limpo automaticamente."
},
"is_cashback": {
"type": "boolean",
"description": "Opcional. true = o cupom é cashback (não desconto direto no carrinho)."
},
"is_sold_out": {
"type": "boolean",
"description": "Opcional. true = marca o cupom como ESGOTADO (o bot exibe o selo \"Esgotado\" em vez do botão de resgate); false = volta a disponível. Como o cadastro é upsert (dedup por loja+code ou loja+url), repita o mesmo code/url do cupom já cadastrado para atualizar só esse estado."
},
"convert_url": {
"type": "boolean",
"description": "Se true, converte a \"url\" em link de afiliado antes de cadastrar. Se a conversão falhar, o cupom NÃO é salvo (nunca se publica a URL crua). Padrão: false."
},
"expires_at": {
"type": "string",
"description": "Validade. Prefira data ISO com hora e fuso, ex.: \"2026-12-31T23:59:59-03:00\" (fim do dia no horário de Brasília). Data solta (\"2026-12-31\") é interpretada como meia-noite UTC — o cupom expira às 21h do dia ANTERIOR no Brasil. Também aceita epoch Unix em segundos ou milissegundos. NUNCA use DD/MM/AAAA. Opcional."
},
"starts_at": {
"type": "string",
"description": "Início de vigência — data ISO ou epoch. Antes dessa data o cupom não aparece como ativo. NUNCA use DD/MM/AAAA. Opcional."
},
"raw_text": {
"type": "string",
"description": "Opcional. Texto original do cupom (trilha de auditoria da ingestão)."
},
"coupons": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Código do cupom (ex.: BLACK10). Opcional se informar \"url\"."
},
"site": {
"type": "string",
"description": "Loja ou marketplace do cupom (ex.: Shopee). Sem nome/ID, identifica pelo domínio mapeado do link."
},
"site_id": {
"type": "integer",
"description": "ID do site obtido em list_coupon_categories. Tem prioridade sobre o nome e a identificação automática."
},
"description": {
"type": "string",
"description": "Descrição/condições do cupom."
},
"url": {
"type": "string",
"format": "uri",
"description": "Link do cupom. Use sem \"code\" para um cupom resgatável direto no link."
},
"discount_type": {
"type": "string",
"enum": [
"percent",
"amount"
],
"description": "Opcional. Tipo de desconto: \"percent\" (em %) ou \"amount\" (em reais). Combine com discount_value."
},
"discount_value": {
"type": "number",
"description": "Opcional. Valor do desconto — em % quando discount_type=\"percent\", em reais quando \"amount\" (ex.: 15 = 15% ou R$15)."
},
"min_purchase": {
"type": "number",
"description": "Opcional. Valor mínimo da compra (em reais) para o cupom valer."
},
"max_discount": {
"type": "number",
"description": "Opcional. Teto do desconto (em reais). SÓ se aplica a discount_type=\"percent\" — em \"amount\" (ou sem tipo) é ignorado/limpo automaticamente."
},
"is_cashback": {
"type": "boolean",
"description": "Opcional. true = o cupom é cashback (não desconto direto no carrinho)."
},
"is_sold_out": {
"type": "boolean",
"description": "Opcional. true = marca o cupom como ESGOTADO (o bot exibe o selo \"Esgotado\" em vez do botão de resgate); false = volta a disponível. Como o cadastro é upsert (dedup por loja+code ou loja+url), repita o mesmo code/url do cupom já cadastrado para atualizar só esse estado."
},
"convert_url": {
"type": "boolean",
"description": "Se true, converte a \"url\" em link de afiliado antes de cadastrar. Se a conversão falhar, o cupom NÃO é salvo (nunca se publica a URL crua). Padrão: false."
},
"expires_at": {
"type": "string",
"description": "Validade. Prefira data ISO com hora e fuso, ex.: \"2026-12-31T23:59:59-03:00\" (fim do dia no horário de Brasília). Data solta (\"2026-12-31\") é interpretada como meia-noite UTC — o cupom expira às 21h do dia ANTERIOR no Brasil. Também aceita epoch Unix em segundos ou milissegundos. NUNCA use DD/MM/AAAA. Opcional."
},
"starts_at": {
"type": "string",
"description": "Início de vigência — data ISO ou epoch. Antes dessa data o cupom não aparece como ativo. NUNCA use DD/MM/AAAA. Opcional."
},
"raw_text": {
"type": "string",
"description": "Opcional. Texto original do cupom (trilha de auditoria da ingestão)."
}
},
"additionalProperties": false
},
"description": "Lote de cupons (até 50), cada um com code OU url e os demais campos. convert_url no topo vale para todos os itens que não disserem o contrário."
}
},
"additionalProperties": false
}