Skip to main content

# Request a Text Reply (LCC.assist.ask_text)

## Declaration​

    result, err, task = LCC.assist.ask_text(options)

## Parameters​

- options
  Table. Assist request configuration. See Common Options and Return Objects. This function sets `type = "text"` automatically.

## Return Values​

- result
  Table or `nil`. Usually `{ kind = "text-reply", text = "..." }` on success.
- err
  String or `nil`. Failure reason.
- task
  Table or `nil`. The latest task state.

## Notes​

> Use this for captchas, SMS codes, passcodes, or other cases where the operator provides text and the script can continue.
> Do not use text reply when the operator needs to decide what the next action should be. Use `request_control()` instead.

## Example​

    local result, err = LCC.assist.ask_text({
        title = "Enter captcha",
        text = "Please read the captcha in the screenshot and enter it",
        screenshotLocalPath = XXT_SCRIPTS_PATH .. "/captcha.png",
        timeout = 120,
    })

    if result then
        sys.input_text(result.text, false)
    else
        nLog("assist failed", err)
    end