Documentação - Sistema de Automação Bella Aesthetics

💎 Sistema de Automação Bella Aesthetics

Documentação Técnica Completa - Typebot v1.0

📋 Visão Geral do Projeto

🎯 Objetivo

Automatizar o atendimento de clientes da clínica de estética com agendamentos, cancelamentos, consulta de procedimentos estéticos e valores através do Typebot.

👥 Público-alvo

Clientes da clínica de estética Bella Aesthetics que buscam informações sobre tratamentos estéticos e agendamentos via WhatsApp.

🕐 Tempo de Resposta

Imediato (0 minutos) para o menu inicial, com timeout padrão de 30 segundos por interação.

📱 Plataforma

Typebot integrado com WhatsApp Business API, otimizado para dispositivos móveis.

                🌟 Principais Funcionalidades
                Menu Interativo: 6 opções principais de navegação
Agendamento Inteligente: Coleta de dados e validação automática
Cancelamento com Taxas: Sistema de cobrança baseado em tempo
Catálogo de Procedimentos: Tratamentos estéticos com preços detalhados
Geração de PIX: Pagamentos automáticos para taxas
Informações Completas: Dados da clínica, especialistas e convênios

            

🏗️ Arquitetura dos Fluxos

🏠

Fluxo Principal - Menu Inicial

Ponto de entrada do sistema com 6 opções principais

💎 Olá! Bem-vinda(o) à Bella Aesthetics! 

Sou sua assistente virtual e estou aqui para ajudá-la(o) com nossos tratamentos de beleza. 

Por favor, escolha uma das opções abaixo digitando o número correspondente:

2️⃣ - Agendar Tratamento
3️⃣ - Cancelar Agendamento
4️⃣ - Visualizar Agendamento
5️⃣ - Ver Tratamentos e Valores
6️⃣ - Informações da Clínica

Digite apenas o número da opção desejada.

💅 Fluxo 2: Agendar Tratamento ▼

2.1 Submenu de Agendamento

2.1 - Avaliação Estética R$ 80,00 45 min

2.2 - Limpeza de Pele R$ 120,00 60 min

2.3 - Botox R$ 800,00 30 min

2.4 - Preenchimento R$ 1.200,00 45 min

2.2 Coleta de Dados

Nome completo: Validação mínimo 2 palavras
Telefone: Formato (XX) XXXXX-XXXX
Data preferencial: Apenas datas futuras
Horário: 09:00 às 18:00
Especialista preferido: Opcional

❌ Fluxo 3: Cancelar Agendamento ▼

⚠️ Sistema de Taxas de Cancelamento

+48 horas: Cancelamento GRATUITO
24-48 horas: Taxa de R$ 50,00
-24 horas: Taxa de 50% do valor
Não comparecimento: Taxa integral do tratamento

Fluxos de Cancelamento:

3.3 - Sem Taxa (+48h)

Cancelamento gratuito com opção de remarcação

3.4 - Taxa Básica (24-48h)

Geração automática de PIX para R$ 50,00

3.5 - Taxa 50% (-24h)

Cobrança de 50% do valor do tratamento

3.6 - Não Comparecimento

Cobrança do valor integral do tratamento

👁️ Fluxo 4: Visualizar Agendamento ▼

Permite ao cliente consultar seus agendamentos através do telefone cadastrado, exibindo:

Data e horário do tratamento
Especialista responsável
Tratamento agendado
Valor do procedimento
Instruções pré-tratamento
Endereço da clínica

💅 Tratamentos e Valores

✨ Tratamentos Faciais

🧼 Limpeza de Pele Profunda

Descrição: Remoção de cravos, células mortas e hidratação profunda

Valor: R$ 200,00 - R$ 400,00 Duração: 40 min

Indicação: Flacidez e celulite

💪 Ultrassom Microfocado

Descrição: Lifting não invasivo com ultrassom

Valor: R$ 1.800,00 - R$ 3.500,00 Duração: 90 min

Indicação: Flacidez facial e corporal

⚡ Carboxiterapia

Descrição: Aplicação de CO2 para melhorar circulação

Valor: R$ 150,00 - R$ 300,00 Duração: 30 min

Indicação: Celulite, estrias e olheiras

💡 Tratamentos a Laser

🌟 Laser CO2 Fracionado

Descrição: Renovação da pele com laser para cicatrizes e rugas

Valor: R$ 800,00 - R$ 1.500,00 Duração: 45 min

Indicação: Cicatrizes de acne, rugas profundas

🎯 Laser para Manchas

Descrição: Remoção de manchas e melasma

Valor: R$ 300,00 - R$ 600,00 Duração: 30 min

Indicação: Melasma, manchas solares

🚫 Depilação a Laser

Descrição: Remoção definitiva de pelos indesejados

