Documentation

Methodox Chat Gateway

Chat Gateway is a managed knowledge base and website chatbot/AI agent plugin.

Methodox Chat Gateway

Methodox Chat Gateway is a production-ready chat layer that lets you add an AI assistant to any website or app—powered by your own knowledge base. It’s part of Methodox Online Services, alongside Divooka (our visual programming system) and Methodox One (our connected services platform).

Deploy in minutes with a single script, or run full-page project chats. Choose the projects to expose publicly, connect private sources for RAG (Retrieval-Augmented Generation), and keep visitors in a focused, branded conversation.

What you get

  • Drop-in Widget One script tag adds a polished, accessible, mobile-friendly chat button to any site.

  • Project-scoped assistants Each “Project” has its own model settings and (optionally) a vector store. RAG status is shown as a pill (e.g., “RAG: on/off”) for transparency.

  • Hosted full-page chat Serve complete project experiences at /Project/{name} (e.g., /Project/ChatGateway)—handy for demos, docs, and support portals.

  • Simple, consistent API Post user messages to /api/Chat with a project name and (optionally) a previous chat ID for continuity.

  • Operational guardrails Built-in request rate limiting and concurrency controls help keep your usage rate moderate.

  • Playground for discovery Explore public projects and test prompts in the browser via the Playground (/index.html).

Where Chat Gateway fits in Methodox Online Services

  • Methodox One Connected Services: unify apps and data with user-owned storage and profiles. Chat Gateway plugs into that ecosystem so assistants can focus on the right content per project.
  • Divooka: use our visual system to prototype, script, and eventually wire more advanced agent flows around your knowledge base.
  • Developers & teams: start with the widget and full-page chat; grow into API workflows and custom integrations when you’re ready.

Typical uses

  • Customer support for docs, FAQs, and product onboarding
  • Knowledge-base search for internal teams
  • Sales assist on marketing pages
  • Education & documentation companions
  • Public “Ask Me Anything” portals per project

Live demo & playground

You can also embed the Chat Gateway Widget on this page (or any page) to chat with the ChatGateway project.

Quick start (embedding)

Add this to your site (same origin or set data-api-base):

<script src="/widget/chat-widget.js"
        data-chat-widget
        data-project="ChatGateway"
        data-title="Chat with Methodox (AI)"
        data-display-name="Chat Gateway"
        data-welcome-message="Hi! I’m your AI assistant. How can I help?"
        data-position="right"
        data-open="false"
        data-primary="#2563eb"></script>

Full-page chat for a specific project: /Project/ChatGateway

Minimal API call (server–server or from a trusted environment):

POST /api/Chat
Content-Type: application/json
{
  "PreviousChatID": null,
  "Source": "ChatGateway",
  "InputText": "Hello! Can you help me?"
}

Response (shape):

{
  "chatID": "abc123...",
  "response": "Hello! What can I help with today?"
}

How it works (B2B process)

  1. Contact: Email contact@methodox.io with a short note about your use case (site/app, audience size, public vs. private content).
  2. Scope & Plan: We discuss your needs: knowledge base size, formats (docs, pages, FAQs), update frequency, model preferences, tone, and guardrails.
  3. Purchase: Move forward with a setup fee (initial ingestion + configuration) and a maintenance subscription (ongoing updates and operations).
  4. Initial Setup: Within days, we provision your project(s), connect the knowledge base, and provide:
    • a full-page URL (e.g., /Project/YourProject)
    • an embed snippet (the widget) for your website
    • optional API details for deeper integration
  5. Ongoing Updates: We refresh content per your schedule (or on demand), monitor rate limits, and iterate on prompts/instructions as your content evolves.

Product details

  • Projects & RAG: Each project can enable a vector store for better grounded answers. RAG status is visible (e.g., “RAG: on”) and configured per project.
  • Models: Use the platform default or set a model per project. You can run public projects side-by-side to compare outputs in the Playground.
  • Available Models: Default, Naive, Retrieval (Default), Thinking.
    • Naive model: Simple, effective, cheap. Suitable for small knowledge base.
    • Retrieval model: Good performance at affortable price.
    • Thinking model: Our smartest model; Suitable for larger knowledge base. Takes longer to respond.
  • Rate limiting & resiliency: Token-bucket and concurrency caps protect upstreams; users get clear “retry later” messages on rare spikes.
  • Themable widget: Position (left/right), color, and welcome message are configurable via data-* attributes.
  • Access patterns:
    • Widget (no-code)
    • Hosted page at /Project/{name}
    • API at /api/Chat for server workflows

Data handling (at a glance)

  • Project-scoped: your knowledge base is isolated per project; content is only used to answer queries for that project.
  • Updates: we support scheduled or manual re-ingestion to keep answers current.
  • Controls: you choose what’s public or private; public projects can be showcased in the Playground for easy testing and visibility.

Need stricter controls or custom retention? Tell us your requirements and we’ll scope it during onboarding.

Pricing (overview)

  • Setup fee: initial ingestion, configuration, and launch.
  • Maintenance subscription: ongoing updates, operations, and support.
  • Usage: you are billed by actual usage at the end of each month.
  • Add-ons (optional): extra projects, higher rate limits, custom domains, or integration assistance.

Contact contact@methodox.io for a quote tailored to your content size and traffic profile.

FAQ

Can I try it now? Yes—visit /index.html for the Playground and /Project/ChatGateway for a live project.

How do I add it to my site? Paste the widget <script> and set data-project to the project name we provide. You can also embed the full-page view in an <iframe> if you prefer.

What if my content changes often? We include ongoing updates in the maintenance plan. We’ll align on cadence and triggers during onboarding.

Do you support multiple projects? Yes. Many customers run a public docs assistant plus a separate internal support assistant.

Talk to us

Questions, partnerships, or ready to get started? Email: contact@methodox.io Or open the Playground at /index.html and test a live project at /Project/ChatGateway.

Methodox Chat Gateway is part of Methodox Online Services, alongside Divooka and Methodox One Connected Services.