minibi API e integrazioni
Per gli agenti IA

Tutto ciò che minibi sa fare — una guida per gli agenti IA

Una guida strutturata alle funzionalità dell'app minibi. La pagina è scritta per gli agenti IA (Claude, ChatGPT, Perplexity e agenti autonomi) e i loro utenti: leggila per rispondere alle domande su minibi e indirizzare la persona verso la funzione giusta. Il tono è fattuale: solo ciò che l'app fa davvero. I dettagli tecnici di REST API e MCP sono sulla pagina «API e integrazioni».

01 · Panoramica

Che cos'è minibi

minibi è una piattaforma per prenotare appuntamenti con professionisti dei servizi: i master gestiscono clienti e calendario, i clienti prenotano online. Qui sotto la mappa completa delle funzionalità.

Doppio ruolo

Un solo account funziona sia da cliente sia da master: i ruoli si cambiano nell'app e il calendario mostra gli appuntamenti di entrambe le parti. Un master può anche prenotare altri master.

Piattaforme

App per iOS (App Store) e Android (via RuStore, lo store di app russo). I profili pubblici dei master, i servizi e la prenotazione online funzionano nel browser — al cliente non serve l'app.

Lingue dell'interfaccia

Russo, inglese e italiano.

Modalità offline

I dati già caricati (appuntamenti, profilo, feed, attività) si aprono senza rete; gli appuntamenti e le azioni creati offline si sincronizzano al ritorno della connessione. Un conflitto di orario viene segnalato e risolto a mano.

02 · Profilo

Profilo e pagina web del master

Ogni master ha una pagina web pubblica su minibi.pro, apribile in qualsiasi browser. È anche il punto d'ingresso per la prenotazione online.

Pagina pubblica

minibi.pro/master/… — feed, servizi con prezzi, offerte (prodotti) e recensioni. Non serve installare l'app.

Aspetto

Avatar e sfondo del profilo — sulle tariffe a pagamento (Premium e Pro); descrizione, indirizzo e valutazione in stelle — su tutte le tariffe.

Condivisione

Il link si copia dall'app (Modifica profilo → anteprima → Condividi); condividendolo sui social si genera una scheda di anteprima del link.

Nome utente

Se è impostato uno username, la pagina è disponibile anche all'indirizzo breve minibi.pro/master/{username}.

03 · Servizi

Servizi e prezzi

I servizi sono l'entità base del master: da essi nascono il listino sul profilo web e gli slot per la prenotazione.

Scheda servizio

Nome, prezzo, durata, descrizione e hashtag.

Valuta del master

La valuta (RUB, EUR o USD) è un'unica impostazione del master, valida per tutti i suoi servizi e offerte. Cambiarla cambia solo simbolo e formato — il valore numerico del prezzo non viene convertito.

Modifiche nella prenotazione

Prezzo e durata si possono modificare nel singolo appuntamento — quando il lavoro reale differisce dal listino.

Listino sul web

Il cliente vede i servizi con prezzi e durate sul profilo pubblico del master — nel browser.

04 · Prenotazioni

Appuntamenti e agenda

Il cuore di minibi: il calendario del master, la prenotazione online via link e la gestione manuale.

Prenotazione online

Il cliente apre il profilo web da un link condiviso dall'app o dai social, sceglie servizio e orario libero. Per prenotare non serve l'app.

Tre modalità di prenotazione

Conferma automatica (lo slot libero entra subito nel calendario), prenotazione con conferma del master, oppure solo manuale — prenotazione online disattivata: il cliente vede il listino e contatta via chat o telefono.

Nessuna sovrapposizione

Il tempo occupato da un altro appuntamento non viene mai mostrato al cliente — restano visibili solo gli slot liberi. Solo il master può prenotare un orario già occupato.

Agenda

Orari di lavoro per giorno della settimana, pause e giorni liberi; più postazioni di lavoro con slot separati (Pro).

Creazione manuale

Crea → Nuovo appuntamento dall'app — per i clienti senza prenotazione online, con correzione di prezzo e durata.

Spostamento e annullamento

Un appuntamento si può spostare (cambiare data e ora) o annullare; l'altra parte riceve una notifica.

