可嵌入小部件

The FeedbackPulse widget lets tenants embed a 反馈表单 directly on their own website with a single line of code.

---

安装

Add this script tag anywhere on your website:

<script src="https://yourdomain.com/widget/{campaign-slug}.js"></script>

Replace:

• yourdomain.com with your FeedbackPulse domain
• {campaign-slug} with your campaign's slug

Example:

<script src="https://feedback.acmecorp.com/widget/rate-our-dashboard.js"></script>

---

工作原理

1. The script injects a floating feedback button on the page (typically bottom-right corner)
2. When clicked, an iframe opens with the full 反馈表单
3. The form supports all campaign features (星级评分, NPS, text, photo upload, etc.)
4. After submission, the user sees a thank-you message
5. The iframe closes automatically

---

Customization

The widget inherits the campaign's configuration:

• Which fields are enabled
• Whether email/OTP is required
• Whether reCAPTCHA is active
• Branding colors from the tenant settings

---

Technical Details

Aspect	Detail
Script size	Lightweight (~5 KB)
Dependencies	None -- vanilla JavaScript
Iframe URL	/widget/{slug}/frame
Rate limit	120 requests/minute
CSRF	Exempt (cross-domain embedding)
Cookies	Third-party cookies not required

---

Best Practices

• Place the script before the closing </body> tag
• Test the widget in both desktop and mobile browsers
• Make sure your campaign is set to "Active" status
• The widget works on any website (WordPress, Shopify, React, etc.)

---

故障排除

Issue	Solution
Widget not showing	Check that the campaign slug is correct and the campaign is active
CORS errors	FeedbackPulse includes proper CORS headers for widget endpoints
Widget blocked by CSP	Add your FeedbackPulse domain to your Content 安全 Policy
Form not submitting	Check browser console for errors

---

下一步

• Feedback 活动 -- configure the form