Skip to main content
These flows use only what Phones supports today. Each one lists the actions in order, so you can run it from an AI assistant, from your own code or with the phone agent.

Post a video to TikTok or Instagram from your own account

The post comes from a real phone that is signed in to your own account. Before you start
  • An Android phone, unlocked, with the TikTok or Instagram app installed and signed in. Pushing media works on Android only. On an iPhone, put the video in the gallery yourself and start at step 2.
  • A link to the video file. For a UGC clip made in Appeeky, read the clip with GET /v1/ugc/clips/:clipId and use its videoUrl. These links are short-lived, so fetch one right before you push. See Personas and clips.
1

Copy the video to the phone

Run push_media with the link. The video lands in the phone’s gallery.
2

Open the app

Run list_apps to find the app’s id, then open_app with it.
3

Walk to the post screen

Repeat observe, then tap: start a new post, pick the newest video from the gallery, continue to the caption screen. Each tap returns the next screen.
4

Write the caption

Tap the caption field, then run type with the caption text.
5

Tap Post and approve

The tap on Post or Share pauses. Open /dashboard/phones, check the screenshot and the caption, and choose Approve. The post goes out.
With an AI assistant connected to the Appeeky MCP server, the same flow is one prompt:
The assistant calls the phone_* tools step by step and stops at the Post button until you approve.

Hand the whole task to the phone agent

When the media is already in the gallery, let the phone agent do the walking. Push the video first, because the agent itself can’t push media.
Watch the steps in the stream, or run the same task from the Agent panel in Appeeky Desktop and watch the phone in the live view. Approve the final tap on the Phones page.

Check a screen on a real device

observe returns a real screenshot from a real phone, so an agent can look at things that only exist on a device: how your app looks after an update, or which screen a flow ends on.
The assistant opens the app, taps through with phone_tap and reads each screen. Nothing in this flow needs approval unless a button it taps is labelled like Buy or Subscribe.

Tips for reliable runs

  • Unlock the phone and keep the screen on before you start.
  • Sign in to the apps yourself. Agents never enter passwords or codes you didn’t give them.
  • Name the app, the media and the exact caption.
  • Stay close to the dashboard or your email. An approval expires after 10 minutes.
  • Keep an eye on the rate limit in long sessions: 30 actions per minute and 600 per hour for each phone.