Tap image

• Type phone.tapImage
• Group MZBase
• Role action
• Risk changes data
• Side effect has an effect each run
• Runs once per item
• Needs phone, media

Waits for a reference image on the screen and taps it

Also available to AI agents and over MCP as a tool.

Parameters

phoneId

Phone · string · optional

The phone to use. Empty = the phone of the run’s target.

templateSource

Reference image from · string · required · default binary · one of binary, media

The picture to look for on the screen: a file on the item or a media library image.

templateBinaryProperty

Reference image property · string · optional · default data

Shown when templateSource is binary.

templateMediaId

Reference image (media) · string · optional

Shown when templateSource is media.

threshold

Match threshold · number · optional · default 0.85 · range 0.5 – 1

How close a match must be, 0–1. Lower finds more but may match the wrong place.

scales

Scales · array · optional · default [1]

region

Region · json · optional

offsetX

Offset X · integer · optional · default 0

Tap this many pixels right of the match centre (negative = left).

offsetY

Offset Y · integer · optional · default 0

timeoutMs

Timeout (ms) · integer · optional · default 10000 · range 0 – 600000

How long to wait, in milliseconds, before the step fails.

failIfMissing

Fail if not found · boolean · optional · default true

into

Into field · string · optional · default match

Outputs

• main

← All nodes