FotoAssist

Manual do Usuario — Assistente WhatsApp para Fotografos

v1.0 — MVP

Indice

  1. Visao Geral do Sistema
  2. Pipeline de Vendas (6 Estagios)
  3. Tela de Login
  4. Painel de Conversas
  5. Chat da Conversa
  6. Servicos e Precificacao
  7. Prompts do Pipeline
  8. Configuracoes
  9. Midias do Pipeline
  10. Variaveis Dinamicas
  11. Comandos WhatsApp
  12. Guia de Primeiro Uso

Visao Geral

O que e o FotoAssist e como ele funciona

O FotoAssist e um assistente inteligente que atende seus clientes pelo WhatsApp de forma automatica. Ele conduz o cliente por um pipeline de vendas em 6 estagios — desde o primeiro contato ate o envio do contrato e dados de pagamento.


A atendente virtual (configuravel — ex: "Julia") conversa com naturalidade, descobre o tipo de evento, verifica sua agenda, apresenta seu trabalho, envia orcamento com pacotes reais e fecha a venda. Voce supervisiona tudo pelo painel e pode intervir a qualquer momento.

Atendimento Automatico

IA responde clientes no WhatsApp 24h por dia, com tom profissional e emocional.

Agenda Integrada

Consulta seu Google Calendar automaticamente para verificar disponibilidade.

Pacotes Reais

IA nunca inventa precos — apresenta apenas os pacotes cadastrados por voce.

Prompts Editaveis

Personalize o que a IA diz em cada estagio sem mexer em codigo.

Modo Hibrido: Cada conversa pode operar em modo IA Ativa ou Manual. Voce alterna com um clique no painel.

Pipeline de Vendas

Os 6 estagios que conduzem o cliente ate o contrato

1 Boas-vindas Descobre evento e data
2 Coleta Duracao e local
3 Apresentacao Protocolo de trabalho
4 Orcamento Pacotes e precos
5 Fechamento Confirma interesse
6 Contrato Link + PIX
Estagio Missao da IA Dados Extraidos
Boas-vindas Recepcionar, descobrir tipo de evento e data desejada Nome, tipo de evento, data
Coleta Confirmar agenda, coletar duracao e local Duracao, local
Apresentacao Apresentar protocolo de trabalho em 4 blocos
Orcamento Apresentar pacotes filtrados com linguagem emocional Pacote escolhido, upgrades
Fechamento Confirmar interesse e encaminhar para contrato
Contrato Enviar link do contrato, chave PIX, instrucoes

Transicao automatica: A IA avanca de estagio sozinha quando coleta os dados necessarios. Voce tambem pode avancar ou retroceder manualmente pelo painel.

Tela de Login

Acesso seguro ao painel

fotoassist.vercel.app/login
FotoAssist
Painel de atendimento
Email
seu@email.com
Senha
********
Entrar

Como funciona

  • Acesse o endereco do seu painel (ex: seudominio.com)
  • Digite o email e senha cadastrados
  • O login usa JWT em cookie seguro — sem dados salvos no navegador
  • A sessao dura 7 dias. Apos isso, faca login novamente

Painel de Conversas

Pagina inicial — todas as conversas do WhatsApp

fotoassist.vercel.app
Conversas
Atendimento e vendas via WhatsApp
Total de Conversas 12
Conversas Ativas 5
Nao Lidas 3
M
Maria Silva 5min
Oi, quero saber sobre ensaio de casal...
Coletando IA
J
Joao Santos 2h
Perfeito! Vou preencher o contrato
Contrato IA
A
Ana Costa 1d
Quanto custa o pacote de casamento?
Orcamento Manual

Elementos da tela

  • Cards de estatisticas: Total de conversas, ativas e nao lidas — atualizados em tempo real
  • Avatar: Inicial do nome do cliente com borda dourada
  • Tempo: Quanto tempo faz desde a ultima mensagem (agora, 5min, 2h, 1d)
  • Badge de estagio: Coletando Orcamento Contrato — mostra em que ponto da venda o cliente esta
  • Badge de modo: IA = resposta automatica | Manual = voce responde
  • Atualizacao automatica: A lista atualiza a cada 10 segundos sem recarregar a pagina

