Platform Overview

Build once, serve everywhere

AIDevelopia gives founders and lean teams an all-in-one workspace to launch a support assistant. Every tenant includes a chat widget, knowledge base training, usage analytics, and optional email & Telegram channels. This documentation reflects what is shipping today so you can implement with confidence.

Workspace

Chat widget + knowledge base + branding controls.

Channels

Email bot (beta) and Telegram integration, gated by plan.

Visibility

Dashboards for usage, unanswered questions, and billing status.

Getting Started

1. Create a workspace

Register from the sign-up page. Each account owns a tenant and begins on the Free plan (30-day trial). Tenant metadata lives in the tenants table and is decorated with plan attributes from subscription_plans.

2. Complete onboarding

First-time logins redirect to /onboarding. Provide brand colors, upload a logo, define the welcome prompt, and choose default tone. These settings update branding previews immediately and can be edited later under Branding.

3. Invite your team (Pro+)

Pro and Enterprise plans unlock team management. Navigate to Team inside the dashboard to invite collaborators, assign roles, and monitor access. Limits are seeded via SubscriptionPlanSeeder and enforced through feature gates.

4. Choose or upgrade your plan

Review pricing at /pricing. Switching plans happens through the subscription dashboard. Annual billing is a built-in 20% discount, controlled directly by the pricing toggle and subscription controller logic.

Knowledge Base & Training

Open knowledge base →

Documents

Upload PDFs, DOCX, TXT, or paste raw text. Embeddings are generated through the KnowledgeBase controller and stored per tenant. Limits per plan originate from subscription_plans and can be reviewed in the seeder.

• Regenerate embeddings after updating source material.
• Delete items to instantly exclude them from chat retrieval.
• Use export/import for offline editing.

FAQs

Seed common questions quickly. Manage from /faqs, import CSVs, and toggle visibility without deleting content. Promote unanswered questions directly into FAQs with one click.

Unanswered Queries

Visit /unanswered-queries to track prompts the assistant couldn't solve. Assign owners, mark items resolved, or bulk-resolve once content has been added to the knowledge base.

Chat Widget Embed

Brand settings →

The chat widget is the fastest way to put your AI assistant in front of visitors. Each tenant gets a hosted script at https://aidevelopia.com/developia.js (served by ChatWidgetController). Drop it into any site and the widget will load with your branding, knowledge base, and rate limits.

Where to find the snippet

Go to the dashboard ➝ Branding ➝ Share widget. You can copy the code manually or use "Send embed code" to email it to a developer. The script contains signed tenant metadata so you don't need to host anything yourself.

Install in three steps

Paste the script right before </body> on every page you want the widget to show.
Replace YOUR_TENANT_ID and TENANT_PUBLIC_KEY with the values from the onboarding email or dashboard.
Refresh the page. The widget icon should appear in the bottom-right corner by default.

<script src="https://aidevelopia.com/developia.js"
    data-api-url="https://aidevelopia.com"
    data-tenant-id="YOUR_TENANT_ID"
    data-api-key="TENANT_PUBLIC_KEY"
    data-primary-color="#3b82f6"
    data-secondary-color="#6366f1"
    data-chat-bubble-text="Need help?"
    data-welcome-message="How can we help?">
</script>

Customize the experience

• Colors, logos, and typography come from Branding and update live.
• data-chat-bubble-text changes the teaser text on the launcher.
• data-welcome-message sets the first message your visitors see.
• Use the dashboard to toggle features (file uploads, knowledge base sources, fun mode) without touching code.

Security & troubleshooting

• Only share the public key; the secret key stays server-side.
• If the widget doesn't appear, check the browser console for CSP or mixed-content errors.
• Use /test-chat inside your workspace to preview the widget in isolation.
• Rotate API keys from the dashboard when changing domains or regenerating credentials.

Email & Telegram Channels

Email Bot (Beta)

Available at /email-bot. Connect your provider, enable automation, and review status via /email/provider-status. Toggle the bot off at any time without losing configuration.

Telegram Integration

Offer real-time support in Telegram groups or direct messages. The integration lives at /telegram and guides you from bot token connection through ongoing upkeep.

Pair your bot

1. Create a bot via @BotFather.
2. Paste the bot token into the dashboard. We validate it, store it securely, and automatically set the webhook to https://aidevelopia.com/webhooks/telegram/{tenant}.
3. Existing stats reset so you start fresh after every token rotation.

Control the experience

• Fun mode: fallback to GPT with a friendly tone when your knowledge base has no match.
• Mention-only replies: stay silent in group chats unless users tag @yourbot.
• Admin chat alerts: add internal chat IDs to get notified whenever the assistant can't answer.

Keep signals healthy

