Manual da Agência

1. Sobre o programa de parceiros

A somvia é uma plataforma de planejamento de viagens para famílias. Nosso foco é juntar três coisas que normalmente vivem separadas: planejamento (orçamento, cofre, marcos), relacionamento (cliente acompanhando a viagem com a família) e operação (você, agência, vendendo e executando o pacote).

A somvia não vende pacotes e não movimenta dinheiro do cliente. Quem vende é você. Nós somos:

• Canal de captação: seu link público de captação traz cliente direto pra sua agência. Sem disputar com outras.
• Distribuidor de leads: clientes que chegam pela somvia pedindo cotação são distribuídos por estado/região e perfil.
• Ferramenta de relacionamento: propostas bonitas em link público, comparativos, histórico de edições, notas internas, lembretes automatizados.

Sua receita continua vindo das vendas. A somvia cobra mensalidade do plano + créditos por lead recebido (ver seção 20).

2. Cadastro da agência

Acesse somvia.com.br/cadastro-agencia e preencha:

• Razão social, nome fantasia, CNPJ (opcional pra MEI)
• Email do responsável + senha
• Endereço completo (cidade, estado, CEP)
• Telefone WhatsApp comercial (vai aparecer pra clientes)
• Estados que você atende (preferência de leads)
• Instagram, link de agendamento (opcionais)

Após enviar, sua agência fica em aguardando aprovação. Nossa equipe revisa e libera em até 48h úteis.

3. Aguardando aprovação

Enquanto a agência está em análise, você consegue logar mas vê apenas a tela "Agência aguardando aprovação". Não é possível receber leads nem criar propostas ainda.

Quando o admin aprovar, você recebe uma notificação no sino("Sua agência foi aprovada! Acesse o painel") e o acesso é liberado automaticamente — sem precisar deslogar/logar.

Algumas agências entram com plano trial ou piloto (free por X meses) quando o admin define na aprovação. Você vê seu plano e validade no painel.

4. Perfil e configurações

Em "Configurações" (item Perfil na navegação) você ajusta:

4.1 Dados cadastrais

Razão social, nome fantasia (o que aparece pro cliente), telefone WhatsApp, endereço, estados atendidos, redes sociais.

4.2 Logo

Suba o logo da agência (PNG/JPG, fundo transparente ou branco recomendado). Ele aparece no header de cada proposta pública, no card da agência dentro da viagem do cliente, e como avatar de chip/notificação.

4.3 Link público de captação

Cada agência tem um slug único (ex: magicblue) e um link público: somvia.com.br/cadastro?ag=magicblue. Clientes que se cadastrarem por esse link entram já vinculados a você — não disputam com outras agências.

4.4 Chave PIX da agência (opcional)

Configurável caso queira receber valores diretamente — usada em telas específicas. Hoje o pagamento da venda é tratado fora da somvia (na sua operação interna).

4.5 Status

Sua agência pode estar em um dos estados: aprovada(operando), pausada (você mesma pausou — não recebe leads novos mas mantém clientes ativos), suspensa (admin suspendeu — acesso limitado). Aparece no topo do painel.

5. Consultores da equipe

Em "Equipe" (navegação) você cadastra consultores da agência. Cada consultor tem nome, foto, função ("Consultora dos Sonhos", "Atendimento", etc), WhatsApp, email e Instagram pessoal.

No wizard de proposta você escolhe qual consultor assina aquela proposta. O card do consultor aparece no link público (foto + nome + função + botões de contato pessoais). Humaniza o atendimento e personaliza o relacionamento.

Pode ter quantos consultores quiser. Marque como inativoquem saiu da agência — o card antigo continua nas propostas já enviadas (histórico) mas não aparece nas novas.

6. Biblioteca de mídia

Em "Mídia" (navegação) você organiza fotos que vai usar nas propostas. Suba até 8 fotos por upload (PNG/JPG). Cada item tem categoria (aéreo, hotel, parques, transporte, atividades, etc) — facilita encontrar depois.