Chat da Conversa

Visualizar e interagir com cada conversa

fotoassist.vercel.app/conversations/1
M
Maria Silva
5532988288694
IA Ativa
Boas-vindas Coletando Apresentacao Orcamento
Evento: Casamento Data: 15/06/2026
Oi, boa tarde! Quero saber sobre cobertura de casamento
14:32
Oi Maria! Que alegria receber voce! Parabens pelo casamento! Quando sera o grande dia?
14:32
Sera dia 15 de junho, em Juiz de Fora
14:35
Maravilha! Deixa eu verificar minha agenda... O dia 15/06 esta livre! Quanto tempo de cobertura voce precisa?
14:35

Funcionalidades do Chat

  • Barra de estagios: Mostra o estagio atual (dourado) e os anteriores (verde). Clique em qualquer estagio para mover a conversa manualmente
  • Dados do cliente: As informacoes que a IA ja coletou aparecem como etiquetas abaixo da barra de estagios
  • Bolhas de mensagem: Mensagens recebidas (escuras) a esquerda, enviadas (douradas) a direita
  • Botao de modo: Clique em IA Ativa para alternar para Manual e vice-versa
  • Envio manual: Use o campo de texto na parte inferior para enviar mensagens manualmente (funciona em ambos os modos)
  • Atualizacao: Novas mensagens aparecem automaticamente a cada 5 segundos
  • Mensagens agrupadas: Se o cliente enviar varias mensagens seguidas (ex: "Oi", "Quero saber sobre casamento", "Dia 15 de junho"), a IA espera 15 segundos apos a ultima mensagem para ler tudo junto e dar uma unica resposta coerente — assim como voce faria numa conversa real

Agrupamento inteligente: No WhatsApp, e comum o cliente enviar varias mensagens curtas em sequencia. O FotoAssist acumula todas essas mensagens e aguarda 15 segundos de silencio antes de responder. Assim a IA le tudo junto, entende o contexto completo e responde de forma natural — podendo inclusive responder em 2 ou 3 mensagens separadas, como numa conversa real.

Servicos e Precificacao

Motor de calculos, pacotes e upgrades — tudo em um lugar

fotoassist.vercel.app/services
Motor Ensaio
Taxa de sessao: R$ 400
Preco por foto: R$ 25
Ao salvar, recalcula automaticamente todos os pacotes de ensaio
Motor Cobertura
Valor hora base: R$ 700
Minimo de horas: 4h
Ao salvar, gera precos para coberturas de 3h a 8h
Pacotes Cadastrados
+ Novo Pacote
Ensaio 30 fotos
R$ 1.150
Motor: 400 + 30×25
Ensaio
Casamento 6h
R$ 4.200
Cobertura base
Casamento

Motor de Precificacao de Ensaio

Defina dois valores e o sistema calcula automaticamente o preco de todos os pacotes de ensaio:


  • Taxa de Sessao: Valor fixo cobrado por cada sessao (independente do numero de fotos)
  • Preco por Foto: Valor adicional por foto editada inclusa no pacote

Formula: Preco = Taxa de Sessao + (Qtd. Fotos × Preco por Foto)


Ao clicar em Salvar, o sistema recalcula automaticamente todos os pacotes que tenham Quantidade de Fotos preenchida.

Motor de Precificacao de Cobertura

Defina o valor-hora e o minimo de horas. O sistema gera automaticamente uma tabela de precos de 3h a 8h.


  • Valor Hora Base: Preco por hora de cobertura
  • Minimo de Horas: Numero minimo de horas para contratar cobertura

Ao salvar, a IA usa esses valores como referencia no estagio de orcamento. Nunca inventa precos — usa exatamente o que esta configurado aqui.

