Manual de uso — Empreitada na Mão

Para quem usa o aplicativo, não para quem o constrói. Escrito na visão do cliente: o que fazer, onde, com que palavras, e o que acontece depois.

Versão deste manual: 12/09/2026 (3ª edição — os três fins da obra, termo de encerramento em PDF e WhatsApp como canal principal). Ele foi escrito a partir do código em produção — cada comando, preço e limite aqui foi conferido no fonte, não na memória. Onde o app ainda não faz alguma coisa, está dito com todas as letras, em vez de sugerido.

Regra de ouro: aqui não existe menu, nem número para digitar, nem "digite 1 para orçamento". Você conversa. O assistente entende o que você quer dizer. As poucas palavras que o aplicativo lê literalmente (sem passar pela IA) estão listadas no capítulo Comandos, no fim.

Índice

1. Onde se fala com o aplicativo
2. Personagens: quem são e o que fazem
3. Usuário geral — cadastro e consentimento
4. Usuário geral — cupom, contratação e configuração dos produtos
5. Usuário geral — apagar os dados e as consequências
6. Empreiteiro — a obra de ponta a ponta pelo WhatsApp
7. Empreiteiro — cadastrar o dono da obra e o encarregado
8. Dono da obra — como usar
9. Encarregado — como usar
10. Comandos: o que o aplicativo entende
11. Limites, franquias e o que o app não faz

1. Onde se fala com o aplicativo

O aplicativo não tem app para baixar. Não há loja, não há instalação, não há senha para começar.

2. Personagens: quem são e o que fazem

O aplicativo tem três personagens. Eles não são três aplicativos: é uma conversa só, e o bastão passa de um para o outro na mesma resposta, sem você ter de recomeçar nada.

🟣 Bia — a recepção e a triagem

Onde atende: em todos os canais (Instagram, Messenger, WhatsApp e Telegram). É ela que recebe quem ainda está conhecendo o aplicativo. Quem já chega sabendo o que quer — "quero um contrato de pintura", ou o botão de um produto no site — fala direto com o Beto no WhatsApp e no Telegram, sem passar por ela (desde 14/10/2026).

O que ela faz:

• Explica o que é o produto e para que serve, em palavras simples.
• Faz uma triagem curta (no máximo três perguntas, uma por vez): você contrata ou executa? Tem um serviço agora, faz isso com frequência ou está só conhecendo? O que quer resolver?
• Registra quem você é e o que precisa, para o time poder responder.
• Gera link de indicação, quando você quer repassar para outra pessoa.
• Chama uma pessoa de verdade quando você pede.
• Passa a conversa para o Beto quando você quer agir (montar o contrato, saber o preço da sua peça, assinar) — e o Beto responde na mesma vez, já sabendo o que você contou.

O que ela NÃO faz: ela não abre obra, não monta contrato, não dá preço de contrato, não cobra e não mexe em dinheiro. O preço da sua peça é o Beto quem diz.

🟠 Beto — a obra e o contrato

Onde atende: WhatsApp e Telegram (e recebe o bastão da Bia em qualquer canal).

O que ele faz: tudo o que é operação — abrir obra, montar orçamento, gerar e enviar contrato para assinatura, medir, registrar diário de obra, cobrar, controlar prazo e custo, vender contrato avulso, cuidar de registro de marca no INPI e fechar a assinatura do plano. Ele tem mais de cem ferramentas (o número exato está no CLAUDE.md, derivado do código), e cada uma só aparece para quem tem o papel certo (ver o capítulo Comandos).

O que ele NÃO faz, por decisão de projeto:

• Não decide sobre o seu dinheiro nem sobre os seus dados sozinho. Apagar dados e ler o seu "sim" de consentimento são feitos pelo aplicativo, antes de a IA ver a mensagem.
• Não dá opinião jurídica própria. O que ele afirma sobre uma peça vem do modelo de contrato cadastrado; quando o modelo não declara uma exigência, ele diz "por regra deste modelo" e nunca "exigência legal".
• Não garante ganho de causa, não promete que o contrato dispensa cartório quando a lei exige escritura pública, e repete o aviso de que é uma IA ao entregar qualquer documento.

🔵 Tito — a loja de IA (GEPS)

No ar desde 26/09/2026. Cuida dos produtos de IA da GEPS: os livros e pacotes de skills e prompts, o que vem dentro, em quais IAs funcionam, a instalação e o suporte de quem comprou. A Bia passa a conversa a ele quando o assunto é pacote de IA; quem chega pela ficha de IA cai direto nele. Ele não redige contrato nem vende plano: isso é do Beto — e ele passa a conversa ao Beto quando você pede contrato, ou chama uma pessoa de verdade quando você pagou e algo não chegou.

3. Usuário geral — cadastro e consentimento

