Widget Troubleshooting

Use this checklist when the widget does not appear, cannot send messages, or does not recognize a visitor.

Widget Does Not Appear

1. Confirm the script URL loads:

   txt
   https://api.rogeriq.com/widget/v1/rogeriq.js

2. Confirm RogerIQ("init", { projectId }) runs after the queue stub exists.

3. Check browser console errors.

4. Confirm the project ID belongs to the expected RogerIQ project.

5. Confirm widget enabled is true in Settings -> Widget.

6. Check display settings such as display.style: "manual".

Messages Do Not Send

Check:

• messagingEnabled is true
• the project exists
• the widget API is reachable
• required contact fields are supplied
• file attachments pass size and type checks
• the conversation was not ended

Identity Is Not Verified

Check:

• secure mode is enabled only when you can generate signatures server-side
• the email passed to identify exactly matches the email used for signing
• the signature is lowercase hex
• the secret was not rotated without updating your server

SPA Page Context Is Missing

Call RogerIQ("event", { type: "page-viewed", ... }) on route changes.

Local Debugging

js
const info = RogerIQ("info");console.table(info.state);console.table(info.visitor);