01

Começando

O fluxo principal do Filed OPS é Lead → Cliente → Agenda → Orçamento → Job → Fatura → Pago. Comece cadastrando a empresa, o usuário administrador, os serviços mais usados e as integrações necessárias. O Dashboard mostra o que exige ação e a Agenda organiza visitas e execução em campo.

• Use Criar para registrar cliente, solicitação, orçamento, job ou fatura sem sair da tela atual.
• Em Configurações, escolha o idioma da conta.
• Em Apps, conecte Google Agenda, Meta, WhatsApp, Google Local Services, Google Ads e Stripe.

02

Clientes

O cadastro do cliente centraliza nome, empresa, telefone, e-mail, endereço, idioma preferido e histórico. Ao criar orçamento, job, agendamento ou fatura, pesquise o cliente digitando ao menos 3 letras; o sistema consulta somente os clientes do tenant atual.

• Use a ficha do cliente para consultar agenda, jobs, orçamentos e faturas relacionados.
• Dados de contato devem ser revisados antes de enviar comunicação ou cobrança.

03

Solicitações e leads

Solicitações podem ser criadas manualmente ou entrar automaticamente de canais conectados. O CRM registra origem, dados de contato, serviço solicitado e mensagem. No Pipeline, avance a oportunidade até qualificação, agendamento, orçamento e ganho/perda.

• Facebook/Instagram e Google Ads podem criar leads automaticamente.
• Google Local Services pode sincronizar leads e conversas de chamadas, mensagens e bookings.
• Converta o lead em cliente para preservar o histórico operacional.

04

Agenda

A Agenda possui visualizações Dia, Semana e Mês, filtros por tipo, equipe e status, além de drag-and-drop. Um agendamento pode ser associado a cliente, lead, job e responsável. Quando o Google Agenda está conectado, o CRM cria ou atualiza o evento externo.

• Clique em um horário vazio para criar um novo agendamento.
• Arraste eventos para alterar data/hora; o endpoint preserva o vínculo com o Google Agenda.
• Use a visão Lista no celular quando a grade semanal ficar ampla demais.

05

Orçamentos

Crie o orçamento a partir do cliente ou lead, informe validade, itens, imposto, depósito e condições. O orçamento recebe um link público seguro; depois de enviado, o cliente pode revisar e aprovar online. Uma aprovação pode seguir para criação do job.

• Use valores e condições claros antes de enviar.
• O depósito solicitado fica registrado no orçamento e pode ser evoluído para cobrança online.
• O status ajuda a distinguir rascunho, enviado, visualizado, aprovado e convertido.

06

Jobs

O Job representa o trabalho contratado. Ele registra cliente, responsável, prioridade, período, endereço, instruções e checklist. O objetivo é concentrar tudo que a equipe precisa para executar o serviço e, ao concluir, permitir o faturamento.

• Vincule despesas e horas trabalhadas ao job para medir lucratividade.
• Use checklist e anexos/fotos para documentação de campo.
• Atualize o status de agendado para em andamento e concluído conforme a execução.

07

Faturas e pagamentos

A Fatura registra itens, impostos, vencimento, total, valor pago e saldo. Pode ser enviada ao cliente por link público e, com Stripe conectada, o checkout é hospedado pela Stripe. O webhook confirma o pagamento e atualiza automaticamente o saldo/status.

• Pagamentos externos como dinheiro, cheque ou transferência podem ser registrados no Financeiro.
• Nunca marque uma fatura como paga apenas pelo retorno do navegador; use o webhook do gateway.
• Faturas vencidas aparecem no aging para priorizar cobrança.

08

Financeiro

O painel Financeiro consolida contas a receber, vencidos, recebido no mês, despesas, custo de mão de obra, resultado de caixa, aging e lucratividade por job. A lucratividade usa receita faturada menos despesas vinculadas, horas trabalhadas multiplicadas pelo custo/hora do usuário e custo interno dos itens.

• Use Despesas para materiais, combustível, estacionamento e outros custos, vinculando ao job quando possível.
• Defina custo/hora dos colaboradores para que a mão de obra componha o job costing.
• Registre pagamentos externos no Financeiro para manter o histórico da fatura consistente.

09

Inbox

A Inbox centraliza conversas de canais integrados. Mensagens novas geram notificações no CRM. Meta permite resposta pelo CRM quando a conta e as permissões estão corretas; Google Local Services é sincronizado para acompanhamento conforme os recursos disponíveis pela Google Ads API.

• Conecte Meta em Apps para Facebook Messenger e Instagram profissional.
• Use a conversa para identificar o lead e não perder mensagens que ficaram no Meta Business Suite.
• Ative alertas do navegador somente em computadores autorizados.

