Developer Guide

Complete SDK and API documentation for integrating CircuCity AI into your store.

Integration Overview

CircuCity AI offers multiple ways to integrate, from a simple JavaScript snippet to a full REST API. Choose the approach that fits your technical requirements.

Widget Snippet

One line of JavaScript. Add to any website in seconds.

~5 min

REST API

Full control over chat, products, and analytics.

~30 min

Webhooks

Real-time event notifications to your server.

~15 min

Authentication

All API and SDK integrations require a workspace API key. Get yours from Settings → API Keys in the dashboard. Keys have the format:

cck_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your API keys secret. Use environment variables in your server code. Rotate keys regularly for security.