3.1 Como se cadastrar (passo a passo)

Não existe formulário obrigatório. O cadastro acontece na conversa, e só quando for preciso.

1. Mande uma mensagem. Um "oi" basta, em qualquer canal. Quem atende é a Bia — ou o Beto direto, se você já disser o que quer ("quero um contrato de…").
2. Diga o que você quer. Exemplos que funcionam:

• "quero um contrato de prestação de serviço"
• "sou empreiteiro e quero controlar minha obra"
• "quanto custa?"

1. A Bia passa para o Beto quando o assunto é obra, contrato ou plano. Ele continua a mesma conversa.
2. O Beto pergunta o consentimento (texto fixo do aplicativo — ver 3.2). **Responda "sim" ou "não".**
3. Só depois do "sim" ele pede nome completo, e-mail e CPF/CNPJ — e grava.
4. Se o seu CPF/CNPJ ou e-mail já tiver cadastro, o aplicativo não liga a conversa à conta automaticamente. Ele manda um código de 6 dígitos para o e-mail já cadastrado (mostrado mascarado, tipo th****@gmail.com) e pede que você digite o código no chat.

• o código vale 15 minutos;
• você tem 5 tentativas;
• pode pedir reenvio 1 vez por minuto, até 5 vezes por hora;
• pode digitar com espaço ou hífen (123 456, 123-456).

1. Pronto. A partir daí a conversa é a sua conta: o que você comprar, abrir ou assinar fica ligado a ela.

Por que o código? Porque saber o e-mail de alguém é fácil. Se o aplicativo ligasse a conversa à conta só porque o e-mail bate, quem soubesse o seu e-mail entraria na sua conta. O código no e-mail é a prova de que a conta é sua.

3.2 Por que consentir — e o que exatamente você está autorizando

O texto da pergunta é do aplicativo, não da IA. Ele cita a finalidade, os dados, o prazo, a página legal e a versão dos Termos e da Política de Privacidade a que você está dizendo sim. O formato é este:

"Para montar e enviar o contrato, preciso guardar seu nome, e-mail e CPF/CNPJ (e telefone, se quiser). Esses dados ficam só para isso, pelo prazo da nossa política. Para apagar depois, é só me escrever 'apagar meus dados' aqui mesmo. O texto completo está em [página legal] (Termos [versão] · Privacidade [versão])."

Por que consentir:

• Sem nome, e-mail e CPF não existe contrato. O contrato qualifica as partes; a assinatura eletrônica manda o link para o e-mail do signatário (nunca para um e-mail solto digitado no chat). Sem o cadastro, o documento não pode ser emitido nem assinado.
• Sem e-mail você não recebe a via assinada, nem o link de senha do painel, nem o código de verificação.
• Consentir não é assinar cheque em branco. A finalidade está escrita na pergunta, e o seu "sim" fica gravado com data, hora e a versão dos documentos. **Se a versão mudar, você é perguntado de novo.**

Como o aplicativo lê a sua resposta (isso é feito por código, não pela IA):

• Valem como sim: sim, aceito, concordo, autorizo, de acordo, confirmo, positivo, pode guardar, pode sim. E, quando é a mensagem inteira (uma ou duas palavras): ok, claro, tudo bem, beleza, pode, pode ser, quero, fechado, combinado.
• Valem como não: não, não aceito, não quero, não autorizo, negativo, prefiro não.
• Uma negação no começo vence o sim. "Sim, mas não quero dar o CPF" é lido como não.
• Hesitação não é sim. "Ok, mas antes…", "quero pensar", "depende" seguem para o Beto com a pergunta ainda pendente.
• Pergunta não é resposta. "Isso é obrigatório?" é uma pergunta — ele responde e a pergunta continua de pé.

Se você disser NÃO: nada é gravado e nada acontece por trás. Você continua conversando, mas o aplicativo não monta contrato, não cadastra e não cobra — porque para isso ele precisaria guardar o seu dado.

3.3 O que é guardado antes do "sim"

Honestidade sobre o que existe desde o primeiro "oi": o número/identificador do canal e o texto da conversa. Sem isso não há como responder você. Essa conversa é apagada sozinha depois de 90 dias. Você não precisa esperar esse prazo: "apagar meus dados" funciona mesmo para quem nunca se cadastrou (ver capítulo 5).

4. Usuário geral — cupom, contratação e configuração dos produtos

4.1 O que dá para comprar

Preço na tela e preço cobrado saem do mesmo lugar no código. Se o Beto disser um valor, é o valor que o aplicativo cobra.

4.2 Como usar um cupom

Pelo chat (recomendado): diga o código junto com o pedido.

• "quero assinar o Pro com o cupom FUNDADORGEPS"
• "tenho um cupom, vale para o Starter?" → o Beto consulta e responde o alcance real do cupom.

