Automated Application Process

Automated Application Process

Once you have reviewed and approved a job application in Envoy, the system takes over to automate the submission process. Envoy leverages a local browser automation service (Playwright) to navigate job portals, fill out forms, and interact with external application sites on your behalf, pausing for your input whenever necessary.

Initiating the Application

After reviewing a job and its generated cover letter, you click the "Start Applying" button in the Envoy Portal. This action signals the Envoy Agent to begin the automated application workflow for that specific job.

The application process proceeds through several phases, providing real-time updates in the Portal:

• idle: The application is ready to start.
• starting: Envoy is launching a dedicated browser instance and navigating to the application page.
• gate: Envoy is waiting for your intervention on a critical step (e.g., logging in).
• paused: Envoy requires your input for specific questions.
• running: Envoy is actively filling out the application form.
• done: The application has either completed successfully or failed.
• error: An unexpected error occurred during the process.

Envoy's Application Workflow

Envoy's core strength lies in its ability to adapt to diverse application processes, from simple forms on job board sites to complex multi-page application portals.

1. Browser Automation and Inspection

Envoy launches a hidden (or visible, depending on your settings) Chrome browser instance. It then navigates to the job application page. Using its Tools service, Envoy's "Inspector" component scans the page to:

• Identify form fields (text inputs, checkboxes, radio buttons, dropdowns, file uploads).
• Read field labels, current values, and available options.
• Detect the type of application flow (e.g., direct application on SEEK vs. redirection to an external company career portal).
• Determine if a login is required for the provider (e.g., SEEK, LinkedIn).

2. Automatic Form Filling

Based on the inspected fields, Envoy intelligently attempts to fill out the application form using information from your profile and the prepared cover letter. This includes:

• Personal details: Name, contact information.
• Resume/CV upload: Attaching your prepared resume.
• Cover letter insertion: Pasting the approved cover letter into the relevant field or uploading it as a file.
• Experience and education: Drawing from your structured profile data.

3. Handling User Intervention (gate and paused states)

Envoy is "review-first," meaning it prioritizes accuracy and your control. There are key moments when Envoy will pause and require your interaction:

• Authentication Required (gate): If the application requires you to be logged into a job board (e.g., SEEK) and Envoy detects you are not, it will pause. A browser window will open, prompting you to log in manually. Once logged in, you can click "Retry" in the Portal to resume.

  • Example message: "SEEK login required. The browser window opened but SEEK requires you to be logged in. Please log in to SEEK in the Chrome window that just opened, then click Retry below."

• External User Questions (paused): For application forms on external company portals, there are often unique questions that Envoy's AI cannot confidently answer from your profile (e.g., "Why are you interested in this specific company?"). In these cases, Envoy will:

  • Pause the application process.
  • Display the detected questions in an "External User Questions Panel" in the Portal.
  • Allow you to provide your answers directly in the UI.
  • Once you've answered, you confirm, and Envoy injects your responses into the browser form to continue.

• Proposed Values Review: Envoy will present the values it proposes to enter into certain fields. You have the opportunity to review and edit these proposed values before confirming they should be submitted.

4. Application Submission

Once all required fields are filled and any necessary user interventions are complete, Envoy will proceed to submit the application form.

• Confirmation: If the application flow includes a final confirmation page, Envoy will detect it and ensure the submission is completed.
• Success Notification: Upon successful submission, the Portal will update the application status to completed and notify you. You can then navigate back to your job queue.
• Failure Notification: If the workflow encounters an unrecoverable error or fails to submit (e.g., due to an unexpected page layout or CAPTCHA), the application status will change to failed, and an error message will be displayed in the Portal. You can then investigate or manually complete the application if desired.

Key Interaction Points for the User

As a user, your main interactions during the automated application process involve:

1. Clicking "Start Apply": To initiate the automation after approving a job.
2. Logging in (if prompted): Manually logging into job board accounts when requested by Envoy.
3. Answering specific questions: Providing answers to unique external questions that Envoy cannot infer.
4. Reviewing and confirming proposed values: Ensuring the information Envoy intends to submit is accurate.
5. Monitoring progress: Observing the real-time RunLog and status updates in the Portal.

Envoy aims to automate the tedious parts of job applications while ensuring you retain ultimate control and oversight.