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:

Identificação clara. Cada canal tem um cliente dono, e você vê isso direto na interface, sem precisar consultar planilha externa.
Relatórios separados. Em Relatórios, você gera relatórios por canal e manda pro cliente específico.
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º.
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.
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.
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

Clique em "Novo cliente".
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)
Clique em "Salvar".

Como vincular canais ao cliente

No card do cliente, expanda a seção "Canais".
Clique no dropdown "+ Vincular canal".
Selecione um canal da lista (canais que você cadastrou em Canal).
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.

ℹ️

Dois lugares, dois papéis. O bloco "Contrato" do modal de cadastro guarda datas e o PDF assinado. A seção "Contrato e escopo" do card guarda o escopo operacional (valor mensal, status e serviços contratados) que alimenta o acompanhamento e a geração de demandas.

Cadastrar o contrato

Expanda "Contrato e escopo" e clique em "Cadastrar contrato".
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
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)".

💡

Dica: use essa barra na reunião mensal pra mostrar ao cliente, num relance, o que já foi entregue do que estava combinado.

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.

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.

No card do cliente ativo, clique em "Inativar" (ícone de floco de neve ❄️).
O cliente sai da aba Ativos, vai pra Inativos.
Os canais dele somem de todas as listas do app: seletor de canal global, kanban, calendário, IA, relatórios, plano editorial, etc.
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

Clique no ícone de lixeira vermelha no card do cliente (ativo ou inativo).
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
O botão "Excluir tudo definitivamente" só fica clicável quando o nome digitado bate exatamente.
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.