Skip to main content

Common Errors

Here's how to fix the most common issues you might encounter.

Build/Save Errors​

"Missing required field"​

What it means: A node is missing essential configuration.

How to fix:

  1. Look for nodes highlighted in red
  2. Click on the node
  3. Fill in the required fields (marked with *)

"Unreachable node"​

What it means: A node isn't connected to anything that would trigger it.

How to fix:

  1. Find the disconnected node (usually highlighted)
  2. Connect it to the flow with a wire
  3. Or delete it if it's not needed

"Type mismatch"​

What it means: You're connecting incompatible data types.

How to fix:

  • Check the data types of your connections
  • Use a Transform node to convert if needed
  • Example: Convert "42" (text) to 42 (number) with int()

Runtime Errors​

Bot doesn't respond​

Possible causes:

  1. Wrong trigger — Is the trigger correctly configured?
  2. Condition blocking — Is there a Guard or Condition blocking all paths?
  3. No flow connected — Is the trigger connected to something?
  4. Bot not saved — Did you save after making changes?

Debug steps:

  1. Add a simple Send Message right after the trigger
  2. Test if that works
  3. Add more debug messages to isolate the issue

"Variable not found"​

What it means: You're trying to use a variable that hasn't been set.

How to fix:

  1. Check the variable name spelling
  2. Make sure the Set Variable node runs before you try to use it
  3. Use the Get Variable node's "Not Found" output to handle missing data

Message not sending​

Possible causes:

  1. User blocked the bot — They need to /start again
  2. Invalid chat ID — Double-check the recipient
  3. Rate limited — Too many messages sent too fast

Editor Issues​

Canvas is blank​

How to fix:

  1. Press F to fit view
  2. Try zooming out
  3. Refresh the page (save first!)

Can't connect nodes​

Possible causes:

  1. Wrong socket type — Data sockets to data, flow to flow
  2. Already connected — Some inputs only accept one wire
  3. Incompatible types — Colors should match

Changes not saving​

How to fix:

  1. Check your internet connection
  2. Look for error messages
  3. Try Ctrl+S to force save
  4. Refresh and try again

Getting More Help​

If you can't solve an issue:

  1. Check the FAQ — Common questions →
  2. Search the docs — Use the search bar
  3. Contact support — Getting Help →

Next Steps​