Lixeira: fotos excluídas vão pra lixeira e permanecem por 90 dias. Botão "Esvaziar lixeira" apaga definitivamente. Após 90 dias um cron diário limpa automaticamente.

Galeria padrão somvia: além das suas fotos, o wizard oferece uma galeria curada (heroes de Orlando, fotos categorizadas) que você usa de graça. Você sempre pode substituir por foto própria.

7. Tours guiados — aprenda no caminho

A somvia tem 3 tours interativos que aparecem automaticamente nas primeiras visitas:

• Onboarding — na primeira vez que você abre /agencia/hoje depois da aprovação. Apresenta o app inteiro (tela Hoje, navegação, painel, fluxo de propostas).
• Wizard de proposta — na primeira vez que você cria uma proposta. Mostra os 4 steps, fotos, consultor, envio.
• Painel — na primeira visita ao painel. Explica KPIs, link de captação, créditos, faturas.

Botão ✨ "Ver tour": ícone discreto no canto da tela reapresenta o tour quando você quiser revisitar.

Tooltips pontuais (ℹ️): ícones de informação ao lado de conceitos que merecem explicação — devolver lead (até 30 dias com 50% de crédito quando sem culpa), score/completude do pedido, crédito de lead, "pago com milhas/cortesia". Hover no desktop, tap no mobile.

8. Tela Hoje — sua inbox

A tela Hoje é a caixa de entrada da agência. Tudo que precisa da sua atenção aparece aqui, organizado por urgência em 4 seções:

• 🔥 Agir agora: cliente esperando ou prazo crítico (lead novo, proposta a vencer, pedido de ajuste, troca de agência solicitada). Cor vermelha.
• ⏳ Aguardando cliente: proposta enviada e cliente ainda não respondeu. Sem urgência sua — só pra ter contexto.
• 🛒 Comprar agora: janela ideal aberta (aéreo próximo, fechamento de hotel). Oportunidades.
• 📦 Longo prazo: clientes em estágios iniciais — cofre lento ou viagem adiada. Lembrete pra cultivar o relacionamento sem pressa.

8.1 KPIs no topo

5 cards no topo, clicáveis pra filtrar:

• Agir agora: cliente esperando você
• Atrasados: fases de compra vencidas
• Comprar agora: janela ideal aberta
• Longo prazo: adiadas + cofre lento
• Aceitas no mês: propostas aprovadas (com receita do mês)

8.2 Pill de origem

Cada item tem um pill colorido indicando como o cliente chegou:

• 🟣 Captação: chegou pelo seu link público de captação. Cliente próprio, sem disputa.
• 🟢 via somvia: cliente já tinha conta na somvia, preencheu cotação dele e o sistema te atribuiu o lead.
• ⚪ Sem perfil ainda: proposta que você criou direto pra cliente externo (sem cadastro). Cliente ainda não tem conta — só vai criar quando aceitar a proposta.

8.3 Filtros e busca

Chips no topo filtram por tipo (leads, propostas, ajustes, revisões, trocas, recusas). Barra de busca filtra por nome do cliente. Combine os dois.

8.4 Menu kebab (⋮)

Em cada card, o menu ⋮ traz ações secundárias: editar cotação enviada, copiar link da proposta, adiar tarefa (snooze), devolver lead, etc. Mantém a tela limpa sem botões redundantes.

9. Painel — KPIs, captação, créditos, faturas

O painel (item Painel na navegação) consolida o estratégico — pra você acompanhar saúde do negócio, performance e financeiro com a somvia.

9.1 Captação no topo

Card destacando seu link público + botão pra copiar + atalho de "Nova proposta" (cliente externo).

9.2 KPIs principais

• Total de clientes ativos
• Valor do mês (faturamento estimado)
• Próximos 12 meses (pipeline)
• Longo prazo (viagens 12m+)
• Leads recebidos no mês

9.3 Performance de propostas

Bloco com enviadas/30d, taxa de abertura, taxa de conversão, pipeline ativo. Comparação automática com mês anterior.

9.4 Saúde operacional

Indicadores de atenção: propostas paradas há X dias, leads recusados, mensagens não lidas. Verde/amarelo/vermelho.

9.5 Aprenda com perdidas

Quando aparecem propostas perdidas (cliente rejeitou ou recusou troca), bloco com motivos agregados — pra você aprender padrões.

9.6 Créditos de lead

Saldo disponível + extrato dos últimos movimentos + alertas em destaque quando há créditos expirando em 7d ou 30d.

9.7 Faturas

Histórico de cobranças da somvia (mensalidade + créditos consumidos). Status pago/pendente. Permite baixar PDF.

9.8 Funil mensal + acumulado

Leads → Aceitos → Propostas → Vendas, do mês e total histórico.

10. Captação de clientes próprios

Há dois caminhos pra você trazer cliente próprio (sem disputa com outras agências):

10.1 Link público

Compartilhe seu link (somvia.com.br/cadastro?ag=seu-slug) nas redes sociais, WhatsApp, Instagram, email-marketing. Cliente cadastra, cria viagem, e ela já entra vinculada a você.

Cliente assim aparece em Hoje com pill 🟣 Captação(e não consome crédito de lead).

10.2 Criar proposta direta

Se você já tem cliente fora da somvia (atendimento WhatsApp, indicação), use "Nova proposta" no painel ou na tela Hoje. Você preenche dados do cliente (nome, email, telefone), monta a proposta e envia link.

Cliente recebe o link público (sem precisar logar pra ver). Quando aceitar, é guiado a criar conta inline. Aparece em Hoje com pill ⚪ Sem perfil ainda até aceitar.

11. Sistema de leads (somvia)

Quando um cliente que já tem conta na somvia pede cotação dentro da viagem dele, isso gera um lead. O sistema atribui o lead à melhor agência disponível considerando:

• Estado do cliente × estados que sua agência atende
• Plano da agência (premium recebe primeiro)
• Score de relacionamento (devolução, recusa, snoozes)
• Round-robin pra distribuição justa entre as elegíveis

11.1 Estágios do lead

• Aguardando: oferecido a você, ainda não respondeu
• Aceito: você aceitou e está em conversa
• Recusado: você recusou (sem custo — recusar nunca consome crédito)
• Fallback: você não respondeu em 72h — redistribuído
• Atendido: virou proposta e foi para a fase de venda

11.2 Validade do lead

Lead expira em 72h sem resposta. Aparece em destaque na tela Hoje conforme se aproxima do prazo.

12. Aceitar, pedir info ou recusar lead

12.1 Aceitar

Em Hoje, no card do lead, clique em "Aceitar". Um crédito de lead é consumido do seu saldo. O cliente é notificado ("Sua cotação foi aceita pela agência X") e a viagem fica vinculada provisoriamente. Próximo passo: criar a proposta.

12.2 Pedir info

Se o pedido está incompleto (faltam datas, perfil, número de viajantes), clique em "Pedir info". Você descreve o que falta numa mensagem curta. O cliente recebe notificação com o que preencher e volta pra você quando completar. Não consome crédito.

12.3 Recusar

Se não puder atender, clique em "Recusar". O lead é redistribuído pra próxima agência.

Recusar é grátis: nenhum crédito é consumido. Se aceitou e depois descobriu que não é seu mercado, use Devolver lead em até 30 dias do aceite — devoluções sem culpa (cliente sumiu, sem capacidade, fora do destino etc.) rendem 50% do crédito de volta ao seu saldo. Tooltip (ℹ️) ao lado dos botões explica.

12.4 Não responder em 72h

Lead vai pra fallback automaticamente — redistribuído pra outra agência. Como você nunca aceitou, nenhum crédito foi consumido. Mas a falta de resposta penaliza score, então prefira sempre responder (aceitar ou recusar).

13. Criar proposta (wizard de 4 steps)

Em "Nova proposta" você entra no wizard. Cada step salva rascunho automaticamente — pode pausar e voltar.

13.1 Step 1 — Cliente

Nome, email, telefone, número de viajantes, perfil (econômico / confortável / premium). Se o lead já trouxe esses dados (caso 11), vêm preenchidos.

13.2 Step 2 — Destino

Destino, nome da viagem, data alvo (mês/ano), número de dias, aeroporto de origem, foto-capa. Você escolhe entre:

• Galeria somvia — heroes prontos (Orlando, etc)
• Sua biblioteca — fotos da sua agência
• Automática — somvia escolhe pelo destino

13.3 Step 3 — Itens

Coração da proposta. Adicione itens em até 9 categorias (aéreo, hospedagem, transporte terrestre, parques, atividades, refeições, câmbio, seguro, outros). Cada item tem:

• Título e categoria
• Valor
• Galeria de fotos (até 8 fotos por item)
• Toggle "Destacar foto na proposta" (capa do item)
• Descrição rica (suporta quebra de linha, formatação básica)
• Para aéreo: editor de voos (origem, destino, datas, número do voo)

Quando o cliente já tinha cotação na somvia (lead via 11), aparece um card "Pedido do cliente" com escopo solicitado, valores estimados pelo cliente, perfil, observações. Use de referência pra alinhar a proposta com o que ele pediu.

13.4 Step 4 — Mensagem e consultor

Mensagem da agência: texto de abertura/contexto que aparece pro cliente na proposta. Escreva de forma humana ("Lucas, montei essa proposta pensando em vocês...").

Consultor responsável: escolha entre os consultores ativos da agência. Card do consultor aparece no link público — humaniza muito o atendimento.

13.5 Envio

Ao enviar, é gerado o link público da proposta (somvia.com.br/proposta/[token]). Cliente cadastrado é notificado no app (com delta R$ no texto). Cliente externo recebe só o link — você compartilha por WhatsApp com texto sugerido. Link com OG image dinâmica: ao colar no WhatsApp, preview vem branded com a foto-capa da proposta.

14. Editar proposta enviada

Em Hoje, no card da proposta, use "Editar cotação" (ou menu ⋮ → Editar). Wizard reabre hidratado com os dados atuais.

14.1 Cliente ainda não viu

Edita normalmente, salva. Cliente quando abrir vê a versão nova — sem aviso de mudança (não tinha visto a anterior).

14.2 Cliente já visualizou

Banner amarelo no topo do wizard avisa ("Cliente já abriu essa proposta"). Ao salvar, abre um modal de confirmação onde você descreve:

• O que mudou (público): texto que vai pro cliente — "Ajustei o hotel, trocou pra Resort X com café da manhã"
• Nota interna (privada): só você vê — anotação sobre o cliente, dificuldades, contexto interno

O cliente recebe notificação e ao abrir vê um aviso destacado informando que a proposta foi atualizada e quando. Histórico de edições fica visível pra você no wizard.

15. O que o cliente vê no link público

A proposta pública (/proposta/[token]) é onde o cliente decide. Layout pensado pra vender com transparência:

• Header com sua logo, nome e número da proposta
• Foto-capa que você escolheu
• Saudação personalizada ("Olá, Lucas!")
• Mensagem da agência em destaque
• Itens agrupados por categoria, cada um expansível com galeria de fotos, descrição rica, valor
• Comparativo (quando o cliente tinha cotação prévia): bolinhas verde/amarelo/vermelho mostram como cada categoria se compara ao orçamento dele
• Impacto no cofre (quando cliente logado tem cofre): meta mensal antes/depois da proposta
• Total da viagem em destaque
• Card do consultor com botões de contato
• Botões: ✨ Aceitar proposta / Pedir ajuste / Baixar PDF

15.1 Após o cliente aceitar

A viagem dele é atualizada com os valores da proposta (não cria viagem nova quando ele já tinha uma — preserva cofre, histórico, programação, família). Você é notificada ("X aceitou sua proposta").

15.2 Após o cliente pedir ajuste

Cliente preenche motivo (opcional). Você recebe notificação com o texto e pode criar uma nova proposta de ajuste ou conversar por WhatsApp pra alinhar.

15.3 Link expirado

Links são válidos por 30 dias. Após expirar, o cliente vê tela explicando + botão "Pedir novo link" que te notifica. Você gera um novo do seu lado em 1 clique.

16. Revisões de orçamento

Após a proposta inicial aceita, qualquer mudança nos valores da viagem passa por revisão. É a forma formal de atualizar o orçamento mantendo histórico.

16.1 Quando criar

• Cliente pediu (botão "Pedir revisão" na viagem dele)
• Você identificou oportunidade (aéreo mais barato, hotel novo)
• Revisão semestral em viagens de longo prazo
• Custos subiram e precisa repactuar

16.2 Como criar

Na ficha do cliente (em /agencia/clientes/[id]) → aba Propostas → "Nova revisão". Wizard parecido com o de proposta, mas pré-preenchido com os valores atuais da viagem.

16.3 O que o cliente vê

Link público de revisão (/revisao/[token]) mostra lado a lado valor atual × valor proposto, com delta por categoria e total. Mesma UI da proposta, com layout adaptado pra comparativo.

Cliente recebe notificação com delta R$ visível(ex: "Sua agência propôs uma revisão — total +R$ 1.500") — ele decide até abrir.

16.4 Aceitar / pedir ajuste

Cliente aceita: viagem atualizada, novos valores valem. Você é notificada com o delta R$.
Cliente pede ajuste: você recebe motivo (se informado) e pode propor nova revisão. A anterior fica no histórico (status "recusada").

17. Devolução de lead, troca de agência, score

17.1 Devolver lead

Aceitou um lead mas viu que não é seu mercado (destino fora da sua especialidade, perfil que não atende)? Você pode devolver em até 7 dias. Crédito é devolvido. O lead é redistribuído.

17.2 Cliente solicita troca

O cliente pode pedir troca de agência uma vez por viagem sem justificar. Você recebe notificação e a viagem é desvinculada de você. Sem penalidade direta — mas o motivo (se informado) entra no score.

17.3 Pausar relação

Em casos críticos (conflito sério, cliente sumiu, você quer sair de operação), pausar relação libera o cliente sem consumir nova troca. Aparece nos cards como ação destacada — usar com cuidado.

17.4 Score da agência

Cada agência tem um score que afeta a posição na fila de leads. Sobe com: leads aceitos rapidamente, propostas enviadas, vendas confirmadas, NPS positivo. Desce com: recusas, devoluções, fallbacks por inatividade, trocas solicitadas pelo cliente.

17.5 Contestar lead

Lead que veio com info incompleta ou que parecia "teste"? Abra contestação em até 7 dias. Admin analisa e pode devolver o crédito + ajustar score se procedente.

18. Notas internas, snoozes e views salvas

18.1 Notas internas sobre cliente

Na ficha do cliente (/agencia/clientes/[id]) há um campo "Notas internas". Cliente NÃO vê. Use pra anotações estratégicas: "Família grande, prefere all-inclusive", "Aniversário do João em janeiro", "Reclamou do hotel da Copa em 2024 — evitar XYZ".

18.2 Snoozes na inbox

Tarefas que não são urgentes agora podem ser adormecidas: no menu ⋮ do card → Snooze → escolhe quando voltar (amanhã, semana que vem, daqui 2 semanas). Some da inbox principal e aparece de novo na data marcada.

Itens adormecidos ficam num accordion no rodapé de Hoje — pode despertar antecipadamente se quiser.

18.3 Views salvas

Combinação de filtros usada repetidamente? Salve como view. Aparece como chip de acesso rápido no topo de Hoje. Ex: "Leads novos esta semana", "Propostas Orlando", "Atrasados".

