Como funciona

Arquitetura, princípios e a vida de uma mensagem, desde que chega por um canal até virar uma tarefa, uma ação ou um aviso.

Atualizado:

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.

Da entrada à ação

Entradas → motor → interpretação → ações. Este é o caminho de uma conversa, não uma sequência obrigatória: painel e API chamam o motor diretamente; formulários vão para uma pessoa. A IA volta ao motor para validar cada proposta antes de agir.

Entradas → Motor Fiuit → IA interpreta → Ações e saídas

A IA não executa por conta própria: pede ferramentas e o motor valida permissões, disponibilidade e confirmações. Reservas e tarefas compartilham uma verdade operacional. Os avisos dependem das suas regras e do canal; o chat web responde durante a conversa, sem lembretes proativos. O bot de clientes reserva serviços com horário; a equipe cria tarefas de fila pelo painel ou pela API. Criação de entregas em fila pelo chat: em breve.

WhatsApp → reserva «Tem horário amanhã para corte com o João?»

Fiuit consulta horários reais, oferece opções e segura a escolhida por 10 minutos. Pede os dados que faltam e a confirmação; só então o motor confirma a reserva. João vê na agenda dele.

Telegram → reserva com horário «Tem mesa para quatro amanhã às 20:00?»

Fiuit consulta os horários do serviço, segura a opção escolhida por 10 minutos e pede os dados e a confirmação. Quando o cliente confirma, o motor registra a reserva e a equipe vê na agenda.

A equipe cria a entrega pelo painel com um serviço de fila, o cliente e o endereço, sem escolher um horário. Depois pode atribuir, assumir e concluir a tarefa pelo Trabalho. Avisos dependem das regras ativadas. Criar entregas em fila automaticamente pelo chat: em breve.

A vida de uma mensagem

  1. Entra e se organiza. O canal verifica a origem e descarta mensagens repetidas. O motor guarda o contexto em Mensagens e respeita as pausas. Formulários: entrada para atendimento humano, sem bot automático.
  2. O contexto é respeitado. O cliente e a conversa são identificados. Se uma pessoa assumiu, o bot não responde. Ações da equipe e da API têm suas próprias permissões e não precisam passar pela IA.
  3. A IA interpreta. Nos canais de conversa, o modelo entende a intenção, consulta dados do negócio por ferramentas e pede o que falta. Áudio é transcrito somente onde o canal suporta.
  4. Proposta e confirmação. O motor verifica regras, permissões e disponibilidade. Uma opção escolhida fica retida por 10 minutos; o cliente confirma antes de virar reserva. Se algo mudou, são oferecidas alternativas.
  5. O motor executa. Operações idempotentes evitam repetir uma ação ao tentar novamente. A base impede reservas sobrepostas. Datas, preços e confirmações são comunicados com dados reais do sistema, em modelos de mensagem.
  6. Trabalho, avisos e diálogo. Uma reserva criada pelo chat ou uma entrega em fila registrada pela equipe no painel aparece como tarefa para a equipe. As regras ativas geram avisos e ações permitidas. Fiuit também responde dúvidas e encaminha para uma pessoa; nem toda mensagem precisa criar uma tarefa.

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.

Regras

Uma regra 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