Manual Embedding in Rakuten GOLD
You can install the FormAgent.ai chat widget as JavaScript in the HTML area of Rakuten GOLD or R-Cabinet. This guide explains the steps and important notes for installing on Rakuten GOLD.
1. Embeddable Locations and Conditions
| Location | Script Embedding | Notes |
|---|---|---|
| Rakuten GOLD Pages | Allowed | You can freely add JavaScript in HTML files |
| R-Cabinet (Image/HTML Area) | Allowed | JavaScript works if written in HTML |
| Product/Purchase Pages (RMS) | Not Allowed | External JavaScript cannot be embedded for security reasons |
| Mobile Pages (RMS Mobile) | Partially | Only certain tags allowed (e.g., img-based analytics tags) |
2. Example: Installing the FormAgent Script
Paste the following code inside the <head> or <body> of your Rakuten GOLD HTML file, preferably just before the </body> tag:
<script defer id="formagent-script" src="https://formagent.ai/embed.js" data-agent-id="YOUR_AGENT_ID"></script>
- Replace
YOUR_AGENT_IDwith the ID issued in your FormAgent dashboard. - Save the file and upload it to Rakuten GOLD to complete the installation.
3. Important Notes
- CSP Restrictions: External JavaScript will not work on standard product or purchase pages on Rakuten Ichiba.
- HTTPS Only: Always use https for the script URL.
- Mobile Pages:
<script>tags may not be allowed on RMS mobile pages.
Troubleshooting
- If the chat widget does not appear, double-check your Agent ID, script placement, and CSP restrictions.
- Clear your cache and reload the page.
If you have any questions, please contact Support.