Common Chatbot Edge Cases & Troubleshooting

1. Shortcode Outputs Nothing #

Docs state:

“If shortcode_enabled is off:

Davix AI Engine

Theme New Full

👋 Welcome to Davix AI Engine!

Attach Send

will output nothing.”

What this means:

• If your full-page chat page looks empty, the first thing to check is whether shortcode_enabled is ON in Chatbot → Shortcode tab.

Fix:

1. Go to Davix AI Engine → Chatbot → Shortcode.
2. Ensure Enable Shortcode is ON.
3. Save changes and reload the page.

2. Login Required + Page Caching = Permission Errors #

From edge cases:

“When login_required is enabled and your site uses page caching:
Make sure REST nonces are up to date to avoid permission errors.”

What this means:

• If you have a caching plugin and you turned on Login Required, guests may see stale nonces (security tokens), leading to denied REST calls.

What to check:

1. Ensure your cache settings don’t serve outdated nonces.
2. Clear cache after enabling login gate.
3. If you use aggressive caching, consider excluding chat pages from full-page cache.

3. Logo or Images Not Showing #

Edge tips mention:

“Use HTTPS for all logo_url and image paths.”

What this means:

• If your logo URL is HTTP instead of HTTPS on an HTTPS site, browsers may block it.
• Always use HTTPS image URLs for logo_url and bubble_logo_url.

4. Bubble Too Large on Mobile #

Docs advise:

“Keep bubble size minimal on mobile (use separate width/height options for each device).”

If users report that:

• The bubble covers content.
• The popup is too big on small screens.

Fix:

1. Adjust bubble_width_mobile and bubble_height_mobile to smaller values.
2. Save and test on mobile.

image IMAGE PLACEHOLDER: Side-by-side screenshot showing oversized mobile bubble vs fixed smaller bubble after adjusting mobile width/height. IMAGE image

5. Debugging Chat Problems #

If the chat doesn’t respond or behaves unexpectedly, you can:

1. Go to Davix AI Engine → Debug Logs.
2. Enable debug_chatbot_enabled.
3. Save.
4. Reproduce the issue.
5. Click “View log” for the chatbot channel to see the internal log.

All of these behaviors and tips are drawn directly from the documentation.