• "Repair Webhook" re-registers the webhook if Telegram reports an error.
• "Send Test Notification" confirms admin alerts are wired correctly.
• Reset usage stats anytime to measure new campaigns or changes.
• Built-in analytics track total messages, KB-powered answers, GPT fallbacks, and unanswered count—all feeding back into your knowledge base workflow.

User experience

End users can DM the bot or mention it in group chats. Out of the box it understands /start, /help, and /about, then answers questions using your knowledge base. If the assistant doesn't know the answer, the question is logged under "Unanswered Queries" and your team gets alerted.

Discord Integration

Invite Developia to your server to answer questions, surface telemetry, and escalate issues without leaving Discord. Tenants can spin this up in minutes using the dashboard controls.

Step one

Connect Discord

Dashboard → Discord → Connect server. Only workspace admins can authorize new guilds.

Approve OAuth scopes for applications.commands.update and bot.
We persist guild + channel metadata and queue slash-command sync.

Step two

Slash command flow

Users trigger /developia. We ACK within three seconds, run RAG + AI jobs, then send follow-up messages.

• Knowledge hits are celebrated; GPT fallback respects workspace tone.
• Escalations and missing prompts raise metadata flags visible in the dashboard.

Step three

Telemetry & alerting

Monitor everything from the Discord dashboard or export raw rows.

• Subscribe admins to failure or unanswered alerts.
• Metrics live in discord_interactions; use the export button for audits.
• Latency, KB hit ratio, channel activity, and failure streaks all update in real time.

Analytics & Usage

Every workspace ships with dashboards that show how your assistant is performing and where limits sit relative to your plan.

Chat Usage dashboard (`/chat/usage`)

• Filter by week, month, or year; trends render via line charts (daily and hourly breakdowns).
• Metrics include total chats, successful answers, GPT fallbacks, token consumption, and failure counts.
• The Export button streams the full report as CSV using the ChatUsageController::export endpoint.
• Historical data is capped to the most recent period so charts stay readable.

File usage (`/file-usage`)

• Weekly, monthly, and yearly summaries show how much storage each content type consumes.
• The dashboard calculates formatted totals, remaining space, and flags when you exceed plan limits.
• Use the quick period switcher to refresh stats without leaving the page (handled via FileUsageController::getStats).

Operational insights

• Unanswered Queries collect gaps the assistant couldn't handle so your team can close the loop.
• Email/Telegram admin alerts keep stakeholders updated whenever a question gets logged from those channels.
• Combine dashboards with billing history to understand how usage maps to spend.

Billing & Plans

Plans are configuration-driven (see config/subscriptions.php) and mirrored into the database so pricing pages, the subscription dashboard, and the billing history screen stay in sync.

Plan behaviour

• Free, Starter, and Pro expose numeric prices; Enterprise stores null which renders as "Contact us for pricing."
• Yearly billing applies a 20% discount automatically across pricing views and the Vue subscription dashboard toggle.
• Marketing visibility is controlled by hide_from_marketing, letting you deprecate features without removing database columns.
• Payment providers (Stripe, Paystack) are feature-flagged via environment variables and read by the config.

Billing history (`/billing/history`)

• Shows successful and failed invoices with pagination and links back to the plan that generated them.
• Computes next billing date (trial vs. paid) using the tenant metadata populated during subscription changes.
• Displays chat usage progress (used vs. limit) so you can see if an upgrade is needed before renewal.
• Totals lifetime spend and counts successful vs. failed payments for quick finance snapshots.

Managing subscriptions

• Upgrade, downgrade, pause, and cancel flows live under /subscription; each route enforces plan feature gates before applying changes.
• Webhooks from Stripe/Paystack hit /subscription/webhook to keep invoices and status aligned.
• The seeder keeps default limits (chat quota, storage, add-ons) consistent across migrations and environments.

Frequently Asked Questions

Which support channels are fully live?

Chat widget is production-ready. Telegram integration is live for authenticated tenants with bot tokens configured. Email bot is currently in beta—enable it from /email-bot once you connect a provider.

Do you expose a public REST API?

Not yet. Automations happen through the hosted widget, dashboard tools, and channel integrations. Feature requests are tracked inside the app under Support.

How do usage limits reset?

Chat quotas reset each billing cycle (handled by the subscription manager). Storage persists until you delete files. Admin notifications trigger when usage crosses warning thresholds defined in config/subscriptions.php.

Can I export usage or billing data?

Yes. Chat usage exports as CSV via the dashboard. Billing history can be exported from the invoices table or synced through provider portals (Stripe/Paystack) connected to your tenant.

Where do unanswered questions go?

All unknown prompts—whether from the widget, email, or Telegram—land in /unanswered-queries. Resolve them once you've added new knowledge base entries so analytics stay accurate.

Support & Resources

Need help? Reach out via the contact form or email us from inside the dashboard. Enterprise customers receive priority handling and custom onboarding sessions.

Keep an eye on the blog for release notes and implementation tips.

Documentation hub