Documentação - Sistema de Automação Odonto Clean

🦷 Sistema de Automação Odonto Clean

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

📋 Visão Geral do Projeto

🎯 Objetivo

Automatizar o atendimento inicial de pacientes com opções para agendamento, cancelamento, consulta de procedimentos e valores através do Typebot.

👥 Público-alvo

Pacientes da clínica odontológica Odonto Clean que buscam informações 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: Preços e descrições detalhadas
Geração de PIX: Pagamentos automáticos para taxas
Informações Completas: Dados da clínica, profissionais e convênios

            

🏗️ Arquitetura dos Fluxos

🏠

Fluxo Principal - Menu Inicial

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

🦷 Olá! Bem-vindo(a) à Odonto Clean! 

Sou seu assistente virtual e estou aqui para ajudá-lo(a). 

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

2️⃣ - Agendar Consulta
3️⃣ - Cancelar Consulta  
4️⃣ - Visualizar Consulta Agendada
5️⃣ - Ver Procedimentos e Valores
6️⃣ - Outras Informações da Clínica

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

📅 Fluxo 2: Agendar Consulta ▼

2.1 Submenu de Agendamento

2.1 - Consulta de Avaliação R$ 80,00

2.2 - Limpeza e Profilaxia R$ 120,00

2.3 - Consulta de Urgência R$ 150,00

2.4 - Retorno Gratuito

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: 08:00 às 17:00

❌ Fluxo 3: Cancelar Consulta ▼

⚠️ Sistema de Taxas de Cancelamento

+24 horas: Cancelamento GRATUITO
-24 horas: Taxa de R$ 30,00
Não comparecimento: Taxa integral do procedimento

Fluxos de Cancelamento:

3.3 - Sem Taxa (+24h)

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

3.4 - Com Taxa (-24h)

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

3.5 - Não Comparecimento

Cobrança do valor integral do procedimento

👁️ Fluxo 4: Visualizar Consulta ▼

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

Data e horário da consulta
Profissional responsável
Procedimento agendado
Valor do procedimento
Endereço da clínica

💰 Procedimentos e Valores

🛡️ Preventivos

Limpeza, aplicação de flúor, selantes

R$ 80 - R$ 150

🔧 Restauradores

Restaurações, tratamento de canal, coroas

R$ 180 - R$ 2.500

✨ Estéticos

Clareamento, facetas, lentes de contato

R$ 400 - R$ 4.000

🦷 Ortodontia

Aparelhos metálicos, estéticos, alinhadores

R$ 1.200 - R$ 15.000

⚕️ Cirurgias

Extrações simples, siso, implantes

R$ 200 - R$ 4.000

🦷 Próteses

Parciais, totais, sobre implantes

R$ 1.800 - R$ 25.000

💳 Formas de Pagamento

À Vista

Dinheiro (10% desc.), PIX (5% desc.), Débito (3% desc.)

Cartão de Crédito

1x sem juros, até 12x com condições especiais

Financiamento

Até 24x com análise de crédito em 24h

⚙️ 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

📱 Tipos de Blocos Utilizados

Text Bubble

Mensagens informativas, menus e confirmações

Input

Coleta de dados (texto, telefone, data, email, arquivo)

Buttons

Opções numéricas e navegação rápida

Image

Procedimentos, localização, QR Codes

Condition

Validação de respostas e direcionamento

HTTP Request

Geração de PIX e validação de pagamentos

💻 Variáveis do Sistema

// Dados do usuário
{{user_name}}
{{user_phone}}
{{user_email}}

// Dados da consulta
{{appointment_date}}
{{appointment_time}}
{{procedure_type}}
{{dentist_name}}
{{total_value}}

// Controle de cancelamento
{{hours_until_appointment}}
{{cancellation_fee}}
{{pix_code_30}}
{{pix_code_integral}}
{{payment_status}}

🔍 Validações Principais

Validação Temporal para Cancelamento ▼

// Calcular diferença em horas
const now = new Date();
const appointmentDateTime = new Date(appointment_date + " " + appointment_time);
const hoursDifference = (appointmentDateTime - now) / (1000 * 60 * 60);

if (hoursDifference > 24) {
    return "no_fee_cancellation"; // Fluxo 3.3
} else if (hoursDifference > 0) {
    return "fee_cancellation"; // Fluxo 3.4
} else {
    return "no_show_fee"; // Fluxo 3.5
}

Geração de PIX Dinâmico ▼

// Para taxa de R$ 30,00
function generatePIX30() {
    const pixData = {
        key: "pagamentos@odontoclean.com.br",
        amount: 30.00,
        description: `Taxa cancelamento - ${user_name}`,
        reference: `CANCEL-${session_id}-${timestamp}`
    };
    return generatePixCode(pixData);
}

🚀 Plano de Implementação

📋 Fase 1: Desenvolvimento

Criação dos fluxos principais
Configuração de variáveis
Teste de validações

🔗 Fase 2: Integração

Conexão com WhatsApp
Integração com agenda
Configuração de pagamentos

🧪 Fase 3: Testes

Testes de usabilidade
Validação de fluxos
Correções e ajustes

🎯 Fase 4: Deploy

Lançamento gradual
Monitoramento em tempo real
Coleta de feedback

                📊 Métricas e KPIs
                Taxa de conversão por fluxo
Tempo médio de atendimento
Procedimentos mais consultados
Horários de maior demanda
Taxa de abandono por etapa

            

🔒 Segurança e LGPD

🛡️ Proteção de Dados

Criptografia de dados sensíveis
Logs de auditoria para rastreabilidade
Backup automático diário
Política de retenção de dados

📋 Conformidade LGPD

Consentimento explícito do usuário
Direito ao esquecimento implementado
Portabilidade de dados garantida
Relatório de impacto disponível

📞 Suporte Técnico

Horário Normal

Segunda a Sexta: 08:00 às 18:00
Sábados: 08:00 às 14:00

Emergências

24 horas por dia, 7 dias por semana