Faturamento - Loja de Módulos

O que é

A Loja de Módulos é a página onde você vê, em um único lugar, todos os módulos adicionais (módulos) disponíveis no Viagilize - CRM, Gestão Financeira, Contratos Digitais, WhatsApp, Hospedagem, Ingressos, Fidelidade, Passeios/Experiências, Portal do Guia, entre outros. Para cada módulo, a página mostra o preço mensal (ou anual, se você estiver no ciclo anual), as principais features, e o estado atual: contratado, em teste, expirado ou disponível.

O usuário normalmente chega aqui pelo menu lateral, ao decidir ampliar a operação (oferecer passeios, aceitar pagamentos via WhatsApp, controlar o financeiro). É também o ponto de retorno depois que um teste grátis expira ou que um módulo é cancelado: a página oferece, no mesmo cartão, o botão para contratar de novo ou remover o módulo da lista.

Como usar

1. No menu lateral, expanda Módulos e clique em Loja de Módulos. A URL canônica é /admin/modulos.
2. Na seção Meus Módulos (topo da página), confira os módulos já contratados ou em teste. Se nenhum módulo estiver ativo, aparece o estado vazio "Nenhum módulo ativo".
3. Role até Loja de Módulos > Módulos Disponíveis. Os cartões marcados com selo Destaque aparecem primeiro, em borda roxa.
4. Em cada cartão, leia a descrição, a lista de recursos (até 4 itens visíveis) e o preço - R$ X,XX/mês ou Grátis quando o módulo está incluso no plano.
5. Para experimentar antes de pagar, clique em Testar Grátis por N dias (botão roxo). O período de teste é o configurado no catálogo do módulo (campo trial_days).
6. Para contratar diretamente, clique em Contratar Agora (botão verde). Você será levado para a página de detalhes do módulo, onde o sistema calcula o valor proporcional aos dias restantes do ciclo atual.
7. Para inspecionar features e preço antes de decidir, use Ver Detalhes (botão cinza claro).
8. Se quiser uma solução personalizada, clique em Falar com Consultor na faixa azul/roxa no rodapé - abre um chamado no Suporte já com assunto e mensagem pré-preenchidos.

Casos especiais

empresa no plano gratuito

Quando a sua empresa está no plano free ou sem assinatura ativa, módulos pagos que já foram testados (ou cujo trial expirou) exibem o botão Assine para desbloquear em vez de Contratar Agora. O clique direciona para /admin/billing para escolher um plano pago antes de contratar o módulo.

Módulo com período de teste já consumido

Se você já usou o teste do módulo (trial_used_at preenchido), o cartão troca o botão Testar Grátis por Contratar Agora, e a contratação passa pelo cálculo de proporcional. Trials só podem ser usados uma vez por módulo, por empresa.

Módulo em destaque

Módulos marcados como destaque: true no catálogo aparecem em uma faixa superior com borda roxa e selo Destaque, exatamente com o mesmo conjunto de botões dos demais.

Módulo expirado

Quando um trial ou assinatura termina sem renovação, o cartão mostra o selo cinza Teste encerrado. Daí é possível Contratar Agora (volta a cobrar normalmente) ou, na página de detalhes, remover o módulo da lista - os dados são preservados e o módulo some do menu até nova contratação.

Módulo gratuito

Módulos com preço zero (monthly_price = 0) aparecem com selo verde Incluso e o botão de ação muda para Ativar Grátis. Não há cobrança nem expiração.

WhatsApp com aceite de termos

Os módulos whatsapp-mensagens e chatbot-whatsapp exigem aceite de termos antes da ativação. Ao clicar em Testar Grátis ou Contratar Agora, o sistema redireciona para a tela de termos do WhatsApp; só depois do aceite o trial/assinatura é efetivado.

Valor proporcional na contratação

A contratação de módulo pago é alinhada ao ciclo da assinatura: o sistema calcula o valor proporcional aos dias restantes do período atual. Se o proporcional for menor ou igual a R$ 5,00, o módulo é ativado imediatamente e o valor entra na próxima fatura. Acima desse limiar, é gerado um pagamento (PIX por padrão) que precisa ser quitado antes da ativação.

Erros comuns e como resolver

• "Para contratar módulos, é necessário ter um plano pago ativo. Escolha um plano para começar." - Causa: tentativa de contratar um módulo pago estando no plano free ou sem assinatura ativa. Solução: clique em Assine para desbloquear, escolha um plano pago em /admin/billing e volte para a Loja de Módulos.
• "Este módulo já está ativo em sua assinatura." - Causa: o módulo está com status active e o usuário tentou contratar de novo. Solução: nenhuma ação necessária, o módulo já está em uso.
• "Módulo não encontrado." - Causa: o slug do módulo na URL não existe no catálogo central (foi removido ou está digitado errado). Solução: volte a /admin/modulos e clique no cartão pela interface.
• "É necessário aceitar os termos de uso antes de contratar este módulo." - Causa: tentativa de contratar whatsapp-mensagens ou chatbot-whatsapp sem ter aceito os termos. Solução: complete o aceite na tela de termos do WhatsApp aberta automaticamente.
• "Apenas módulos expirados podem ser removidos." - Causa: clique em remover sobre um módulo ainda ativo. Solução: aguarde o término do período ou cancele a assinatura antes de remover.

Onde encontrar

• URL: /admin/modulos
• Caminho no menu: Módulos > Loja de Módulos
• Permissão necessária: nenhuma específica - a página é visível para qualquer usuário da sua empresa, mas a contratação efetiva requer permissões de billing do papel
• Módulo necessário: nenhum (a página em si é fixa)

Veja também

• Visão Geral do Faturamento
• Módulos Adicionais