Execute code

The Execute Code action allows you to run custom code directly within your journey. This gives you the flexibility to perform operations beyond the built-in actions, such as making calculations, manipulating data, or integrating with external services.

When using this action, you have access to pre-configured Globals that make coding easier and safer.

---

Execute Code Globals

• Functions
  Pre-built operations you can call directly in your code.

  • len: Gets the length of an object.
  • range: Generates a sequence of numbers.
  • isinstance: Checks if an object is of a certain type.
  • print: Safe logging function.
  • uuid: Generates a unique ID.
  • get_unix_timestamp: Gets the current Unix timestamp.
  • upload_to_s3: Uploads a file to an S3 bucket.
  • get_contact_details: Retrieves predefined details about the current contact.
    • The returned object includes useful variables you can directly use in your code:
      details = {
        "phn_number": <users phone number>,
        "first_name": <users first name>,
        "last_name": <users last name>,
        "email_id": <users email id>,
        "contact_id": <users contact id>,
        "iframe_user_id": <users iframe id >
        # ... plus any custom attributes saved for the contact
      }
      
    • This means you can quickly access user data without writing extra queries.
    • Example usage:
      details = get_contact_details()
      name = details['first_name']
      
      Output: Hello Avinash, we’ll contact you at 918237502610.

• Modules
  Imported Python libraries available for use.

  • httpx: For making HTTP requests.
  • json: For parsing and serializing JSON data.
  • ElementTree: For parsing XML data.
  • re: For working with regular expressions.

• Types
  Basic data types you can work with.

  • str: String type.
  • int: Integer type.
  • float: Float type.
  • list: List type.
  • dict: Dictionary type.
  • set: Set type.
  • tuple: Tuple type.

Test Run

The Test Run feature allows you to test your custom code before you save it to the journey. This is an essential debugging tool that helps you ensure your code works as expected and is free of errors.

When you click Test Run, the platform executes your code in a safe, isolated environment. You can use this to:

• Check for any syntax errors in your code.
• Verify that your code produces the correct output.
• See how your code interacts with the variables and functions available in the journey.

Using this feature helps you confidently build and publish your flows, knowing that your code will perform correctly.