Skip to main content

Human-in-the-Loop

Some tasks cannot be fully automated. Complex CAPTCHAs, two-factor authentication prompts, unexpected UI changes, or manual verification steps may require a human to step in. hidettp supports this through human-in-the-loop intervention — a mechanism that lets a bot pause, request help, and resume once a person has completed the required action.

Use Cases​

  • Complex CAPTCHAs — Visual puzzles, audio challenges, or multi-step CAPTCHAs that automated solvers cannot handle.
  • Login flows requiring 2FA — Entering a one-time code from an authenticator app or SMS.
  • Unexpected UI changes — A page layout has changed and the bot cannot find the expected element.
  • Manual verification steps — Confirming an action, reviewing extracted data, or making a judgment call.

How It Works​

The human intervention flow follows these steps:

  1. Bot requests help — During execution, the bot script encounters a barrier and triggers a requestHuman step.
  2. Execution pauses — The bot stops all automated actions and holds the browser in its current state.
  3. Alert is created — hidettp creates an alert tied to the execution, visible in the Alerts section.
  4. Notification is sent — Team members are notified through configured channels: in-app notification, Slack message, or email.
  5. User takes over — A user clicks the alert or notification link and is connected to the live browser session. From this point, the user has full control — clicking, typing, scrolling — just as if they were browsing directly.
  6. User completes the action — The user solves the CAPTCHA, enters the 2FA code, or performs whatever manual step is needed.
  7. Execution resumes — The user signals completion (or navigates past the barrier), and the bot picks up where it left off, continuing with the remaining automated steps.

External Access​

Not everyone who can help will have a hidettp account. When a human intervention request is created, a shareable URL is generated that grants access to the live browser session:

  • The link is token-authenticated — only someone with the exact URL can connect.
  • The link is time-limited — it expires after the intervention window closes.
  • Anyone with the link can interact with the browser, making it easy to involve colleagues, clients, or external specialists.

Timeout Behavior​

Human intervention requests have a 30-minute response window:

  • If no one connects within 30 minutes, the intervention times out and the execution fails with a timeout status.
  • Once a human starts interacting with the browser, the timeout is cancelled — there is no rush once someone has taken over.

Configuration​

To use human intervention in your bots:

  1. Open the bot's settings.
  2. Enable Human Intervention Mode.
  3. In your bot script, add requestHuman steps at the points where human help may be needed.

When enabled, the bot will pause at those steps and follow the intervention flow described above. When disabled, requestHuman steps are skipped and the bot continues automatically.