FEATURES

Chatbot

Rules-based Q&A chatbot (no LLM in MVP): knowledge items, intents, confidence, fallbacks, and optional private webhook actions.

Overview

Rules-based Q&A chatbot (no LLM in MVP): knowledge items, intents, confidence, fallbacks, and optional private webhook actions.

Who should use this

Support teams automating FAQs on marketing sites or logged-in apps.

Core concepts

Draft vs published knowledge. Intents match keywords then run reply or webhookAction. Confidence 0–1; fallback when below threshold. authRequired on sensitive intents.

Setup

Follow /chatbot/prerequisites then /chatbot/quickstart. Manage bots in org dashboard; embed via /chatbot/widget-script, /chatbot/react, /chatbot/sdk, or /chatbot/rest-api.

Required entitlement

chatbot; intent_workflows for webhook actions.

Required permissions

chatbot.view, chatbot.manage, chatbot.knowledge.manage.

REST API

CRUD /tenants/{id}/chatbots/{botId}, knowledge, intents, POST /publish, GET /analytics.

SDK (@startupcore/api-client)

  • startupCore.chatbot.create(tenantId, { name, workspaceId, environmentId });
  • startupCore.chatbot.addKnowledge(tenantId, botId, { question, answer });

React components

<ChatbotBuilder />, <KnowledgeBaseEditor />, <IntentWorkflowEditor />, <ChatbotAnalytics />, <StartupCoreChatbot botId publicKey />.

Widget

Embed with data-public-key and data-bot-id — see /chatbot/widget-script (customer guide) or /widget-script/installation.

Webhooks

Private actions POST to your backend with X-StartupCore-Signature — see /webhooks/action-workflows.

Security notes

Allowed domains on environment. Rate limits on widget messages. No secrets in browser.

Troubleshooting

Low confidence — add knowledge or tune intent keywords. FORBIDDEN on action — enable auth handoff.