Skip to main content
Before you can run any flows, you need to upload your mobile app builds to Autosana.

​
What is an App?

In Autosana, an app has a name and bundle ID and can have multiple builds, allowing you to test the latest build before each release.

​
Key Concepts

  • App: A mobile application with a unique name and bundle ID
  • Build: A specific version of your app (.app for iOS, APK for Android)
  • Active Build: The build that will be used when running flows
  • Environment: Optional grouping to organize apps (e.g., Development, Staging, Production)

​
Creating a New App

​
Step 1: Navigate to Apps Page

Click on Apps in the sidebar navigation.

​
Step 2: Click “Create New App”

Click the Create New App button in the top right corner.

​
Step 3: Fill in App Details

Required Fields:
  • App Name: A descriptive name for your app (e.g., “MyApp iOS”)
  • Bundle ID: Your app’s unique identifier (e.g., com.company.appname)
Optional Fields:
  • Environment: Assign the app to an environment for better organization
  • Agent Context: Add special instructions for the agent (e.g., “The app requires biometric authentication on first launch”)
Learn more about finding your Bundle ID →

​
Step 4: Select Platform

Choose your app’s platform:
  • iOS: For iPhone and iPad apps
  • Android: For Android devices
    • Toggle Google Play Enabled if your APK requires Google Play Services. This will ensure your app is run on a Google Play enabled device.

​
Step 5: Upload Your Build

iOS Apps:
  • Drag and drop a .zip file containing your .app bundle
  • The .app bundle should be created for simulators
Android Apps:
  • Drag and drop an .apk file
  • Ensure the APK is built for the correct architecture (universal is recommended)
Learn more about building apps →

​
Step 6: Complete Upload

Click Upload and wait for the file to upload. Once complete, your app will appear in the Apps list.

​
Managing Builds

Each app can have multiple builds. This allows you to test new versions while keeping previous builds available.

​
Uploading a New Build

  1. Find your app in the Apps list
  2. Click Upload New Build
  3. Select your new build file
  4. Click Upload
The new build will automatically become the active build.

​
Setting an Active Build

The active build is the version used when running flows. To change the active build:
  1. Click Show build history on your app card
  2. Find the build you want to activate
  3. Click Set as active

​
Downloading Builds

To download a previous build:
  1. Click Show build history
  2. Click the download icon (⬇️) next to any build

​
Deleting Builds

To delete a build:
  1. Click Show build history
  2. Click the trash icon (🗑️) next to the build
  3. Confirm deletion
If you delete the active build, the next most recent build will automatically become active. If no builds remain, flows cannot run until a new build is uploaded.

​
Editing App Details

​
Changing App Name

  1. Click the pencil icon (✏️) next to your app name
  2. Edit the name
  3. Press Enter or click Save

​
Adding Agent Context

Agent Context provides special instructions to the agent when running flows on this app.
  1. Click Add Agent Context (or Edit Agent Context if already set)
  2. Enter instructions
  3. Click Save
Example Agent Context: 
This app uses Face ID on first launch.
The test account is [email protected] with password TestPass123.
After login, dismiss the tutorial overlay by tapping "Skip".

​
Changing Environment

If you use environments to organize your apps:
  1. Click the environment dropdown on your app card
  2. Select a different environment

​
Organizing with Environments

Environments help you organize apps by deployment stage or purpose.

​
Creating an Environment

  1. Navigate to Settings → Environments
  2. Click Create Environment
  3. Enter a name (e.g., “Staging”, “Production”, “QA”)
  4. Click Create

​
Assigning Apps to Environments

  • During app creation: Select an environment from the dropdown
  • After creation: Use the environment dropdown on the app card
Apps grouped by environment appear in separate sections on the Apps page.

​
Deleting an App

To delete an app:
  1. Click the trash icon (🗑️) on the app card
  2. Confirm deletion in the dialog
Deleting an app will soft-delete it and all its builds. This action can be reversed by contacting support, but any associated flow runs will be affected.

​
Platform-Specific Features

​
iOS Apps

Device Targeting:
  • Choose between iPhone and iPad when running flows
  • Device selection affects screen resolution and UI layout
Build Requirements:

​
Android Apps

Google Play Services:
  • Toggle Google Play Enabled when uploading if your app requires Google Play Services
  • This ensures the correct runtime environment
Build Requirements:

​
Best Practices

Use Agent Context Effectively
  • Specify anything to look out for in the app
  • Note any known UI quirks or workflows

​
Troubleshooting

​
Common Issues

iOS:
  • Ensure the .zip contains a valid .app bundle (not an IPA)
  • Check that the app is built for iOS Simulator
  • Verify the bundle ID matches what you entered
Android:
  • Ensure the APK is properly signed
  • Check that the file extension is .apk
  • Verify the bundle ID matches the package name

​
Next Steps

Now that you’ve uploaded your app: