# Manual do Vendedor (Sales) — E-radios > Plataforma E-radios — Marketplace B2B de publicidade em rádio programática. > > Este manual é dedicado a usuários do tipo **Vendedor / Sub-usuário de Emissora** (sales). --- ## 1. Quem é o Vendedor (Sales) O **Vendedor** (também chamado de **Sales** ou **sub-usuário de emissora**) é uma conta vinculada a uma emissora de rádio, criada pelo **Gerente** dessa emissora (o dono da conta principal, chamado internamente de `manager`). A função do Vendedor é trabalhar a parte **comercial** do dia a dia da emissora: - Criar e enviar **propostas comerciais** para clientes - Cadastrar e gerenciar **clientes** (e seus tipos / origens) - Acompanhar **campanhas / pedidos** que chegam pela plataforma - Acompanhar **metas individuais** atribuídas a você - Usar **combos prontos** e o catálogo de **produtos e patrocínios** já configurados pela emissora > ℹ️ **Nota:** Cada emissora pode ter, por padrão, até **3 vendedores** ativos. Esse limite pode ser ampliado pela equipe E-radios sob demanda — quem precisa solicitar a ampliação é o Gerente. > ⚠️ **Atenção:** Você **não administra** a emissora em si. Dados sensíveis (perfil público da emissora, dados bancários, criação/exclusão de produtos, criação de outros vendedores, definição de metas, mudanças de cadastro) ficam com o Gerente. Veja a [Seção 20](#20-restrições--o-que-apenas-o-gerente-faz). --- ## 2. Como você recebe acesso Você **não se cadastra sozinho**. Quem cria a sua conta é o Gerente da emissora. Fluxo do lado do Gerente: 1. O Gerente entra em **Equipe Comercial** (`/broadcaster/sales-team`). 2. Clica em **+ Novo Vendedor** (ou similar). 3. Preenche seu **Nome**, **e-mail**, **telefone** e **CPF/CNPJ**. 4. Salva. Quando isso acontece, o sistema: - Cria sua conta com `userType = "broadcaster"` e `broadcasterRole = "sales"`. - Marca a conta como **aprovada** automaticamente (você não precisa esperar aprovação da equipe E-radios). - Marca seu e-mail como **confirmado** (o gerente atestou seu e-mail). - Gera um **token de convite** válido por **7 dias**. - Dispara um **e-mail de convite** para você, em nome do Gerente / da emissora. > 💡 **Dica:** Se o e-mail não chegar, peça ao Gerente para clicar em **"Reenviar convite"** na lista de vendedores. O sistema gera um novo token de 7 dias. --- ## 3. Primeiro acesso e definição de senha Você recebe um e-mail com assunto parecido com "Você foi convidado para a equipe comercial de [Nome da Emissora]". Passo a passo: 1. Abra o e-mail e clique no botão / link de **definir senha**. 2. Você cai em uma tela do tipo `/reset-password/:token`. 3. Crie uma senha forte (siga os requisitos exibidos na tela — geralmente comprimento mínimo, letras maiúsculas, número, símbolo). 4. Confirme a senha. 5. Clique em **Salvar**. 6. Você será redirecionado para a tela de **Login**. Faça login com: - **E-mail:** o e-mail que o Gerente cadastrou. - **Senha:** a que você acabou de criar. > ⚠️ **Atenção:** O token de convite expira em **7 dias**. Se passar disso, peça ao Gerente para reenviar o convite. > ℹ️ **Nota:** Você não é cobrado, não preenche dados bancários e não passa por aprovação manual da equipe. Sua conta entra ativa direto. --- ## 4. Login no dia a dia Tela: `/login`. Use **e-mail e senha** (CNPJ não se aplica a vendedores — você é uma pessoa, não a empresa). 2FA por e-mail pode estar ativado se você ligar nas configurações. **Redirecionamento pós-login (regra específica de Sales)**: | Tipo de usuário | Para onde vai | |---|---| | Gerente da emissora | `/home` (Dashboard) | | **Vendedor (Sales)** | **`/broadcaster/proposals`** (Lista de Propostas) | | Anunciante / Agência | `/marketplace` | Ou seja: ao logar, você cai direto na tela de Propostas — onde está a maior parte do seu trabalho. > 💡 **Dica:** Se quiser ver o painel "Visão Geral / Dashboard" e seu grupo de permissões liberar, basta clicar em **Dashboard** no menu lateral. --- ## 5. Recuperação de senha Tela: `/forgot-password`. 1. Clique em **"Esqueci minha senha"** na tela de login. 2. Informe seu e-mail. 3. Você recebe um link de redefinição. 4. Cria nova senha em `/reset-password/:token`. 5. Faz login normalmente. O fluxo é o mesmo do Gerente — não há diferença para o Vendedor. --- ## 6. Visão geral da interface A interface é a mesma do Gerente (mesma sidebar, mesmo Header, mesmo Footer obrigatório), **mas com menos itens de menu**. Estrutura geral: - **Sidebar lateral esquerda** (recolhível): seu menu de navegação. - **Header superior:** logo, ações rápidas, avatar do seu usuário. - **Área central:** a tela atual. - **Footer:** links institucionais (termos, política, contato, docs). Na **Minha Conta**, seu badge aparece como **"Vendedor"** (não "Emissora") e mostra "**Vendedor de [Nome da Emissora]**" — assim fica claro a quem você está vinculado. --- ## 7. Permissões: o que você pode (e não pode) ver O Gerente pode te colocar em um **Grupo de Permissões** que define quais telas aparecem no seu menu. As páginas controláveis são: | Chave | Tela | O que faz | |---|---|---| | `dashboard` | Dashboard / Visão Geral (`/home`) | KPIs e resumo da emissora | | `campaigns` | Campanhas (`/broadcaster/campaigns`) | Pedidos recebidos | | `calendar` | Calendário (`/broadcaster/calendar`) | Visão temporal de propostas/pedidos | | `products` | Produtos e Patrocínios (`/broadcaster/products`) | Catálogo + Combos | | `sales_team` | Equipe Comercial (`/broadcaster/sales-team`) | Visão da equipe | | `proposals` | Propostas (`/broadcaster/proposals`) | Suas propostas | | `clients` | Clientes (`/broadcaster/clients`) | Cadastro de clientes | | `goals` | Metas (`/broadcaster/goals`) | Suas metas | | `reports` | Relatórios (`/broadcaster/reports`) | Análises agregadas | > ℹ️ **Nota:** Se o Gerente **não** te colocou em nenhum grupo, você cai no **padrão de fábrica** para Sales: apenas **Propostas** e **Clientes** liberados. > 💡 **Dica:** Não vê alguma tela que você precisaria? Fale com o Gerente — ele edita o seu grupo em **Equipe Comercial → Grupos de Permissão**. > ⚠️ **Atenção:** Mesmo que você consiga digitar a URL na barra do navegador, o backend bloqueia com `403 — Permissão insuficiente` se a permissão não estiver no seu grupo. As regras valem nos dois lados: front esconde, back recusa. --- ## 8. Dashboard / Visão Geral Tela: `/home`. Permissão: `dashboard`. Quando habilitado, é o mesmo painel do Gerente — KPIs gerais da emissora, gráficos resumidos. > ℹ️ **Nota:** Em algumas emissoras o Gerente prefere que o Vendedor não veja o dashboard "macro" (faturamento global). Nesse caso, o item **Dashboard** simplesmente some do seu menu. --- ## 9. Campanhas (pedidos da emissora) Tela: `/broadcaster/campaigns`. Permissão: `campaigns`. **O que aparece:** lista dos **pedidos / campanhas** recebidos pela emissora vindos do marketplace (ou convertidos a partir de propostas). **O que você consegue fazer (se tiver permissão)**: - Ver todos os pedidos recebidos pela emissora. - Filtrar por status (Aguardando contato / Pagamento Pendente / Pago / Agendado / Veiculado / Concluído / Cancelado / Expirado). - **Aprovar** ou **rejeitar** itens da emissora num pedido. - Abrir o detalhe da campanha para ver itens, datas, materiais. > ⚠️ **Atenção:** Sales **não** muda dados sensíveis do contrato comercial fora do que a tela permite (preço final, regime de pagamento). Pagamento é feito por fora da plataforma. --- ## 10. Calendário Tela: `/broadcaster/calendar`. Permissão: `calendar`. Mostra propostas, pedidos e patrocínios em um calendário (mensal/semanal). **Diferença importante:** como Vendedor, você vê **apenas as propostas que você criou** no calendário. Já os pedidos e patrocínios da emissora você vê todos (são da emissora inteira). > 💡 **Dica:** Use o calendário para enxergar gargalos — semanas cheias, vencimentos de propostas (`validUntil`), prazos de envio de material. --- ## 11. Produtos e Patrocínios (catálogo) Tela: `/broadcaster/products`. Permissão: `products`. Aqui o Gerente cadastra os produtos (spots / inserções) e patrocínios de programas que a emissora vende. **O que Sales pode fazer**: - **Visualizar** todo o catálogo (produtos + patrocínios + combos). - Usar esses itens ao montar uma **proposta**. **O que Sales NÃO pode fazer**: - **Criar**, **editar** ou **excluir** produtos. - **Criar**, **editar** ou **excluir** patrocínios. - **Criar**, **editar** ou **excluir** combos. > ⚠️ **Atenção:** A permissão `products` libera apenas a visualização. As ações de escrita são protegidas pela mesma chave, mas as telas de Sales (sem o controle de manager) só renderizam os modos de leitura. O Gerente é quem mantém o catálogo. --- ## 12. Combos prontos Combos são **pacotes pré-montados** (ex: "10 inserções + 1 patrocínio com 15% off") que o Gerente cria para acelerar a montagem de propostas. **Onde Sales usa um combo:** 1. Vá para **Propostas → Nova Proposta** (`/broadcaster/proposals/new`). 2. No **passo 1** (escolha de itens), clique em **"Usar Combo"**. 3. Selecione o combo desejado no modal. 4. O carrinho é preenchido com os itens do combo (quantidades + descontos por item já vêm aplicados). 5. Você pode **editar quantidades, descontos por item e desconto global** depois — combos são um ponto de partida, não algo travado. > 💡 **Dica:** Combo é só um atalho. Tudo que ele preenche pode ser ajustado na hora de finalizar a proposta. > ⚠️ **Atenção:** Sales **não cria** combos. Quem cria é o Gerente, na aba **Combos** dentro de **Produtos e Patrocínios**. --- ## 13. Propostas — sua ferramenta principal Telas: - Lista: `/broadcaster/proposals` (esta é onde você cai ao logar) - Criar / editar itens: `/broadcaster/proposals/new` e `/broadcaster/proposals/:id/edit-items` - Editar texto/visual: `/broadcaster/proposals/:id/edit` - Detalhe: `/broadcaster/proposals/:id` - Analytics: `/broadcaster/proposals/analytics` - Pública (link enviado ao cliente): `/p/:slug` Permissão: `proposals`. ### O que Sales vê Você vê **todas as propostas da emissora** — incluindo as criadas pelo Gerente e por outros Vendedores. Pode editar qualquer uma delas. > ℹ️ **Nota:** Cada proposta guarda quem foi o autor. É por aí que o Gerente mede sua performance individual em **Equipe Comercial** e nas **Metas**. ### Regra de preço importante (sem taxas da plataforma) Propostas criadas pela emissora **não levam taxas da plataforma**: - Sem markup de 25%. - Sem tech fee. - Sem taxa de gravação / produção embutida. - Sem custo de monitoramento. A fórmula é simples: ``` totalAmount = grossAmount - discountAmount ``` Você usa o **netPrice** da emissora direto. O markup de 25% só existe quando a venda é via marketplace (anunciante/agência comprando direto). ### Passo a passo: criar uma proposta 1. Em **Propostas**, clique em **+ Nova Proposta**. 2. **Escolha o cliente** (lista carregada de **Clientes** — veja [seção 15](#15-clientes)). Pode marcar como cliente novo e cadastrar na hora. 3. **Monte os itens:** - Selecione produtos do catálogo (com quantidade). - Selecione patrocínios (com mês alvo, se for mensal). - Ou clique em **Usar Combo** para preencher tudo de uma vez. - Adicione **itens customizados** (não vinculados a um produto cadastrado, livre digitação). 4. Defina **desconto global** (opcional — percentual ou valor fixo). 5. Avance para a tela do **Editor** (texto, capa, contrato). 6. Configure **título**, **descrição**, **logo do cliente**, **contrato**. 7. Defina a **validade** (`validUntil`). 8. Salve como **Rascunho** ou **Envie**. ### Status do ciclo de vida da proposta | Status | Significado | |---|---| | `draft` | Rascunho — só você/equipe vê | | `sent` | Enviada ao cliente (link público gerado) | | `viewed` | Cliente abriu o link | | `approved` | Cliente aprovou pelo link público | | `rejected` | Cliente rejeitou | | `expired` | Passou da `validUntil` sem decisão | | `converted` | Aprovada e convertida em **Pedido** | ### Compartilhar com o cliente Toda proposta tem um **slug** público. Ao enviar, o sistema gera um link `/p/:slug` que o cliente abre **sem precisar de login**, vê todos os itens, valor, e pode **aprovar** ou **rejeitar** dali mesmo. > 💡 **Dica:** Use o botão de copiar link ou enviar por e-mail/WhatsApp direto da tela de detalhe. Cada visualização do link é registrada (status muda para `viewed`). ### Versões Toda alteração relevante na proposta gera uma **versão**. O sistema guarda até **20 versões** por proposta. Útil pra reverter ou auditar mudanças. ### Analytics de propostas Em `/broadcaster/proposals/analytics` você vê: total de propostas, taxa de conversão, valor médio por proposta, tempo médio até resposta. > ℹ️ **Nota:** Sales vê os dados da emissora inteira nesta tela (igual ao Gerente). --- ## 14. Kanban de Propostas (estados customizados) Na própria tela `/broadcaster/proposals`, há uma visualização em **Kanban** (drag & drop). - As **colunas de sistema** correspondem aos status reais (rascunho, enviada, etc.). - As **colunas customizadas** são definidas pela emissora (ex: "Em negociação", "Aguardando contrato", "Hot lead"). - O **kanban é compartilhado** com toda a equipe da emissora — você, o Gerente e os outros Vendedores enxergam o mesmo board. - Você pode **arrastar** um card de proposta entre colunas customizadas livremente — isso é só visual, não muda o status. - Arrastar entre **colunas de sistema com status diferentes** é bloqueado (não tente, vai aparecer um aviso). > ℹ️ **Nota:** Se a proposta mudar de status (envio, aprovação, etc.), ela é automaticamente removida da coluna customizada onde estava. > 💡 **Dica:** O Gerente costuma criar colunas tipo **"Quente"**, **"Morno"**, **"Frio"** pra alinhar o time. Combine com ele os critérios. --- ## 15. Clientes Tela: `/broadcaster/clients`. Permissão: `clients` (liberada por padrão para Sales). Cadastro de **clientes** (anunciantes diretos — não precisam ter conta na plataforma) que sua emissora atende. **O que Sales pode fazer**: - **Listar** clientes cadastrados (compartilhados com toda a emissora). - **Buscar** por nome. - **Criar** novo cliente (CNPJ/CPF, nome, contato, e-mail, telefone, endereço, logo, observações). - **Editar** cliente existente. - **Excluir** cliente. - **Anexar logo** do cliente (upload de imagem). - Atribuir **Tipo de Cliente** (categoria visual com cor — ex: "Indústria", "Varejo") e **Origem** (ex: "Indicação", "Site"). - Criar / editar / excluir **Tipos de Cliente** e **Origens**. - Exportar a lista para **Excel**. > ℹ️ **Nota:** Os clientes ficam vinculados à **emissora**, não ao vendedor individual. Se você sair, eles continuam com a emissora. --- ## 16. Metas Tela: `/broadcaster/goals`. Permissão: `goals`. > ⚠️ **Atenção:** Esta tela **só aparece se o Gerente liberou** — ela faz parte das permissões opcionais. No padrão de Sales sem grupo, **não aparece**. Quando aparece, você vê: - A **meta geral** da emissora (se houver). - A(s) **meta(s) individual(ais)** atribuída(s) a você. - Gráfico de evolução da meta no período selecionado (mês / trimestre / ano / customizado). - Comparativo de quanto você fez vs. seu alvo (`targetValue`). **O que Sales NÃO pode fazer aqui**: - **Criar metas** (exige manager). - **Editar metas** (exige manager). - **Excluir metas** (exige manager). - Acessar a aba **"Cadastro"** — ela só aparece se você for o gerente. Você só **acompanha** as metas; quem as cria e ajusta é o Gerente. --- ## 17. Relatórios Tela: `/broadcaster/reports`. Permissão: `reports`. > ⚠️ **Atenção:** Também é uma tela opcional. Não vem por padrão para Sales. Exibe relatórios agregados (propostas vendidas, pedidos veiculados, faturamento por período, top clientes, top produtos). **Diferença importante para Sales:** o backend **filtra automaticamente** os dados pelos itens em que você é o autor (`createdBy = seu userId`). Você vê **as suas vendas**, não o consolidado da emissora inteira. > 💡 **Dica:** Use o filtro de período do topo (mês / trimestre / ano / customizado) e o botão **Exportar** para baixar Excel. O Gerente, no mesmo lugar, vê todos os vendedores combinados (ou pode filtrar por vendedor específico). --- ## 18. Equipe Comercial (visão de Sales) Tela: `/broadcaster/sales-team`. Permissão: `sales_team`. > ⚠️ **Atenção:** Por padrão essa tela **não aparece para Sales**. O Gerente precisa habilitar a permissão no seu grupo. Quando aparece, é a mesma tela do Gerente. Mas você **não consegue agir** nas operações de gestão: | Ação | Sales | Gerente | |---|:---:|:---:| | Ver lista de vendedores e KPIs | Sim (se permissão liberada) | Sim | | Ver dashboard agregado da equipe | Não — endpoint requer manager | Sim | | Criar / editar / excluir vendedor | Não — requer manager | Sim | | Reenviar convite | Não — requer manager | Sim | | Criar / editar grupos de permissão | Não — requer manager | Sim | | Criar / editar metas individuais | Não — requer manager | Sim | Em resumo: para Sales essa tela vira **apenas observatório**; ações administrativas dão erro `403 — Acesso restrito ao gerenciador da emissora`. --- ## 19. Minha Conta (perfil pessoal) Tela: `/my-account`. Sempre visível, em qualquer perfil. Aqui você ajusta **seus dados pessoais** (não os da emissora). ### Aba "Perfil" Edita: - **Nome completo** - **Telefone** - **Endereço** (CEP, rua, número, complemento, bairro, cidade) Não edita: - **E-mail** (bloqueado — para trocar, fale com o Gerente, que pede ao suporte). - **CPF/CNPJ** (bloqueado). - **Função** (somente leitura — mostra **"Vendedor de [Nome da sua Emissora]"**). > 💡 **Dica:** Quando você for um Sales, **não aparece o botão "Alterar dados de Perfil de Emissora"** que o Gerente vê. Ele leva para `/broadcaster/profile-settings` e é exclusivo do Gerente. ### Aba "Segurança" - **Trocar senha** (senha atual + nova + confirmação). - **Ativar / desativar 2FA por e-mail** (ao ativar, todo login passa a exigir um código de 6 dígitos enviado ao seu e-mail). - **Esqueci minha senha** (atalho para o fluxo público de reset). ### Aba "Notificações" Configurações de e-mail (frequência, tipos de evento). Mesma tela do Gerente. --- ## 20. Restrições — o que apenas o Gerente faz Lista explícita do que está **bloqueado** para Sales no backend (mesmo digitando a URL ou batendo na API): | Funcionalidade | Resposta para Sales | |---|---| | Editar **perfil público da emissora** (`/broadcaster/profile-settings`) | bloqueado / item some do menu | | **Criar / editar / excluir produtos** | acesso recusado se grupo não tem `products` | | **Criar / editar / excluir patrocínios** | idem acima | | **Criar / editar / excluir combos** | idem acima | | **Criar / listar / editar / excluir vendedores (sub-users)** | `403 — Acesso restrito ao gerenciador da emissora` | | **Reenviar convite de vendedor** | 403 | | **Stats / Dashboard da equipe** | 403 | | **Criar / editar grupos de permissão** | 403 | | **Criar / editar / excluir metas** | 403 | | Aba "Cadastro" das Metas | item some | | **Definir limite de sub-users** | aguarda equipe E-radios | Telas administrativas também não te pertencem — qualquer rota administrativa retorna 403. > ⚠️ **Atenção:** Mesmo que o navegador deixe abrir a URL, o backend **sempre** valida sua role. Não há como burlar. Se uma operação que você faz tem cara de "deveria funcionar" mas dá erro de permissão, é porque é manager-only por design. --- ## 21. Notificações e e-mails Você recebe e-mails automáticos da plataforma para eventos do seu cotidiano: - **Convite inicial** (quando o Gerente cria sua conta). - **Reenvio de convite** (se o Gerente reenviar). - **Reset de senha** (quando você pede recuperação). - **Código 2FA** (em todo login, se 2FA estiver ativado). - **Notificações de proposta** (cliente abriu, aprovou, rejeitou — depende da configuração da emissora). Configurações finas estão em **Minha Conta → Notificações**. --- ## 22. Materiais criativos recebidos Quando uma campanha (pedido) é fechada via marketplace, o anunciante / agência envia o **material criativo** (áudio do spot, roteiro, briefing). - Você acessa o material **dentro do detalhe da campanha** (em **Campanhas**). - Pode **baixar** o áudio, ver o roteiro, etc., para programar a veiculação. - A aprovação/rejeição do **material em si** segue o fluxo de aprovação de itens da emissora, permissão `campaigns`. > ⚠️ **Atenção:** Se a permissão `campaigns` não estiver no seu grupo, você não acessa o material — quem cuida disso é o Gerente ou outro Vendedor com permissão. --- ## 23. Termos, contato e suporte No rodapé (Footer) e em `/docs` você encontra: - **Termos de Uso** (`/terms`). - **Política de Privacidade** (`/policy`). - **Documentação pública** (`/docs` — guias, FAQ, manual do usuário, tutoriais). - **Página inicial pública / Marketplace** (`/marketplace`) — útil pra ver a emissora "do lado de fora", como o cliente vê. Para **suporte:** - Dúvidas operacionais do dia a dia: **fale com o Gerente da sua emissora** primeiro. - Bugs / problemas técnicos da plataforma / pedido de aumento de limite de vendedores / mudança de e-mail: **aguarda equipe E-radios** (o Gerente abre o chamado). --- ## 24. Tour guiado nas telas Várias telas têm um **botão de tour** (ícone de "?" / play) no canto superior direito. Ao clicar, um overlay passo a passo destaca cada elemento da tela e explica. Tours específicos disponíveis para você (se a permissão correspondente estiver liberada): - **Equipe Comercial** (modos: equipe, dashboard, metas, grupos) - **Propostas** - **Relatórios** - **Clientes** - E os tours globais (Header, Sidebar, Marketplace público, etc.) > 💡 **Dica:** Faça o tour pelo menos uma vez em cada tela nova. O sistema marca a conclusão na sua conta e o botão fica disponível pra repetir quando quiser. --- ## Resumo prático para o vendedor - Sua "casa" é a tela **Propostas** — ali você vive. - Você usa o **catálogo (produtos, patrocínios, combos)** que o Gerente preparou; não cria itens. - Você cadastra **clientes** livremente — eles ficam com a emissora. - Você acompanha **suas próprias metas e relatórios** filtrados por você. - Você **não** mexe em perfil da emissora, dados bancários, criação de outros vendedores, ou definição de metas. - Tudo o que está bloqueado pra você está bloqueado também na API — confie nas mensagens de "Acesso restrito ao gerenciador da emissora".