Clientes

Cadastro dos clientes da sua agência, com contrato e escopo, vinculação de canais, documentos e portal externo.

Pra que serve

Se você roda uma agência que gerencia canais pra múltiplos clientes, essa tela é onde você cadastra cada cliente (nome, empresa, CNPJ, contato, foto, contrato), vincula os canais que você gerencia pra cada um e gerencia o ciclo de vida dele (ativo, inativo, excluído).

A função dessa tela é organizar a operação multi-cliente de quem trabalha como agência. Sem ela, você precisaria de planilhas externas pra lembrar qual canal pertence a qual cliente, quando começou o contrato, onde tá o PDF do contrato, etc.

Ela te ajuda de seis formas:

1. Identificação clara. Cada canal tem um cliente dono, e você vê isso direto na interface, sem precisar consultar planilha externa.
2. Relatórios separados. Em Relatórios, você gera relatórios por canal e manda pro cliente específico.
3. Contrato e escopo. Além do CNPJ e do PDF do contrato, cada cliente tem um contrato estruturado (valor mensal, vigência, status) com os serviços contratados (ex: 4 vídeos e 2 thumbnails por mês). O sistema acompanha o contratado vs. entregue do mês e pode gerar as demandas do escopo automaticamente todo dia 1º.
4. Documentos e recursos. Anexe entregáveis (planejamento, estratégia, atas) que aparecem no portal do cliente, e guarde links de recursos que o cliente fornece (Drive, Trello, Notion) só pra equipe.
5. Controle de ciclo de vida. Inativar congela um cliente sem deletar dados (ex: quando o contrato termina mas você quer manter histórico). Reativar volta tudo. Excluir é definitivo e em cascata.
6. Portal customizável. Cada cliente tem um link público (/portal/{token}) onde acompanha o pipeline. Você copia o link, ativa/revoga o acesso e clica em "Configurar" pra customizar branding (logo + cor da sua agência), abas visíveis e ocultar a marca YouFlow. Detalhes em Portal do Cliente.

Se você é criador solo ou trabalha com time próprio (sem atender outros canais), essa tela não é pra você.

Quem pode acessar

• Plano necessário: Agency. Ver planos.
• Perfis com acesso: dono, administrador e gerente editam clientes, contrato e escopo. Colaborador só visualiza o card. Excluir e inativar são restritos a dono e administrador.

Como chegar

Menu lateral, grupo "Clientes", opção "Clientes".

O que você vê

• Cabeçalho: título "Clientes", contador (quantos clientes e quantos canais vinculados) e botão "Novo cliente".
• Tabs Ativos / Inativos com contadores. A tab Inativos só aparece se você tem pelo menos 1 cliente cadastrado.
• Aviso azul na aba Inativos explicando que clientes congelados somem das listas em todas as telas.
• Barra de busca pra filtrar por nome, empresa, e-mail ou CNPJ.
• Lista em cards: cada cliente tem um card.

Cada card mostra

• Avatar ou foto do cliente (ou iniciais, se não tiver foto)
• Nome em destaque
• Empresa, e-mail, telefone, CNPJ
• Período do contrato no formato 01/01/2026 → 31/12/2026 (ou → Atual se sem data de saída)
• Link clicável "Contrato" quando tem PDF anexado
• Anotações internas (truncadas em 120 caracteres)
• Badge com número de canais vinculados (1 canal / 5 canais)
• Cards inativos ficam com borda roxa e opacity reduzida pra distinguir
• Botões de ação mudam conforme status:
  • Ativo: Editar / Documentos / Recursos / Inativar / Excluir
  • Inativo: Reativar / Excluir
• Barra "Portal do cliente" (aparece quando o cliente tem token): botão "Copiar link", indicador "Ativo/Revogado" (clique pra liberar ou cortar o acesso) e botão "Configurar" que leva pra página de branding e abas do portal
• Seção "Contrato e escopo" expansível: contrato estruturado, serviços contratados e o progresso contratado vs. entregue do mês (detalhes mais abaixo)
• Seção "Canais" expansível: lista os canais YouTube vinculados em chips. Clicar no chip abre a edição do canal; os ícones ao lado editam o canal, abrem no YouTube ou desvinculam. O botão "Vincular canal" abre um dropdown pra adicionar mais

