SuperAPI AI Directory

analyse-inboxmate

General & other

View repository

Updated 10-16 04:53

About this skill

InboxMate Ecosystem Reference

Use this skill to understand the InboxMate product, its architecture, outreach pipeline, and how to query data across systems.

Architecture

InboxMate is a module (chatwidget) within the AgentHub platform — a full-stack Nuxt 3 + Supabase + Socket.IO SaaS.

Repos & Key Files

Repo Purpose Key Files
agenthub Full-stack app (InboxMate + AgentHub) server/api/mcp.post.ts (demo MCP), app/pages/demo.vue (demo page), server/utils/scraping.ts (Tavily/Firecrawl), server/utils/subscriptionUtils.ts (tiers), app/components/InboxMatePricingModal.vue
notification-service Email drafts, templates, funnel analytics src/routes/drafts.ts (draft CRUD), src/routes/stats.ts + frontend/pages/funnel.vue (funnel)
psquared-websites Marketing sites apps/inboxmate/ (inboxmate.psquared.dev), apps/psquared/ (psquared.dev)
psquared-skills Pipeline skills skills/ directory

URLs

Service URL
InboxMate app app.psquared.dev (chatwidget module)
Demo pages demo.inboxmate.psquared.dev/?id=<demoId>
Marketing site inboxmate.psquared.dev
Company site psquared.dev
Notification admin notifications.psquared.dev/drafts
CRM crm.psquared.dev
Analytics ackee.psquared.dev

Demo Pipeline

/find-leads [N]          → CRM companies + people (German B2B, UWG-compliant)
  ↓
/inboxmate-batch-demo    → Demos created, opportunities at SCREENING/PENDING_REVIEW
  ↓
/review-demos            → demoStatus: OK_TO_SEND or NEEDS_FIX
  ↓
/fix-demos               → Fixes applied, reset to PENDING_REVIEW
  ↓
/plan-campaign           → CRM campaign created, opportunities linked with shared deadline
  ↓
/setup-email-drafts      → Email drafts at notifications.psquared.dev/drafts
  ↓
Human review + send      → demoStatus: SENT, outreachSentAt timestamped
  ↓
/check-outreach-status   → Follow-up drafts created (5+ days after send)
  ↓
/check-demo-analytics    → Pipeline health report (Ackee + CRM)
  ↓
/refurbish-demos         → Upgrade knowledge for campaign demos (clear + re-scrape via MCP)

CRM State Machine (Twenty CRM)

Opportunity.demoStatus

Status Meaning
PENDING_REVIEW Demo built, awaiting QA
OK_TO_SEND QA passed, ready for outreach
NEEDS_FIX QA failed, needs corrections
SENT Initial outreach email sent
FOLLOW_UP_SENT Follow-up email sent
SKIP_FAULTY_WEBSITE Website unreachable/broken
SKIP_IRRELEVANT Company not a fit
SKIPPED Generic skip
DISQUALIFIED Permanently excluded

Opportunity.demoType

Value Meaning
CHATBOT (or null = legacy) Personalized chatbot demo (/inboxmate-demo)
INBOX Demo-Postfach: seeded pre-triaged inbox (/inboxmate-inbox-demo), email-product outreach. CRM view "InboxMate Email Outreach" filters on this.

Opportunity.stage

Stage Meaning
NEW Fresh lead, no outreach
SCREENING Outreach phase
MEETING Responded / call scheduled
PROPOSAL Quoted or decision-maker demo
CUSTOMER Paying customer

Campaign Structure

Campaigns group opportunities into sendable batches with shared offerExpiresAt and offerText. Created by /plan-campaign, consumed by /setup-email-drafts.

How to Query Each System

CRM (Twenty) — GraphQL

  • Endpoint: https://crm.psquared.dev/graphql
  • Auth: Authorization: Bearer $PSQUARED_CRM_TOKEN
  • Key objects: companies, people, opportunities, campaigns, tasks, notes

Example — list opportunities in a campaign:

query {
  opportunities(filter: { campaignId: { eq: "CAMPAIGN_ID" } }) {
    edges { node { id name stage demoStatus demoUrl } }
  }
}

Supabase (AgentHub DB)

  • Project: fevtfywriufbqnvbgyrm
  • Tool: mcp__plugin_supabase_supabase__execute_sql
  • Key tables: demo_pages, agents, knowledge, knowledge_bucket_items, knowledge_bucket_chunks, chats, messages, accounts

Example — find chats on demo agents:

SELECT dp.company_name, c.id as chat_id, c.created_at,
  (SELECT count(*) FROM messages m WHERE m.chat_id = c.id) as msg_count
FROM demo_pages dp
JOIN chats c ON c.agent_id = dp.agent_id
ORDER BY c.created_at DESC

Ackee Analytics — GraphQL

  • Endpoint: https://ackee.psquared.dev/api
  • Auth: Authorization: Bearer $ACKEE_TOKEN
  • Demo domain ID: 4bdddc8c-11d9-4d7e-ab94-aeb7866f0bb2
  • CTA event ID: 0f037f1c-c2c0-4205-b90d-3cb9bf66f9c2

Example — get demo page views:

