Este manual detalha o processo completo de configuração da integração com a VitalSource Bookshelf na plataforma ecommerce Moovin. A integração permite que, ao realizar uma compra, o cliente receba acesso automático ao eBook correspondente diretamente no leitor VitalSource — sem intervenção manual.
Você aprenderá como inserir sua chave de API, configurar o redirecionamento SSO, definir os gatilhos de pedido e mapear os produtos da sua plataforma com os títulos do catálogo VitalSource. Siga este guia para aproveitar ao máximo os recursos da integração.
ℹ️Para utilizar esta integração, é necessário ter uma conta ativa na VitalSource com acesso à API. Entre em contato com o suporte VitalSource para obter sua chave de API antes de iniciar.
Passo 1 - Acesse o módulo VitalSource no painel Moovin
No painel administrativo da Moovin, acesse o menu PlaceMarket e localize o módulo VitalSource. Caso o módulo ainda não esteja instalado, clique em Instalar.
Clique na Imagem para Ampliar.
Após a instalação, clique em Configurar para acessar as configurações do módulo. O status Módulo Ativo será exibido no topo da tela assim que o módulo estiver habilitado.
Clique na Imagem para Ampliar.
Passo 2 - Configure a Autenticação da API
Na seção Autenticação API, insira sua chave de acesso fornecida pela VitalSource no campo API Key. Este campo é obrigatório — sem ele, nenhuma comunicação com a API VitalSource será possível.
Clique na Imagem para Ampliar.
⚠️Nunca compartilhe sua API Key publicamente. Ela autentica todas as operações de acesso a eBooks em nome da sua conta VitalSource.
A chave é enviada automaticamente em cada requisição pelo cabeçalho X-VitalSource-API-Key. Não é necessário nenhuma configuração adicional após salvar.
Passo 3 - Configure o SSO / Bookshelf
Na seção SSO / Bookshelf, defina o tipo de redirecionamento que o cliente receberá após a compra. O SSO (Single Sign-On) autentica o usuário automaticamente no leitor VitalSource, sem necessidade de login separado.
Clique na Imagem para Ampliar.
Ou pode ser cadastrado uma brand diferente, basta selecionar a outra opção na imagem acima.
Clique na Imagem para Ampliar.
Passo 4 - Configure os Gatilhos de Pedido
Na seção Gatilhos de Pedido, defina as regras globais de acesso ao eBook: por quanto tempo o cliente terá acesso e em quais situações esse acesso é concedido ou revogado.
Clique na Imagem para Ampliar.
Campos disponíveis
Tempo de Validade geral dos produtos — define em anos por quanto tempo o cliente terá acesso ao eBook após a ativação. Este valor é usado como padrão para todos os produtos, mas pode ser sobrescrito individualmente no mapeamento.
Dias de Download geral dos produtos — quantidade de dias disponíveis para leitura offline no aplicativo Bookshelf. Também pode ser sobrescrito por produto.
Status que criam acesso ao Ebook — status do pedido na plataforma que dispara a concessão de acesso. Por padrão, configurado como Todos.
Status que estornam acesso ao Ebook — status do pedido que revoga o acesso (ex: cancelamentos e reembolsos). Por padrão, configurado como Todos.
ℹ️Os valores globais definidos aqui são aplicados a todos os produtos que não possuam configuração individual no mapeamento De/Para.
Após preencher os campos, clique em Salvar para aplicar as configurações.
Passo 5 - Mapeie os produtos (De/Para de Produtos)
Acesse o menu De/Para de Produtos — VitalSource. Nesta tela você associa cada produto da sua plataforma ao título correspondente no catálogo VitalSource, identificado pelo ISBN ou VBID.
Clique na Imagem para Ampliar.
Como adicionar um novo mapeamento
No campo Produto Plataforma, busque o produto pelo nome ou SKU.
No campo Produto VitalSource, busque o título pelo nome ou ISBN.
Clique em + Adicionar para criar a associação.
Na linha criada, informe o Tempo de validade (em anos) e os Dias para download específicos para este produto — se desejar valores diferentes do padrão global definido no Passo 4.
Clique em Salvar para confirmar.
Clique na Imagem para Ampliar.
🗑️O botão vermelho de exclusão em cada linha remove o mapeamento permanentemente. Pedidos futuros desse produto não gerarão acesso ao eBook até que um novo mapeamento seja criado.
Fluxo de acesso ao eBook
Abaixo, veja o fluxo completo desde a realização do pedido até o acesso do cliente ao eBook na plataforma VitalSource Bookshelf.
Moovin → VitalSource
Status na Moovin | Ação na VitalSource |
Pedido aprovado (ou status configurado) | ✅ Acesso ao eBook concedido automaticamente |
Pedido cancelado / reembolsado (ou status configurado) | ❌ Acesso ao eBook revogado automaticamente |
ℹ️ A concessão e revogação de acesso são disparadas automaticamente com base nos status configurados nos Gatilhos de Pedido (Passo 4). Não é necessária nenhuma ação manual após a configuração.
Se encontrar qualquer dificuldade ou tiver perguntas, estamos aqui para ajudar! Clique aqui para acessar nosso canal de suporte.
Nossas equipes estão prontas para atendê-lo através dos diversos canais de atendimento disponíveis.
Seu feedback é extremamente importante para nós!
Por gentileza, tire um momento para avaliar a documentação que acabou de ler. Suas opiniões são cruciais para aprimorarmos nossa plataforma e proporcionar a melhor experiência possível.
Clique no quadro abaixo para deixar sua avaliação.