Conversaic docs overview
This documentation is for teams integrating Conversaic into a chat, assistant, search, education, productivity, or developer-tool product. It explains the runtime objects, environments, SDK path, and launch checks needed for a controlled publisher integration.
Integration map
Publisher app
Owns the chat UI, answer rendering, and sponsor container.
SDK or API
Sends context and receives a placement or no-placement response.
Conversaic runtime
Checks intent, offer eligibility, publisher policy, and tracking metadata.
Event stream
Records impressions, clicks, conversions, and earnings states.
Core objects
| Object | Used by | Purpose |
|---|---|---|
| App ID | SDK, placement API | Identifies the publisher application. |
| Placement key | Publisher UI, policy checks | Identifies where a recommendation may render. |
| Context | Matching runtime | Carries prompt, topic, language, geography, or workflow data. |
| Placement payload | Publisher frontend | Contains the recommendation content and tracking metadata. |
| No-placement response | Publisher frontend | Tells the UI to render no sponsored surface. |
| Event record | Attribution runtime | Connects impression, click, conversion, and earnings data. |
Environments
| Environment | Frontend | Backend | Notes |
|---|---|---|---|
| Dev | https://dev.conversaic.io |
https://api.dev.conversaic.io |
Use for pilot setup, SDK testing, and mock-auth review. |
| Production | https://conversaic.io |
https://api.conversaic.io |
Use only after production app approval and launch review. |
Use dev app IDs with the dev backend. Keep production app IDs out of local and dev builds.
Recommended reading order
01
How it works
Understand request flow, placement decisions, and no-placement behavior.
02
Publisher integration
Confirm app configuration, placement keys, context fields, and launch checks.
03
SDK installation
Load the browser SDK, pass context, and attach the sponsored container.
04
Guardrails
Set disclosure, blocked categories, sensitive contexts, and review rules.