# Apresentação Técnica — Ferramentas BioSistema

**Público:** comprador / decisor técnico  
**Versão:** 2026-06-24  
**Formato:** duas ferramentas documentadas **separadamente** — cada uma com resumo executivo, escopo, custos e comparativo de mercado.

---

## Índice

### Parte I — e-Contas Médicas + GregPay
1. [Resumo executivo](#parte-i--e-contas-médicas--gregpay)
2. [O que é](#o-que-é-o-e-contas-médicas--gregpay)
3. [O que entrega](#o-que-o-e-contas-médicas-entrega)
4. [Problemas que resolve](#problemas-que-o-e-contas-médicas-resolve)
5. [Arquitetura técnica](#arquitetura-técnica-e-contas-médicas)
6. [Módulos funcionais](#módulos-funcionais-e-contas-médicas)
7. [Custos](#custos-e-contas-médicas-terceiros-e-alternativas)
8. [Comparativo com o mercado](#comparativo-e-contas-médicas-com-o-mercado)
9. [Implantação](#implantação-e-contas-médicas)

### Parte II — eBot Produção
1. [Resumo executivo](#parte-ii--ebot-produção)
2. [O que é](#o-que-é-o-ebot-produção)
3. [O que entrega](#o-que-o-ebot-produção-entrega)
4. [Problemas que resolve](#problemas-que-o-ebot-resolve)
5. [Arquitetura técnica](#arquitetura-técnica-ebot)
6. [Módulos funcionais](#módulos-funcionais-ebot)
7. [Custos](#custos-ebot-terceiros-e-alternativas)
8. [Comparativo com o mercado](#comparativo-ebot-com-o-mercado)
9. [Implantação](#implantação-ebot)

---

# Parte I — e-Contas Médicas + GregPay

## Resumo executivo

| Dor do comprador | O que a ferramenta faz |
|------------------|------------------------|
| Repasse médico manual, lento e sem rastreio | Split automático no recebimento (clínica + médicos + parceiros) |
| Caixa, extrato e repasse não batem | Conciliação caixa × GregPay × extrato por participante |
| Regra diferente por médico, convênio ou procedimento | Motor de rateio configurável |
| Pagamento particular desconectado do financeiro | Pagamento online e captura integrada ao caixa |
| NFSe/OS convênio em processo paralelo | Módulos OS e NFSe quando ContSelf está ativo |

> **Em uma frase:** módulo financeiro no app da clínica que define **quem recebe quanto** em cada venda, com auditoria e substituição gradual do repasse legado.

---

## O que é o e-Contas Médicas + GregPay

O **e-Contas Médicas** é o módulo de **split de pagamento e repasse financeiro** da rede clínica, operado no **Flutter** (web e mobile). A liquidação e o split são processados pela **GregPay** (plataforma de pagamentos terceira, contratada pela clínica/rede). Opcionalmente integra **ContSelf** para e-commerce, ordem de serviço e NFSe.

**Canal de uso:** app e-prontu → menu Contas Médicas / GregPay.  
**Não é:** ERP genérico, gateway avulso nem planilha de repasse.

---

## O que o e-Contas Médicas entrega

| Entrega | Descrição |
|---------|-----------|
| **Dashboard financeiro** | KPIs, saúde da API, últimas transações, modo de repasse |
| **Cadastro de participantes** | Clínica, médicos e parceiros sincronizados com GregPay |
| **Transações de split** | Histórico com status (pendente, enviada, liquidada, erro) |
| **Rateio automático** | Regras por médico, convênio, procedimento e unidade |
| **Extrato por participante** | Saldo e movimentação individual |
| **Curadoria D-1** | Conferência antes da liquidação |
| **Conciliação** | Cruzamento caixa × GregPay × extrato |
| **Pagamento online** | Link ou checkout transparente GregPay |
| **OS convênio e NFSe** | Quando ContSelf está configurado |
| **Relatórios e desempenho** | Indicadores e comparativo legado × GregPay |
| **Logs e auditoria** | Erros de integração e trilha técnica |
| **Guias TISS (complementar)** | Listagem, fechamento e remessas convênio |

**Total:** 14 módulos em uma única interface Flutter (dashboard até configuração).

---

## Problemas que o e-Contas Médicas resolve

| Situação atual (sem a ferramenta) | Resultado com e-Contas Médicas |
|-----------------------------------|--------------------------------|
| Repasse em lote quinzenal/mensal | Repasse por transação, conforme liquidação da adquirente |
| Planilha ou conferência manual | Transação rastreável por atendimento e parcela |
| Bitributação (NF integral + NF médico) | Split na origem: cada um emite sobre sua fatia |
| Gap de caixa (repassa antes de receber) | Liquidação alinhada às parcelas (D+30, D+60…) |
| Regras espalhadas no legado | Motor de rateio centralizado e versionado |
| Erro financeiro sem histórico | Logs, curadoria e status por split |
| Módulo financeiro fora do prontuário | Tudo dentro do mesmo app que a equipe já usa |

---

## Arquitetura técnica (e-Contas Médicas)

| Camada | Tecnologia |
|--------|------------|
| Interface | Flutter (web + mobile), `go_router`, Provider |
| API | REST `api/e-contas-medicas/*` (bioma-back / PHP) |
| Banco | PostgreSQL — schema `gregpay` (migrations 001–011) |
| Split / pagamento | **GregPay** (HML e PROD), webhooks |
| E-commerce / NFSe | **ContSelf** (opcional) |
| Legado | Repasse antigo convive durante migração; pode ser bloqueado após cutover |

**Isolamento:** código GregPay em pasta dedicada (`lib/screens/contasMedicas/gregpay/`), sem quebrar o repasse legado (`contasmedicas.js`, `tab_repassemedico.php`).

---

## Módulos funcionais (e-Contas Médicas)

| # | Módulo | Função |
|---|--------|--------|
| 0 | Dashboard | Visão geral e saúde operacional |
| 1 | Participantes | Cadastro e sync GregPay |
| 2 | Transações | Histórico de splits |
| 3 | Pagamento online | Captura cartão / PIX / link |
| 4 | Rateio | Regras e grupos de divisão |
| 5 | Extrato | Movimentação por participante |
| 6 | Curadoria | Conferência pré-liquidação |
| 7 | Logs | Auditoria técnica |
| 8 | OS convênio | Ordem de serviço (ContSelf) |
| 9 | NFSe | Emissão/consulta de notas |
| 10 | Conciliação | Caixa × GregPay × extrato |
| 11 | Relatórios | Gráficos e indicadores |
| 12 | Desempenho | Legado × simulação × GregPay |
| 13 | Configuração | Credenciais, ambiente, taxas, formas de pagamento |

---

## Custos (e-Contas Médicas): terceiros e alternativas

### Custo da ferramenta (BioSistema)

| Item | Natureza | Observação |
|------|----------|------------|
| **Licença / módulo no e-prontu** | Recorrente (contrato) | Conforme proposta comercial — **não inclui** GregPay nem adquirente |
| **Implantação** | Pontual (se contratada) | Rede, participantes, rateio, homologação HML |
| **Infraestrutura** | Compartilhada | API e banco do e-prontu; sem servidor dedicado obrigatório |
| **Suporte / evolução** | Contrato | Migrations, correções e novas abas conforme SLA |

### Custos de terceiros

| Terceiro | O que cobra | Quem paga | Observação |
|----------|-------------|-----------|------------|
| **GregPay** | Contrato + taxas por transação/split | Clínica / rede | Merchant UUID, `ChavePessoa`, HML antes de PROD |
| **Adquirente / bandeira** | MDR, antecipação, PIX | Clínica | Já existente no caixa/TEF |
| **ContSelf** | Contrato + API (OS, NFSe) | Clínica | Opcional |
| **NFSe (prefeitura)** | Taxas municipais | Participante | Independente da ferramenta |
| **Contador / fiscal** | Emissão e conferência | Clínica / médico | Reduzido com split na origem |

### Comparativo de custo total (estrutura)

| Modelo | Software | Transacional | RH operacional | Escala |
|--------|----------|--------------|----------------|--------|
| **e-Contas + GregPay** | Módulo + contrato GregPay | MDR + taxa split | Baixo | Alta |
| **ERP genérico** | Licença alta + custom | MDR separado | Médio/alto | Média |
| **Fintech split genérica** | Integração custom | Por transação | Alto (dev) | Alta, sem vertical saúde |
| **Planilha manual** | Zero extra | Só MDR | **Muito alto** | Baixa |

> **Resumo:** paga-se **módulo BioSistema + GregPay + adquirente**. O retorno vem de **menos trabalho manual**, **menos erro** e **conciliação automática**.

---

## Comparativo (e-Contas Médicas) com o mercado

| Critério | e-Contas + GregPay | ERP (TOTVS, Omie) | Fintech split | Planilha |
|----------|-------------------|-------------------|---------------|----------|
| Foco clínica | ✅ Nativo | ⚠️ Adaptação | ❌ Genérico | ❌ |
| Split no recebimento | ✅ | ⚠️ | ✅ | ❌ |
| Dentro do prontuário | ✅ | ❌ | ❌ | ❌ |
| Rateio clínico | ✅ | ⚠️ | ⚠️ | ❌ |
| Conciliação integrada | ✅ | ⚠️ | ⚠️ | ❌ |
| NFSe / OS | ✅ (ContSelf) | ⚠️ | ❌ | ❌ |

---

## Implantação (e-Contas Médicas)

| Item | Requisito |
|------|-----------|
| App | Flutter web (ex.: `e-prontu.bioma.app.br`) |
| API | `bioma.app.br/api/e-contas-medicas/*` |
| Banco | PostgreSQL com migrations GregPay |
| GregPay | Contrato, merchant, webhooks, HML |
| Rede | Liberada (ex.: REDEBIO) |
| Usuários | Login e-prontu com permissão |

**Referências:** `gregpay/docs/MANUAL_USO.md`, `gregpay/INTEGRACAO.md`.

---

# Parte II — eBot Produção

## Resumo executivo

| Dor do comprador | O que a ferramenta faz |
|------------------|------------------------|
| WhatsApp em celular pessoal, sem controle | Atendimento centralizado com filas, tickets e histórico |
| Paciente sem resposta fora do horário | Bot 24/7 com menus, blocos e funções configuráveis |
| Confirmação de consulta manual | Campanhas e processos monitorados com templates Meta |
| Agendamento só por telefone | Pré-agendamento e confirmação via WhatsApp |
| Mudar fluxo exige desenvolvedor | Painel visual Fluxo 2.0 — sem deploy de código |

> **Em uma frase:** plataforma de **WhatsApp corporativo** para clínicas — bot, atendimento humano em fila, campanhas e painel administrativo completo.

---

## O que é o eBot Produção

O **eBot Produção** é o motor de **conversas WhatsApp** da clínica, usando a **Meta Cloud API** (API oficial do WhatsApp Business). Combina **automação (bot)** e **atendimento humano (call center / recepção)** no mesmo número oficial.

**Canal de uso:** WhatsApp do paciente + painel web admin (`/admin`).  
**Não é:** app de mensagens genérico, CRM horizontal nem ferramenta de marketing isolada.

---

## O que o eBot Produção entrega

| Entrega | Descrição |
|---------|-----------|
| **Bot conversacional** | Menus, listas, botões, blocos, validações, funções SQL |
| **Fluxo 2.0 visual** | Construtor de jornada sem programar |
| **Atendimento humano** | Inbox, filas, tickets, protocolo, transferência |
| **Chat multimídia** | Texto, imagem, vídeo, PDF, áudio (gravar e enviar) |
| **Campanhas automáticas** | Disparos programados e confirmação de consulta |
| **Processos monitorados** | SQL + template Meta → lembretes e avisos |
| **Agenda integrada** | Busca paciente, disponibilidade, agendar, cancelar |
| **Templates Meta (HSM)** | Mensagens fora da janela de 24h |
| **Painel admin** | Dashboard, atendentes, filas, logs, config API |
| **IA de apoio (opcional)** | Rascunhos de fluxo e interpretação |
| **Documentação web** | `/docs/apresentacao-tecnica` |

---

## Problemas que o eBot resolve

| Situação atual (sem a ferramenta) | Resultado com eBot Produção |
|-----------------------------------|----------------------------|
| Vários celulares na recepção | Número único corporativo |
| Sem histórico auditável | Logs `whatsapp_logs` e tickets |
| Confirmação por ligação manual | Template + bot trata resposta |
| Fila invisível | Filas, atendentes e métricas de SLA |
| Bot engessado ou inexistente | Fluxo editável pelo painel |
| BSP caro no meio | Cloud API direto (Meta); Prix opcional |
| Janela 24h desconhecida | Gestão de templates e sessão |

---

## Arquitetura técnica (eBot)

| Camada | Tecnologia |
|--------|------------|
| Runtime | Node.js 18+ (Express), PM2 |
| Banco | PostgreSQL |
| WhatsApp | Meta Cloud API (Graph API v21) |
| Painel | SPA `public/admin/index.html` |
| Webhook | `POST /webhook` com validação de assinatura |
| Motor de fluxo | `conversationEngine`, `blockExecutor`, `sessionService` |
| Mídia | Upload Meta, proxy autenticado, FFmpeg para áudio |
| IA (opcional) | Ollama/Llama local |
| Deploy típico | `https://e-bot.bioma.app.br` |

---

## Módulos funcionais (eBot)

### Bot e automação

| Recurso | Entrega |
|---------|---------|
| Menus e opções | URA no WhatsApp (lista, botões) |
| Blocos / etapas | Perguntas CPF, data, texto, confirmações |
| Funções | Consulta e gravação SQL no banco |
| Fluxo 2.0 | Editor visual menu → bloco → passo |
| Start (palavras-chave) | Entrada no fluxo por texto |
| Templates Meta | HSM fora da janela 24h |
| IA | Rascunhos, ideias, interpretação |

### Atendimento humano

| Recurso | Entrega |
|---------|---------|
| Inbox / filas | Aguardando, atendendo, resolvidos |
| Chat operador | Texto, mídia, áudio gravado |
| Tickets | Protocolo de atendimento |
| Atendentes | Vínculo com login e-prontu |
| Transferência | Entre fila e entre operadores |
| Tags, macros, templates | Produtividade |
| Métricas | SLA, primeira resposta, resolvidos |

### Campanhas e operação

| Recurso | Entrega |
|---------|---------|
| Disparos automáticos | Regras programadas |
| Processos monitorados | SQL + template → confirmação consulta |
| Cron / fila campanhas | Worker bioma-back |
| Config API | Tokens Meta, phone_id, WABA |
| Logs WhatsApp | Auditoria in/out |
| Chat de teste | Simular bot sem WhatsApp real |

---

## Custos (eBot): terceiros e alternativas

### Custo da ferramenta (BioSistema)

| Item | Natureza | Observação |
|------|----------|------------|
| **Licença / módulo eBot** | Recorrente (contrato) | Conforme proposta — **não inclui** Meta |
| **Implantação** | Pontual (se contratada) | WABA, webhook, fluxos, filas, templates |
| **Servidor Node** | Infraestrutura | VM/cloud com PM2 |
| **Banco PostgreSQL** | Infraestrutura | Pode ser cluster compartilhado |
| **Suporte / evolução** | Contrato | Fluxos, painel, correções |

### Custos de terceiros

| Terceiro | O que cobra | Quem paga | Observação |
|----------|-------------|-----------|------------|
| **Meta (WhatsApp)** | Conversas por categoria | Clínica / WABA | Marketing, utilidade, autenticação, serviço |
| **BSP (Prix etc.)** | Se usado em vez de API direta | Clínica | Opcional no eBot |
| **Número WABA** | Verificação Meta | Clínica | Business Manager |
| **Servidor / SSL** | Hospedagem HTTPS | Clínica ou BioSistema | Webhook exige HTTPS |
| **IA externa** | Tokens API | Clínica | Opcional; Ollama local dispensa |

**Meta:** cobrança por conversa de 24h conforme categoria. Campanhas de confirmação usam templates (custo variável). Ver [WhatsApp Business Platform Pricing](https://developers.facebook.com/docs/whatsapp/pricing).

### Comparativo de custo total (estrutura)

| Modelo | Software mensal | Variável (conversas) | Infra | RH |
|--------|-----------------|----------------------|-------|-----|
| **eBot self-hosted** | Módulo + servidor | Meta direto | VM + DB | Operadores |
| **Blip / Take / Zenvia** | SaaS por agente | Incluso ou markup | Cloud vendor | Operadores |
| **Zendesk + WhatsApp** | Por agente | Meta repassada | Cloud | Operadores |
| **ManyChat / Typebot** | Por contato | Meta à parte | Cloud | Baixo TI |
| **WhatsApp Business App** | Grátis | Zero API | Zero | **Altíssimo** manual |

> **Resumo:** paga-se **módulo BioSistema + infra + Meta**. Em alto volume de campanhas, **Meta** pode ser o maior custo variável. O eBot evita markup de BSP na API direta.

---

## Comparativo (eBot) com o mercado

| Critério | eBot Produção | Blip / Take / Zenvia | ManyChat | WhatsApp App |
|----------|---------------|----------------------|----------|--------------|
| Bot sem código | ✅ Fluxo 2.0 | ✅ (licença alta) | ✅ | ❌ |
| Atendimento em fila | ✅ | ✅ | ⚠️ | ❌ |
| Campanhas clínicas | ✅ SQL + template | ⚠️ | ✅ marketing | ❌ |
| Self-hosted | ✅ | ❌ | ❌ | ❌ |
| Custo fixo | Infra + licença | Por agente | Por contato | Zero |
| Custo campanhas | Meta direto | Meta + markup | Meta + plano | N/A |
| Áudio operador | ✅ | ⚠️ | ❌ | Manual |

---

## Implantação (eBot)

| Item | Requisito |
|------|-----------|
| Servidor | Node.js 18+, PM2 |
| Banco | PostgreSQL |
| Meta | WABA, número verificado, token permanente |
| Webhook | HTTPS público (`/webhook`) |
| Variáveis | `META_*`, `DB_*`, `BIOMA_*`, `EBOT_PUBLIC_BASE_URL` |
| Atendentes | Cadastro eBot + e-mail e-prontu |
| FFmpeg | Áudio (`@ffmpeg-installer/ffmpeg`) |

**URLs:** painel `https://e-bot.bioma.app.br/admin/` · docs `https://e-bot.bioma.app.br/docs/apresentacao-tecnica`

**Referências:** `e-bot-producao/README.md`, `e-bot-producao/docs/ia/GUIA-SISTEMA-EBOT.md`.

---

*Valores de licença BioSistema e contratos GregPay/Meta são definidos em proposta comercial. Este material descreve estrutura de custos, não tabela de preços fechada.*