Events 📅
Events lets you feed your upcoming schedule directly into Konvoq's AI. Once events are in the system, visitors can ask the widget things like "What's on this weekend?" or "Do you have any yoga classes next week?" and get accurate, up-to-date answers.
Manage events at Dashboard → Knowledge → Events.
:::info Pro & Enterprise only Events is available on Pro (up to 500 events) and Enterprise (unlimited). Free and Basic plans don't have access to this section. :::
How the AI uses events
When a visitor asks something that sounds like an event question, Konvoq automatically:
- Detects the intent (e.g. "What workshops are on next Saturday?")
- Parses the time window from the question ("next Saturday")
- Queries your events table for matching events in that window
- Builds a structured context block and passes it to the AI
- The AI answers with accurate titles, dates, times, locations, and prices
This happens before the general knowledge base search, so event questions always get the freshest structured data rather than a scraped text match.
Example questions the widget can answer
- "What events do you have this week?"
- "Any workshops this weekend?"
- "What's happening next Saturday?"
- "Do you have events in July?"
- "When is the next yoga class?"
Event fields
| Field | Required | Notes |
|---|---|---|
| Title | Yes | Name of the event |
| Starts at | Yes | Date and time the event begins |
| Ends at | No | Leave blank for open-ended or all-day events |
| Description | No | Short summary shown in context |
| Location | No | City, address, or venue name |
| URL | No | Link to registration or event page |
| Price | No | e.g. Free, $25, ₹500 |
| Recurring | No | daily, weekly, monthly, yearly — the AI shows the next occurrence |
| Status | Auto | upcoming, cancelled — cancelled events are excluded from responses |
Event limits
| Plan | Event limit |
|---|---|
| Free | Not available |
| Basic | Not available |
| Pro | 500 events |
| Enterprise | Unlimited |
When you reach your plan's limit, existing events can still be updated but no new events can be created until some are deleted.
Priority: which source wins when events overlap?
If the same event comes in from multiple sources (e.g. manually entered and also in your iCal feed), Konvoq merges them using a priority ladder:
| Source | Priority |
|---|---|
| Manual entry (locked) | Highest — never overwritten |
| Manual entry (unlocked) | Very high |
| Webhook | High |
| Bulk CSV import | Medium-high |
| iCal / RSS URL source | Medium |
| JSON-LD (auto-detected from scrape) | Low |
| HTML scrape | Lowest |
Two events are considered the same if they share the same title + date + city. Higher-priority sources overwrite lower-priority field values.
To permanently protect an event from being overwritten by any automated source, enable Lock when creating or editing it manually.
Ways to add events
There are five ways to get events into Konvoq:
| Method | Best for |
|---|---|
| Manual entry | One-off events, quick additions |
| CSV / Excel import | Bulk upload from a spreadsheet |
| iCal / RSS URL source | Automatic sync from your calendar app or website |
| JSON-LD auto-detect | Events already marked up on your website |
| Webhook ingest | Push from external booking or ticketing systems |