Clusterify.AI

Magento Admin Operations Specification

Magento 2 ChatBot & Assistant Admin Dashboard Operations Guide

A complete operational manual for e-commerce managers, store administrators, and support leads. Monitor real-time RabbitMQ queues, verify API connectivity, and trigger on-demand sync tasks directly from Magento Admin.

Magento Admin ChatBot & Assistant Menu Navigation

The extension registers a dedicated, prominent Magento Admin ChatBot & Assistant Menu on the primary admin sidebar, featuring the official speech-bubble brand mark.

Primary Access PathMagento Admin > CHATBOT > Dashboard & Status
Alternative Marketing PathMagento Admin > Marketing > Chatbot & Assistant > Dashboard

Live Subscription & Health Metrics Cards

The top row of the status screen presents 4 instant diagnostic cards summarizing operational readiness:

Plan Detection
PROFESSIONAL

1,000 URLs • RabbitMQ Sync

Storefront State
ACTIVE

Enabled on 32 / 38 pages

URL Quota Usage
142 / 1,000

858 URLs available

API Healthcheck
CONNECTED

Ping: 38ms (/v1/ping)

Real-Time RabbitMQ Queue Monitor

Monitor message backlogs across all three entity queues. Trigger on-demand drains without terminal access.

CMS Pages Queue

0 Pending (Idle)
clusterify.chatbot.sync.cms
Cron Worker Ready

Categories Queue

0 Pending (Idle)
clusterify.chatbot.sync.category
Cron Worker Ready

Products Queue

14 Pending (Draining)
clusterify.chatbot.sync.product
Active Consumer

Terminal Reference Card (Embedded in Admin)

For system administrators who prefer CLI operations, the admin dashboard embeds copy-paste commands:

# CLI Shortcuts for Store Administrators
# 1. Reindex and queue all products to RabbitMQ
bin/magento clusterify:chatbot:sync:run --entity=product

# 2. Drain up to 50 pending messages immediately
bin/magento clusterify:chatbot:sync:consume --limit=50
Operations FAQ

Frequently Asked Questions: Admin Dashboard & Operations

Common questions about live metrics, queue draining, plan detection, and admin permissions.

Where can administrators find the CHATBOT menu in Magento Admin?
The extension registers a prominent top-level Magento Admin ChatBot & Assistant Menu on the primary admin sidebar featuring the official speech-bubble mark. You can also access it via Marketing > Chatbot & Assistant > Dashboard & Status.
What does the '⚡ Process Pending Tasks Now' button do?
It triggers an asynchronous AJAX request that immediately consumes up to 50 pending RabbitMQ messages per entity queue. It updates pending count badges on screen in real time without requiring terminal SSH access or page reloads. Learn more about our RabbitMQ sync architecture.
How does live plan detection work on the status dashboard?
The dashboard automatically queries the Clusterify API via the PHP SDK during page rendering and caches results for 10 minutes. It displays your active subscription plan (STARTER Plan or PROFESSIONAL Plan) with direct links to our Subscription Plans & Prices if quotas are reached.
What does the URL Quota Usage counter (e.g. 142 / 1,000) indicate?
It tracks the total number of synchronized storefront pages (Products, Categories, CMS) currently vectorized in your Clusterify account. Learn more in our Knowledge Architecture guide.
What should I do if the API Healthcheck shows 'DISCONNECTED'?
The card displays the specific error returned by the /v1/ping endpoint (e.g. invalid credentials or network block). Check that your API Public Key and Secret Key are saved correctly in Stores > Configuration under ChatBot Configuration, or test via our CLI test tool.
Can store managers trigger reindexing from the Magento Admin interface?
Yes. Under System > Index Management, three dedicated indexers (clusterify_chatbot_cms, clusterify_chatbot_category, and clusterify_chatbot_product) can be reindexed manually. Review the sync architecture.
Do store administrators need terminal or SSH access to monitor queue health?
No. The real-time AMQP queue monitor table provides operations managers and e-commerce directors with complete transparency into queue depths and consumer activity directly within the browser.
How can administrators preview the storefront widget styling?
The CHATBOT sidebar menu includes direct shortcuts to our live Chatbot Window Styling showcase and Visual Message Components in the Clusterify Cloud Dashboard, opening securely in a new browser tab.
Can multiple admin users access the ChatBot dashboard simultaneously?
Yes. The status screen is completely stateless and read-only. Multiple administrators, customer support leads, and marketing managers can review metrics simultaneously without session locks or resource contention.
Where are background synchronization errors logged?
All background consumer events, API exceptions, and rate-limit retries route through Magento's standard PSR-3 logging architecture into var/log/system.log and var/log/debug.log.