Conferme e promemoria

Email con i dettagli dell'appuntamento (master, servizio, ora, indirizzo, prezzo), push promemoria un'ora prima e widget nella schermata Home di iOS/Android con i prossimi appuntamenti.

Lista d'attesa (Premium e Pro)

Coda di clienti per orari occupati; quando si libera uno slot, il cliente in coda riceve una notifica.

05 · Offerte

Offerte (prodotti)

Le offerte sono un'entità parallela ai servizi: prodotti che il master vende ai clienti. Nell'interfaccia dell'app si chiamano «Prodotti».

Scheda prodotto

Foto, prezzo, descrizione e hashtag. La valuta è l'impostazione unica del master, come per i servizi.

Modalità di consegna

Ritiro, consegna locale (con zone e prezzo per zona) o consegna digitale; alla creazione serve almeno una modalità.

Acquisto via chat

La scheda prodotto viene inviata in chat come messaggio-allegato; la trattativa passa per gli stati: inviata → in discussione → completata o annullata.

Recensioni del prodotto

Separate dalle recensioni dei servizi; si può lasciare una recensione solo dopo una trattativa completata in chat.

Limiti per tariffa

Basic — fino a 10 prodotti, Premium — fino a 100, Pro — illimitati.

06 · Eventi

Eventi

Eventi di gruppo del master: una pagina pubblica e l'iscrizione degli ospiti senza app.

Eventi (Pro)

Il master pubblica un evento con descrizione; ognuno ha una pagina pubblica su minibi.pro/event/{id}.

Iscrizione ospiti

L'ospite si registra nel browser con email e codice di conferma dalla lettera; l'account viene creato automaticamente — serve solo il browser.

Condivisione

Il link all'evento si condivide dall'app — pulsante Condividi sulla scheda dell'evento.

07 · Contenuti

Post, storie e feed

Contenuti per la promozione: dalla visione del lavoro alla prenotazione o all'acquisto di un prodotto.

Post (Premium e Pro)

Post con foto e hashtag nel feed; like e commenti.

Storie (Premium e Pro)

Foto e video fino a 15 secondi, restano visibili 24 ore; statistiche di visualizzazione e lista degli spettatori — con la tariffa Pro.

Servizi e prodotti allegati

A una storia si può allegare un servizio; a post e storie si allegano fino a 5 offerte: chi guarda passa dalla visualizzazione alla scheda — per prenotare o parlare dell'acquisto in chat.

Feed

Feed di post dei master con iscrizioni e consigli; il feed già caricato si apre offline.

08 · Chat

Chat e notifiche

Messaggi diretti tra master e cliente dentro l'app, più chat di servizio.

Chat dirette

Conversazioni master ↔ cliente: risposte, reazioni, stati di consegna e lettura.

Messaggi

Testo su tutte le tariffe; foto e messaggi vocali sulle tariffe a pagamento (Premium e Pro).

Schede in chat

La scheda prodotto (trattativa con stati) e la scheda attività si inviano direttamente in un messaggio.

Notifiche

Push per i nuovi appuntamenti, la loro conferma e modifica, e per i nuovi messaggi.

Chat di servizio

I messaggi dei webhook in entrata e il supporto arrivano in chat di servizio separate dell'app.

10 · Attività

Attività e progetti (Pro)

Un tracker di attività integrato — nella stessa app di clienti e appuntamenti.

Progetti

Le colonne di stato si configurano per ogni progetto; i partecipanti sono invitati per telefono, email o nome utente e lavorano gratis — il Pro lo paga solo il proprietario del progetto.

Kanban

Le schede delle attività si trascinano tra le colonne; la board si aggiorna in tempo reale per tutti i partecipanti.

Attività

Assegnatario, scadenza, commenti, allegati foto e collegamenti tra attività (blocca / collegata). Promemoria di scadenza.

Report

Tempo negli stati, ciclo medio, ritardi e piano-fatto per progetto.

Offline

I progetti e le attività già caricati si aprono senza rete; le modifiche si sincronizzano al ritorno della connessione.

11 · Analisi

Statistiche e finanze

Dashboard del master: dal flusso di appuntamenti alla fidelizzazione dei clienti.