Como cadastrar um cliente novo

1. Clique em "Novo cliente".
2. No modal:
   • Upload de foto (arraste ou clique, aceita JPG ou PNG até 2MB)
   • Nome (obrigatório)
   • Empresa (razão social)
   • CNPJ, campo com máscara 00.000.000/0000-00 automática
   • E-mail
   • Telefone
   • Bloco "Contrato":
     • Data de entrada (date picker)
     • Término de contrato (date picker, deixa vazio se sem prazo)
     • Anexo do contrato (PDF / DOC / DOCX, até 10MB), sobe pro Storage privado
   • Observações (notas internas)
3. Clique em "Salvar".

Como vincular canais ao cliente

1. No card do cliente, expanda a seção "Canais".
2. Clique no dropdown "+ Vincular canal".
3. Selecione um canal da lista (canais que você cadastrou em Canal).
4. O canal aparece como chip. Dá pra desvincular depois clicando no "X" do chip.

Um mesmo canal não pode ser vinculado a dois clientes ao mesmo tempo.

Contrato e escopo

Dentro do card, a seção "Contrato e escopo" (clique pra expandir) guarda o contrato estruturado do cliente. É diferente do PDF anexado no cadastro: aqui você define o que foi combinado (serviços e quantidades por mês) e o sistema acompanha quanto já foi entregue.

Cadastrar o contrato

1. Expanda "Contrato e escopo" e clique em "Cadastrar contrato".
2. Preencha:
   • Nome do contrato (ex: "Contrato 2026") e valor mensal (R$), opcional
   • Início e Fim (deixe o Fim vazio se o contrato está vigente sem prazo)
   • Status: Ativo, Pausado ou Encerrado (aparece como badge colorido no cabeçalho da seção)
   • Observações
3. Salve. Você pode editar depois pelo botão "Editar".

Serviços contratados (escopo)

Cada contrato tem linhas de serviço. Clique em "Adicionar serviço" e informe:

• Serviço: tipo de entrega do catálogo (ex: vídeo, thumbnail, roteiro). Só aparecem os tipos ativos.
• Canal: um canal específico ou "Todos os canais".
• Qtde/mês: quantas entregas daquele serviço por mês. Use 0 pra "sob demanda" (sem cota fixa).
• Gerar demandas automaticamente todo dia 1º: quando marcado, a linha vira demanda todo início de mês (badge de raio "auto").

Contratado vs. entregue

Cada serviço com cota mostra uma barra de progresso do mês corrente: entregue/contratado no mês. A barra fica vermelha/laranja enquanto falta e verde quando a cota é batida. Serviços com quantidade 0 aparecem como "Sob demanda (sem cota mensal)".

Gerar demandas do mês

O botão "Gerar demandas do mês" cria de uma vez as Demandas do mês corrente pras linhas marcadas como automáticas. Serve pra adiantar o mês na hora ou repor caso a geração automática do dia 1º ainda não tenha rodado. O sistema avisa quantas demandas foram criadas e não duplica o que já existe.

Remover um serviço do contrato não apaga as demandas já geradas: elas só perdem o vínculo com a linha.

Documentos e recursos

No card do cliente ativo, dois botões abrem modais de arquivos e links:

• Documentos: entregáveis que a equipe produz pro cliente (planejamento, estratégia, atas de reunião, briefings). Ficam visíveis no portal do cliente. Aceita upload de arquivo ou link, com categoria.
• Recursos: links que o cliente fornece pra equipe trabalhar (Drive de fotos, Trello, Notion). Nunca aparecem no portal, são só internos.

A diferença é só a finalidade: Documentos vão pro cliente, Recursos ficam com a equipe.

Portal do cliente

Quando o cliente tem um token de portal, o card mostra a barra "Portal do cliente":

• Copiar link: copia a URL pública /portal/{token} pra você mandar pro cliente. Fica desabilitado se o portal estiver revogado.
• Ativo / Revogado: liga ou corta o acesso público na hora, sem trocar o link.
• Configurar: abre a página de configuração do portal (/dashboard/clientes/{id}/portal) onde você customiza branding, abas visíveis e a marca YouFlow.

Passo a passo completo e o que o cliente vê em Portal do Cliente.

Onboarding do cliente

