Ofertas: order bump, upsell e downsell

Abrir em

Conversa Labs

Última atualização em Aug 12, 2026

Visão geral

Uma oferta é um preço reutilizável que você cadastra uma vez e reaproveita em várias vendas. Existem três tipos:

Order bump: aparece no checkout como uma oferta-relâmpago e, quando aceita, entra como uma linha extra na cobrança que está sendo criada.
Upsell: oferta pós-compra de um clique, normalmente um item de maior valor, que gera uma nova cobrança para o contato.
Downsell: também pós-compra de um clique, usada como alternativa mais barata quando o cliente recusa o upsell — igualmente gera uma nova cobrança.

Em todos os casos a oferta guarda nome, valor, moeda e método; você só a vincula a uma venda ou contato no momento certo.

Um gateway conectado e válido (veja Conectar gateway).
Opcional: um produto do Catálogo vinculado à oferta (catalog_product_id), para reaproveitar o cadastro do produto.
Defina na oferta a conexão (gateway) e o método (billing_type) que serão usados quando ela virar cobrança — especialmente para upsell e downsell.
Para aceitar uma oferta (upsell/downsell), o contato precisa de dados mínimos (nome e, idealmente, e-mail/telefone) para o pagador no gateway.

Order bump no checkout: a oferta é convertida em uma linha de cobrança (nome, valor e moeda são "fotografados" no momento). Ela soma ao total somando uma nova linha — nunca altera o valor de uma cobrança já existente. A linha guarda apenas a referência da oferta nos metadados.
Upsell / downsell pós-compra: ao aceitar a oferta para um contato, a plataforma cria uma nova cobrança reaproveitando a conexão, o valor e os dados do pagador já conhecidos — sem redigitar nada. Essa cobrança segue o fluxo normal (gateway → webhook → cartão de pagamento na conversa), exatamente como qualquer outra cobrança.
A oferta nunca é alterada quando é aceita: ela é um modelo; cada aceite gera uma cobrança nova e independente.
O aceite pós-compra só funciona para uma oferta ativa e não arquivada. Um order bump pertence ao checkout e é recusado nessa ação. Repetir a mesma tentativa de rede recupera a mesma cobrança.

Campos de uma oferta:

Campo	Para que serve
Nome	Identifica a oferta e vira a descrição da cobrança/linha. Obrigatório.
Tipo (`kind`)	`order_bump`, `upsell` ou `downsell`.
Valor	Preço da oferta (unidades maiores, ex.: `49.90`). Precisa ser maior que zero.
Moeda	Código de 3 letras (ex.: `BRL`).
Método (`billing_type`)	PIX, boleto ou cartão usado quando a oferta virar cobrança.
Conexão	O gateway (conexão de pagamento) usado para cobrar.
Produto do catálogo	Vínculo opcional a um produto do Catálogo.
Descrição	Texto auxiliar da oferta.
Ativa / inativa	Ofertas inativas não são oferecidas.

Na área de Pagamentos, abra Ofertas e crie uma nova oferta.
Informe nome, escolha o tipo (order bump, upsell ou downsell), o valor e a moeda.
Defina o método e a conexão (gateway) que serão usados ao gerar a cobrança.
(Opcional) Vincule um produto do catálogo e escreva uma descrição.
Salve. A oferta fica disponível enquanto estiver ativa.
Para aplicar um order bump, use a oferta no checkout: aceita pelo cliente, ela vira uma linha extra na cobrança.
Para aceitar um upsell/downsell, dispare o aceite da oferta para o contato (opcionalmente ligado a uma conversa): a plataforma gera uma nova cobrança e a envia na conversa.
Para desativar uma oferta, arquive-a — ela some das ofertas disponíveis, mas o preço é preservado (nunca apagamos um preço que um funil ativo possa referenciar).

Aumentar o ticket com um order bump no checkout ("adicione a garantia estendida por R$ 19,90").
Oferecer um upsell logo após a compra ("leve a versão Pro com 1 clique").
Recuperar a venda com um downsell quando o cliente recusa o upsell mais caro.
Reutilizar a mesma oferta em várias conversas e checkouts, sem recadastrar o preço.

O order bump não altera uma cobrança já criada — ele apenas adiciona uma linha ao total no momento do checkout.
Aceitar upsell/downsell sempre cria uma cobrança nova e independente; a oferta original permanece intacta.
Ofertas são arquivadas, não apagadas — assim nenhum funil ou histórico que dependa daquele preço quebra.
Defina conexão e método na oferta de upsell/downsell: sem eles, o aceite não consegue gerar a cobrança corretamente.
Valores são em unidades maiores (R$ 49,90 = 49.90); o total do checkout é a soma das linhas — nunca divida por 100.

A oferta não aparece: confira se ela está ativa e não arquivada (ofertas inativas ou arquivadas não são oferecidas).
O aceite falhou: verifique se o contato tem os dados mínimos e se a conexão (gateway) da oferta é válida — o aceite cria uma cobrança real e precisa desses dados.
O valor saiu errado no order bump: lembre que ele soma uma linha ao total; ele não substitui nem reduz o valor das demais linhas.
Não consigo excluir uma oferta: ofertas são arquivadas (reversível) e não removidas — use o arquivar.