Pelo navegador: o link de adesão já pode vir com o cupom embutido (/adesao?cupom=…). Quem recebeu um link de indicação não precisa digitar nada.

O que você precisa saber sobre cupom:

• Um cupom pode valer em todos os planos ou só em um (Starter ou Pro). Se der erro, é porque ele foi criado restrito — pergunte ao Beto, ele diz.
• Um cupom pode valer por N cobranças (ex.: 3 mensalidades) ou para sempre (fundador). O Beto informa quantas cobranças ainda saem com desconto — ele não promete desconto eterno por conta própria.
• A vaga de uma campanha só é consumida quando o pagamento é confirmado, não quando você clica no link. Curioso que abre o link e não paga não queima vaga de ninguém.
• Cupom não incide sobre o adicional de obra extra (decisão do dono). O desconto do plano incide sobre o plano.
• Condição de fundador: quem assina com preço travado **mantém o preço enquanto a assinatura estiver ativa**. Cancelou, perdeu. Ficou inadimplente, fica suspensa.

4.3 Como contratar um plano (passo a passo, pelo chat)

1. "quero assinar" / "quero o Pro" / "quero entrar no fundador".
2. O Beto pergunta o consentimento → você responde sim.
3. Ele pede nome completo, e-mail, CPF/CNPJ e o plano.
4. Se o CPF/e-mail já existir → código de 6 dígitos no e-mail (ver 3.1).
5. O aplicativo então, na mesma conversa:

• cria a assinatura no provedor de pagamento;
• entrega a cobrança no chat E por e-mail (Pix copia-e-cola / link);
• manda o termo em PDF;
• manda, só por e-mail, o link para criar a senha do painel (vale 48 h).

1. A senha nunca vem pelo chat. Se você perder o link, diga "link do painel" / *"esqueci a senha"* — ele reenvia ao e-mail do cadastro e diz para qual e-mail mandou (mascarado).

Como se paga: a cobrança chega sozinha todo ciclo e você escolhe a forma de cada uma — Pix, boleto ou cartão. O cartão acrescenta o débito automático; as outras formas você paga quando a cobrança chegar.

Mês pulado não some. Se você deixar de pagar e depois quiser voltar, o acesso só volta com todas as mensalidades vencidas do período pagas. Um pagamento abate, mas não destranca sozinho. A mensalidade do ciclo corrente, que ainda está no prazo, não entra nessa conta.

4.4 Como contratar um contrato avulso (passo a passo)

A ordem é: escolher a peça → decidir o timbre → pagar → entrevista → minuta → assinatura.

1. "quero um contrato de locação" / "vocês fazem contrato de sociedade?" → o Beto abre o gerador e diz os avisos obrigatórios antes de qualquer pergunta: que ele é uma IA que pode errar, que usa modelos padrão, que os dados são de sua responsabilidade, que só faz objeto lícito, e as condições de compra.
2. Ele consulta a biblioteca de peças e diz qual peça serve e quanto custa. (Ele nunca diz "não temos isso" de cabeça — ele procura.)
3. Ele abre o pedido sem cobrar nada e pode oferecer o timbre próprio. Decida aqui: aceitar ou recusar.
4. Só então sai a cobrança — UMA só, com a peça e o timbre somados. *(É de propósito: duas cobranças pagariam duas tarifas do provedor, e quem paga isso é o preço.)*
5. Pagou? A entrevista começa. O Beto pergunta o que a peça exige. O que você não souber responder vira lacuna visível (______) no documento — **ele nunca inventa um número plausível**.
6. Minuta no chat para LER, em PDF, junto com um guia de leitura (uma página, cláusula por cláusula, em português comum).
7. Você aprova → ele manda para assinatura eletrônica. **O link de cada signatário vai para o chat e o e-mail DAQUELA pessoa** — nem você recebe o link do outro, nem ele o seu.
8. Assinado por todos → ele entrega a via final no chat e por e-mail. Guarde esse e-mail: a trilha de evidências fica com o provedor de assinatura, não com o aplicativo.

Se você já tem um contrato em elaboração, pedir outro não abre um segundo nem gera um segundo Pix: ele devolve o que está em andamento.

Para sair do contrato e voltar à obra, escreva: voltar para a obra (ou minha obra, ou sair do contrato).

4.5 Documentos que você manda — o app não guarda acervo

Regra da casa: extrair, confirmar com você, apagar.

• Você pode mandar foto de RG/CNH, contrato social, nota fiscal, para preencher campo.
• O documento fica só até a assinatura e é apagado depois. Você é avisado disso antes de mandar qualquer coisa.
• Exceção: prestação de contas de obra (notas, recibos, holerites, fotos) fica **enquanto o contrato original não estiver integralmente concluído**.
• O que NÃO é apagado: o comprovante da compra (quem contratou, quando, quanto) — obrigação fiscal de quem vende.
• Se o anexo não puder ser lido, o aplicativo avisa. Ele não finge que recebeu:
• PDF enviado como documento → ele pede para fotografar a página;
• foto acima de 5 MB → ele pede para reenviar mais leve.

