Skip to content
Nappai Documentation

Conditional Router

This component acts like a traffic controller for your messages. It checks if two text inputs match based on the conditions you set, and then sends the message down one of two paths: “True Route” or “False Route”. Think of it as a “yes” or “no” decision point in your automation workflow.

Relationship with Text Comparison

This component performs a simple text comparison. It doesn’t use any external APIs or complex algorithms; it just compares two pieces of text based on your chosen comparison method.

Inputs

  • Input Text: The first text string you want to compare.
  • Match Text: The second text string that the first text string will be compared against.
  • Operator: This lets you choose how the texts are compared. The default is “equals” (exact match). You can also choose:
    • “not equals” (checks if the texts are different)
    • “contains” (checks if the first text contains the second)
    • “starts with” (checks if the first text begins with the second)
    • “ends with” (checks if the first text ends with the second)
    • “is empty” (checks if the first text is blank). This is an advanced option.
  • Case Sensitive: This is an advanced option. If turned on, the comparison will be case-sensitive (e.g., “Apple” and “apple” would be considered different). Otherwise, it’s case-insensitive.
  • Message: The message that will be sent to either the “True Route” or “False Route” output.

Outputs

  • True Route: This output sends the message if the comparison between the “Input Text” and “Match Text” is true based on the selected “Operator”.
  • False Route: This output sends the message if the comparison between the “Input Text” and “Match Text” is false based on the selected “Operator”.

Usage Example

Imagine you’re processing emails. You want to send emails containing the word “urgent” to a special team.

  1. Input Text: The body of the email.
  2. Match Text: “urgent”
  3. Operator: “contains”
  4. Case Sensitive: Off (so it finds “Urgent”, “urgent”, etc.)
  5. Message: The entire email message.

If the email body contains “urgent”, the message goes to the “True Route” (to the special team). Otherwise, it goes to the “False Route” (to the regular team).

Templates

This component is used in the ‘Eurocup 2024’ template.

Many components can be used before or after the Conditional Router. For example:

  • Text Input: To get text input from a user or another system.
  • Email Processor: To extract email content.
  • Message Logger: To record the message flow.

Tips and Best Practices

  • Start with simple comparisons using “equals” before trying more complex operators.
  • Carefully consider whether you need case-sensitive comparisons.
  • Test your configuration thoroughly to ensure it works as expected.

Security Considerations

No specific security considerations apply to this component, as it only performs basic text comparisons. However, the security of your overall Nappai workflow depends on the security of the components it connects to.