Um formulário que o próprio cliente responde por um link, antes da primeira reunião: por que procurou você, dores, objetivos, negócio e funil, público, posicionamento, rotina de produção, referências e expectativas. Leva de 15 a 20 minutos e ele pode parar e voltar pelo mesmo link. Serve tanto para cliente de gestão de canal quanto de consultoria.

Só dono, admin e gerente veem a faixa "Onboarding" no card e as respostas (elas trazem ticket médio, faturamento e forma de venda do cliente).

Como enviar

1. No card do cliente, na faixa Onboarding, clique em Gerar link.
2. Escolha o serviço contratado (gestão, consultoria ou os dois). Isso só ajusta o texto de algumas perguntas.
3. Se quiser pedir acesso ao YouTube Studio, informe o e-mail que deve receber o acesso. Clientes que já têm canal veem o passo a passo no fim e confirmam antes de enviar.
4. Clique em Gerar link, depois em Copiar link, e mande para o cliente.

O que o cliente vê

A primeira pergunta separa três situações: ainda não tem canal, tem canal sem estratégia, ou tem canal e estagnou. A resposta muda um bloco de perguntas e o texto final. Cada tela tem um bloco, com barra de progresso; ao avançar, o bloco é salvo. Depois de enviar, ele vê a confirmação e pode consultar o que respondeu.

Acompanhar e ler

A faixa do card mostra o status: Aguardando o cliente, Em andamento ou Respondido em (data). Em Acompanhar / Ver respostas você vê quantas perguntas obrigatórias ele já respondeu e onde parou, e as respostas bloco a bloco conforme ele salva. Quando ele envia, dono, admin e gerentes recebem aviso no sino e por e-mail.

• Copiar tudo em texto: leva o onboarding inteiro para colar num documento.
• Ajustar: corrige uma resposta. O ajuste fica marcado com o seu nome e a data, e o que o cliente escreveu continua guardado ("Ver o que o cliente escreveu"). O cliente não vê o ajuste.
• Reabrir para o cliente: devolve o formulário para ele corrigir, com tudo que já respondeu. Ele envia de novo no fim.
• Desativar link: o link para de abrir até você reativar.
• Gerar novo link: cria um endereço novo; o antigo para de funcionar na hora. As respostas salvas continuam.
• Começar de novo: arquiva o onboarding atual e cria outro em branco (quando o cliente mudou de serviço ou muito tempo passou).
• Atualizar para o modelo atual: aparece só antes do envio, quando o modelo de perguntas mudou depois que o link foi gerado. O que o cliente já respondeu continua; respostas de perguntas que não existem mais deixam de aparecer (a confirmação diz quantas).

Mudar as perguntas (Modelo do onboarding)

No topo de Clientes, o botão Modelo do onboarding abre o editor das perguntas do seu workspace. Dá para mudar o texto de qualquer pergunta, o texto de abertura de cada bloco, para quais perfis o bloco aparece, adicionar e remover blocos e perguntas, reordenar, escolher o tipo de resposta (texto curto, texto longo, escolha única, múltipla escolha, escala de 0 a 10 ou link), marcar como obrigatória, permitir "Outro" nas escolhas e editar os textos da tela final por perfil, inclusive o pedido de acesso ao YouTube Studio.

• A primeira pergunta (a situação do cliente) tem sempre as três opções; você muda só o texto delas.
• Nos textos, {agencia} vira o nome do workspace, {servico} vira "a gestão do canal", "a consultoria" ou "o nosso trabalho", {nome} vira o primeiro nome do cliente e {email} o e-mail de acesso do link.
• Pré-visualizar abre o formulário como o cliente vê, sem salvar nada.
• As mudanças valem para os links gerados a partir de agora. Quem já recebeu o link continua com o formulário de quando o link foi criado (dá para trazer para o modelo atual na tela do cliente, antes do envio).
• Perguntas marcadas com "Alimenta: Consultoria" ou "Alimenta: Canal" têm a resposta aproveitada em outras telas; por isso o tipo delas é fixo. Dá para mudar o texto mantendo o sentido, ou remover (aí aquele campo deixa de vir do onboarding).
• Restaurar o modelo padrão apaga a customização e volta às perguntas padrão do YouFlow.

Aproveitar as respostas em outras telas