5. Usuário geral — apagar os dados e as consequências

5.1 Como pedir

Escreva no próprio chat, em qualquer canal, uma destas frases exatas:

`` apagar meus dados apagar os meus dados excluir meus dados excluir minha conta quero apagar meus dados /apagardados /apagar dados ``

Esse comando não passa pela IA. Ele é lido pelo aplicativo, antes do modelo. A IA não decide se apaga dado de ninguém, nem promete prazo.

5.2 O que acontece em seguida

Se você é visitante (nunca se cadastrou): é na hora. Seu nome, seu contato, o que você contou e a conversa são apagados imediatamente. Fica só uma linha sem identificação (canal e data), para estatística. Você recebe o recibo ali mesmo, e pode voltar quando quiser — basta mandar um "oi".

Se você tem cadastro: o pedido é registrado na hora, com recibo, e executado depois da conferência de identidade, em até 15 dias (LGPD art. 18, §3º). Você é avisado no chat quando terminar. Pedir duas vezes não abre dois pedidos.

Por que não é instantâneo para quem tem cadastro: porque por trás de um cadastro há obra, contrato e caixa. Apagar a linha errada levaria junto o registro de um acordo que outra pessoa tem direito de provar. A conferência existe para não destruir o que não é seu.

5.3 As consequências — leia antes de pedir

O que É apagado ou anonimizado:

• Nome, CPF/CNPJ, telefone e e-mail — o nome vira [removido a pedido do titular], os demais viram vazios.
• A senha do painel sai junto: conta anonimizada não loga mais.
• A transcrição das suas conversas.

O que FICA, e por quê:

Se você é EMPREITEIRO, leia com atenção: você é anonimizado, e a obra sobrevive. A obra, as medições e o contrato são o registro de um acordo entre você e o seu cliente — e o cliente não pediu nada e tem direito à prova do que combinou (art. 18, §4º). O que sai é a sua identificação; o que fica é o histórico, sem apontar para você.

Consequência prática: apagar os dados encerra o seu acesso. Você não entra mais no painel, não recebe mais e-mail, e não consegue pedir segunda via de nada. Baixe e guarde o que interessa antes de pedir — principalmente os e-mails do provedor de assinatura com os documentos assinados.

Onde mais está escrito: a página pública .../legal/exclusao-de-dados diz a mesma coisa, e é a URL oficial de exclusão de dados.

6. Empreiteiro — a obra de ponta a ponta pelo WhatsApp

Esta é a parte longa, e é de propósito. Tudo abaixo se faz conversando. Onde houver navegador, está dito.

Passo 0 — ter um plano

Sem assinatura ativa você não abre obra. Faça a adesão pelo chat (capítulo 4.3). Starter = 1 obra por vez. Pro = 3 obras simultâneas.

Complete o seu próprio cadastro antes de chegar no contrato — é pré-requisito para você assinar:

"atualiza meu cadastro, meu e-mail é fulano@exemplo.com e meu CPF é ..."

Passo 1 — abrir a obra

"quero abrir uma obra" · "comecei um serviço novo" · "peguei outra obra"

O Beto pergunta o apelido da obra (é por ele que ela vai ser chamada dali em diante) e, se você quiser dizer, o endereço.

Se você estiver no limite do plano:

• Pro: ele oferece a vaga extra — R$ 117 por mês, enquanto a obra durar. Não gera Pix agora: entra na próxima mensalidade e sai sozinho quando a obra encerrar. A vaga vale na hora, então você abre a obra em seguida.
• Starter: não existe vaga extra. O caminho é o Pro.

Se a obra for sua (você está construindo para si, sem cliente terceiro), declare:

"essa obra é minha" → ele marca como obra própria, e aí quem aprova o orçamento é você mesmo.

Ele nunca deduz isso. Obra de terceiro cujo cliente ainda não aceitou o convite tem exatamente a mesma cara — e deduzir seria deixar alguém aprovando orçamento no lugar do dono.

Passo 2 — montar o orçamento

Caminho guiado (recomendado para obra civil):

"quero orçar do zero" · "monta um orçamento para 120 m²"

Ele cria as etapas e os itens típicos, já com quantidade estimada pela área e preço sugerido.

Três coisas que você precisa saber sobre esses números:

