Adicionar cupom
add_couponCadastra (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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "add_coupon"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Link do cupom. Use sem "code" para um cupom resgatável direto no link. | |
| code | No | Código do cupom (ex.: BLACK10). Opcional se informar "url". | |
| site | No | Loja ou marketplace do cupom (ex.: Shopee). Sem nome/ID, identifica pelo domínio mapeado do link. | |
| coupons | No | 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. | |
| site_id | No | ID do site obtido em list_coupon_categories. Tem prioridade sobre o nome e a identificação automática. | |
| raw_text | No | Opcional. Texto original do cupom (trilha de auditoria da ingestão). | |
| starts_at | No | 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. | |
| expires_at | No | 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. | |
| convert_url | No | 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. | |
| description | No | Descrição/condições do cupom. | |
| is_cashback | No | Opcional. true = o cupom é cashback (não desconto direto no carrinho). | |
| is_sold_out | No | 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. | |
| max_discount | No | Opcional. Teto do desconto (em reais). SÓ se aplica a discount_type="percent" — em "amount" (ou sem tipo) é ignorado/limpo automaticamente. | |
| min_purchase | No | Opcional. Valor mínimo da compra (em reais) para o cupom valer. | |
| discount_type | No | Opcional. Tipo de desconto: "percent" (em %) ou "amount" (em reais). Combine com discount_value. | |
| discount_value | No | Opcional. Valor do desconto — em % quando discount_type="percent", em reais quando "amount" (ex.: 15 = 15% ou R$15). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| added | No | Lote: quantos entraram. | |
| coupon | No | O cupom salvo (um cupom). | |
| failed | No | Lote: quantos falharam. | |
| results | No | Lote: um por item, com index, code, ok, coupon ou error e hint. | |
| success | No |