As respostas não ficam presas aqui: com o botão Trazer do onboarding, elas preenchem o Questionário do engajamento de Consultoria (só perguntas ainda sem resposta) e o card Sobre o Canal do canal ligado ao cliente. Nas duas telas você revisa campo a campo antes, e vale a resposta com o ajuste da equipe.

Inativar (congelar) um cliente

Inativar é o caminho recomendado quando o contrato termina, mas você quer manter os dados pra histórico, relatórios passados ou possível retomada.

1. No card do cliente ativo, clique em "Inativar" (ícone de floco de neve ❄️).
2. O cliente sai da aba Ativos, vai pra Inativos.
3. Os canais dele somem de todas as listas do app: seletor de canal global, kanban, calendário, IA, relatórios, plano editorial, etc.
4. Os dados ficam todos preservados: vídeos, ideias, persona, relatórios. Nada é deletado.

Reativar

Na aba Inativos, clique em "Reativar" (ícone de sol ☀️) no card do cliente. Tudo volta ao normal.

Excluir cliente (cascata, irreversível)

Excluir é o caminho destrutivo. Apaga o cliente e tudo que depende dos canais dele.

O que é apagado

• Cadastro do cliente
• Todos os canais vinculados
• Todos os vídeos, roteiros, thumbnails e otimizações desses canais
• Persona, ideias e dados importados (CSV YouTube Studio)
• Relatórios mensais, atividades, tarefas e lembretes
• Lotes de aprovação enviados pra esse cliente

O que não é apagado automaticamente

• Anexos no Storage (foto do avatar, PDFs de contrato, thumbnails), viram órfãos. Limpe manualmente em Supabase Storage se quiser.

Como fazer

1. Clique no ícone de lixeira vermelha no card do cliente (ativo ou inativo).
2. Modal de confirmação aparece com:
   • Lista detalhada do que será apagado, incluindo nomes dos canais
   • Campo de texto pedindo pra você digitar o nome exato do cliente pra confirmar
3. O botão "Excluir tudo definitivamente" só fica clicável quando o nome digitado bate exatamente.
4. Confirme. Operação roda em cascata via RPC e leva alguns segundos.

Não dá pra desfazer. Se em dúvida, prefira inativar.

Dicas e atalhos

• Foto do cliente ajuda visualmente a identificar rápido no card. Recomendado pra quando você tem muitos clientes.
• Anotações é útil pra coisas tipo "cliente paga no dia 10", "prefere ser contatado pelo WhatsApp", "tem filho no aniversário em dezembro".
• Busca por CNPJ funciona, útil quando você lembra do CNPJ mas não do nome.
• Inativar antes de excluir é quase sempre a escolha certa. Excluir é pra quando você tem certeza que nunca mais vai precisar daquele histórico.
• PDF do contrato abre pelo link "Contrato" no card (arquivo privado, aberto por link temporário).
• Escopo antes das demandas. Cadastre o contrato e os serviços com "gerar automaticamente" marcado, e o mês começa já com as demandas prontas, sem você lançar uma por uma.
• "Configurar" leva direto pra tela de branding do portal, sem precisar procurar no menu.
• Se o canal não aparece no dropdown de vincular, você precisa cadastrá-lo primeiro na tela de Canal.

Limitações conhecidas

• Não tem endereço completo ou dados fiscais avançados no cadastro. CNPJ é o único campo fiscal. Pra emissão de nota fiscal, use sistema financeiro separado.
• Não tem histórico de conversas, e-mails ou atendimentos. Não é um CRM completo.
• Não tem alerta automático de fim de contrato. Você precisa olhar a data manualmente.
• Anexos no Storage não são apagados quando você exclui o cliente. Limpe manualmente em Supabase Storage se ocupar muito espaço.
• Foto só sobe imagem. Sem URL de avatar externo.
• CNPJ não é validado no banco, só máscara visual. Se digitar errado, salva mesmo assim.
• Tipos de serviço vêm de um catálogo. Você escolhe o serviço de uma lista pronta ao montar o escopo; não dá pra criar um tipo novo direto por essa tela.
• O escopo consultivo não aparece aqui. A seção "Contrato e escopo" mostra só o contrato operacional (de produção). Engajamentos de consultoria vivem no módulo Consultoria.