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.
- On Core select Connect Google Calendar and complete Google authorisation. Check the connected account on return.
- Enable Synchronise Agenda Core to Google to write appointments to its dedicated calendar. Enable Import external events and select source calendars.
- Select Synchronise now to save configuration and update imports. Check last sync and errors; if source calendars are missing reconnect to refresh the list.
- 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.
- 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.
| Topic | Example | Result |
|---|---|---|
| Appointments | Quanti appuntamenti ho la settimana prossima? (How many appointments do I have next week?) | Total and period. Ask for the list if you need details. |
| Availability | Cosa ho libero giovedì pomeriggio? (What is free on Thursday afternoon?) | Up to three real times to choose with buttons. |
| Bookings | Prenota 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 cancellations | Sposta l'appuntamento di Mario Rossi a venerdì (Move Mario Rossi's appointment to Friday) | A proposal to review and confirm. |
| Clients | Quante disdette ha fatto Mario Rossi? (How many cancellations has Mario Rossi made?) | Recent and upcoming appointments, cancellations, and no-shows. |
| Statistics | Quante disdette ho avuto a ottobre? (How many cancellations did I have in October?) | Counts by status and service, booked minutes. |
| Studio | Quanto costa la visita? Sabato sono aperto? (How much is the visit? Am I open on Saturday?) | Duration, price, hours, closures, and overrides. |
| To handle | Cosa 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.
| Operation | Cost |
|---|---|
| Single question, text or photo | 1 AI credit |
| Voice note or audio | 1 AI credit per begun minute: 60 seconds cost 1, 61 seconds cost 2 |
| Text reply to an open draft | Included in the draft's action |
| Voice reply to an open draft | Adds the audio's begun minutes |
| Buttons, Confirm, and Cancel | Free |
| Voice note echo, including summaries | Free |
| Change on the final proposal | New request, new action |
| Assistant replies on WhatsApp | Do 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.
| Function | Model | Provider |
|---|---|---|
| Conversation and calendar | Claude Haiku 5.5 | Google Vertex AI, Europe |
| Conversation fallback | Claude Haiku 5.5, GPT-6 Luna | Amazon Bedrock, Azure, Europe |
| Voice note transcription | Whisper Large v3 | Groq |
| Photo reading | Gemini 2.5 Flash Lite |
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.
| Step | Telegram | |
|---|---|---|
| First step | Generate the link in Settings → Assistant, open it in Telegram, and activate the bot | Generate the link in Settings → Assistant, open it, and send the prefilled COLLEGA command |
| Link validity | Ten minutes | Ten minutes, single use |
| Audio length | Limit set by the operator | Up to 60 seconds, or a lower configured limit |
| More than three choices | Buttons | Scegli list |
| Cancel a draft | Cancel, /annulla, or /cancel | annulla |
| Unlink | Disconnect in Settings → Assistant or /unlink in the bot | Disconnect in Settings → Assistant or scollega in chat |
| Instructions | — | aiuto or help |
| Retention | Telegram stores messages and media on its servers | Meta 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.