For REST API error codes (Documentation Index
Fetch the complete documentation index at: https://docs.clickterm.com/llms.txt
Use this file to discover all available pages before exploring further.
400, 401, 404, etc.), see the API Error Reference.
Web SDK
| Error | Cause | Solution |
|---|---|---|
| SDK not initialized | ClicktermClient.initialize() was not called | Call initialize() with your App ID before using ClicktermDialog |
| Template not found | Template is disabled or has no effective version | Enable the template and ensure a version is effective |
| Network error | Cannot reach the ClickTerm API | Check the user’s network connection |
Inline mode (v2.2.0+)
| Error | Cause | Solution |
|---|---|---|
| Container element not found | No element with that id in the DOM | Ensure the container element exists before calling renderInline() |
| Already rendered for container | renderInline() called twice for the same container | Call handle.destroy() first, or use a different container |
| Missing inline content | Backend returned content without inlineContent field | Check template configuration — ensure inline content is set in the dashboard |
| Finalize failed | Network or server error during finalize() | Does not throw — returns status: 'ERROR' and unlocks the checkbox for retry |
Android SDK
| Error | Cause | Solution |
|---|---|---|
| SDK not initialized | ClicktermClient.initialize() was not called | Call initialize() in your Application class or MainActivity |
| Invalid template ID | Template ID format is incorrect | Use the UUID from the ClickTerm dashboard |
Related
API error codes
HTTP status codes and response format for the REST API.
Troubleshooting
Common integration issues and step-by-step fixes.