Skip to main content

How to troubleshoot Chatbots that don't trigger or stop unexpectedly

Summary

If your chatbot doesn't start when expected or stops before completing its conversation, the issue is usually caused by an incorrect chatbot configuration, chat assignment, keyword rule, or flow setting.

This guide explains the most common reasons why a chatbot may not trigger or stop unexpectedly, along with the steps to resolve each issue.

Instructions

Chatbot issues generally fall into one of two categories:

  • The chatbot never starts.

  • The chatbot starts but stops before completing the conversation.

Choose the section below based on the issue you're experiencing.

The chatbot is not triggering

If your chatbot doesn't start when a customer sends a message, check the following:

Note: This troubleshooting section applies only to chatbots. It does not apply to keyword based rules automation.

1. Verify the chatbot has a Start Node

Every chatbot flow must have a Start Node. If a Start Node isn't configured, or your chatbot doesn't contain any message nodes, the chatbot won't begin the conversation.

Solution

  • Open your chatbot in the chatbot builder.

  • Click the three-dot menu.

  • Select Set Start Node.

  • Verify that the Start Node is connected to the rest of the chatbot flow.

  • Ensure that at least one message node is configured in the chatbot.

2. Verify the keyword matches the configured rule

If your chatbot is triggered using Rules, the customer's message must match the keyword configured in the rule.

Solution

  • Verify that the correct keyword is configured in the rule.

  • If the keyword uses Exact Match, make sure the customer's message matches the keyword exactly, including spelling and spaces.

  • If the customer's message doesn't match the configured keyword, the chatbot won't be triggered.

Note: Keywords used in keyword-based rules are not case-sensitive. For example, Support, support, and SUPPORT are treated as the same keyword.

3. Verify the conversation is assigned to a Bot

Chatbot automation only runs when the conversation is assigned to a Bot.

If the conversation is assigned to a human operator, the chatbot won't trigger.

Solution

  • Check how conversations are assigned.

  • Ensure the conversation is assigned to a Bot instead of a human operator.

4. Another chatbot or AI agent is already handling the conversation

Only one chatbot or AI agent can handle a contact at a time on the same channel. If another chatbot or AI agent is already handling the conversation, a new chatbot or AI agent cannot start.

This can happen in the following situations:

  • Multiple rules match the same message: Only the highest-priority matching rule starts a chatbot or AI agent. Other matching rules are skipped for the chatbot or AI agent action, but their other actions still run.

  • A chatbot is already running: If a chatbot started from an earlier message, a rule cannot interrupt it.

This limit applies separately to each channel. For example, a chatbot running on WhatsApp does not prevent another chatbot from running on Instagram.

Solution

  • Check whether another chatbot or AI agent is already handling the conversation.

  • If multiple rules match the same message, check which rule has the highest priority.

  • Review any keyword actions or campaigns that may be stopping the current chatbot.

The chatbot starts but stops unexpectedly

If your chatbot begins the conversation but doesn't complete the flow, check the following:

1. The customer sent an unsupported response

If the chatbot expects a specific reply but receives a different response, the conversation may stop.

For example, if the chatbot expects 1, 2, or 3, but the customer replies with Hello, the chatbot won't know which path to follow.

Solution

  • Configure a General or Default Response to handle unexpected replies.

  • Redirect customers back to the expected question or another chatbot flow.

2. The customer sent a media message

If a customer sends a media message, such as an image or video, and the chatbot isn't configured to accept media input, the chatbot will stop.

Solution

Configure the chatbot node to accept media responses where required.

3. The chatbot timer expired

Every chatbot has an inactivity timer. If the customer doesn't reply before the timer expires, the chatbot automatically ends.

Solution

  • Open the chatbot builder.

  • Click Chatbot Timer in the upper-right corner.

  • Adjust the timeout value.

The chatbot timer can be set between 1 minute and 1,440 minutes (24 hours).

4. A chatbot node is misconfigured

