Developer documentation
Troubleshooting
Fix common Wiretalk widget, iframe embed, CORS, and API integration issues with step-by-step guides.
Widget not showing
Chat bubble does not appear
- Confirm snippet is before
</body>andwidgetKeyis correct - Add your domain under Widget Settings → Allowed domains
- Open browser DevTools → Console for errors
- Ensure
embed.jsURL loads (check Network tab)
CORS or script load error
apiBase must match your Wiretalk server. Production: https://wiretalk.tech/api. Embed script: https://wiretalk.tech/build/assets/embed.js
Widget shows on localhost but not production
Add your production domain to allowed domains. Clear browser cache after deploy.
Agent embed / iframe issues
CSP: frame-ancestors blocked
Error: violates Content Security Policy directive "frame-ancestors 'self'"
- Use URL
https://www.wiretalk.tech/agent/embed— not homepage or/dashboard - Confirm your parent site domain is approved for agent embed (contact admin@wiretalk.tech with the exact URLs you embed from)
- Hard-refresh the parent page after any domain allowlist change
CSRF / 419 on login inside iframe
Deploy latest code with CSRF exemptions for bearer-token API calls. Hard-refresh the iframe (Ctrl+Shift+R).
Real-time / messages not syncing
- Confirm the visitor page and agent dashboard both have a stable internet connection
- Hard-refresh the chat widget and agent inbox (Ctrl+Shift+R)
- Check browser DevTools → Console for blocked scripts or WebSocket errors
- Try an incognito window with extensions disabled to rule out ad blockers
- If delays persist, email admin@wiretalk.tech with your widget key, domain, and a short screen recording
Webhooks never sent
- Open Dashboard → Integrations → Webhooks and confirm the endpoint URL is correct HTTPS
- Click Send test — your server must return HTTP
2xxwithin 30 seconds - Verify your endpoint accepts
POSTwith JSON and responds quickly (no long-running work in the request) - Check firewall / WAF rules — Wiretalk delivery IPs must reach your URL
- Still failing? Email admin@wiretalk.tech with the webhook ID and recent delivery attempts
API errors
| Code | Fix |
|---|---|
401 | Invalid or missing API key / Bearer token |
403 | API key missing required ability scope |
422 | Validation error — check request body |
429 | Rate limit — slow down requests |
Still stuck?
Email support with: your widget key, domain URL, browser console screenshot, and steps to reproduce.