10

Integrações

Abra Apps e clique em Configurar. Google Agenda usa OAuth 2.0; Google Local Services usa OAuth da Google Ads API e Developer Token da plataforma; Google Ads Lead Forms usa webhook + google_key; Meta usa token da conta e webhook assinado; WhatsApp usa uma instância WhatsApp API por tenant conectada por QR Code; Stripe usa Secret Key e Signing Secret de webhook.

• Google Agenda: autorize uma conta com acesso de escrita à agenda escolhida.
• Google Local Services: informe Customer ID e, se necessário, Manager Account ID.
• Google Ads: copie a URL e Google key geradas pelo CRM para o formulário de lead.
• Meta: configure IDs e tokens somente em ambiente seguro; o App da plataforma precisa das permissões aprovadas para contas de terceiros.
• WhatsApp: o Master configura URL/API Key da infraestrutura WhatsApp; o tenant vê somente o QR Code da própria instância.
• SMTP: o Master configura o servidor uma vez para reset de senha, orçamentos, faturas e lembretes.
• Stripe: registre o webhook da empresa e mantenha as chaves em segredo.

11

Idiomas e moedas

O Master define quais idiomas e moedas estão habilitados e mapeia um idioma para uma moeda. O tenant vê somente idiomas liberados. Ao aplicar o idioma para toda a empresa, a moeda padrão do tenant também é atualizada conforme esse mapeamento. A página pública de planos procura o preço configurado na moeda correspondente.

• Português (Brasil) usa código interno pt e pode ser mapeado para BRL.
• English normalmente pode ser mapeado para USD.
• Español pode ser mapeado para EUR, USD ou outra moeda habilitada pelo Master.
• Se um plano não tiver preço cadastrado na moeda ativa, o sistema não inventa conversão: mostra que o preço precisa ser configurado.

12

Admin Master

A área Master controla tenants, trials, assinaturas, planos, idiomas, moedas e credenciais globais da plataforma. O Master pode entrar em uma conta em modo suporte sem conhecer a senha do cliente e deve sair da impersonação assim que concluir o atendimento.

• Mantenha a conta Master separada das contas dos tenants.
• Desative idiomas/moedas que não serão oferecidos antes de publicar os planos.
• Configure Google OAuth, Developer Token, Meta App, SMTP, WhatsApp API e Stripe da plataforma em Configurações do Master.
• Nunca envie a senha Master a clientes.

13

Segurança e produção

Antes de colocar clientes reais, use HTTPS, APP_DEBUG=false, senha Master forte, backups automáticos, cron monitorado e credenciais de produção. Tokens externos ficam criptografados no banco; o .env não deve ficar acessível pela web. Webhooks devem validar assinatura/chave antes de processar qualquer dado.

• Meta exige App configurado e permissões adequadas; contas de terceiros normalmente exigem Advanced Access/App Review.
• Stripe deve usar Signing Secret do endpoint correto e a baixa depende do webhook.
• Google OAuth precisa de Redirect URI exatamente igual ao cadastrado no Google Cloud.
• O Google Ads Lead Form webhook valida google_key e deduplica por lead_id.
• Faça backup do banco e arquivos antes de cada atualização.

14

Privacidade e conformidade

As integrações devem ser configuradas com o menor acesso necessário e de acordo com a Política de Privacidade pública do Filed OPS. Google OAuth usa os escopos calendar.events para eventos de agenda e adwords para Google Ads/Local Services. O uso de dados do Google segue a Google API Services User Data Policy, incluindo Limited Use. Meta/WhatsApp exigem avisos, permissões e consentimentos adequados; o cliente é responsável pela base legal dos dados que importa para o CRM.

• Antes de publicar o OAuth do Google, mantenha Home, Política de Privacidade, Termos e domínio autorizado em filedopscrm.com e verifique a propriedade do domínio no Search Console.
• No Google Auth Platform, declare somente os escopos realmente usados e envie o app para verificação quando os escopos sensíveis exigirem.
• Use /exclusao-de-dados como página pública para pedidos de exclusão; desconectar uma integração interrompe novas sincronizações, mas não apaga automaticamente dados já importados.
• Para Meta/Facebook/Instagram, use a URL pública de exclusão de dados no painel do App e mantenha as permissões aprovadas para produção.
• Para WhatsApp, obtenha opt-in adequado antes de iniciar mensagens e respeite pedidos de bloqueio/opt-out.
• Tokens e segredos nunca devem ser enviados por e-mail ou inseridos em documentação pública.