1. A referência de preço é interna da casa, ajustada por fator de padrão. **Não é tabela SINAPI oficial** — o app diz isso, e você não deve dizer o contrário para o seu cliente.
2. A planilha grava UF, mês-base e regime no próprio orçamento, no dia em que ele nasce. Ela não se reescreve quando os padrões da casa mudam: o que você imprimiu continua afirmando o que afirmou.
3. Cada quantidade diz de onde veio — estimada por área, medida na planta ou informada. Quem digita por cima vira a origem. Isso sai na planilha, no PDF e quando o Beto lê os itens.

Conferir e ajustar, item por item:

"me mostra o rascunho" → lista o que está montado "adiciona 40 m² de reboco interno" "ajusta a alvenaria para 128 m²" "tira o item de forro" "detalha a etapa de fundação" "fecha o orçamento"

Cronograma:

"me mostra o cronograma" · "joga a etapa de pintura para depois do reboco"

Enquadramento CAIXA:

"esse orçamento passa na CAIXA?"

→ ele classifica nas 20 categorias do modelo oficial e diz o que ficou acima do teto ou faltando, e se o avanço está adiantado / no ritmo / atrasado.

Fatiar (quando o cliente quer contratar por partes):

"fatia em dois blocos: bloco 1 com fundação e estrutura, bloco 2 com acabamento"

→ depois cada bloco é apresentado, aprovado e contratado separadamente, e os contratos coexistem.

Passo 3 — apresentar ao dono da obra e esperar o aceite

Antes disso, o cliente precisa estar vinculado à obra (capítulo 7) e com e-mail no cadastro:

"o e-mail do cliente é maria@exemplo.com e o CPF é ..."

Então:

"apresenta o orçamento para o cliente" (ou "apresenta o bloco 1")

O aplicativo gera a planilha em PDF e entrega no chat do cliente, não no seu.

O cliente responde de um destes dois jeitos, no chat DELE:

• "aprovo o orçamento" → libera o contrato;
• "quero mudar X" → vira um pedido registrado no app, que aparece para você.

⚠️ Você não aprova por ele. Se o cliente disser "aprovei" por fora — telefone, papel, outro WhatsApp —, o Beto não aceita no lugar dele. Ele explica e manda apresentar de novo. A única exceção é a obra própria declarada.

Ver o que o cliente pediu:

"tem algum pedido do cliente?" · "resolve o pedido X"

Passo 4 — gerar e assinar o contrato

"gera o contrato"

• Só depois do aceite do orçamento. Sem aceite, não sai nem o PDF.
• A planilha entra como ANEXO I do contrato.
• Gerar um novo substitui os contratos ativos do mesmo escopo ainda não assinados (evita a fila de contratos velhos). Com fatiamento, informe o bloco: os outros ficam intactos.

"manda para assinatura"

• O aplicativo materializa o PDF e entrega o link de cada signatário no chat e no e-mail DELE. Você não recebe a URL de ninguém — o link de uma pessoa assina no lugar dela. Você recebe o relatório da entrega.
• Pré-requisitos: orçamento aprovado + e-mail no cadastro de cada signatário.

"já assinaram?" → ele consulta o provedor ao vivo e diz quem assinou. "me entrega o contrato assinado" → baixa a via final e manda a cada parte.

Passo 5 — tocar a obra no dia a dia

Diário de obra (RDO):

"RDO de hoje: concretamos a laje do térreo, equipe de 6, tempo bom, sem ocorrência"

→ as fotos que vierem na mesma mensagem ficam anexadas ao RDO automaticamente. Registre só o que já aconteceu; programação futura não é RDO.

"me mostra os RDOs" → lista do mais recente ao mais antigo, com data, etapa, avanço, tarefas, clima, ocorrências e quantas fotos.

Execução (alimenta o realizado):

"executei 60 m² de alvenaria" · "a etapa de fundação está 80% pronta"

Checklist:

"liga o checklist da obra" (desligado, o encarregado relata em texto livre) "a tarefa de amanhã é armar a laje" · "marca a tarefa X como feita" · "mostra o checklist"

Acompanhamento:

"como está a obra?" → situação da medição "relatório da obra" → etapas com estado, percentual, valores e as partes "controle da obra" → previsto × revisado × realizado: valor previsto, escopo com aditivos, valor executado, custo real, avanço físico, desvio de custo (CPI) e status de prazo (no prazo / atrasado)

Passo 6 — medir (o ritmo da semana)

A obra para na sexta. O ritmo é fixo e o aplicativo o conduz sozinho:

Medição que você não fechou NÃO vai para o cliente. Número que o responsável não assinou embaixo não se manda.

Como registrar:

"medição: fundação 100%, alvenaria 45%"

• Etapas medidas no MESMO dia contam como UMA medição para o ritmo semanal. Se a leva da semana cobre duas etapas, registre as duas hoje.
• Com aceite do executor, o realizado da etapa passa a ser o percentual medido.
• Registrar medição NÃO tem limite. Meça quantas vezes precisar, todo dia se for o caso: o registro do andamento é o coração da obra. **O que é semanal é o RELATÓRIO que vai ao dono da obra** — sexta às 12h o Beto cobra a sua revisão, sexta às 19h ele entrega a medição concluída. E você pode adiantar quando quiser: "manda a medição pra ela".