Valor: R$ 80,00 - R$ 500,00 Duração: 15-60 min

Áreas: Buço, axila, virilha, pernas, costas

👁️ Tratamentos para Olhos

💤 Tratamento de Olheiras

Descrição: Clareamento e melhora da textura da região

Valor: R$ 200,00 - R$ 500,00 Duração: 30 min

Técnicas: Peeling, carboxiterapia, preenchimento

👀 Lifting de Pálpebras não Cirúrgico

Descrição: Rejuvenescimento da região dos olhos

Valor: R$ 800,00 - R$ 1.500,00 Duração: 60 min

Técnicas: Radiofrequência + plasma

💳 Formas de Pagamento

À Vista (PIX/Dinheiro)

15% de desconto em todos os tratamentos

Cartão de Débito

10% de desconto

Cartão de Crédito

Até 6x sem juros | 7x a 12x com juros

Pacotes Promocionais

Desconto progressivo: 3 sessões (10%), 5 sessões (15%), 10 sessões (25%)

⚙️ Especificações Técnicas

🔧 Configurações do Typebot

Timeout Padrão

30 segundos

Retorno Automático

Menu Principal

Banco de Dados

SQLite/PostgreSQL

Integração

WhatsApp Business API

💻 Variáveis do Sistema Estético

// Dados do cliente
{{client_name}}
{{client_phone}}
{{client_email}}
{{client_skin_type}}

// Dados do agendamento
{{appointment_date}}
{{appointment_time}}
{{treatment_type}}
{{specialist_name}}
{{treatment_value}}
{{treatment_duration}}

// Controle de cancelamento (específico para estética)
{{hours_until_appointment}}
{{cancellation_fee_type}} // "free", "basic", "50%", "full"
{{cancellation_amount}}
{{pix_code_basic}} // R$ 50
{{pix_code_50_percent}} // 50% do valor
{{pix_code_full}} // Valor integral
{{payment_status}}

// Informações específicas da estética
{{pre_treatment_instructions}}
{{post_treatment_care}}
{{contraindications}}
{{expected_results}}

🔍 Validações Específicas da Estética

Validação Temporal para Cancelamento Estético ▼

// Sistema de taxas mais rigoroso para tratamentos estéticos
const now = new Date();
const appointmentDateTime = new Date(appointment_date + " " + appointment_time);
const hoursDifference = (appointmentDateTime - now) / (1000 * 60 * 60);

if (hoursDifference > 48) {
    return {
        type: "free_cancellation",
        fee: 0,
        message: "Cancelamento gratuito (+48h)"
    };
} else if (hoursDifference > 24) {
    return {
        type: "basic_fee",
        fee: 50,
        message: "Taxa básica de R$ 50,00 (24-48h)"
    };
} else if (hoursDifference > 0) {
    return {
        type: "half_fee",
        fee: treatment_value * 0.5,
        message: "Taxa de 50% do valor (-24h)"
    };
} else {
    return {
        type: "full_fee",
        fee: treatment_value,
        message: "Taxa integral - não comparecimento"
    };
}

Validação de Contraindicações ▼

// Verificar contraindicações antes do agendamento
function checkContraindications(treatmentType, clientInfo) {
    const contraindications = {
        "botox": ["gravidez", "amamentacao", "doencas_neurologicas"],
        "preenchimento": ["alergias_acido_hialuronico", "infeccoes_ativas"],
        "laser": ["bronzeado_recente", "medicamentos_fotossensibilizantes"],
        "peeling": ["lesoes_ativas", "exposicao_solar_recente"]
    };
    
    if (contraindications[treatmentType]) {
        return {
            questions: contraindications[treatmentType],
            required_assessment: true
        };
    }
    return { safe_to_proceed: true };
}

Geração de Instruções Pré e Pós Tratamento ▼

// Instruções específicas por tratamento
function generateInstructions(treatmentType) {
    const instructions = {
        "botox": {
            pre: [
                "Evitar aspirina 7 dias antes",
                "Não consumir álcool 24h antes",
                "Vir sem maquiagem"
            ],
            post: [
                "Não deitar por 4 horas",
                "Evitar exercícios por 24h",
                "Não massagear a região"
            ]
        },
        "laser": {
            pre: [
                "Evitar exposição solar 15 dias",
                "Não usar autobronzeador",
                "Suspender ácidos 1 semana"
            ],
            post: [
                "Usar protetor solar FPS 60+",
                "Aplicar hidratante 3x ao dia",
                "Evitar sol por 30 dias"
            ]
        }
    };
    
    return instructions[treatmentType] || {};
}

👩‍⚕️ Informações dos Especialistas

Dra. Isabella Santos

Especialização: Dermatologia e Estética

CRM: 12345-SP