Cadastro de Pacotes

  • Nome: Nome curto do pacote (ex: "Casamento 6h")
  • Descricao: Descricao breve do que inclui
  • Preco (R$): Valor do pacote — a IA nunca inventa, usa exatamente este valor
  • Quantidade de Fotos: Preencha nos pacotes de ensaio para o motor calcular automaticamente
  • Inclui: Lista de itens, um por linha (fotos, video, album, etc.)
  • Prazo de entrega: Em dias uteis
  • Tipos de evento: Para quais eventos esse pacote aparece (Casamento, Ensaio, Evento, Formatura, Festa Infantil). Vazio = aparece para todos
  • Upgrade: Marque se for complemento/adicional (entrega premium, album extra, etc.)

Filtragem automatica: No estagio de orcamento, a IA mostra apenas os pacotes compativeis com o tipo de evento do cliente. Ex: se o cliente quer um ensaio, nao vera pacotes de casamento.

Prompts do Pipeline

Personalize o comportamento da IA em cada estagio

Como funciona o sistema de prompts

Cada estagio do pipeline tem um prompt (instrucao) que define o que a IA deve fazer. O sistema monta a mensagem para a IA em 4 camadas:


CamadaOrigemFuncao
1 Prompt da IA (Configuracoes) Persona e regras globais — vale para todos os estagios
2 Identidade (automatica) "Voce e Julia, atendente do estudio..." — gerado pelo sistema
3 Prompt do Pipeline Missao especifica do estagio — este voce edita
4 Formato JSON (fixo) Estrutura de resposta (reply, stage_complete, etc.)

Editando prompts

  • Clique em "Editar" ao lado do estagio desejado
  • Use as variaveis dinamicas clicando nos botoes acima do editor (ex: {{dadosCliente}})
  • Clique em "Salvar" — a mudanca vale imediatamente para novas mensagens
  • Use "Restaurar" para voltar ao prompt original de fabrica a qualquer momento

Historico de Versoes

Cada vez que voce salva um prompt, a versao anterior e guardada automaticamente. Voce pode ver e restaurar versoes anteriores a qualquer momento.


  • Clique em "Historico" ao lado do estagio para ver as versoes salvas
  • Cada versao mostra data e hora do salvamento e um preview do texto
  • Clique em "Restaurar esta versao" para voltar a qualquer versao anterior
  • O sistema guarda as ultimas 10 versoes por estagio — versoes mais antigas sao removidas automaticamente
  • Ao restaurar, a versao atual e salva no historico antes de ser substituida

Dica: Teste suas mudancas mandando uma mensagem no WhatsApp (use o modo teste com seu proprio numero). Se o resultado nao for o esperado, use o historico para reverter rapidamente.

Configuracoes

Configure o assistente, agenda, pagamento e midias

Secao: Geral

  • Nome do Negocio: Nome do seu estudio (aparece na identidade da IA)
  • Nome da Atendente Virtual: Como a IA se apresenta (ex: "Julia")
  • Google Calendar: Cole o link iCal publico da sua agenda. A IA verifica automaticamente quais datas e horarios estao ocupados
  • Intervalo entre eventos: Tempo minimo (em minutos) entre o fim de um evento e o inicio do proximo. Padrao: 120 minutos (2 horas). Ajuste conforme sua necessidade de deslocamento e preparacao
  • Link do Contrato: URL do formulario de contrato (Google Forms, JotForm, etc.)
  • IA responde automaticamente: Ative/desative a resposta automatica globalmente
  • Numeros de Teste: Quando preenchido, a IA so responde esses numeros. Ideal para testar sem afetar clientes reais

Secao: Prompt da IA

Instrucoes extras que valem para todos os estagios. Aqui voce define a personalidade global da IA.


Exemplos:

  • "Sempre trate o cliente pelo nome"
  • "Nao ofereca desconto sem confirmar com o fotografo"
  • "Use linguagem emocional e empolgante"

