Partner guide
On the Smart Aleck engine you can build your business's own AI consultant — with your personality, your knowledge, on your channels: your website, Telegram and Facebook Messenger.
What you get
- A bot on your website — a one-line embeddable widget: a floating button and a chat panel that matches your brand.
- The same bot on Telegram and Messenger — teach it once, it answers the same way on all three channels.
- Your knowledge — upload files (prices, services, rules) and the bot grounds its answers in them.
- Your personality — with the instruction (system prompt) you decide what the bot is like: tone, language, topics, what it answers and what it doesn't.
- Questionnaire mode — a button-driven conversation tree that walks the client step by step to the answer.
Where to start
- Go to the partner portal: developers.chkuiskolopi.ge and register. On email confirmation your account receives a $5 gift — building and testing your bot starts free.
- In the portal you meet Ostati („ოსტატი", the Master) — the partners' personal assistant. It doesn't just explain — it does much of the work for you: creating the bot, polishing the instruction, loading knowledge files, building the questionnaire.
- The portal has a live test window for your bot — changes take effect immediately, no page reload needed.
- When you're ready, take the embed code (the
</>button in the portal) and paste it into your site. Technical details — in the developer guide.
Ostati remembers you: previous conversations are stored automatically and can always be found in the portal archive — the Chest („სკივრი"). No need to re-explain old context in a new conversation.
Raising your bot — instruction and knowledge
The instruction (personality)
Your instruction is what matters most: tone, language, topics, behaviour, specialisation — all of it is defined by the text you write. The platform enforces only a safety minimum (legality, protection of system information, proper link rendering) — in everything else the bot follows your word.
Tip: tell the bot in the instruction to format answers with Markdown — bold the key words and prices, list the options. The widget renders it beautifully and answers become far more readable.
The knowledge basket
Upload the files the bot should ground its answers in — a catalogue, prices, rules, FAQs:
- at most 5 files per bot, each up to 5 MB, total text up to 30,000 characters;
- formats: PDF, DOCX, XLSX, TXT, CSV, MD, JSON;
- only the text is kept — the original file does not stay on the server;
- a scanned (image-only) PDF yields no text — upload a text version.
The bot takes this knowledge into account in every answer. To update a file, delete the old one and upload the new one.
The questionnaire — a button tree
If you want the bot to walk a visitor to the answer with buttons ("I'd like the menu" → "Coffee or breakfast?"), enable questionnaire mode. Ask Ostati to build the tree — describe it in words and it will assemble it. Schema details — in the developer guide.
Channels — website, Telegram, Messenger
One and the same bot answers on all three channels with one personality, one knowledge basket and conversation memory.
The site widget
- The embed code is one line — copy it from the portal and paste it into your site's code (instructions).
- The widget works on any website — no special server setup is required.
- The domain list: enter your website(s) and the bot works only there — nobody else can spend your balance.
Telegram
- Create a bot with @BotFather in Telegram and take the token.
- Paste the token in the bot's "Channels" section in the portal — done: your Telegram bot is now your AI consultant.
Facebook Messenger
You need your verified Meta business and a Facebook app. In the portal you paste the Page Access Token, and the system gives you two values (Callback URL and Verify Token) to put into your Meta app. Ostati walks you through it step by step.
Channel parity: on Telegram/Messenger too the bot remembers the conversation context, uses the knowledge basket and can switch power level when needed — exactly like the site widget. A conversation session resets after 1 hour of inactivity.
Look and behaviours
Styling to your brand
- Colours: the main (accent) colour, panel background, bubble colours — a light or dark scheme.
- Shape: corner rounding, the floating button's shape (circle, pill, square).
- Logo: upload your logo and the floating button shows it (or pick an emoji icon).
- White-label: by default the widget header says "powered by chkuiskolopi.ge" — you can turn it off and the branding is fully yours.
Behaviours — the "alive" chat feel
Toggleable features (in the portal's bot modal, or just ask Ostati):
| Behaviour | What it does |
|---|---|
| Typing… | A live "typing…" animation while waiting for the answer |
| Processing ⏳ | On long questions an interim bubble "processing the information…" |
| New chat | The visitor types "start over"/"new chat" (or presses ↺) → the conversation starts from a clean sheet |
| Merging | Several messages sent within seconds are merged into one question |
| 🎤 Voice | The visitor dictates by voice (in Georgian), the text lands in the field — they review and send |
| 📎 Files | The visitor uploads a document or a photo and the bot takes it into account |
Keep in mind: voice recognition is a paid operation charged to your balance — enable it when you really need it.
The greeting — a free "face"
Set a welcome text that the widget shows when the panel first opens. It appears locally and costs nothing — every bot is better off with one.
Billing
- You pay only for real usage — every answer of the bot is charged to your balance.
- The widget works while the balance is above $1; the minimum top-up is $10.
- On registration — a $5 gift.
- Payment: Georgian cards pay in GEL, foreign ones in USD; PayPal is accepted.
- When your balance runs low you get an email warning — the widget won't silently "go dark" on your clients.
Security — what you should know
- The public key: it is visible in the widget code, and that is by design — it is merely the bot's name tag. The real gate is the domain list: enter your sites and the key won't work anywhere else.
- Tokens are secret: the system stores your Telegram and Facebook tokens but never shows them — not to you, not to anyone.
- Irreversible actions: transferring a bot to another account and deleting a knowledge file cannot be undone; putting a bot "to sleep" stops the widget on your site — be careful.
- Your material is yours: the bot uses only your uploaded knowledge and instruction; no one can see another partner's data.
Help
- Ostati — in the portal chat, for any question; it also does much of the work for you.
- ⛑️ The Doctor's Box — a free SOS straight to a human: right in the portal, the message goes to the support team and they answer by email.
- Email: info@chkuiskolopi.ge
Need the technical integration? Go to the developer guide — widget code, API reference, questionnaire schema.