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, pré-reserva e confirma. A IA nunca inventa um horário nem um preço.
2. O banco de dados garante as regras. O overbooking é impossível porque o PostgreSQL rejeita alocações sobrepostas, não porque o app "confere antes".
3. Uma verdade operacional, várias visões. Uma tarefa é um único objeto; você a vê em Hoje, em lista, em calendário ou no mapa.
4. API primeiro. O painel, o bot, o MCP e o Wagy usam os mesmos serviços. Se algo não dá para fazer por API, falta na API.
5. A credencial define o negócio. Uma chave ou sessão sempre pertence a um projeto.

Arquitetura

Canais:     WhatsApp · Chat web · Telegram · Painel · Wagy · API · MCP
                 │
Gateway:    credencial → projeto · permissões · limites · pausas · webhooks assinados
                 │
Núcleo:     conversas + IA │ motor de agenda e tarefas │ fluxos │ conhecimento
                 │
Dados:      PostgreSQL (segurança por linha, constraints de exclusão) · Redis
Externos:   modelos de IA · transcrição de áudio · provedores de canal · mapas

A vida de uma mensagem

1. Chega. O canal (WhatsApp, chat web ou Telegram) entrega a mensagem. Verifica-se a assinatura ou a chave, descartam-se duplicadas e salva-se no Inbox. Se o canal está pausado, a pausa é aplicada antes de qualquer outra coisa.
2. É entendida. Os áudios são transcritos. Identifica-se o cliente (um cliente pode ter várias identidades: telefone, Telegram) e a conversa. Se uma pessoa assumiu o controle, o bot não responde. As regras do canal (por exemplo pedir telefone e e-mail no chat web) são aplicadas antes de chamar a IA.
3. A IA pede. O modelo recebe o contexto do negócio, a data e a hora locais e as últimas mensagens. Só pode chamar ferramentas: buscar horários, pré-reservar, confirmar, consultar o conhecimento, salvar uma localização compartilhada ou encaminhar para uma pessoa.
4. O motor decide. Cada chamada é validada contra as regras do negócio e só depois executada. Se algo mudou, o motor devolve alternativas e a IA pergunta de novo.
5. Resposta exata. Datas, horas, serviços, preços e endereços saem de modelos preenchidos com o resultado real.
6. Trabalho e eventos. A reserva é uma tarefa com etapas. Cada mudança de etapa ou ação gera eventos que disparam fluxos, avisos à equipe (por Telegram ou WhatsApp) e webhooks.

Tarefas, etapas e ações

Cada negócio define as etapas por onde passa o seu trabalho e as ações que movem uma tarefa de uma para outra (pegar, soltar, concluir, "não estava"). Uma ação pode ter efeitos: atribuir a quem a executa, liberar, encerrar com um resultado. Veja Trabalho e ações.

Fluxos

Um fluxo diz "quando isto acontecer, se esta condição for atendida, faça aquilo": enviar uma mensagem, avisar a equipe, esperar, executar uma ação. As condições são expressões simples sobre a tarefa, o cliente ou a hora.

Segurança

Cada negócio é isolado no próprio banco de dados, os segredos são cifrados e cada mudança fica num registro de auditoria. Você é o responsável pelos dados dos seus clientes; a Fiuit os trata em seu nome.

Para onde ir depois

• Reservas e pré-reservas: as garantias da agenda.
• Bot e IA: o que o assistente pode e não pode fazer.