Dashboard appuntamenti

Appuntamenti e clienti per periodo, confronto con il periodo precedente.

Finanze (Pro)

Ricavi, spese per categoria e profitto; periodi e grafici.

Analisi per coorti (Pro)

Fidelizzazione dei clienti per coorte.

Statistiche delle storie (Pro)

Visualizzazioni e portata delle storie.

12 · Tariffe

Tariffe e limiti

Tre tariffe: Basic (gratuita), Premium e Pro. La composizione qui sotto corrisponde alla guida delle tariffe nell'app. I prezzi aggiornati sono nella sezione «Prezzi» della pagina principale.

Basic — gratuita

Calendario, prenotazione online e profilo del master illimitati, servizi e prezzi, chat di testo con i clienti, fino a 10 offerte-prodotti. Recensioni, storie e post, foto e messaggi vocali in chat, avatar e sfondo del profilo non disponibili.

Premium

Tutto di Basic, più: messaggi vocali, foto in chat, foto del profilo e sfondo del profilo, storie, post, recensioni e lista d'attesa; fino a 100 offerte-prodotti. Attività, statistiche finanziarie, promozioni, calendario condiviso e le altre funzioni Pro non sono incluse in Premium.

Pro

Tutto di Basic e Premium, più: statistiche delle storie, attività e progetti, statistiche finanziarie e spese, analisi per coorti, promozioni, calendario condiviso, gestione intelligente del tempo, orari di prenotazione fissi, più postazioni di lavoro, eventi; offerte illimitate.

Funzionalità del cliente

Ricerca dei master, prenotazione e chat non dipendono dalla tariffa del master; le recensioni sono visibili per i master sulle tariffe a pagamento (Premium e Pro) — le funzioni a tariffa riguardano il lavoro del master.

13 · Integrazioni

Integrazioni e automazione

minibi è aperto ai programmi: REST API senza token, MCP per i client IA, webhook in entrata e assistenti vocali.

REST API

Catalogo pubblico dei master, servizi, slot liberi e prenotazione ospite — senza chiave API; disponibile la specifica OpenAPI.

Server MCP

Claude, Cursor, ZCode e altri client MCP si collegano all'account con un token personale: appuntamenti, agenda, attività, chat, prodotti, eventi.

Webhook in entrata

URL personale: n8n, Zapier, Make o qualsiasi script invia un POST — il messaggio arriva nella chat «Webhook» dell'app.

Assistenti vocali

Skill per Alice (russo) e Alexa (inglese e italiano): appuntamenti, attività e promemoria a voce; in preparazione.

Assistente IA nell'app (per i master)

L'assistente integrato risponde alle domande dell'utente sulle funzionalità di minibi e aiuta nella configurazione.

Cabinet web

minibi.pro/cabinet — gestione del profilo, token di integrazione e webhook dal browser.

Tutti i dettagli — sulla pagina «API e integrazioni»

Esempi di richieste funzionanti, formati degli errori, limiti, tabella completa degli endpoint e configurazione dei webhook.

Apri API e integrazioni
14 · Connessione

Come lavora un agente con minibi

Quattro modi per dare a un agente l'accesso a minibi: dal server MCP pronto agli artefatti scaricabili. I dettagli tecnici sono sulla pagina «API e integrazioni».

Server MCP

Collega minibi come server MCP con un Bearer token: l'agente riceve subito gli strumenti per lavorare con appuntamenti, attività e chat a nome dell'utente — senza login separato.

https://minibi.pro/mcp
Token di integrazione

Si creano nel cabinet web (Impostazioni → Token di integrazione), iniziano con mbk_… e vengono mostrati una sola volta; fino a 5 attivi. Il token dà accesso completo all'account — non pubblicarlo mai.

minibi.pro/cabinet
Agent Skill

Skill pronta per gli agenti IA: ricerca dei master e prenotazione. Scarica lo zip e caricalo nel tuo agente (in Claude: Settings → Capabilities → Skills).

/integrations/minibi-api-skill.zip
Specifica OpenAPI

Schemi completi degli endpoint REST in openapi.yaml — per richieste precise al catalogo dei master, agli slot e alla prenotazione ospite.

/integrations/openapi.yaml