SCStartupCoreDOCS

CHATBOT

Widget script installation

Embed StartupCore chatbot on any website without React.

When to use

  • Plain HTML, Shopify, Webflow, WordPress, or custom marketing sites.
  • Requires public_widget key and botId only.
  • Does not require React or a build step.
  • Never put secret_server in the script tag.

Production snippet

html

<script src="https://cdn.startupcore.com/chatbot-widget.js" data-public-key="pk_live_xxx" data-bot-id="bot_123" async> </script>

Local development

html

<script src="http://localhost:4000/chatbot-widget.js" data-api-base-url="http://localhost:4000" data-public-key="pk_live_xxx" data-bot-id="bot_123" async> </script>

Common errors

  • 401 — invalid or revoked public_widget key, or wrong botId binding.
  • 403 — domain not allowed (add origin to environment allowedDomains).
  • 429 — rate limited; backoff or upgrade plan.
  • Bot not published — publish from org dashboard.
  • Wrong botId/key pair — key must be bound to the same bot.

Related