Practical Troubleshooting Recipes Using Debug Logs

1. Chatbot / Telegram Issue (No Response / Human Handoff Failing) #

Symptoms:

• Chat messages spin endlessly.
• No AI answer.
• Human mode doesn’t send messages to Telegram or doesn’t receive replies back.

Debug workflow:

1. Go to Davix AI Engine → Debug Logs.
2. Enable the Chatbot/Telegram channel.
3. Save.
4. Reproduce the issue from the front-end.
5. View Chatbot/Telegram log:
   • Look for:
     • OpenAI API errors (invalid key, quota, model name).
     • REST permission errors for /human, /human-poll, /telegram-webhook.
     • Rate limit messages.
6. Adjust:
   • OpenAI key, model, or Telegram settings based on log messages.
7. Test again.

2. Forms Issue (Entries Not Stored / Auto Reply Not Sent / Email Missing) #

Symptoms:

• Submissions don’t show under Forms → Entries.
• AI doesn’t generate a reply.
• Auto emails or Telegram alerts aren’t triggered.

Debug workflow:

1. Enable Forms debug channel.
2. Submit a test form from a supported provider.
3. View the Forms log:
   • Check for:
     • Provider detection logs.
     • Entry insert failures (e.g., DB or validation errors).
     • OpenAI errors using forms_openai_model or API key.
     • Email sending errors.
     • Telegram sending failures.
4. Fix configuration (provider enablement, OpenAI settings, email config, provider filters).
5. Retest.

3. Comment/Review Auto-Reply Issue #

Symptoms:

• New comments or product reviews don’t get auto replies.
• Telegram notifications for comments/reviews missing.

Debug workflow:

1. Enable Auto-Reply / Comments & Reviews channel.
2. Post a new test comment or review that should be auto-replied.
3. View Auto-Reply log:
   • Look for:
     • Whether the plugin detects the new comment/review.
     • Whether auto-reply is skipped (e.g., disabled, wrong status).
     • Any OpenAI errors when generating replies.
     • Any reply user issues (comment_reply_user_id, review_reply_user_id).
4. If Telegram notifications are missing:
   • Also check the Telegram or Auto-Reply log for notification attempts.

4. AI Writer Issue (Sidebar Errors / No Output / REST Failures) #

Symptoms:

• Sidebar shows error messages.
• Drafts/rewrites fail to load.
• Requests time out.

Debug workflow:

1. Enable AI Writer debug channel.
2. Open a post in Gutenberg and trigger AI Writer (draft or rewrite).
3. View AI Writer log:
   • Look for:
     • REST calls to /davix-ai-writer/v1/generate.
     • Nonce or permission errors.
     • OpenAI errors (bad model, invalid key, etc.).
     • JSON parsing issues.
4. Fix any misconfigured settings (model, tokens, roles, API key) indicated by the log.

5. LLM Index Issue (Empty JSON / 404 on /llm.txt) #

Symptoms:

• /wp-json/davix/v1/llm-index returns 404 or empty.
• /llm.txt doesn’t have expected content.

Debug workflow:

1. Enable LLM Index debug channel (if available).
2. Visit /wp-json/davix/v1/llm-index and /llm.txt.
3. View LLM log:
   • Check that:
     • LLM Index is enabled.
     • Post types and taxonomies are correctly configured.
     • Per-post Davix LLM Index meta box overrides aren’t excluding everything.
4. Adjust LLM Index settings and try again.

image IMAGE PLACEHOLDER: Composite screenshot idea: left panel showing some module’s settings (e.g., Forms), right panel showing the corresponding Debug Log entries after reproducing issues. IMAGE image