"manda a medição para o cliente" → entrega a última medição concluída.

Se o dono da obra perguntar antes da sexta, o aplicativo repassa a última concluída dizendo com todas as letras que uma nova ainda será fechada — e já avisa você de que pediram atualização. Você não precisa mandar esse aviso na mão.

Passo 7 — serviço extra (aditivo)

"cria um aditivo de R$ 4.500 para impermeabilizar a laje"

• O aditivo nasce PENDENTE e trava a execução do extra até a aprovação.
• Quem aprova é normalmente o cliente, porque muda o valor.
• Limite: 1 aditivo por obra a cada 30 dias.

Passo 8 — dinheiro

O dinheiro da obra é SEU. Ponto.

O padrão do aplicativo é pix_empreiteiro: você diz "quero receber no meu Pix, minha chave é ..." e, daí em diante, o cliente paga direto na sua chave. O dinheiro não passa pela plataforma — nós não recebemos, não retemos e não repassamos nada. A baixa é por comprovante, porque não existe aviso automático de um Pix que não é nosso.

Cobrar o dono da obra:

"cobra R$ 12.000 da etapa de fundação"

→ o Beto manda ao dono da obra uma mensagem com a SUA chave Pix e o valor daquela etapa, e registra a cobrança para você acompanhar. Não é cobrança emitida pela plataforma: não há boleto, não há link de pagamento nosso e não há tarifa. Quando o dinheiro cair, você diz "o cliente pagou R$ 5.000 por Pix ontem" e o Beto dá a baixa.

Exige cliente vinculado com e-mail ou CPF no cadastro.

E se eu QUISER que a plataforma cuide do dinheiro?

Aí é outro serviço, combinado à parte — não é o que você contrata ao assinar o plano. Ele existe no aplicativo (asaas_split, com a sua carteira no provedor: o pagamento do cliente é dividido na hora, a sua fatia cai na sua conta e a comissão da gestão fica com a casa), mas só entra em vigor se você pedir e combinarmos. Fale com o time antes de configurar.

⚠️ Configuração incompleta PARA a cobrança. Chave Pix faltando, ou split escolhido sem a carteira, fazem o aplicativo recusar com o motivo escrito. Ele nunca desvia calado para a conta da casa — essa é a regra mais importante desta página.

"quais cobranças estão em aberto?" / "confere os pagamentos"

→ sempre pergunte isso em vez de confiar na memória da conversa. conferidas: 0 não é defeito — significa que não há cobrança em aberto.

Registrar pagamento que entrou por fora:

"o cliente pagou R$ 5.000 por Pix ontem"

Desembolso e caixa:

"registra o desembolso da entrada da etapa de alvenaria" "como está o caixa da obra?"

Passo 9 — franquia de mensagens

Só vale para o WhatsApp. No Telegram é ilimitado.

"quantas mensagens sobraram?"

Quando estiver perto do fim, o Beto avisa em uma frase e oferece a recarga:

"quero mais mensagens" → R$ 37 por 100, avulso, paga uma vez, vale até acabar. Não é mensalidade nova. As mensagens entram quando o pagamento cair.

Se você só quer gastar menos, o caminho honesto é conversar pelo Telegram. O aplicativo diz isso.

Passo 10 — encerrar a obra

"acabou a obra" · "encerra a obra" · "a obra foi entregue" · "quero concluir a obra" (e, para os outros dois fins: "arquiva essa obra" · "quero rescindir")

Quem tem a última palavra é o dono da obra. Se a obra tem dono cadastrado, o seu "acabou" é um pedido: o aplicativo avisa o dono, explica que a garantia vai começar e espera a confirmação dele. Enquanto ele não confirmar, a obra continua aberta e a vaga do plano continua ocupada — e o Beto te diz isso, em vez de fingir que fechou. Em obra própria (sem dono cadastrado), encerra na hora.

O que acontece quando a obra encerra:

1. o aplicativo fecha as etapas que faltam de uma vez;
2. abre a garantia de 90 dias e diz até que data ela vale;
3. a obra sai de "em execução" e libera a vaga no seu plano;
4. **se essa obra ocupava uma vaga extra, o adicional de R$ 117 sai da próxima mensalidade sozinho** — você não precisa pedir nem cancelar nada.

Também dá para encerrar pelo painel, no navegador: /painel → abrir a obra → Encerrar obra. É o mesmo comando, com confirmação antes.

Se ele recusar, ele diz exatamente o que falta, etapa por etapa. As três recusas possíveis:

