Customer support · Ready to use

SupportForge

End-to-end AI customer support for SMBs — monitor chat, email, and forms; answer from your knowledge base; escalate with full context; approve external actions with human-in-the-loop.

▸ Dark neon chat widget · drop-in script for any site
▸ Triage · Knowledge · Responder · Escalation agents
▸ Confidence scoring · audit log · usage & cost tracking

FastAPI Grok optional HITL Tickets + CRM-lite

1. Triage

Urgency, sentiment, topic, and sensitive-issue flags on every inbound message.

2. Knowledge

Retrieve answers from your FAQs, policies, Notion export, or uploaded docs.

3. Respond

Auto-resolve high-confidence FAQs or draft replies for human approval.

4. Escalate

Open tickets with full context; admin dashboard for HITL and follow-ups.

Architecture

Channels → FastAPI → multi-agent orchestrator → tickets / HITL / audit / usage.

01
Ingest

Widget chat, website form webhook, email webhook or IMAP.
02
Classify & retrieve

Triage + local knowledge index with confidence scores.
03
Act safely

Auto-reply, draft-for-approval, or escalate — external writes need HITL.
04
Operate

Admin UI, audit trail, usage/cost for SaaS billing prep.

Deploy on this machine

Code: agents/support-forge · Full guide: agents/support-forge/README.md

Demo (no API keys required)

cd agents/support-forge
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
copy .env.example .env
python -m src.cli seed
python -m src.cli demo
python scripts/smoke_test.py
python -m src.cli serve

Production keys

SUPPORTFORGE_API_KEY=your-admin-secret
SUPPORTFORGE_WIDGET_KEY=pk_live_your-site-key
XAI_API_KEY=optional-for-smarter-replies
CORS_ORIGINS=https://your-site.example

Safety: External actions (email send, CRM writes) queue for human approval. Low-confidence or legal/fraud keywords escalate with full conversation context.

Embed code

Place before </body>. Replace the host with your SupportForge VPS URL.

<!-- Matrixly SupportForge widget -->
<script
  src="https://YOUR_SUPPORTFORGE_HOST/static/widget/embed.js"
  data-api="https://YOUR_SUPPORTFORGE_HOST"
  data-key="pk_live_your-site-key"
  data-title="Support"
  async>
</script>

Iframe option

<iframe
  src="https://YOUR_SUPPORTFORGE_HOST/static/widget/chat-panel.html?api=https://YOUR_SUPPORTFORGE_HOST&key=pk_live_your-site-key"
  title="Support chat"
  style="position:fixed;right:16px;bottom:16px;width:400px;height:560px;border:0;z-index:9999;">
</iframe>

Connect knowledge (non-technical)

Drop FAQ / policy files into agents/support-forge/knowledge/
Run python -m src.cli seed
Optional: Notion sync via NOTION_API_KEY + admin reindex

Back to marketplace Integrations