Skip to main content
When Conversation AI is not behaving as expected in the HoopAI platform — whether the bot is not responding, giving poor answers, or failing to hand off to a human — the issue usually comes down to configuration, training data, or channel setup.

Common Conversation AI issues

IssueLikely cause
Bot does not respond at allConversation AI is disabled or channel is not assigned
Bot gives irrelevant answersTraining data is incomplete or outdated
Bot responds when it should notTrigger conditions or channel filters are too broad
Handoff to human failsHandoff rules are not configured or no agents are available
Knowledge base not syncingSource URL is unreachable or sync schedule is paused

Step 1: Verify Conversation AI is enabled

1

Check the main toggle

Navigate to Conversation AI > Settings in the Hoop platform. Confirm the master toggle is switched on. If it is off, the bot will not respond to any messages.
2

Confirm the bot is assigned to the correct channel

Under Conversation AI > Channels, verify the bot is enabled for the specific channels you expect — such as SMS, web chat, Facebook Messenger, or Instagram DM. Each channel must be individually activated.
3

Review trigger conditions

Check if you have set trigger conditions that limit when the bot activates. For example, a condition set to “only new contacts” will prevent the bot from responding to existing contacts.

Step 2: Improve response quality

1

Review your training data

Go to Conversation AI > Knowledge Base and review the content the bot is trained on. Ensure it covers the topics your contacts are asking about. Gaps in training data are the most common cause of irrelevant responses.
2

Add Q&A pairs

For frequently asked questions, add explicit Q&A pairs under Conversation AI > Q&A. These take priority over general knowledge base content and give you precise control over specific answers.
3

Adjust the confidence threshold

Under Conversation AI > Settings, adjust the confidence threshold. A higher threshold means the bot only responds when it is very confident, which reduces incorrect answers but may cause more handoffs. A lower threshold makes the bot more responsive but increases the risk of poor answers.
Start with a confidence threshold around 0.6 and adjust based on the quality of responses you observe in conversation logs.

Step 3: Fix knowledge base sync issues

1

Check your source URLs

If you are syncing from a website, verify the URLs are publicly accessible and not behind a login wall. The Hoop crawler cannot access password-protected content.
2

Review sync status

Under Conversation AI > Knowledge Base, check the last sync timestamp and status. If the sync shows an error, click into it for details. Common errors include DNS failures, timeouts, and 403 responses.
3

Manually re-sync

Click the Sync Now button to force a refresh. After syncing, test the bot by asking a question that should be answered by the newly synced content.
Changes to your knowledge base may take a few minutes to take effect. The bot continues to use the previous version until the new data is fully indexed.

Step 4: Configure handoff to human agent

1

Enable handoff rules

Navigate to Conversation AI > Handoff and ensure handoff is enabled. Define the conditions that trigger a handoff — for example, when the bot’s confidence is below the threshold or when the contact explicitly requests a human.
2

Set agent availability

Handoffs only work when at least one agent is marked as available. Check Settings > Team Management to confirm agent availability status and working hours.
3

Test the handoff flow

Send a test message that should trigger a handoff (such as “I want to speak to a person”). Verify that the conversation is routed to the correct team or agent and that the bot stops responding.
If no agents are available when a handoff is triggered, the bot can be configured to either continue responding or send a fallback message. Configure this under Conversation AI > Handoff > Fallback Behavior.

FAQs

Yes. You can enable Conversation AI on any combination of channels. Each channel can have its own trigger conditions and behavior, or you can use a shared configuration across all channels.
Add a contact tag or custom field condition to your trigger rules. For example, you can exclude contacts tagged as “VIP” so they always reach a human agent directly.
This usually happens when the knowledge base contains duplicate or very similar content. Review your training data and remove duplicate entries. Also check that Q&A pairs do not overlap with knowledge base content.
Last modified on March 5, 2026