Strumenti · Prenotazioni e Appuntamenti

Il modulo Prenotazioni e gli Appuntamenti tramite l'assistente: cercare sale e orari liberi (con il costo in crediti e il tuo saldo), prenotare, spostare, annullare, segnare l'assenza, scaricare l'invito di calendario, registrare sale e scrivanie, bloccare orari, definire i prezzi e approvare le agende dei membri. I due moduli usano gli stessi strumenti di prenotazione; quelli degli Appuntamenti sono gli ultimi cinque.

Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.

#In sintesi

"Team" è il proprietario, l'amministratore, il moderatore e la finanza. I ruoli sono quelli delle rotte: l'assistente non fa mai più di quanto la persona collegata farebbe sullo schermo.

Gli spazi si creano con create_space e module: "bookings" o "scheduling"; update_space cambia solo ciò che invii. L'argomento bookings porta i valori predefiniti di ogni sala (slot_minutes, min_duration_minutes, max_duration_minutes, min_notice_minutes, max_advance_days, show_booker_name e opening_hours, con le chiavi da mon a sun e periodi HH:MM); scheduling porta gli stessi più offerers (ADMINS, TEAM o MEMBERS), allow_paid_slots e require_listing_approval.

Orari. Gli orari che invii sono sempre sull'orologio della community ("2026-11-03T14:00", senza suffisso). Costi. Prenotare, spostare e annullare toccano i crediti: l'assistente dice il costo e il saldo prima di prenotare. Senza crediti sufficienti, la risposta riporta required, balance e shortfall; con l'orario occupato, riporta i prossimi orari liberi.

#Cercare e consultare

#search_booking_rooms

Solo lettura

Ciò che risponde alla richiesta. Indica un inizio esatto (starts_at) o una fascia del giorno (date con from e to), più durata, capienza e dotazioni. Restituisce solo le risorse che corrispondono, con gli orari di inizio liberi, il costo in crediti, canAfford e il tuo saldo, ordinate dalla più presto e poi dalla capienza minore; quando nulla va bene, next_slots elenca i prossimi orari per la stessa richiesta.

Chiedi così: "Mi serve una sala per 6 persone domani dalle 14 alle 16, con proiettore."

#check_availability

Solo lettura

Libero e occupato. Gli orari di un giorno (o fino a 7), calcolati dall'orario settimanale, dai blocchi e dalle prenotazioni, ogni orario libero con creditCost e canAfford. Non dice mai chi ha prenotato, a meno che lo spazio mostri il nome.

#list_booking_resources

Solo lettura

Le sale. Sale, scrivanie, postazioni e agende dello spazio. Il membro vede solo quelle visibili, attive e aperte alle prenotazioni; il team le vede tutte. Parametri: space (obbligatorio), kind, host_profile_id, page, limit.

#list_booking_amenities

Solo lettura

Il catalogo delle dotazioni che la community accetta (proiettore, TV, lavagna, Wi-Fi…). Una chiave fuori dal catalogo viene rifiutata. Senza parametri.

#get_booking_resource

Solo lettura

Una sala con le regole effettive già combinate con i valori predefiniti dello spazio (orario, intervallo, limiti di durata, preavviso, finestra di annullamento). Parametro: resource_id.

#Prenotare

#create_booking

Modifica

Prenotare per te. Prenota subito (già confermata) e addebita i tuoi crediti nello stesso passo. Prima, l'assistente dice il costo e il saldo. Per prenotare a nome di un altro membro, usa create_booking_for_member. La cortesia (waive_credits con waive_reason) è solo del proprietario e dell'amministratore. L'e-mail di conferma con l'invito di calendario entra in coda. Restituisce creditCost e balanceAfter.

Chiedi così: "Prenota la Sala 2 domani dalle 14 alle 16 per 6 persone."

#create_booking_for_member

Chiede conferma

Prenotare a nome di un membro. Addebita i crediti del membro (o è gratuita come cortesia, solo proprietario e amministratore, con waive_reason) e il membro riceve l'e-mail con l'invito. Prima di agire, mostra un riepilogo con il membro e il suo saldo e ripete la chiamata solo dopo il tuo sì. Stessi parametri e stesse risposte di create_booking, più profile_id. Ruolo minimo: moderatore (o finanza).

Chiedi così: "Prenota la Sala 1 venerdì alle 10, a nome di Maria."

#list_my_bookings

Solo lettura

Le tue prenotazioni, oppure, con as_host, quelle che le persone hanno fatto sull'agenda che offri. Filtri: space, resource_id, status (elenco, es. CONFIRMED,NO_SHOW), from, to, order, page, limit. Ognuna riporta canCancel.

#list_bookings

Solo lettura

Tutte le prenotazioni della community, con gli stessi filtri. Ruolo minimo: moderatore (o finanza).

#get_booking

Solo lettura

Una prenotazione: sala, persona, orari, stato, costo in crediti, se è stata una cortesia o un annullamento tardivo e cosa può fare chi chiede. Solo il titolare, l'host e il team; chiunque altro riceve 404. Parametro: booking_id.

#Cambiare una prenotazione

#cancel_booking

Chiede conferma

