Buni.aiDocs
USSDChatbotVoice (IVR)Automation

Error

Shows the user a message when their input is invalid, then lets them try again. On voice projects it says the message and ends the call.

Error handles a failure on the path that reaches it. Its main use is on USSD: when a user types an option that does not exist, an Error node shows a short message above the next screen, typically the same menu again, so they can try again.

When to use it

  • A USSD menu reply matches none of the Router's paths: connect the Router's fallback path to an Error node, then back to the menu.
  • On a voice call, say a closing message and hang up when something has gone wrong.
  • In chatbots, send a message with a Reply node instead; the Error node does not send its message there (see below).
  • In automations, handle failed steps with the failure path on API and Integration nodes, or an error workflow.
Error settings with Error Message set to Invalid choice, please try again

Settings

Prop

Type

What it does on each project type

Project typeBehaviour
USSDSaves the message, then runs the next node. The next Menu screen shows the message on its first line, above its own text, and clears it. Connect the Error node to the screen the user should see.
VoiceSays the message to the caller and ends the call. Nothing after it runs.
ChatbotDoes not send the message. The flow passes straight to the next node. An Error node with nothing after it replies "Hello... Do you want me to connect you to a human?"
AutomationPasses its input straight to the next node.

Outputs

One output. On USSD it must be connected: the message is shown by the next screen.

Example

A USSD main menu offers 1. Balance and 2. Airtime:

  1. Menu (Main) shows the options.
  2. Router: input == 1 to Balance, input == 2 to Airtime, fallback to the Error node.
  3. Error: "Invalid choice. Please try again."
  4. Connect the Error node back to the Menu.

A user who types 5 sees:

Invalid choice. Please try again.
1. Balance
2. Airtime

Tips and limits

  • Keep USSD error messages short: they share the screen with the menu, and USSD screens are limited in length.
  • On voice projects, put any "transferring you" or "call us back" wording in the message itself, since the call ends straight after it.
Last reviewed 24 September 2026

On this page