Uma etapa que nunca saiu do papel aceita os dois caminhos: tocar até a medição, ou cancelar a etapa se ela não vai mais acontecer.

O TERMO DE ENCERRAMENTO em PDF vai para VOCÊS DOIS, no chat, na hora. É o papel que prova que acabou e que diz quando a garantia começa e quando vence — você não precisa reenviar nada ao dono da obra, o aplicativo já entrega a ele. (Se por algum motivo não conseguir entregar, ele avisa você.)

O que o termo NÃO é: ele não é quitação nem recibo. O padrão deste produto é o cliente pagar direto na sua chave Pix, e o aplicativo não testemunha esse dinheiro — dizer "está tudo pago" sobre o que não vimos seria escrever um documento contra quem confiou nele.

O que o termo NÃO é: ele não é quitação nem recibo. Boa parte dos pagamentos desta obra pode ter sido feita direto entre vocês, fora do aplicativo — o sistema não viu esse dinheiro e, por isso, não declara que nada mais é devido. Acertos pendentes continuam valendo entre as partes.

Depois de encerrada, a obra continua visível e consultável — o que muda é que ela não ocupa mais vaga e a garantia passa a correr. Dentro da garantia, um chamado reabre o atendimento sem orçamento novo.

Os três fins de uma obra — e por que não dá para usar um pelo outro

Arquivar é para obra aberta por engano, cliente que sumiu antes de fechar, orçamento que não virou nada. O motivo é obrigatório — o aplicativo pergunta. E ele recusa arquivar quando há contrato assinado, pagamento recebido ou medição registrada: aí a obra aconteceu, e o caminho é encerrar ou rescindir. Isso não é burocracia — é o que impede que uma obra com compromisso vivo suma da lista onde a outra parte tem direito de encontrá-la.

Rescindir é o caminho de quando a obra parou no meio e vocês vão acertar contas.

1. Diga "quero rescindir essa obra, culpa do cliente" (ou "culpa minha").
2. O aplicativo mostra uma prévia com os números que ele tem: serviço prestado, total contratado, já pago, retenção, devolução e multa.
3. Leia a prévia com atenção, principalmente esta ressalva: *pagamento feito direto na sua chave Pix, sem cobrança emitida aqui, não aparece nesses totais*.
4. Só depois do seu sim ele grava. A rescisão não se desfaz.

As duas também estão no painel, na tela da obra. A rescisão não substitui acordo entre as partes nem afasta reparação civil.

7. Empreiteiro — cadastrar o dono da obra e o encarregado

7.1 Como funciona o convite

Não existe "cadastrar uma pessoa". Existe convidar para a obra — e a pessoa entra sozinha, com os dados dela.

"convida o cliente para a obra" "gera um convite de encarregado" "convida meu sócio como empreiteiro"

O aplicativo devolve um link e um código de 7 letras/números.

O que você faz: manda o link para a pessoa. Ela toca e já entra. Cite o código só como alternativa ("se preferir digitar"). O código não tem 0, O, 1, I nem L — justamente para ninguém errar ao digitar.

Nunca mande a pessoa "procurar o bot". O link já leva.

7.2 Os papéis que você pode dar

Uma pessoa pode ter mais de um papel na mesma obra — e nesse caso ela enxerga a união das ferramentas dos papéis dela.

⚠️ Convite nunca concede ADMIN. Nenhum código de convite dá acesso de administrador da plataforma.

7.3 Completar o cadastro do cliente

Depois que ele aceitar o convite:

"o e-mail do cliente é maria@exemplo.com, CPF ..."

É pré-requisito para mandar o contrato para assinatura, porque o e-mail do signatário sai do cadastro, nunca de um texto solto no chat. Atualiza só o que você informar.

7.4 Convite de obra ≠ link de adesão

São coisas diferentes, e confundir custa dinheiro:

Peça "quero indicar alguém" / "link para cadastrar" quando for o segundo caso.

8. Dono da obra — como usar

Você não precisa de senha, nem de plano, nem de cadastro prévio. Você entra pelo convite do empreiteiro e conversa pelo mesmo WhatsApp ou Telegram de sempre.

8.1 Entrar

1. Toque no link que o empreiteiro mandou (ou cole o código de 7 caracteres no chat).
2. O aplicativo liga você à obra e passa a chamá-la pelo apelido.

8.2 O que você pode fazer

8.3 O que você NÃO faz

Você não abre obra, não monta orçamento, não gera contrato, não mede e não cobra. Isso é do empreiteiro. Se algo estiver errado, o caminho é registrar o pedido no app — ele fica gravado, e é isso que protege os dois lados.

9. Encarregado — como usar

Você é quem está no canteiro. O seu papel é alimentar o Beto, não administrar a obra.

9.1 Entrar

Igual ao dono da obra: toque no link do convite (ou cole o código de 7 caracteres).

