In this article, you will learn which information MagicAI Chat already gets from the software automatically, what you need to provide through your own knowledge sources, and how to structure that content so the bot answers your members accurately.
Contents
- How MagicAI Chat uses your information
- What comes automatically from the software
- What belongs in your knowledge sources
- File format recommendations
- Tips for better answers
- How often to update
- Related articles
How MagicAI Chat uses your information
MagicAI Chat can do more than answer questions. It can also act directly: book trial sessions, pause contracts, switch rates. Those actions come from the software. This article covers the information side, that is, everything MagicAI Chat needs to know in order to answer questions precisely.
MagicAI Chat answers exclusively on the basis of the content available to it. It does not make up answers, and it can only answer what is actually stored. If a member asks a question for which no matching information exists, MagicAI Chat cannot help. Complete, up-to-date knowledge sources are therefore decisive for the quality of MagicAI Chat.
Two kinds of information are available to MagicAI Chat:
- System data: information that comes automatically from the software (for example opening hours, contracts, class schedule, membership offers).
- Knowledge sources: content you provide yourself (files, URLs or your Zendesk Help Center).
Anything that does not come from the system and is not stored in your knowledge sources cannot be answered by MagicAI Chat.
What comes automatically from the software
The following information is pulled directly from the software, depending on which feature you have activated. You do not need to add it to your knowledge sources. On the contrary, duplicated information can lead to contradictory answers.
| Comes from the software (when the feature is active) | Do not duplicate in your sources |
|---|---|
| Opening hours, address and contact details of the studio | Opening hours, address, phone number |
| Membership offers and prices | Price lists, rate overviews |
| Available trial-session slots and booking | Available appointments |
| Class schedule and available classes | Class times and class descriptions |
| Cancellation process | Cancellation steps (MagicAI Chat guides the member through the process) |
| Requesting idle periods (freeze) | Freeze steps (MagicAI Chat guides the member through the process) |
Important: These restrictions only apply when you have activated the relevant feature. If a feature is active, rely on the system data. If your sources contain, for example, an old price while the software delivers the current one, the answers can contradict each other.
If you deliberately did not activate a feature, for example because you have a special case such as a paid trial session that MagicAI Chat cannot handle, then it does make sense to cover that topic in your knowledge sources. The table above is not a blanket ban but a guideline: whatever the system already delivers automatically, you do not need to maintain twice.
What belongs in your knowledge sources
Your knowledge sources cover everything that does not come automatically from the system, which means everything your studio does individually. The list below shows typical questions your members ask that can only be answered through your knowledge sources.
Trial session and registration
- What do I need to bring to a trial session?
- How does the trial session work?
- What is the minimum age to sign up?
- Can I view the studio beforehand?
- What does a day pass include? Does it cover the sauna and parking, and may I enter more than once?
Facilities and offering
- Is there parking? Is it free?
- Are there showers, lockers and towels?
- Is there a sauna or wellness area? Is it separated by gender or mixed?
- Does the sauna have its own opening hours that differ from the studio's?
- Is there WiFi in the studio?
- Are there drinks or a water dispenser?
- How large is the training area?
- Do you offer personal training? Roughly what does it cost?
Guests and companions
- Can I bring a friend?
- What does a day pass cost?
- Is there a “bring a friend” promotion?
- What is the minimum age for guests?
- Can children accompany their parents into the studio without training themselves?
Membership and contract
- How does signing a contract work?
- What do I need to bring to sign a contract?
- Are there student, pupil or senior rates?
- Do you offer corporate fitness options (Hansefit, EGYM Wellpass, Urban Sports Club, etc.)?
- How does signing up via corporate fitness work?
- Can I change my rate (upgrade or downgrade)?
- Can I change my home studio?
- Is there a current special offer or promotion? Until when is it valid and what conditions apply?
- I signed up online. From when can I come to the studio?
- Can I transfer my membership to another person?
- Can I give a membership as a gift?
- Can I keep using the studio until the end of my contract after I have cancelled?
- I have cancelled. Can I undo it?
- Is there a right of withdrawal after signing up?
Payment
- When is the membership fee debited?
- My payment failed. What should I do?
- Is there a registration fee or an administration fee?
- How does a refund for overpayment work?
- Why was a different amount debited than expected?
- Which payment methods are accepted?
- Are there other mandatory recurring fees besides the monthly fee?
House rules
- What clothing do I need to wear?
- Do I need a towel?
- Am I allowed to take photos or film in the studio?
- May I bring my dog?
- What are the rules for the sauna and wellness area?
- Do I have to wipe down equipment after use?
- Can I enter the studio more than once a day?
- What should I do if a piece of equipment is broken?
App and access
- What can I do in the app?
- I cannot log in to the app. What should I do?
- How does 24/7 access work?
- The entrance door will not open. What should I do?
- I lost my membership card. How do I get a new one?
- Is there a digital membership card, and how do I use it?
- How do I top up consumption credit?
Other
- Are you hiring? How can I apply?
- Is the studio accessible for people with disabilities?
- When is the studio busiest?
- Are there special programmes (for example Hyrox or rehab sport)?
- Can I just come and train with a corporate fitness option (for example Wellpass or Hansefit), or do I need to register separately?
- Is the studio open on public holidays, and if so, do different opening hours apply?
- How do I get a membership confirmation (for example for my health insurer)?
File format recommendations
Recommended formats
- Text files (.txt, .md): best suited. Clear structure, easy to update.
- PDF: works as long as the text is selectable. Scanned documents or image-only PDFs are not recognised.
Not suitable
- Scanned PDFs (text cannot be extracted)
- Image-only files
- Excel spreadsheets (relationships are lost)
Website as a source
- MagicAI Chat can read your existing website or FAQ page.
- It follows up to 5 levels deep and a maximum of 50 links.
- The page must be publicly accessible (no login required).
Important: If your website is intended to serve as a source of information, simply entering a domain is sufficient. Our system will then crawl all information up to 5 levels deep. Adding each subpage individually as a source of information is counterproductive for processing and can lead to errors.
Tips for better answers
The quality of MagicAI Chat's answers depends directly on how your knowledge sources are built. Here are the most important recommendations.
Every section must be understandable on its own
MagicAI Chat searches for the text sections that match a question. A section that makes no sense without the text before it leads to poor answers.
Less effective
Cancellation
You can cancel at any time. The notice period is 5 working days.
Better
Cancelling your Example Fitness membership
The Example Fitness membership can be cancelled monthly. The notice period is 5 working days before the next renewal date.
Give headings context
Less effective
Guests
Better
Guest policy at Example Fitness Anytown
This lets MagicAI Chat assign the section more accurately, even when the question is phrased generally.
One topic per section
Each section should answer exactly one question. Do not mix several topics in one long paragraph.
Keep conditions and restrictions with the statement
If a rule has exceptions or prerequisites, they must sit in the same section, not further down or in a separate paragraph.
Less effective
What is the minimum age to become a member?
You must be at least 15 years old.
Signing a contract for minors
A legal guardian must be present when the contract is signed in the studio.
Better
What is the minimum age to become a member?
You must be at least 15 years old. If you are a minor (15 to 17), your legal guardian's consent is required. A legal guardian must be present when the contract is signed in the studio. Online registration is not possible for minors.
Use the FAQ format
The most effective format is question and answer.
Example
How can I cancel my Example Fitness membership?
The Example Fitness membership can be cancelled monthly via:
the Member App (fastest option), email to info@example-fitness.com, post to [address].
The notice period is 5 working days before the renewal date.
Use consistent terminology
Always use the same term for the same concept. If you alternate between “app”, “training app”, “member portal” and “online area”, it is harder for MagicAI Chat to recognise that they all mean the same thing.
Facts, not marketing
MagicAI Chat searches for facts. Marketing copy such as “Experience your best workout” does not help. “The studio offers 500 m² of training space with 80 machines” does.
Avoid contradictions
The same information should appear in only one place. If opening hours appear in three different places with different details, MagicAI Chat gives contradictory answers. Duplicated content also takes up slots in the search results and may crowd out other relevant information.
Sections not too short and not too long
A good section is 3 to 8 sentences and answers one question completely, including all conditions and restrictions. Sections that are too short (1 to 2 sentences) give too little context. Sections that are too long (more than half a DIN A4 page) make it harder for MagicAI Chat to find the relevant passage.
How often to update
System data (opening hours, prices, class schedule and so on) is pulled from the software in real time, so you do not need to update anything manually here.
For your knowledge sources:
- File sources: after every change to your documents, click the Update knowledge sources button so MagicAI Chat uses the new content.
- Website sources (URLs): re-crawled automatically every night. Make sure your website is up to date, otherwise MagicAI Chat passes on outdated information.
- Zendesk Help Center: synced automatically every night.