Troubleshooting

Troubleshoot AI, Web, Email, and API channels

Use availability, configuration state, and end-to-end tests to locate integration problems.

Updated 2026-07-24For: Administrators · AI managers · Developers

First identify whether failure occurs at customer entry, NavoChat handling, or external delivery. Do not change several settings at once.

Steps

AI does not reply

Check plan availability, agent enabled state, the agent selected by the channel, knowledge processing, and test traces.

Widget is missing

Check channel state, one-time loader installation, origin allowlist, browser console, and content security policy.

Custom domain is not active

Verify the exact CNAME shown by NavoChat, wait for DNS and certificate state, and use Check now when needed.

Email does not work

Confirm that the channel is Ready and Enabled. Test inbound from an external mailbox before testing an agent reply.

API or callback fails

Check server time, raw-body signing, channelId, secret, public HTTPS reachability, and response status. Retry with the same messageId.

Related guides