Troubleshooting

Widget Returns 401 Unauthorized

Checks:

• Confirm X-Widget-Publishable-Key is set.
• Confirm key is active and not revoked.
• Confirm key belongs to the target agent.

Widget Returns 403 Domain Not Allowed

Checks:

• Confirm current origin is in allowed domains.
• Confirm no typo or missing subdomain in allowlist.
• Confirm request origin/referer headers are present in client runtime.

Chat Returns 413

Cause:

• User message exceeds max length (4000 chars).

Fix:

• Truncate or chunk large prompts client-side before submit.

Chat Returns 429

Cause:

• Rate limit exceeded for IP, visitor, or key.

Fix:

• Respect Retry-After.
• Add client-side backoff and send queue.

No Leads Appearing

Checks:

• email is required in /api/leads payload.
• X-Visitor-Id is present.
• Conversation id matches an organization+agent scoped session.

Webhook Not Received

Checks:

• Webhook is active.
• Event type is lead_captured.
• Destination URL is reachable and accepts JSON POST.
• Destination system is not rejecting requests due to auth/payload constraints.