Secao: Pagamento

  • Chave PIX: CPF, email, telefone ou chave aleatoria — enviada pela IA no estagio de contrato
  • Instrucoes de Pagamento: Ex: "50% de entrada para reservar a data, restante ate o dia do evento"

Midias do Pipeline

Videos, imagens e PDFs enviados automaticamente em cada estagio

Como funciona

Voce pode cadastrar midias (videos, imagens, PDFs) para cada estagio do pipeline. Quando a conversa chega naquele estagio, a IA envia as midias automaticamente.


Exemplo de uso:

  • Apresentacao: Video mostrando seu trabalho, portfolio em PDF
  • Orcamento: Tabela de precos em imagem
  • Fechamento: Depoimentos de clientes em video
  • Contrato: PDF com termos e condicoes

Campos de cada midia

  • Estagio: Em qual etapa enviar (Apresentacao, Orcamento, Fechamento, Contrato)
  • Tipo: Video, Imagem ou Documento (PDF)
  • URL: Link publico da midia (hospedada em Google Drive, YouTube, etc.)
  • Legenda: Texto opcional enviado junto com a midia
  • Ordem: Numero para definir a sequencia de envio (0, 1, 2...)

Variaveis Dinamicas

Dados inseridos automaticamente nos prompts

VariavelDescricaoExemplo
{{dataHoje}}Data atual formatadaquarta-feira, 26 de marco de 2026
{{dadosCliente}}Dados ja coletados (JSON){"event_type":"casamento","event_date":"15/06"}
{{agendaDisponivel}}Datas ocupadas na agendaLista de datas do Google Calendar
{{tipoEvento}}Tipo de eventocasamento, ensaio, formatura
{{duracao}}Duracao do evento6 horas
{{dataEvento}}Data do eventono dia 15/06
{{localEvento}}Local do eventoem Juiz de Fora
{{pacotes}}Pacotes filtrados com precosLista formatada dos seus pacotes
{{linkContrato}}Link do contratoURL configurada em Settings
{{chavePix}}Chave PIXCPF, email ou chave aleatoria
{{instrucoesPagamento}}Instrucoes de pagamento50% de entrada, restante no dia

Comandos WhatsApp

Comandos especiais que podem ser enviados pelo WhatsApp

ComandoEfeito
/reset Apaga todas as mensagens da conversa, volta para o estagio de boas-vindas com dados limpos. Util para testar o fluxo do zero

Modo Teste: Configure seu numero em Configuracoes → Numeros de Teste. Enquanto ativo, a IA so responde os numeros listados — seus clientes reais nao serao afetados.

Guia de Primeiro Uso

Passo a passo para configurar e comecar a usar

1

Faca login no painel

Acesse o endereco do sistema e entre com seu email e senha.

2

Configure as informacoes basicas

Va em Configuracoes e preencha: nome do negocio, nome da atendente virtual, link do Google Calendar e link do contrato.

3

Configure o pagamento

Ainda em Configuracoes, preencha sua chave PIX e as instrucoes de pagamento.

4

Configure seus servicos e precos

Va em Servicos e configure o motor de precificacao (ensaio e cobertura) e cadastre seus pacotes reais com precos, descricoes e itens inclusos. Separe por tipo de evento se necessario.

5

Adicione midias (opcional)

Em Configuracoes → Midias do Pipeline, adicione videos e imagens que a IA envia automaticamente em cada estagio.

6

Personalize os prompts (opcional)

Va em Prompts para ajustar o tom e comportamento da IA em cada estagio. Os prompts padrao ja funcionam bem.

7

Ative o modo teste

Em Configuracoes → Numeros de Teste, coloque seu numero de WhatsApp. Assim so voce recebe respostas da IA.

8

Teste o fluxo completo

Envie uma mensagem pelo WhatsApp e acompanhe no painel. Use /reset para recomecar quantas vezes quiser.

9

Va para producao

Quando estiver satisfeito, remova seu numero do campo "Numeros de Teste" (deixe vazio). A IA passara a responder todos os clientes!