๐Ÿ“š

Obsidian Gold โ€” Complete Setup Guide

Everything from installation to going live

๐Ÿ“‹ Table of Contents
  1. After Installation โ€” Admin First Steps
  2. Creating Your First Chatbot
  3. Training Your Bot (FAQs & Keywords)
  4. Adding Quick Reply Buttons
  5. Website Integration (All Platforms)
  6. Live Agent Chat Setup
  7. SMTP Email Configuration
  8. Managing Leads
  9. Analytics & Reports
  10. Client Management (Admin)
  11. Troubleshooting Common Issues

1
After Installation โ€” Admin First Steps

  1. Login at https://chat.savjgroup.com/login.php with admin credentials set during install
  2. Go to Admin โ†’ SMTP Email โ€” Configure email so clients get notifications
  3. Go to Admin โ†’ SEO Settings โ€” Set title, description, Google Analytics code
  4. Go to Admin โ†’ Packages โ€” Edit or create pricing plans (they appear on homepage instantly)
  5. Go to Admin โ†’ Settings โ€” Update homepage hero text, contact info, social links
  6. Go to Admin โ†’ Announcements โ€” Create a welcome message for new clients

2
Creating Your First Chatbot

  1. Login at https://chat.savjgroup.com/client/index.php
  2. Click ๐Ÿง  Bot Training in sidebar, then + New Bot
  3. Choose an industry template (Real Estate, Beauty, Finance, etc.) for pre-built FAQs
  4. Enter bot name, set theme color, write a welcome message
  5. Click Create Chatbot โ†’
๐Ÿ’ก Templates: Each template includes 5 ready-made FAQs and 4 quick reply buttons so your bot works immediately after creation!

3
Training Your Bot (FAQs & Keywords)

  1. Go to Bot Training โ†’ FAQs tab
  2. Enter keywords (words visitors type): price, cost, charges, rate, fees
  3. Enter the question and a clear answer
  4. Set priority (10=highest) and click Add FAQ
Example:
Keywords: price, cost, charges, rate
Question: What is your pricing?
Answer: Our plans start from โ‚น999/mo. Want a custom quote?
Synonyms Tab: Teach bot that "cost" = "price" = "charges" = "fee" so all variations work.
Documents Tab: Upload PDF/TXT files โ€” bot searches them automatically when no FAQ matches.

4
Adding Quick Reply Buttons

  1. Go to Bot Training โ†’ Quick Replies tab
  2. Add buttons visitors see when they open the chat
  3. Action types: Send Message, Open URL, WhatsApp, Capture Lead
Examples: ๐Ÿ’ฐ Pricing ๐Ÿ“ž Call Us ๐Ÿ“… Book Demo ๐Ÿ“ฒ WhatsApp

5
Website Integration

โšก One Line of Code โ€” Works Everywhere
<script src="https://chat.savjgroup.com/widget/widget.js?id=YOUR_BOT_ID" defer></script>
Find your Bot ID in Dashboard โ†’ click your bot card โ†’ copy the ID shown
๐Ÿ“ WordPress
Appearance โ†’ Theme Editor โ†’ footer.php โ†’ paste before
๐Ÿ›’ Shopify
Online Store โ†’ Themes โ†’ Edit Code โ†’ theme.liquid โ†’ paste before
๐ŸŽฏ Wix
Settings โ†’ Custom Code โ†’ Add Code โ†’ Body End โ†’ All Pages
๐ŸŒ HTML
Find tag โ†’ paste script just before it โ†’ save & upload

6
Live Agent Chat Setup

  1. Go to Themes page โ†’ enable Live Agent Tab toggle
  2. Go to ๐Ÿ‘ค Live Agent in sidebar
  3. Select your bot, click Go Online
  4. Visitors see a "Live Agent" tab in your widget
  5. You receive and reply to messages in real-time
When offline: Visitors leave a message. Bot captures their lead automatically so you can follow up!

7
SMTP Email Configuration

  1. Go to Admin โ†’ SMTP Email
  2. Click a provider preset (Gmail, Zoho, Outlook, SendGrid)
  3. Enter email and password (Gmail = App Password)
  4. Enter From Name, click Save
  5. Click Send Test Email to verify
Gmail App Password: Google Account โ†’ Security โ†’ 2-Step Verification โ†’ App Passwords โ†’ Generate for "Mail"
Auto-emails: Welcome ยท New Lead ยท Password Reset ยท Subscription ยท Ticket Reply

8
Managing Leads

  1. Go to ๐ŸŽฏ Leads in sidebar
  2. Filter by status: New, Contacted, Qualified, Converted, Lost
  3. Click ๐Ÿ“ฒ to open WhatsApp chat with the lead instantly
  4. Change lead status using the dropdown
  5. Click โฌ‡ Export CSV to download leads to Excel

9
Analytics & Reports

๐Ÿ“ˆ Analytics
6-month trend charts for conversations and leads. Bot performance comparison.
๐Ÿ’ฌ Conversations
Full log of every chat session. Device, browser, duration, lead captured.
๐Ÿ“„ Documents
Upload PDFs to train bot. Bot searches automatically.
๐Ÿ’ณ Billing
Current plan, usage, upgrade options, payment history.

10
Client Management (Admin)

  1. Go to Admin โ†’ Clients to see all registered users
  2. Click Login As to impersonate any client (for support)
  3. Click + Add Client to create client manually
  4. Go to Subscriptions โ†’ apply any package to any client instantly
  5. Go to Packages โ†’ create new plans โ†’ they appear on homepage and registration page
  6. Use SMTP โ†’ Bulk Email to send updates to all clients

11
Troubleshooting

โ“ Widget not showing
Check: 1) Bot status is Active 2) Script URL is correct 3) Bot ID matches 4) Open browser F12 console for errors 5) No ad-blockers
โ“ 500 Error on install
MySQL strict mode issue. The installer handles this automatically. Verify DB user has CREATE TABLE permission.
โ“ Emails not sending
Admin โ†’ SMTP โ†’ Send Test Email. Gmail needs App Password not regular password. Check host/port is correct.
โ“ Bot giving wrong answers
Add more keywords. Use Synonyms. Higher priority = shown first when multiple FAQs match.
โ“ Login redirects to install
Config file missing. Re-run install.php or check includes/config.php exists with correct DB details.
โ“ 403 on directories
Normal security behavior. Only /install.php and /login.php etc. should be accessed, not folders.
ยฉ 2026 Obsidian Gold ยท Home ยท Login