19. Notificações

Sino no canto superior direito concentra avisos do dia. Badge tem tier de urgência:

• Vermelho: avisos críticos (crédito expirando, baixa recusada, lead a vencer)
• Roxo: tudo o resto (lead novo, proposta aceita, revisão respondida)

Tipos que você recebe:

• Novo lead disponível
• Lead expirando em 24h
• Cliente aceitou sua proposta (com delta R$)
• Cliente pediu ajuste / rejeitou proposta
• Cliente pediu revisão de orçamento
• Cliente pediu troca de agência
• Cliente atingiu marco de cofre (25/50/75/100%) — oportunidade de parabenizar / enviar brinde
• Crédito expirando em ≤3 dias (cron diário)
• Admin aprovou sua agência
• Lead recusou sua proposta de ajuste (revisão)
• Cliente postou baixa em despesa (visibilidade da execução)

Notificações também aparecem em /agencia/notificacoescom histórico completo. Refetch automático ao voltar pra aba.

20. Planos, créditos e faturas

20.1 Planos disponíveis

• Básico: recebe leads em ordem normal, painel completo, propostas ilimitadas. Mensalidade vigente publicada no painel.
• Premium: prioridade na distribuição de leads, KPIs avançados, sem teto de propostas/mês.
• Trial: agências em fase de teste — X meses gratuitos (admin define ao aprovar). Vira plano pago no final.
• Piloto: parceiros piloto — mesmas regras de trial, com termos negociados caso a caso.

20.2 Créditos de lead

Cada lead aceito consome um crédito. Plano contratado vem com X créditos por mês — adicionais podem ser comprados. Tooltip (ℹ️) no painel explica detalhes.

Devolução: em até 30 dias do aceite, com motivos sem culpa (cliente sumiu, destino fora etc.), devolve 50% do crédito. Recusar lead nunca consome crédito — só aceitar consome. Trocas iniciadas pelo cliente também podem gerar crédito.

Validade: crédito expira em 6 meses. O sistema alerta no painel + sino quando há saldo expirando em 7d/30d. Cron diário às 7h envia notificação consolidada.

20.3 Faturas

Bloco no painel mostra histórico (mês, valor, status pago/pendente, link PDF). Cobrança da mensalidade + créditos consumidos.

20.4 Suspensão

Faturas em atraso ou conduta que viole termos podem levar à suspensão. Acesso fica limitado até regularizar. Aviso amarelo no topo do app indica o motivo. Cliente atual da agência continua ativo — só não recebe leads novos.

21. Boas práticas

• Responda lead em 24h. Lead frio = lead perdido. Cliente que esperou demais já está conversando com outra agência.
• Detalhe itens com fotos. Proposta com galeria vende muito mais que proposta só de valores. Use a biblioteca da somvia ou fotos próprias da sua operação.
• Atribua consultor. Card do consultor humaniza — cliente sente que tem uma pessoa cuidando, não uma empresa anônima.
• Escreva mensagem personalizada. "Lucas, montei essa proposta pensando no aniversário da Maria..." vende mais que "Segue proposta".
• Use notas internas. Você vai esquecer detalhes. Anotar "esposa tem alergia a frutos do mar" agora salva o próximo atendimento.
• Mande revisão semestral. Cliente de longo prazo ama saber que você está acompanhando — "Vi que aéreo está 25% mais barato pra junho, quer rever?".
• Celebre marcos do cliente. Quando ele atinge 50% do cofre, mande mensagem de parabéns. Pequenos toques fazem diferença gigante na fidelidade.
• Use snooze. Lead que veio em estágio inicial (viagem daqui 18m) — adia 60 dias e cultiva quando estiver mais perto. Sem entulhar inbox.
• Recuse com bom-senso. Recusar leads que você não consegue atender protege seu score — pior é aceitar e não dar conta.
• Acompanhe o painel semanalmente. KPIs e saúde operacional pegam padrões antes de virarem problema.

22. Perguntas frequentes