query {
  domain(id: "4bdddc8c-11d9-4d7e-ab94-aeb7866f0bb2") {
    statistics { views(interval: MONTHLY, type: UNIQUE) { count } }
    facts { viewsMonth viewsToday activeVisitors }
  }
}

Notification Service — REST

  • Base URL: https://notifications.psquared.dev
  • Auth (admin): Authorization: Bearer $BEARER_TOKEN
  • Auth (drafts only): Authorization: Bearer $EMAIL_DRAFT_ONLY_BEARER

Key endpoints:

  • GET /drafts?status=SENT&pageSize=50 — list sent emails
  • GET /drafts/:id — read full email (html_body, variables, subject)
  • POST /drafts/create — create draft from template
  • POST /drafts/send — send drafts { draftIds: [...] }
  • GET /stats/funnel — full conversion funnel data
  • GET /drafts/campaigns — list CRM campaigns with draft counts

InboxMate MCP — JSON-RPC

  • Endpoint: https://app.psquared.dev/api/mcp
  • Auth: Authorization: Bearer $NUXT_MCP_DEMO_TOKEN
  • Protocol: JSON-RPC 2.0

Key tools:

  • clear_bucket — remove all items from a knowledge bucket
  • scrape_and_build_knowledge — scrape URLs via Tavily, create knowledge items with real sourceUrls
  • create_agent, update_prompt, update_widget_style, publish_agent
  • create_knowledge_bucket, add_to_bucket, set_knowledge
  • create_demo_page, update_demo_page, list_demos, get_demo
  • create_inbox_demo, update_inbox_demo — Demo-Postfach (type='inbox': seeded pre-triaged inbox, no agent)
  • list_bucket_items, list_knowledge, get_knowledge

Key Metrics

Metric Source How to check
Demo page views Ackee Query demo domain statistics
CTA clicks Ackee Query CTA event
Emails sent Notification service GET /drafts?status=SENT
Chat interactions Supabase chats JOIN demo_pages on agent_id
Pipeline funnel Notification service GET /stats/funnel
Hot leads CRM Opportunities with stage > SCREENING
Campaign status CRM + Notification service Campaigns + draft counts per campaign

Environment Variables

All in /Users/martinpammesberger/Documents/psquared/claude-overlord-folder/.env:

Variable Service
PSQUARED_CRM_TOKEN Twenty CRM GraphQL
NUXT_MCP_DEMO_TOKEN InboxMate MCP endpoint
NUXT_TAVILY_SEARCH_API_KEY Tavily web scraping
EMAIL_DRAFT_ONLY_BEARER Notification service (draft creation)
NOTIFICATIONS_SERVICE_BEARER_TOKEN Notification service (admin)
ACKEE_TOKEN Ackee analytics

Pricing Tiers (credits model, since 2026-09)

Note: If prices change, this table must be updated. The /price-change skill handles pricing updates across all touchpoints — make sure this file is included in the update list.

Model: pay per Postfach (mailbox) + AI credits + one-time setup. All prices net (zzgl. USt.). Manual invoicing, bank transfer. Stripe is NOT used for InboxMate billing (do not create Stripe prices). 14-day Pro trial, no credit card; at trial end the account is downgraded to Free (data kept).

Tier Price Postfächer Credits/mo Users Agents Notes
Free €0 0 50 1 1 where accounts land after the trial; not marketed (website shows no chatbot since 2026-09-24)
Pro €129/mo · €107/mo yearly 1 (extra €49/mo) 2,500 5 5 entry paid plan; API+MCP, auto-send, triage, advanced analytics
Business €389/mo · €349/mo yearly 5 (extra €39/mo) 15,000 10 unlimited SLA tickets, time tracking, advanced export, priority support
Enterprise individuell / auf Anfrage (never show a price) more than 5 individual — — custom integrations built by psquared, SLA, named contact, training. SaaS only — never offer Exoscale/self-hosting or a framework contract.
  • Starter is removed from all displays. The code tier key im_starter stays in agenthub (schemas, Shopify) — hide only.
  • Setup (Einrichtung), Pro and Business: Standard €890 one-time (1 Postfach, up to 10 rules, Microsoft 365 / IMAP, test run, 2 adjustments; each extra mailbox + €290). Individuell: fixed price after first call (webhooks, integrations, complex rules). Enterprise: individual. Display + AGB only, not in code.
  • Top-ups: €40 per 1,000 credits, €175 per 5,000 (shared/constants/credits.ts), instant grant, invoiced afterwards.
  • Credit costs (agenthub/server/utils/creditLedger.ts): categorize (one run) 2, chat reply 1, email draft 1, email send 1, webhook 0.5, PDF/OCR 1, scrape 5, tool call 0, test chat 0. Grace buffer 20% (×1.2).
  • Grandfathered: Doppler Holding €100/mo for 3 mailboxes. Do not mention publicly.

Knowledge System

Agents use RAG (vector search) over knowledge buckets:

  • Each bucket contains knowledge items (text entries with sourceUrl)
  • Items are chunked and embedded for vector similarity search
  • When the agent's searchKnowledge tool is called, it returns matching chunks WITH their sourceUrl
  • The widget UI shows sources as clickable links in citations

To upgrade knowledge quality: clear_bucket → scrape_and_build_knowledge with real page URLs → publish_agent