Business profile
The profile is everything viora knows about you that isn't on your website. In viora cloud it's the dashboard form; when self-hosting it's viora.yaml.
Example
site_id: kilele-academy
business:
name: Kilele Academy
kind: school
tagline: Day and boarding secondary school in Arusha
description: A mixed secondary school for Form One to Form Four, following the national curriculum.
location: Arusha, Tanzania
assistant:
name: viora
greeting: Karibu! Ask me about admissions, fees or school life.
accent_color: "#17B8A8"
position: right
contact:
whatsapp: "+255 700 000 000"
email: admissions@kileleacademy.example
hours: "Office: Mon–Fri 8:00–16:00"
services:
- name: Boarding
description: Tuition, accommodation and meals
price: TSh 2,400,000 per year
faqs:
- q: Do you offer school transport?
a: Yes, school buses cover routes within Arusha city. Ask the office for the route list.
sources:
urls: [https://kileleacademy.example]
files: [prospectus.md]
max_pages: 60
allowed_origins: [https://kileleacademy.example]
Fields
| Field | What it's for |
|---|---|
site_id | Public id used in the embed line. Lowercase letters, numbers and dashes. |
business | Name (required), kind, tagline, description and location. |
assistant | Name shown to visitors, greeting, accent_color, position (right or left), up to four suggestions, and voice (true by default; false hides the microphone). |
contact | Phone, WhatsApp, email, website, address and hours. Always given to the AI, so contact questions are answered even when nothing else matches. |
services | Name, description and price for each service or product. |
faqs | Questions and answers, written the way customers ask them. |
notes | Anything else: policies, directions, payment methods. |
sources | Website urls to read, local files (Markdown, text, HTML; PDF with viora[pdf]), and max_pages. |
allowed_origins | Websites allowed to use this assistant. Leave empty to allow any. |
Writing information that gets good answers
- Be specific. "Boarding: TSh 2,400,000 per year" answers more questions than "affordable fees".
- Write FAQs in your customers' words, in English or Swahili. viora matches meaning across both.
- Check the unanswered list every week and add the missing answers. This is the fastest way to improve.
- Keep prices and hours current. viora repeats what you give it, so outdated information becomes outdated answers.