Skip to main content

Debugging automations and fixing errors

Find and solve problems in your automations quickly and reliably

Mika Hally avatar
Written by Mika Hally
Updated yesterday

This article shows you how to identify, debug, and fix problems in automations. From common errors to systematic debugging methods.

Common problems and solutions

Problem 1: Filters are not applied correctly

What happens:

The automation goes in the wrong direction or stops unexpectedly.

Why this happens:

  • Filter condition is incorrectly configured (e.g., "contains" instead of "equals")

  • "Has no value" misunderstood (means field is empty, not "value is not X")

Solution:

  1. Open the automation

  2. Go to the filter node causing the problem

  3. Check the condition step by step:

    • Is the condition logically correct? (e.g., "contains at least one of" when multiple options are possible)

    • Test with a known value

Problem 2: Multiple automations running simultaneously

What happens:

Customer receives multiple messages simultaneously or different automations collide.

Why this happens:

Multiple automations have triggers that listen to the same signal (e.g., "New incoming conversation" and "New incoming message").

Solution:

See detailed instructions in the article "Automations for advanced users" under "Working with multiple automations".

Short version:

  • Use "Wait / Pause" (2 seconds) + "Filter: Active other automation" in the more general automation

Problem 3: Deleted elements in nodes

What happens:

Automation suddenly stops at a specific node and shows an error.

Why this happens:

A user deleted an element (e.g., label, contact list, contact attribute) that is used in an automation node.

Example:

  • You deleted the label "VIP"

  • Node "Update label" tries to add label "VIP"

  • Node fails because the label no longer exists

Solution:

  1. Go to the sidebar on the right under "Automations" (in the inbox or in the Contact Hub for the conversation or contact where the automation failed)

  2. Click on the failed automation run

  3. Look at the individual executed nodes - the failed node shows exactly which element is missing

  4. Open the automation

  5. Go to the affected node

  6. Select an existing element or recreate the deleted element

Prevention:

Before deleting labels, contact lists, or inboxes, check if they are used in automations.

Problem 4: Two AI agents active at the same time

What happens:

Automation automatically stops at the AI agent node with an error message.

Why this happens:

There is already an automation with AI agent running for this conversation. We don't allow two AI agents to speak with the same contact in the same conversation at the same time.

Solution:

Build your automations so that only one AI agent automation can run at a time:

  1. Use "End other automation" at the beginning of the new automation to stop the old one

  2. Or use filter "Active automation" to check if an AI agent automation is already running

Problem 5: Automation runs with old version

What happens:

You made changes to the automation but it behaves like before.

Why this happens:

You forgot to publish the new version. The old version is still active.

Solution:

  1. Open the automation

  2. In the top right you'll see the "Update" button

  3. Click on "Update"

Using version history:

You can view all versions of your automation:

  1. In the Automation Builder, click the three-dot menu in the top right (next to the "Update/Pause" button)

  2. Click on "Version history"

  3. You'll see all versions chronologically with date, time, and who published the version

  4. "Active" shows you which version is currently live

  5. "Draft" shows you unpublished changes

  6. Click on the eye icon to view an old version

What the version history is good for:

  • Check which version is currently active

  • Track when and who made changes

  • View old versions to understand what was changed

Important:

  • Only published versions run live

  • Changes in editing mode are not automatically active

  • For updated automations: Only newly started automation runs go through the updated version

  • Already active runs finish in the version they started in

Example:

  1. Automation version 1 is active

  2. Customer A starts automation → runs through version 1

  3. You publish version 2

  4. Customer A is still in the automation → finishes with version 1

  5. Customer B starts automation → runs through version 2

Problem 6: Variables or contact attributes are empty

What happens:

Automation stops at a "Send message" node or other nodes that use variables.

Why this happens:

The variable or contact attribute you want to use is empty. We don't send messages with empty placeholders because it looks unprofessional.

Example:

  • Node "Send message": "Hello {{contact.first_name}}, welcome!"

  • Contact attribute "First name" is empty

  • Message would be: "Hello , welcome!"

  • Node fails

Solution 1 - Define fallback:

You can set a fallback value for each variable that will be used if the variable is empty:

  1. Click on the variable in the text field (e.g., the "First name" chip)

  2. A popup opens: "Fallback value for First name"

  3. Enter a fallback value (e.g., "there" or "Customer")

  4. Click on "Apply"

Example:

  • Variable "First name" with fallback "from Berlin"

  • If first name is filled in: "Hello Max, welcome!"

  • If first name is empty: "Hello from Berlin, welcome!"