Annullare. Se il titolare annulla dopo la finestra (24 h per impostazione predefinita), l'annullamento è segnato come tardivo e può perdere i crediti; entro la finestra, o quando annulla il team o l'host, il rimborso è per intero. La persona riceve l'e-mail e l'evento viene annullato nel suo calendario. Una prenotazione già iniziata non si annulla (usa l'assenza). Mostra un riepilogo e agisce solo dopo il tuo sì.

#reschedule_booking

Chiede conferma

Spostare. Cambia l'orario nella stessa sala (ciò che non invii resta, e la durata si mantiene). Tocca i crediti: un orario più caro addebita la differenza (senza saldo, la risposta riporta shortfall), uno più economico rimborsa, una cortesia non tocca il registro. L'invito viene aggiornato e la persona riceve un'e-mail. Mostra il riepilogo e restituisce charged, refunded e balanceAfter.

#mark_booking_no_show

Modifica

Segnare l'assenza. Solo per una prenotazione confermata già iniziata. La community decide se i crediti si perdono; la risposta dice quanti ne sono stati restituiti. Team e host. Parametro: booking_id.

#get_booking_ics

Solo lettura

L'invito di calendario, lo stesso file dell'e-mail di conferma, restituito come testo in ics con il nome del file (una prenotazione annullata restituisce l'annullamento). Parametro: booking_id.

#Sale, blocchi e prezzi

#create_booking_resource

Modifica

Creare una sala, scrivania o agenda. kind è ROOM, DESK, STATION o OTHER (proprietario e amministratore); negli Appuntamenti, PERSON: chi può creare l'agenda di una persona lo decide offerers dello spazio (un membro crea solo la propria). Il tipo non cambia dopo. Senza fascia di prezzo, è gratuita.

#update_booking_resource

Modifica

Modificare. Cambia solo ciò che invii; cambia la foto con image_url o image_base64 e la rimuove con remove_image. Le prenotazioni esistenti mantengono il prezzo. Parametro resource_id più i campi sopra. Negli Appuntamenti, chi offre modifica la propria agenda, tranne listed.

#delete_booking_resource

Chiede conferma

Eliminare. Con prenotazioni future attive, la risposta è 409 con il loro elenco; con cancel_bookings: true, le annulla tutte (rimborso per intero ed e-mail a ogni persona) ed elimina. Proprietario o amministratore.

#list_availability_exceptions

Solo lettura

Blocchi (CLOSED) e orari extra (OPEN) di una sala da qui in avanti. Parametri: resource_id, from.

#create_availability_exception

Modifica

Bloccare o aprire un periodo. kind è CLOSED (predefinito: manutenzione, festività) o OPEN (extra). Un blocco con prenotazioni attive viene rifiutato con 409 e il loro elenco: per annullarle, usa cancel_bookings_for_closure. Sale: il team; agende di persone: chi offre e il proprietario e l'amministratore.

#cancel_bookings_for_closure

Chiede conferma

Bloccare annullando. Blocca il periodo e annulla ogni prenotazione attiva al suo interno: ognuna viene rimborsata per intero, ogni persona riceve l'e-mail e l'evento viene annullato nel calendario. Dice quante ne sono state annullate. Usalo dopo che create_availability_exception ha risposto 409 e la persona ha acconsentito. Parametri: resource_id, starts_at, ends_at, reason.

#delete_availability_exception

Chiede conferma

Rimuovere un blocco o un orario extra. Le prenotazioni che il blocco ha già annullato non tornano. Parametri: resource_id, exception_id.

#list_price_rules

Solo lettura

Le fasce di prezzo di una sala (l'unica fonte di prezzo; senza fascia, è gratuita). Vale la prima che si adatta: data specifica, poi giorno della settimana, poi il predefinito; il costo è per blocco, e ogni blocco usa la fascia in cui inizia. Proprietario o amministratore. Parametro: resource_id.

#create_price_rule

Modifica

Creare una fascia. Per esempio, 3 crediti ogni 30 minuti. Un orario offerto da un membro è sempre gratuito; negli Appuntamenti, una fascia a pagamento richiede Consenti orari a pagamento nello spazio (409). L'addebito in denaro non è ancora attivo.

#update_price_rule

Modifica

Modificare una fascia (resource_id, rule_id e solo ciò che cambia). Le prenotazioni già fatte mantengono il prezzo.

#delete_price_rule

Chiede conferma

Rimuovere una fascia. Senza nessuna, la sala diventa gratuita; le prenotazioni già fatte mantengono il prezzo. Parametri: resource_id, rule_id.

#Appuntamenti

#get_scheduling_config

Solo lettura

Le regole dello spazio: chi offre (offerers), allowPaidSlots, requireListingApproval, se puoi offrire ora, le tue agende e, per il proprietario e l'amministratore, quante offerte attendono approvazione. L'orario di un membro è sempre gratuito. Parametro: space.

#search_scheduling_hosts

Solo lettura

Persone con orari liberi. Ognuna arriva con le agende, quanti orari liberi ha e i prossimi 3 (gratis o con il costo in crediti, con canAfford) e il tuo saldo. Quando nessuno ha orari, suggerisce i più vicini. Per prenotare, usa create_booking.

#get_scheduling_host

Solo lettura

La pagina di una persona, con la griglia degli orari liberi per giorno (da 1 a 7 giorni). Una persona senza agenda visibile, che ha perso il ruolo o di un'altra community risponde 404. Parametri: space, profile_id, date, days, duration_minutes.

#list_pending_scheduling_offers

Solo lettura

Agende in attesa di approvazione, ognuna con il titolare e se rispetta ancora la regola di chi offre. Proprietario o amministratore. Parametro: space.

#set_booking_resource_listing

Modifica

Approvare o rimuovere un'agenda. listed: true approva (l'agenda compare ai membri); false la rimuove (non annulla nessuna prenotazione già fatta, impedisce solo quelle nuove). Reversibile, senza conferma. Proprietario o amministratore. Parametri: resource_id, listed.

#Correlati

• Prenotazioni
• Appuntamenti
• Strumenti · Crediti
• Strumenti
• Denaro e conferma
• Ricette