9.2 O que você faz

O que você NÃO faz: falar com o dono da obra em nome do empreiteiro. Você mede; quem entrega a medição ao dono da obra é o empreiteiro. A medição que chega ao cliente é a palavra da empresa sobre o que foi feito, e quem responde por ela é quem assinou o contrato com ele.

9.3 O que você NÃO faz

Não abre obra, não monta nem fecha orçamento, não gera contrato, não cobra ninguém e não aprova aditivo. Registrar o que aconteceu é o seu trabalho aqui — e é o registro que vira medição, que vira pagamento.

10. Comandos: o que o aplicativo entende

10.1 As palavras que o app lê LITERALMENTE (não passam pela IA)

Estas são as únicas que precisam ser escritas assim:

Todo o resto é conversa normal. Não decore nada.

10.2 O que cada papel pode pedir (o mapa completo)

O Beto tem mais de cem ferramentas (número exato no CLAUDE.md). Cada uma só existe para quem tem o papel certo — e isso não é uma sugestão: é conferido antes de qualquer coisa acontecer.

Exclusivo do empreiteiro (46 ferramentas): abrir obra · encerrar obra · arquivar obra · rescindir obra · abrir e fechar orçamento · orçamento guiado · adicionar / ajustar / remover item · detalhar e remover etapa · cronograma · fatiar · enquadramento CAIXA · apresentar orçamento ao cliente · gerar / cancelar contrato · enviar para assinatura · entregar via assinada · gerar cobrança · conferir pagamentos · registrar pagamento manual · registrar desembolso · criar aditivo · convidar para a obra · marcar obra própria · assumir obra · completar cadastro do cliente · ativar checklist e definir tarefa · ver e resolver pedidos · aderir ao plano · link do painel · link de indicação · comprar pacote de mensagens · contratar obra extra · cobranças da plataforma.

Exclusivo do dono da obra (1): registrar pedido — a contraproposta dele, gravada no app.

Do empreiteiro e do encarregado (8): RDO · execução · medição · enviar medição ao cliente · checklist (ver e marcar) · saldo de mensagens · definir recebimento.

Do empreiteiro e do dono da obra (9): relatório · controle · ver cobranças · ver contrato · abrir contrato · ver medição · aceitar orçamento · aprovar aditivo · link da minha obra.

De todo mundo (25): status da obra · ver RDOs · atualizar o próprio cadastro · apresentar o produto · toda a linha de contrato avulso (gerador, biblioteca de peças, cadastro do comprador, abrir, cobrar, consentimento, situação, montar, entregar minuta, enviar, entregar assinado, timbre próprio, ver contratos) · toda a linha de registro de marca no INPI (orientação, calcular, gravar, propostas, dossiê) · aderir ao plano.

10.3 As ferramentas da Bia (6)

Ela é curta de propósito — o poder dela é conversar, não operar o aplicativo:

registrar_interesse (quem é você, o que precisa e o ritmo de obra) · consultar_planos (preço do plano de obra, só se você perguntar) · gerar_link_adesao (link de indicação para repassar) · passar_para_o_beto (quando você quer agir: contrato, preço da peça, plano) · passar_para_o_tito (pacotes de IA) · falar_com_humano (chamar uma pessoa de verdade).

11. Limites, franquias e o que o app não faz

11.1 Limites por obra — são o contrato do plano, não defeito

Quando a ferramenta recusar por limite, ela já diz a data em que a vaga volta. Se você precisa de mais do que isso, o caminho é falar com o time — não insistir no aplicativo.

11.2 O que o aplicativo NÃO faz (e não vai fingir que faz)

• Não guarda acervo de documentos seus (só até a assinatura; prestação de contas é a exceção).
• Não guarda a trilha de assinatura — ela é do provedor, e chega por e-mail a cada parte. Guarde esse e-mail.
• Não protocola marca no INPI — a consultoria monta o dossiê; o protocolo no e-INPI é humano.
• Não garante resultado jurídico. Não promete ganho de causa e não dispensa cartório quando a lei exige escritura pública.
• Não inventa número. Dado que você não informou vira lacuna visível (______) no documento.
• Não afirma que assinaram sem consultar o provedor ao vivo. Se o provedor não responder, ele diz que não conseguiu conferir — e não apresenta o status guardado como conferência.
• Não emite recibo de quitação. O termo de encerramento prova que a obra acabou, não que o dinheiro foi todo pago — porque boa parte dele passa direto entre as partes e o aplicativo não o testemunha.

11.3 Se algo der errado

Documento gerado a partir do código em produção do Empreitada na Mão. Os preços, prazos e limites citados são os padrões do sistema e podem ser ajustados pelo administrador da plataforma — em caso de divergência, vale o que o assistente informar na conversa, porque ele lê o valor em vigor.