Solution 2 - Add filter:

Add a filter before the "Send message" node:

  • Filter: "First name has any value"

  • Only if first name is filled in → Send personalized message

  • Otherwise → Send generic message without first name

Solution 3 - Request attribute beforehand:

Make sure the attribute is filled in before you use it:

  • Node "Ask question": "What's your first name?"

  • Node "Edit contact": Save response in "First name"

  • Now you can be sure that first name is filled in

Problem 7: Automation triggers again after manual cancellation

What happens:

User cancels automation to take over manually. Customer responds. Automation starts again from the beginning.

Why this happens:

You're using the trigger "New incoming message" - this triggers with every message, even after an agent has taken over.

Example:

  • Automation: Trigger "New incoming message" → AI agent

  • Agent cancels and takes over manually

  • Agent responds to customer

  • Customer writes back

  • Trigger fires again → AI agent starts again

Solution: Use the trigger "New and reopened conversation" instead:

  • Only triggers on the first message of a conversation

  • Doesn't trigger on every follow-up message

  • Agent can take over without the automation starting again

Alternative solution: If you must use "New incoming message":

  • Add filter: "Assignment has no value"

  • Automation only runs if conversation is not assigned

  • As soon as user takes over (assignment happens) → Automation no longer triggers

Problem 8: Automation cannot be tested

What happens:

You want to test the automation but it also triggers for real customers, or you can't trigger it reliably.

Why this happens:

We don't have a test mode for automations yet (only for AI agent).

Solution - Message content filter for testing: Add a filter at the beginning of the automation that only triggers during testing:

  1. Option 1 - Message content filter:

    • Node "Filter / Condition": "Message content contains 'TEST123'"

    • Only when you write "TEST123" in the message → Automation runs

    • Real customers never write that → Automation doesn't trigger for them

  2. Option 2 - Contact list filter:

    • Create contact list "Testing"

    • Add yourself to this list

    • Node "Filter / Condition": "Contact list contains Testing"

    • Only for contacts in "Testing" → Automation runs

Important: Remove the test filter before publishing the automation for real customers!

Problem 9: Automation only triggers once

What happens:

Automation runs the first time but never again - not even when testing.

Why this happens:

Reason 1 - "Only once per contact" enabled:

  • Many triggers have the option "Execute only once per contact"

  • If enabled → Automation only runs the very first time for this contact

  • Never again after that

Reason 2 - Trigger "New incoming conversation" without "Reopened":

  • Trigger is set to "New conversations only"

  • Only triggers on the very first message from a contact

  • Reopened conversations don't trigger

Solution:

When testing:

  1. Delete the conversation completely

  2. Start fresh - Automation can trigger again

For live operation:

  1. Open the automation

  2. Go to the trigger

  3. Deactivate "Execute only once per contact" (if enabled)

  4. Or change "New conversations only" to "New and reopened conversations"

Problem 10: Wrong message type for channel

What happens:

Automation stops at a "Send message" node with an error message.

Why this happens:

You're trying to send a message type that isn't supported for this channel.

Most common examples:

WhatsApp quick replies in Instagram:

  • You use "WhatsApp quick replies" node

  • But the conversation is running via Instagram

  • WhatsApp quick replies only work on WhatsApp

WhatsApp list in email:

  • You use "WhatsApp list" node

  • But the conversation is running via email

  • WhatsApp lists only work on WhatsApp

Solution 1 - Add filter:

Add a filter before the channel-specific node:

  1. Node "Filter / Condition": "Channel type equals WhatsApp"

  2. If WhatsApp:

    • Path 1: WhatsApp quick replies / WhatsApp list

  3. Otherwise:

    • Path 2: Regular "Send message" node without special features

Solution 2 - Use multi-channel automations correctly:

When building automations across multiple channels:

  • Build separate paths for each channel

  • Only use channel-specific message nodes in the correct path

Problem 11: Conversation time window closed

What happens:

Automation stops at WhatsApp quick replies, WhatsApp list node, or channel-independent "Send message" node with error message "Conversation time window closed".

Why this happens:

WhatsApp has a 24-hour rule: You can only send free messages (quick replies, lists, regular text) within 24 hours of the customer's last message. After 24 hours, the conversation time window is closed.

When this problem occurs:

Example - Delayed automation:

  1. Customer writes at 10:00 AM

  2. Automation starts

  3. Node "Wait / Pause": Wait 25 hours

  4. Node "WhatsApp quick replies": Tries to send

  5. Error: Window is closed (more than 24 hours have passed)

Solution - Check conversation time window:

Add a filter before channel-specific WhatsApp nodes:

  1. Node "Filter / Condition": Conversation time window

  2. Path Open: Window is open (less than 24 hours)

    • WhatsApp quick replies / WhatsApp list / Regular message

  3. Path Closed: Window is closed (more than 24 hours)

    • Node "Send WhatsApp template" (only option outside the window)

Important to understand:

Within 24-hour window (Conversation time window = Open):

  • Free messages allowed

  • WhatsApp quick replies allowed

  • WhatsApp lists allowed

  • WhatsApp templates allowed

Outside 24-hour window (Conversation time window = Closed):

  • ONLY WhatsApp templates allowed

  • No free messages

  • No WhatsApp quick replies

  • No WhatsApp lists

Problem 12: Automation stops - No more credits

What happens:

Automation suddenly stops at action nodes. In the activity log you see many failed runs.

Why this happens:

You have no more automation credits. Without credits, automations can't run - only the trigger is executed, but no action nodes.

What are credits:

  • Each action node costs 1 credit per execution

  • Trigger and logic nodes are free

  • Without credits → Automation stops at the first action node

Solution:

  1. Go to Settings

  2. Click on Plan & Billing

  3. Click on Credits

  4. Check how many credits are still available

  5. Switch to a higher credit package or upgrade your plan for more monthly credits

How to systematically debug automations

Step 1: Identify which automation is causing the problem

Scenario: A message was sent that shouldn't have been sent

How to find the automation:

  1. Go to the conversation where the problem occurred

  2. Scroll to the affected message in the chat timeline

  3. Hover the mouse over the lightning icon next to the message

  4. A tooltip appears with the name of the automation

For AI agent messages:

  • You'll see an AI agent icon instead of a lightning icon

  • Tooltip shows: Automation name + AI agent name

Now you know which automation caused the problem.

Step 2: Check which automation runs have occurred

Sidebar on the right → "Automations" section

Here you can see two important things:

Currently active automations:

  • Which automations are currently running for this conversation

  • Status: "Running"

Past automation runs:

  • All automation runs for this contact across all conversations

  • With status: Completed, Failed, Canceled

What you can see here:

  • When the automation started

  • Which trigger activated it

  • Current status

  • How long it ran

Step 3: Analyze the specific automation run

Click on an automation run in the sidebar

Now you can see the details:

Overview:

  • Overall status of the run (Completed, Failed, etc.)

  • Start and end time

  • Trigger that activated the automation

List of all nodes that were executed:

You can see:

  • Name of the node (e.g., "Send message", "Filter / Condition", "AI Agent")

  • Status of the task:

    • Green checkmark → Successfully executed

    • Red X → Failed

    • Yellow clock icon → Waiting for response

  • Timestamp when the task was executed

For failed tasks:

  • You can see the error message why it failed

  • Example: "Label 'VIP' no longer exists"

Step 4: Go to the affected node in the automation

Jump directly to the node:

  1. Click on the failed or problematic task in the task list

  2. You'll be automatically redirected to the automation

  3. The affected node will be highlighted

Now you can:

  • Check the node's configuration

  • Review filter conditions

  • Check variables

  • Correct the node

Step 5: Check the activity log (for overarching problems)

In the automation → Tab "Activity log"

Here you can see all automation runs across all contacts.

When to use:

  • Automation isn't running for anyone (not just for you)

  • You want to see how often the automation was triggered recently

  • You're looking for patterns in errors

Filter options:

Filter by status:

  • Completed → Automation ran through successfully

  • Running → Automation is currently running

  • Failed → At least one task failed

  • Canceled → Automation was manually canceled or ended by another automation

  • Completed without action → Very important for debugging!

What does "Completed without action" mean?

The automation was triggered BUT not a single action node was executed. This happens when:

  • A filter directly after the trigger stops the automation

  • Filter is incorrectly configured

  • Condition in the trigger itself is not met

Example:

  • Trigger "New incoming conversation"

  • Directly after: Filter "Label contains VIP"

  • Contact doesn't have VIP label → Filter stops automation

  • No action was executed → Status "Completed without action"

More filters:

  • Search by contact name → Find runs from a specific customer

  • Filter by automation → Only runs from a specific automation

  • Time period → Only runs within a specific date range

Did this answer your question?