Claro, aqui está a documentação técnica transformada em um artigo para a Central de Ajuda, seguindo rigorosamente todas as suas diretrizes.---

Esta funcionalidade permite criar uma campanha de incentivo para novos usuários, exibindo um banner com um cupom de desconto exclusivo para a primeira compra realizada através do aplicativo. O objetivo é aumentar a taxa de conversão de novos clientes e estimular a adoção do app como canal de vendas principal. Uma vez que o cliente realiza a sua primeira compra, o banner deixa de ser exibido para ele automaticamente.

Sistemas envolvidos: A configuração desta funcionalidade depende da capacidade da sua plataforma de Cloud Commerce (como VTEX, Shopify, entre outras) de notificar sistemas externos sobre a criação de novos pedidos através de webhooks. O cupom de desconto em si é criado e gerenciado integralmente no painel administrativo do seu e-commerce, devendo ser configurado para ser válido no canal de vendas do aplicativo.

Onde eu crio o cupom de desconto de primeira compra?

O cupom deve ser criado e configurado diretamente no painel administrativo da sua plataforma de e-commerce (ex: VTEX). A responsabilidade do aplicativo é apenas exibir o banner e o código do cupom para os usuários elegíveis.

Como o aplicativo sabe que o cliente já fez a primeira compra para parar de mostrar o banner?

O sistema funciona de forma integrada. Quando um pedido é criado na sua plataforma de e-commerce, ela envia uma notificação automática (via webhook) para os sistemas da Kobe Apps. Nosso sistema então atualiza o perfil daquele usuário, e o banner de primeira compra deixa de ser exibido para ele nas próximas visitas.

Se um cliente já comprou no site, mas nunca no aplicativo, ele verá o cupom?

Não. A validação é baseada no histórico de compras geral do cliente na sua loja. Se o cliente já possui um pedido registrado em seu e-commerce, independentemente do canal (site ou app), ele não será mais considerado um cliente de "primeira compra" e, portanto, não visualizará o banner no aplicativo.

O que eu preciso fornecer para a equipe da Kobe Apps para ativar essa funcionalidade?

Você precisa primeiro criar o cupom de desconto em sua plataforma e preparar a arte do banner promocional. Com isso em mãos, basta abrir um chamado com nossa equipe de suporte informando o código do cupom e enviando o arquivo da arte para que possamos realizar a ativação técnica interna.

A ativação desta funcionalidade é um processo colaborativo. Primeiro, o lojista deve realizar as seguintes ações em seu ambiente de Cloud Commerce: 1. Criar o cupom de desconto que será oferecido. 2. Produzir a arte do banner que será exibido no aplicativo. Após concluir esses dois passos, o lojista deve abrir um chamado para a equipe de suporte da Kobe Apps, fornecendo o código do cupom e o arquivo de imagem do banner. Nossa equipe técnica realizará a ativação interna necessária para configurar a comunicação entre as plataformas e a exibição do banner no aplicativo.