Softsource Web Tool: Setup

Log into your SoftSource dashboard. Navigate to Tools > Web Tool Manager > New Setup . Click “Start Guided Setup.”

| Error Message | Likely Cause | Solution | |---------------|--------------|----------| | “Site ID not recognized” | Typo in embed code | Regenerate the code from the dashboard and copy-paste exactly. | | “Mixed content blocked” | HTTP resource loaded on HTTPS page | Update all asset URLs to HTTPS. Enable “Force HTTPS” in SoftSource settings. | | “Form submission 403” | Missing CSRF token | Add % csrf_token % if using Django/Rails, or enable “Token-less mode” in SoftSource (less secure). | | “Engine.js failed to load” | CDN blocked by firewall | Whitelist cdn.softsource.io in your network security policy. | | “Duplicate tool initialization” | Script loaded twice | Check your theme for duplicate embed code. Remove one instance. | softsource web tool setup

import SoftSourceClient from '@softsource/web-tool-sdk'; const client = new SoftSourceClient( siteId: process.env.SOFTSOURCE_SITE_ID, secretKey: process.env.SOFTSOURCE_SECRET_KEY, endpoint: 'https://api.softsource.io/v3', cacheTTL: 3600 // seconds ); Log into your SoftSource dashboard