If a node isn't configured correctly, the chatbot may stop before continuing to the next step.

This commonly happens with integration nodes such as:

  • Webhook

  • Google Sheets

Solution

  • Verify that each node is configured correctly.

  • Confirm that any external integrations are connected and working as expected.

5. The chatbot uses features unavailable on your plan

Some chatbot features are available only on specific Wati plans.

If your chatbot contains features that aren't included in your current plan, parts of the chatbot may not function correctly.

Solution

  • Remove features that aren't supported by your current plan.

or

  • Upgrade your Wati plan to use those features.

6. The chatbot reaches an AI agent node

The Astra AI Agent and Custom AI Agent nodes end the chatbot and hand the conversation over to the AI agent. Nothing runs after these nodes.

Solution

If you need the chatbot to run additional steps before handing over the conversation, move those steps before the AI agent node.

7. The chatbot reaches a Smart Escalation assignment

When Smart Escalation detects that a customer needs human assistance, it assigns the chat to the selected team and ends the chatbot. Nothing runs after the Smart Escalation assignment.

Solution

This is expected behavior.

Still having issues?

If your chatbot still doesn't trigger or complete its flow after checking the items above:

  • Review your chatbot flow for missing or disconnected nodes.

  • Verify that all rules and integrations are configured correctly.

  • Check whether another chatbot or AI agent is already handling the conversation.

  • Check whether a keyword action or campaign has stopped the current chatbot.

  • Test the chatbot using the expected customer inputs.

  • If the issue persists, contact Wati Support with your chatbot details so the team can help investigate further.

Frequently Asked Questions (FAQs)

Chatbot not triggering

1. What does a chatbot need to start a conversation?

A chatbot needs a Start Node connected to the rest of the chatbot flow and at least one configured message node. If the Start Node is not configured or the chatbot has no message nodes, the chatbot will not start.

2. Why doesn't my chatbot trigger when a customer sends a message?

If the chatbot is triggered using a Rule, the customer's message must match the keyword configured in that Rule. If Exact Match is enabled, the message must match the keyword exactly, including spelling and spaces. Keywords in keyword-based Rules are not case-sensitive.

3. Why doesn't my chatbot trigger when the conversation is assigned to a human operator?

Chatbot automation only runs when the conversation is assigned to a Bot. If the conversation is assigned to a human operator, the chatbot will not trigger.

4. Can another chatbot or AI agent prevent my chatbot from starting?

Yes. Only one chatbot or AI agent can handle a contact at a time on the same channel. If another chatbot or AI agent is already handling the conversation, a new chatbot or AI agent cannot start.

Chatbot stops unexpectedly

5. Why does my chatbot stop when a customer sends an unexpected response?

If a chatbot expects a specific reply but receives a different response, it may stop because it cannot determine which path to follow. For example, if the chatbot expects 1, 2, or 3, but the customer replies with Hello, the chatbot will not know which path to follow.

6. Why does my chatbot stop when a customer sends a media message?

If a customer sends a media message, such as an image or video, and the chatbot is not configured to accept media input, the chatbot will stop.

7. Why does my chatbot stop after a period of inactivity?

A chatbot automatically ends when its inactivity timer expires before the customer replies. The chatbot timer can be set between 1 minute and 1,440 minutes (24 hours).

8. Why does my chatbot stop at a chatbot node?

A chatbot may stop before continuing if a node is not configured correctly. This commonly happens with integration nodes such as Webhook and Google Sheets.

9. Why doesn't part of my chatbot work with my current Wati plan?

Some chatbot features are available only on specific Wati plans. If your chatbot uses features that are not included in your current plan, those parts of the chatbot may not function correctly.

10. Why does my chatbot stop after an AI agent node?

The Astra AI Agent and Custom AI Agent nodes end the chatbot and hand the conversation over to the AI agent. Nothing runs after these nodes. Any additional chatbot steps must be placed before the AI agent node.

Did this answer your question?