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.