Launch AI widgets on your clients’ stores — without friction

This guide walks you through real-world installation scenarios: WordPress, Shopify, custom HTML sites, and modern frameworks like React or Next.js. Follow these steps to avoid common setup errors and get your widget live in minutes.

1. Create your first widget

Choose an agent, customize branding (colors, label, greeting, position), and copy the generated embed script.

You don’t need to manage databases, API keys, or environment variables. Every widget is linked to a secure agent key and validated automatically.

2. Customize behavior & branding

Control the widget appearance and behavior using URL parameters: accent color, brand name, greeting message, button label, and screen position.

Changes are applied instantly — no rebuilds or redeploys needed.

3. Install the widget (important)

The embed script is designed for standard HTML environments. Choose the correct installation method depending on your stack.

WordPress / Shopify / Webflow
Paste the full script into the site footer, custom HTML block, or a plugin like “Insert Headers and Footers”.
Static HTML sites
Paste the script right before the closing </body> tag.
React / Next.js projects
Do not paste the raw script inside JSX. Use a framework-specific loader (for example, Next.js next/script).

4. Allowed domains & security

Each widget is protected by domain validation. The widget will only load on domains explicitly allowed in the agent settings.

• elsaltoweb.es is not the same as agentes.elsaltoweb.es
• If you see a 403 error, the current domain is not authorized
• Add all required domains or subdomains, or use a wildcard like *.example.com

Tip: During development, you can temporarily leave allowed domains empty to test from localhost or staging environments.

Common issues & troubleshooting

• Widget not appearing → Check allowed domains
• Console shows 403 → Domain mismatch
• Script error in React → Wrong installation method
• Nothing loads → Verify the agent key is active

Need help or a custom setup?

Our technical team can help you validate domains, adapt the widget to your stack, or provide framework-specific examples.

Contact technical support