Guide index

User manual

Integrations

Google Calendar and the AI assistant on Telegram and WhatsApp.

Updated November 2026

Google Calendar

Export appointments and import external events. Requires Core.

Once connected, appointments export automatically to a dedicated Agenda Core calendar. Importing external events is optional and enabled per calendar: imported events reduce bookable slots, and all-day events close the day unless a manual date override exists. Conflicts appear in the Calendar Google conflicts panel. Disconnecting removes the synced data from the system.

  1. On Core select Connect Google Calendar and complete Google authorisation. Check the connected account on return.
  2. Enable Synchronise Agenda Core to Google to write appointments to its dedicated calendar. Enable Import external events and select source calendars.
  3. Select Synchronise now to save configuration and update imports. Check last sync and errors; if source calendars are missing reconnect to refresh the list.
  4. Timed events block the studio rather than one resource; all-day events close the date when there is no manual override. A conflict with appointments or overrides needs a Calendar check.
  5. Disconnect unlinks the account; read warnings about removing imported data. All resources share one Google connection.

Assistant

Check and manage your calendar from Telegram or WhatsApp, by text, voice, or photo.

Open Settings → Assistant (/dashboard/settings/assistant) to link Telegram and WhatsApp. In Replies, choose the voice note echo: this single account preference applies to both channels. Only the owner can access this page.

The assistant reads your real calendar data and prepares changes. It creates, moves, or cancels an appointment only after you press Confirm. Telegram and WhatsApp offer the same features and use the same AI credit allowance. The linked channel belongs to the owner: team members have no personal channel.

To distinguish clients with the same name, write the full alias saved in Clients, for example «Prenota Pilates martedì domani alle 10» (Book Tuesday Pilates tomorrow at 10). The assistant recognises the alias and shows it to you in replies and choice options. If several clients share an alias, it asks which record to use. Agenda Core replaces names and aliases with opaque references before sending text to the AI provider; clients never see the alias, and appointments keep the original name.

What you can ask
TopicExampleResult
AppointmentsQuanti appuntamenti ho la settimana prossima? (How many appointments do I have next week?)Total and period. Ask for the list if you need details.
AvailabilityCosa ho libero giovedì pomeriggio? (What is free on Thursday afternoon?)Up to three real times to choose with buttons.
BookingsPrenota Mario Rossi domani alle 10 per una visita (Book Mario Rossi tomorrow at 10 for a visit)A proposal to review and confirm.
Moves and cancellationsSposta l'appuntamento di Mario Rossi a venerdì (Move Mario Rossi's appointment to Friday)A proposal to review and confirm.
ClientsQuante disdette ha fatto Mario Rossi? (How many cancellations has Mario Rossi made?)Recent and upcoming appointments, cancellations, and no-shows.
StatisticsQuante disdette ho avuto a ottobre? (How many cancellations did I have in October?)Counts by status and service, booked minutes.
StudioQuanto costa la visita? Sabato sono aperto? (How much is the visit? Am I open on Saturday?)Duration, price, hours, closures, and overrides.
To handleCosa ho in attesa? Chi è in lista d'attesa? (What is pending? Who is on the waitlist?)Requests, proposals, and the waitlist.

Assistant limits

Confirmation
It never writes to the calendar without Confirm. Check client, service, and time before pressing it.
Periods
Each lookup covers up to 31 days. Long lists can be partial; totals stay complete.
Verified data
If a reply contains a value not found in the data, Agenda Core removes it and shows only the verified data, in a plainer form.
Language
It replies in Italian.
Content
It accepts text, voice notes, audio, and photos. Videos, documents, and stickers are unsupported.
Clients
It does not message clients on its own: notifications follow the Messages rules.
Processing
If you reach a processing or cost limit, send a new request or use the web calendar. After a delivery error the reply can be lost: send a new message.
Costs in AI credits
OperationCost
Single question, text or photo1 AI credit
Voice note or audio1 AI credit per begun minute: 60 seconds cost 1, 61 seconds cost 2
Text reply to an open draftIncluded in the draft's action
Voice reply to an open draftAdds the audio's begun minutes
Buttons, Confirm, and CancelFree
Voice note echo, including summariesFree
Change on the final proposalNew request, new action
Assistant replies on WhatsAppDo not use the message allowance

Free includes 20 AI credits per month, Core 100 per operator. Agenda Core uses the included allowance first, then top-ups. On Core, top-ups start at 250 AI credits for €2.49 + VAT and never expire. Find usage in Subscription, under Usage this month.

AI models
FunctionModelProvider
Conversation and calendarClaude Haiku 5.5Google Vertex AI, Europe
Conversation fallbackClaude Haiku 5.5, GPT-6 LunaAmazon Bedrock, Azure, Europe
Voice note transcriptionWhisper Large v3Groq
Photo readingGemini 2.5 Flash LiteGoogle

Models can change after a provider review; the cost in AI credits does not depend on the model. Before the conversation, Agenda Core replaces clients with anonymous references. The model does not receive client contacts or notes. The text you write, the photo, and the audio still reach the listed providers: avoid unnecessary sensitive data.

Link a channel
StepTelegramWhatsApp
First stepGenerate the link in Settings → Assistant, open it in Telegram, and activate the botGenerate the link in Settings → Assistant, open it, and send the prefilled COLLEGA command
Link validityTen minutesTen minutes, single use
Audio lengthLimit set by the operatorUp to 60 seconds, or a lower configured limit
More than three choicesButtonsScegli list
Cancel a draftCancel, /annulla, or /cancelannulla
UnlinkDisconnect in Settings → Assistant or /unlink in the botDisconnect in Settings → Assistant or scollega in chat
Instructions—aiuto or help
RetentionTelegram stores messages and media on its serversMeta stores messages and media
  • Drafts: if a detail is missing, the assistant keeps a draft and asks for one detail at a time. The draft lasts fifteen minutes from the first message, with up to five AI turns. After the limit or expiry, the next message opens a new request.
  • New request: on Telegram the prefix new request: replaces the open draft.
  • Questions and bookings: you can combine them in one message. Buttons keep date and time-of-day constraints.
  • Voice note echo: choose Off (default), Transcript, or Summary. The preference applies to Telegram and WhatsApp. After transcribing a voice note, the bot sends the text in chat before replying. Summaries use 1–2 Italian sentences. Agenda Core does not archive this text; the channel keeps the message. Audio files do not trigger echo. After a delivery error, the bot may not repeat the text.