Experiência: 15 anos

Especialidades: Botox, Preenchimentos, Lasers

Dra. Camila Oliveira

Especialização: Biomedicina Estética

CRBM: 67890-SP

Experiência: 10 anos

Especialidades: Tratamentos Faciais, Microagulhamento

Dr. Ricardo Ferreira

Especialização: Medicina Estética

CRM: 54321-SP

Experiência: 12 anos

Especialidades: Tratamentos Corporais, Criolipólise

🚀 Plano de Implementação

📋 Fase 1: Desenvolvimento

Criação dos fluxos específicos para estética
Configuração de variáveis dos tratamentos
Sistema de contraindicações
Teste de validações temporais

🔗 Fase 2: Integração

Conexão com WhatsApp Business
Integração com agenda de especialistas
Sistema de pagamentos PIX
Notificações de lembrete

🧪 Fase 3: Testes

Testes com diferentes tipos de tratamento
Validação de fluxos de cancelamento
Teste de contraindicações
Simulação de cenários reais

🎯 Fase 4: Deploy

Lançamento gradual por especialista
Monitoramento de agendamentos
Coleta de feedback dos clientes
Ajustes baseados no uso real

                📊 Métricas Específicas para Estética
                Taxa de conversão por tipo de tratamento
Procedimentos mais procurados por faixa etária
Horários de pico para agendamentos
Taxa de no-show por especialista
Satisfação pós-tratamento via follow-up
Tempo médio entre avaliação e procedimento
Retorno de clientes para tratamentos complementares

            

🔒 Segurança e LGPD na Estética

🛡️ Proteção de Dados Sensíveis

Dados médicos: Criptografia avançada para histórico de tratamentos
Fotos antes/depois: Armazenamento seguro com consentimento
Informações de saúde: Contraindicações e alergias protegidas
Logs de auditoria: Rastreabilidade completa dos acessos

📋 Conformidade Específica para Estética

Consentimento informado: Para cada procedimento
Termo de responsabilidade: Assinatura digital integrada
Histórico médico: Acesso controlado por especialista
Direito ao esquecimento: Remoção segura de dados sensíveis

📞 Suporte Especializado

Horário Normal:
Segunda a Sexta: 09:00 às 19:00
Sábados: 09:00 às 15:00

🚨 Emergências Pós-Tratamento

WhatsApp de Plantão:
24 horas para complicações
Resposta em até 30 minutos

                🎨 Elementos Visuais Específicos
                Galeria de resultados: Antes/depois (com autorização)
Vídeos educativos: Procedimentos e cuidados
Simulador virtual: Previsão de resultados
QR Codes: Acesso rápido a informações pós-tratamento

            

R$ 120,00 Duração: 60 min

Indicação: Todos os tipos de pele

💆‍♀️ Hidrafacial

Descrição: Tratamento que limpa, esfolia e hidrata simultaneamente

Valor: R$ 280,00 Duração: 45 min

Indicação: Rejuvenescimento e hidratação

🌟 Peeling Químico

Descrição: Renovação celular com ácidos para melhorar textura e manchas

Valor: R$ 180,00 - R$ 350,00 Duração: 30 min

Indicação: Manchas, cicatrizes e envelhecimento

🔆 Microagulhamento

Descrição: Estímulo da produção de colágeno e elastina

Valor: R$ 250,00 Duração: 50 min

Indicação: Rugas, poros dilatados e flacidez

💉 Procedimentos Injetáveis

💉 Botox (Toxina Botulínica)

Descrição: Relaxamento muscular para redução de rugas dinâmicas

Valor: R$ 800,00 - R$ 1.500,00 Duração: 30 min

Áreas: Testa, glabela, pés de galinha, pescoço

💋 Preenchimento Labial

Descrição: Aumento e definição dos lábios com ácido hialurônico

Valor: R$ 1.200,00 - R$ 2.000,00 Duração: 45 min

Resultado: Duração de 8 a 12 meses

✨ Preenchimento Facial

Descrição: Restauração de volume e contorno facial

Valor: R$ 1.500,00 - R$ 3.000,00 Duração: 60 min

Áreas: Maçãs do rosto, sulcos, olheiras, queixo

💧 Bioestimulador de Colágeno

Descrição: Estímulo natural da produção de colágeno

Valor: R$ 2.500,00 - R$ 4.000,00 Duração: 45 min

Indicação: Flacidez e perda de volume

🔥 Tratamentos Corporais

❄️ Criolipólise

Descrição: Redução de gordura localizada através do frio

Valor: R$ 800,00 - R$ 1.200,00 Duração: 60 min

Áreas: Abdômen, flancos, culotes, papada

📡 Radiofrequência

Descrição: Aquecimento profundo para estimular colágeno

Valor: