Why Isn't My ZazzyAgent AI Agent Replying?
Your AI Agent is configured, but customers aren't receiving replies.
Before changing the System Prompt or rebuilding the agent, check the connection and configuration in order.
1. Is the AI Agent active?
Creating an AI Agent does not necessarily mean it is ready to respond.
Check the Agent Configuration area and confirm that the agent is enabled for the intended setup.
This is one of the first checks to make.
2. Is the correct agent configured?
If you have multiple AI Agents, confirm that the intended agent is active.
For example:
Sales Agent
Support Agent
Order Agent
Make sure the customer's conversation can actually reach the agent you're testing.
3. Check agent routing
If your setup uses routing rules, check that the customer's message can be routed to the correct AI Agent.
Example:
Product question
→ Sales Agent
Order question
→ Support Agent
If a conversation isn't being routed to an AI Agent, the prompt itself won't solve the problem.
4. Check the connected channel
Make sure you're testing the same channel where the agent is configured.
For WhatsApp, check that your WhatsApp connection is active.
For Instagram, check the Instagram connection and messaging permissions.
If Instagram isn't receiving incoming messages at all, see Instagram Bot Connected but Not Replying? Check This Setting.
5. Test with a simple message
Start with:
Hello
Then try:
What do you sell?
This helps establish whether the problem is the agent connection or a particular workflow.
6. Check the System Prompt
A System Prompt can accidentally prevent useful responses.
Look for instructions such as:
Never reply.
Only respond after an action.
Transfer every conversation.
Skip vague messages.
A rule like:
##skip_reply##
can intentionally prevent a customer-facing reply when your conditions tell the agent to use it.
Don't use broad instructions that can suppress normal conversations.
7. Check the knowledge source
If the agent is supposed to answer business questions, confirm the correct knowledge source is attached.
Also make sure the knowledge contains the information the customer is asking about.
Remember:
Knowledge helps answer questions.
The System Prompt controls behavior.
A missing knowledge source doesn't always mean the agent should remain silent, but it can affect the quality and usefulness of its responses.
8. Check whether an action is blocking the conversation
Actions such as:
##skip_reply##
can intentionally result in no customer-facing response.
Other actions can transfer the conversation to another agent or human.
Review the System Prompt to make sure the action is being used under the right condition.
9. Check AI-to-human handoff
If your agent transfers conversations immediately, it may appear as though the AI isn't replying.
Review rules containing:
##assign_human_member##
or:
##assign_human_role##
Make sure human assignment happens only when required.
See How to Hand Off AI Conversations to Human Agents in ZazzyAgent.
10. Check AI-to-AI transfers
Your agent may be transferring the conversation to another AI Agent.
Look for:
##transfer_agent##
If the receiving agent isn't configured correctly, the conversation may appear to stop.
Review both agents.
11. Check action IDs and resources
If an action depends on a selected resource, use the ## autocomplete inside the System Prompt editor.
Don't manually guess IDs.
This applies to actions such as:
##add_label## : 12
##assign_sequence## : 8
##save_custom_field## : 42
and:
##transfer_agent## : 18
12. Check ecommerce store actions
If you're using Shopify or WooCommerce actions, remember that the store needs to be selected first.
Shopify:
##shopify_store## : 12
WooCommerce:
##woocommerce_store## : 12
Without the required store configuration, related ecommerce actions may not behave as expected.
13. Test without actions
A useful diagnostic test is to temporarily simplify the agent.
Use a minimal prompt such as:
You are a friendly customer support assistant.
Answer customer questions using your connected knowledge.
If you cannot answer something accurately,
say that you don't have enough information.
Then send:
Hello
If the simplified agent responds, your original problem may be in the System Prompt, routing or actions.
14. Test a second channel or account where appropriate
When possible, test from another customer account.
This helps distinguish:
Agent problem
from:
Customer/channel-specific problem
15. Check the incoming message
If the message isn't reaching ZazzyAgent at all, the AI Agent cannot respond.
For Instagram, make sure the required message-access settings are enabled.
For WhatsApp, check the WhatsApp connection and messaging flow.
A useful troubleshooting path
Customer sends message
↓
Message reaches ZazzyAgent?
↓ ↓
No Yes
↓ ↓
Check channel Agent active?
↓
Correct routing?
↓
System Prompt?
↓
Knowledge?
↓
Actions?
↓
Human/AI transfer?
↓
AI reply
Common causes at a glance
Agent isn't active
Enable it in the appropriate Agent Configuration.
Wrong agent is receiving the conversation
Review routing rules.
Agent immediately transfers
Review ##transfer_agent## and human-assignment rules.
Agent stays silent
Look for ##skip_reply## or another instruction that prevents replies.
Agent replies but doesn't know the business
Review the attached knowledge source.
Ecommerce agent isn't working
Check the connected Shopify/WooCommerce store and relevant action.
Instagram agent receives nothing
Check the Instagram account connection and message-access settings.
The most important diagnostic rule
Don't immediately rewrite the AI Agent.
First determine where the conversation stops:
Channel
→ Routing
→ Agent
→ Prompt
→ Knowledge
→ Action
→ Reply
Once you know where the chain breaks, the fix is usually much easier to find.