# Fiuit

> Horizontal scheduling engine with a WhatsApp + LLM channel, an admin dashboard and a developer platform (REST API with scoped tokens, signed webhooks). Every business (barbershop, aesthetics, clinic, restaurant, deliveries) is modeled with resources, services, requirements and schedules. Bookings go through a 10-minute hold before confirmation; the database prevents double booking.

Status: in development. The API described here is the target contract (draft).

Full text of every page: https://fiuit.com/llms-full.txt

## Docs (English)

- [Introduction](https://fiuit.com/en/docs/introduction): What Fiuit is, who it is for, and the building blocks you will use to take bookings, serve customers and run work with your team.
- [Getting started](https://fiuit.com/en/docs/getting-started): Step-by-step guide to set up your business in Fiuit with Wagy's help, connect a channel, test the bot and complete your first task.
- [How it works](https://fiuit.com/en/docs/how-it-works): Architecture, principles and the life of a message, from arriving on a channel to becoming a task, an action or an alert.
- [Workspaces and resources](https://fiuit.com/en/docs/concepts/workspaces-and-resources): Organizations, workspaces, roles, resources, capacity modes and resource groups.
- [Services and availability](https://fiuit.com/en/docs/concepts/services-and-availability): Services, multi-resource requirements, schedules and how slots are computed.
- [Bookings and holds](https://fiuit.com/en/docs/concepts/bookings-and-holds): Booking states, the 10-minute hold, deposits and the no-double-booking guarantee.
- [Automations](https://fiuit.com/en/docs/concepts/automations): Simple reminder and confirmation rules, quiet hours and execution guarantees. For waits and conditions, see flows.
- [WhatsApp](https://fiuit.com/en/docs/channels/whatsapp): Connect your business number by QR, what the assistant does with customers and with your team, and how to hand a conversation to a person.
- [Web chat](https://fiuit.com/en/docs/channels/webchat): Put the Fiuit assistant on your site with one line of code, with required contact details and per-channel rules.
- [Telegram](https://fiuit.com/en/docs/channels/telegram): Connect your business's Telegram bot so customers can book and ask questions as on WhatsApp, with the same Inbox and the same bot.
- [Pauses and Status](https://fiuit.com/en/docs/channels/pauses-and-status): Pause a channel or your project's AI in an emergency, and check Status and AI usage to see whether your business is serving customers.
- [The bot and the AI](https://fiuit.com/en/docs/bot/overview): What your business's bot does, what it cannot do, how to configure it, test it in the simulator and when a conversation passes to a person.
- [Bot knowledge](https://fiuit.com/en/docs/bot/knowledge): Teach the bot with texts, files, web pages, a section of your site or listings (spreadsheets, CSV, JSON and RSS) that stay up to date.
- [Work and actions](https://fiuit.com/en/docs/work/tasks-and-actions): How the day to day is organized in Fiuit, with Today, Inbox and Work, and how task stages and actions work, such as take, release and close.
- [Map and addresses](https://fiuit.com/en/docs/work/map-and-addresses): The Work map view, address autocomplete, the location a customer shares and how privacy is protected.
- [Flows](https://fiuit.com/en/docs/work/flows): What to do automatically when something happens in your business: waits, conditions and alerts. Load examples, activate, pause and review history.
- [Flow conditions](https://fiuit.com/en/docs/work/conditions): How to write a condition in a flow, which data it can look at, ready-made examples by industry and how to test it before activating.
- [Zones](https://fiuit.com/en/docs/work/zones): Group your team by zone, with its area, service days and hours and a per-slot limit, and let each task find its own zone.
- [Team Telegram](https://fiuit.com/en/docs/team/telegram-team): Get work alerts on Telegram, take tasks with one tap and open your day in the "My day" Mini App.
- [Roles and permissions](https://fiuit.com/en/docs/team/roles): What each role (owner, manager, staff and read-only) can see and do, how to invite the team and how to work with several projects.
- [Notifications](https://fiuit.com/en/docs/team/notifications): The panel bell, push on your phone, which notices you get and where, quiet hours and the project rules.
- [Quickstart](https://fiuit.com/en/docs/quickstart): Create your first booking through the API in five minutes using a key for a test business.
- [Authentication](https://fiuit.com/en/docs/api/authentication): API keys, scopes, and which routes you can use with a key and which are dashboard-only.
- [Conventions](https://fiuit.com/en/docs/api/conventions): Formats, idempotency, pagination, errors and rate limits of the v1 API.
- [Endpoints](https://fiuit.com/en/docs/api/endpoints): The v1 API endpoints grouped by topic, with the scope each one needs, and which areas are dashboard-only.
- [Webhooks](https://fiuit.com/en/docs/api/webhooks): Signed notifications for what happens to your bookings, with automatic retries, a delivery log and examples to verify the signature.
- [TypeScript and Python SDKs](https://fiuit.com/en/docs/api/sdks): Typed clients generated from the OpenAPI contract: how to use them today from the repository, with booking, error, pagination and idempotency examples.
- [MCP and AI agents](https://fiuit.com/en/docs/mcp): Connect Claude, ChatGPT or your own agent to the Fiuit MCP server to look up times, book and run the business with your API key.
- [Recipes](https://fiuit.com/en/docs/recipes): API recipes (customers, tasks, actions, webhooks) and how to model a barbershop, aesthetics, clinic, restaurant and deliveries.

## Docs (Português)

- [Introdução](https://fiuit.com/docs/introduction): O que é a Fiuit, para quem serve e os blocos que você vai usar para atender, agendar e trabalhar com a sua equipe.
- [Primeiros passos](https://fiuit.com/docs/getting-started): Guia passo a passo para montar o seu negócio na Fiuit com a ajuda do Wagy, conectar um canal, testar o bot e fazer a sua primeira tarefa.
- [Como funciona](https://fiuit.com/docs/how-it-works): 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.
- [Workspaces e recursos](https://fiuit.com/docs/concepts/workspaces-and-resources): Organizações, workspaces, papéis, recursos, modos de capacidade e grupos de recursos.
- [Serviços e disponibilidade](https://fiuit.com/docs/concepts/services-and-availability): Serviços, requisitos com vários recursos, horários e como os slots são calculados.
- [Agendamentos e pré-reservas](https://fiuit.com/docs/concepts/bookings-and-holds): Estados do agendamento, a pré-reserva de 10 minutos, sinal e a garantia de zero overbooking.
- [Automatizações](https://fiuit.com/docs/concepts/automations): Regras simples de lembretes e confirmações, horário de silêncio e garantias de execução. Para esperas e condições, veja os fluxos.
- [WhatsApp](https://fiuit.com/docs/channels/whatsapp): Conecte o número do seu negócio por QR, o que o assistente faz com clientes e com a sua equipe, e como encaminhar uma conversa a uma pessoa.
- [Chat web](https://fiuit.com/docs/channels/webchat): Coloque o assistente da Fiuit no seu site com uma linha de código, com dados de contato obrigatórios e regras por canal.
- [Telegram](https://fiuit.com/docs/channels/telegram): Conecte o bot do Telegram do seu negócio para que os clientes reservem e consultem como no WhatsApp, com a mesma caixa e o mesmo bot.
- [Pausas e Estado](https://fiuit.com/docs/channels/pauses-and-status): Pause um canal ou a IA do seu projeto numa emergência e veja em Estado e em Uso de IA se o seu negócio está atendendo.
- [O bot e a IA](https://fiuit.com/docs/bot/overview): O que o bot do seu negócio faz, o que ele não pode fazer, como configurá-lo, testá-lo no simulador e quando a conversa passa para uma pessoa.
- [Conhecimento do bot](https://fiuit.com/docs/bot/knowledge): Ensine o bot com textos, arquivos, páginas web, uma seção do seu site ou listas (planilhas, CSV, JSON e RSS) que se mantêm atualizadas.
- [Trabalho e ações](https://fiuit.com/docs/work/tasks-and-actions): Como o dia a dia se organiza no Fiuit, com Hoje, Inbox e Trabalho, e como funcionam as etapas e as ações de uma tarefa, como assumir, soltar e encerrar.
- [Mapa e endereços](https://fiuit.com/docs/work/map-and-addresses): A visão Mapa de Trabalho, o endereço com preenchimento automático, a localização compartilhada pelo cliente e como a privacidade é protegida.
- [Fluxos](https://fiuit.com/docs/work/flows): O que fazer automaticamente quando algo acontece no seu negócio: esperas, condições e avisos. Carregar exemplos, ativar, pausar e ver o histórico.
- [Condições dos fluxos](https://fiuit.com/docs/work/conditions): Como escrever uma condição em um fluxo, quais dados ela pode olhar, exemplos prontos por segmento e como testá-la antes de ativar.
- [Zonas](https://fiuit.com/docs/work/zones): Agrupe sua equipe por zona, com área, dias e horários de atendimento e um limite por faixa, e deixe cada tarefa receber a sua zona sozinha.
- [Telegram da equipe](https://fiuit.com/docs/team/telegram-team): Receba avisos de trabalho no Telegram, pegue tarefas com um toque e abra seu dia no Mini App "Meu dia".
- [Papéis e permissões](https://fiuit.com/docs/team/roles): O que cada papel (dono, gerente, equipe e somente leitura) pode ver e fazer, como convidar a equipe e como trabalhar com vários projetos.
- [Notificações](https://fiuit.com/docs/team/notifications): O sino do painel, o push no celular, quais avisos você recebe e por onde, o horário de silêncio e as regras do projeto.
- [Início rápido](https://fiuit.com/docs/quickstart): Crie seu primeiro agendamento pela API em cinco minutos com uma chave de um negócio de teste.
- [Autenticação](https://fiuit.com/docs/api/authentication): Chaves de API, scopes e quais rotas podem ser usadas com uma chave e quais são só do painel.
- [Convenções](https://fiuit.com/docs/api/conventions): Formatos, idempotência, paginação, erros e limites de uso da API v1.
- [Endpoints](https://fiuit.com/docs/api/endpoints): Os endpoints da API v1 agrupados por tema, com o scope que cada um pede, e quais áreas são só do painel.
- [Webhooks](https://fiuit.com/docs/api/webhooks): Avisos assinados do que acontece com seus agendamentos, com reenvio automático, log de entregas e exemplos para verificar a assinatura.
- [SDKs de TypeScript e Python](https://fiuit.com/docs/api/sdks): Clientes tipados gerados a partir do contrato OpenAPI: como usá-los hoje a partir do repositório, com exemplos de agendamento, erros, paginação e idempotência.
- [MCP e agentes de IA](https://fiuit.com/docs/mcp): Conecte Claude, ChatGPT ou seu próprio agente ao servidor MCP da Fiuit para buscar horários, agendar e operar o negócio com sua chave de API.
- [Receitas](https://fiuit.com/docs/recipes): Receitas de API (clientes, tarefas, ações, webhooks) e como modelar barbearia, estética, clínica, restaurante e entregas.

## Docs (Español)

- [Introducción](https://fiuit.com/es/docs/introduction): Qué es Fiuit, para quién es y los bloques que vas a usar para atender, agendar y trabajar con tu equipo.
- [Primeros pasos](https://fiuit.com/es/docs/getting-started): Guía paso a paso para armar tu negocio en Fiuit con la ayuda de Wagy, conectar un canal, probar el bot y hacer tu primera tarea.
- [Cómo funciona](https://fiuit.com/es/docs/how-it-works): Arquitectura, principios y la vida de un mensaje, desde que llega por un canal hasta que se convierte en una tarea, una acción o un aviso.
- [Workspaces y recursos](https://fiuit.com/es/docs/concepts/workspaces-and-resources): Organizaciones, workspaces, roles, recursos, modos de capacidad y grupos de recursos.
- [Servicios y disponibilidad](https://fiuit.com/es/docs/concepts/services-and-availability): Servicios, requisitos con varios recursos, horarios y cómo se calculan los slots.
- [Reservas y pre-reservas](https://fiuit.com/es/docs/concepts/bookings-and-holds): Estados de la reserva, la pre-reserva de 10 minutos, señas y la garantía de cero sobreturnos.
- [Automatizaciones](https://fiuit.com/es/docs/concepts/automations): Reglas simples de recordatorios y confirmaciones, horario de silencio y garantías de ejecución. Para esperas y condiciones, mirá los flujos.
- [WhatsApp](https://fiuit.com/es/docs/channels/whatsapp): Conectá el número de tu negocio por QR, qué hace el asistente con clientes y con tu equipo, y cómo derivar una conversación a una persona.
- [Chat web](https://fiuit.com/es/docs/channels/webchat): Poné el asistente de Fiuit en tu sitio con una línea de código, con datos de contacto obligatorios y reglas por canal.
- [Telegram](https://fiuit.com/es/docs/channels/telegram): Conectá el bot de Telegram de tu negocio para que tus clientes reserven y consulten como en WhatsApp, con la misma bandeja y el mismo bot.
- [Pausas y Estado](https://fiuit.com/es/docs/channels/pauses-and-status): Pausá un canal o la IA de tu proyecto en una emergencia, y mirá en Estado y en Uso de IA si tu negocio está atendiendo.
- [El bot y la IA](https://fiuit.com/es/docs/bot/overview): Qué hace el bot de tu negocio, qué no puede hacer, cómo configurarlo, probarlo en el simulador y cuándo pasa la conversación a una persona.
- [Conocimiento del bot](https://fiuit.com/es/docs/bot/knowledge): Enseñale al bot con textos, archivos, páginas web, una sección de tu sitio o listados (hojas de cálculo, CSV, JSON y RSS) que se mantienen al día.
- [Trabajo y acciones](https://fiuit.com/es/docs/work/tasks-and-actions): Cómo se organiza el día a día en Fiuit, con Hoy, Inbox y Trabajo, y cómo funcionan las etapas y las acciones de una tarea, como tomar, soltar y cerrar.
- [Mapa y direcciones](https://fiuit.com/es/docs/work/map-and-addresses): La vista Mapa de Trabajo, la dirección con autocompletar, la ubicación compartida por el cliente y cómo se protege la privacidad.
- [Flujos](https://fiuit.com/es/docs/work/flows): Qué hacer automáticamente cuando pasa algo en tu negocio, con esperas, condiciones y avisos. Cómo cargar ejemplos, activarlos, pausarlos y ver su historial.
- [Condiciones de los flujos](https://fiuit.com/es/docs/work/conditions): Cómo escribir una condición en un flujo, qué datos puede mirar, ejemplos listos por rubro y cómo probarla antes de activarla.
- [Zonas](https://fiuit.com/es/docs/work/zones): Agrupá a tu equipo por zona, con su área, sus días y horas de atención y un tope por franja, y dejá que cada tarea tome su zona sola.
- [Telegram del equipo](https://fiuit.com/es/docs/team/telegram-team): Recibí avisos de trabajo en Telegram, tomá tareas con un toque y abrí tu jornada en la Mini App "Mi día".
- [Roles y permisos](https://fiuit.com/es/docs/team/roles): Qué puede ver y hacer cada rol (dueño, gerente, personal y solo lectura), cómo invitar al equipo y cómo trabajar con varios proyectos.
- [Notificaciones](https://fiuit.com/es/docs/team/notifications): La campana del panel, el push en el celular, qué avisos recibís y por dónde, el horario de silencio y las reglas del proyecto.
- [Inicio rápido](https://fiuit.com/es/docs/quickstart): Creá tu primera reserva por API en cinco minutos con una clave de un negocio de prueba: servicios, horarios, pre-reserva y confirmación.
- [Autenticación](https://fiuit.com/es/docs/api/authentication): Claves de API, scopes y qué rutas se pueden usar con una clave y cuáles son solo del panel.
- [Convenciones](https://fiuit.com/es/docs/api/conventions): Formatos, idempotencia, paginación, errores y límites de uso de la API v1.
- [Endpoints](https://fiuit.com/es/docs/api/endpoints): Los endpoints de la API v1 agrupados por tema, con el scope que pide cada uno, y qué áreas son solo del panel.
- [Webhooks](https://fiuit.com/es/docs/api/webhooks): Avisos firmados de lo que pasa con tus reservas, con reintentos automáticos, log de entregas y ejemplos para verificar la firma.
- [SDK de TypeScript y Python](https://fiuit.com/es/docs/api/sdks): Clientes tipados generados desde el contrato OpenAPI: cómo usarlos hoy desde el repositorio, con ejemplos de reserva, errores, paginación e idempotencia.
- [MCP y agentes de IA](https://fiuit.com/es/docs/mcp): Conectá Claude, ChatGPT o tu propio agente al servidor MCP de Fiuit para buscar horarios, reservar y operar el negocio con tu clave de API.
- [Recetas](https://fiuit.com/es/docs/recipes): Recetas de API (clientes, tareas, acciones, webhooks) y cómo modelar una barbería, estética, clínica, restaurante y entregas.