Como funciona

Princípios

1. Núcleo determinístico, IA como intérprete. A IA entende o cliente e chama ferramentas. O motor calcula disponibilidade, faz a pré-reserva, confirma e cobra. A IA nunca inventa horário nem preço.
2. O banco de dados garante as regras. Overbooking é impossível porque o PostgreSQL rejeita alocações sobrepostas, não porque o app "confere antes".
3. API primeiro. Painel, página de reserva, bot de WhatsApp e MCP usam os mesmos serviços. Se algo não dá para fazer pela API, está faltando na API.
4. A credencial define o negócio. Uma chave ou sessão sempre pertence a um workspace.

Arquitetura

Canais:     WhatsApp · Página de reserva · Painel · REST / MCP
                 │
Gateway:    credencial → workspace · escopos · limites · webhooks assinados
                 │
Núcleo:     conversas + IA │ motor de agenda │ automações │ pagamentos │ conhecimento
                 │
Dados:      PostgreSQL (segurança por linha, constraints de exclusão, jobs) · Redis
Externos:   modelos de IA (OpenRouter) · transcrição de áudio · provedor de WhatsApp · Pix

A vida de uma mensagem

1. Chega. O provedor de WhatsApp chama nosso webhook. Verificamos a assinatura HMAC, descartamos duplicadas pelo id da mensagem e guardamos. Respondemos em menos de 200 ms.
2. É entendida. Áudios são transcritos. Identificamos cliente e conversa. Se uma pessoa assumiu, o bot fica em silêncio.
3. A IA pede. O modelo recebe o contexto do negócio, data e hora locais, um estado estruturado da conversa e as últimas mensagens. Ele só pode chamar ferramentas como find_slots, hold_slot ou confirm_hold.
4. O motor decide. Cada chamada é validada contra um schema estrito e as regras do negócio, e então executada. Erros voltam como dados estruturados (por exemplo slot_taken com alternativas) para a IA perguntar de novo.
5. Resposta exata. Datas, horários, serviços, preços e endereços saem de modelos de mensagem preenchidos com o resultado real.
6. Eventos. booking.confirmed e companhia disparam automações (lembretes) e seus webhooks.

Para onde ir

• Agendamentos e pré-reservas explica as garantias.
• WhatsApp e IA explica o que a IA pode e não pode fazer.