Configuration Issues

This page covers common configuration issues and how to resolve them.

Changes Not Taking Effect

Symptoms

• Updated prompt but behavior unchanged
• New settings not reflected in calls

Solutions

Steps

1. Look for “You have unsaved changes” message
2. Click Save if present
3. Check if agent is locked
4. Test again after saving

Knowledge Base Not Working

Symptoms

• Agent doesn’t use KB content
• Wrong answers despite correct KB

Solutions

Steps

1. Verify KB toggle is ON
2. Check selected KB is correct
3. Verify KB status is “Ready”
4. Test with specific questions

Webhook Not Receiving Data

Symptoms

• No webhook calls received
• Missing event data

Solutions

Steps

1. Go to Agent Settings → Webhook Tab
2. Verify endpoint is selected
3. Verify events are checked
4. Test endpoint independently
5. Make test call and check

API Calls Failing

Symptoms

• API data not appearing in conversation
• Errors in conversation logs

Solutions

Steps

1. Check conversation logs for error details
2. Test API endpoint independently
3. Verify headers and authentication
4. Check response mapping

Variables Not Substituting

Symptoms

• See {{variable_name}} in output
• Variable values not appearing

Solutions

Steps

1. Verify variable name in prompt matches definition
2. Check Variables panel for value
3. For API variables, check response mapping
4. Test with known values

Phone Number Not Working

Symptoms

• Can’t make or receive calls
• Number shows inactive

Solutions

Widget Not Appearing

Symptoms

• Widget doesn’t show on website
• Button missing

Solutions

What’s Next