> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpressbot.org/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Automations

> Automate TikTok direct messages, comment replies, mentions and ad entries with triggers and TikTok steps.

## What is this?

A **TikTok automation** is a normal automation that runs on the **TikTok** channel. It can answer direct messages, reply to or moderate comments, respond to mentions, and welcome people who arrive from a TikTok ad or link.

## What can I do here?

Choose a trigger, then add TikTok steps from the **TikTok Messages** group in the builder.

| Trigger | Starts when |
| - | - |
| **Message received** | A customer messages you on TikTok (the usual message triggers work) |
| **User comments on your TikTok post** | Someone comments on one of your posts (usually within five minutes). Choose **Any post** or **A specific post**, **Also run for replies to comments**, and match **Any comment**, **Contains a keyword** or **Exactly matches a keyword** |
| **Someone mentions your TikTok account** | Someone @mentions you in a comment or a post caption — choose **Any mention**, **Mentions in comments** or **Mentions in post captions**. TikTok reports mentions up to two or three hours late |
| **User opens a DM from a TikTok ad or link** | Someone enters your DMs from a Click-to-Message ad or a `tiktok.me` link. Filter by **Entry point**, a link **ref**, or an **Ad ID** |
| **High-intent comment on your TikTok post** | TikTok flags a comment as high intent (Comment-to-Message). The first text message of the flow is sent as one private reply to that comment |

| Step | What it does |
| - | - |
| **TikTok Text** | Sends a text reply in the DM |
| **TikTok Image** | Sends one JPG or PNG (max 3 MB) |
| **TikTok Ask Text / Ask Number / Ask Email** | Asks a question, waits for the reply, validates it, and saves the answer to a field |
| **TikTok Comment Reply** | Publicly replies to the triggering comment (max 1,200 characters). Add several variants — one is picked at random |
| **TikTok Moderate Comment** | Hides or deletes the triggering comment, for example after a spam keyword |

## How to use it

1. In [Automations](https://docs.xpressbot.org/workspace/automation/overview.md), create a new automation and choose the **TikTok** channel.
2. Pick a trigger and fill in its options. For keyword matching, add at least one keyword. For a specific post, pick the post — the automation doesn't run until you do.
3. Add steps. Comment steps work only with the comment trigger (and **TikTok Comment Reply** also with the mention trigger).
4. Save and activate.

> [!NOTE]
>
> **TikTok does not allow direct messages to people who only commented**, so after a normal comment you can reply publicly or moderate, but not DM. The exception is a **High-intent comment** (Comment-to-Message): TikTok allows one private reply per top-level comment on your own post, within 48 hours, when the user hasn't chatted with you recently.

## Troubleshooting / Technical Notes

* **The automation never runs.** Check it's active, the account shows **Connected**, a post is selected (for a specific post), and a keyword is added (for keyword matching).
* **A DM step isn't offered after a comment.** TikTok doesn't allow DMs to commenters; use a public reply instead.
* **A reply was rejected.** TikTok only allows DM replies after the customer has messaged you, within its messaging window.
* **Image messages don't send.** Image messages aren't available in every market.

## Related docs

* [TikTok](https://docs.xpressbot.org/workspace/tiktok/overview.md)
* [Automation Overview](https://docs.xpressbot.org/workspace/automation/overview.md)
* [AI Agents](https://docs.xpressbot.org/workspace/ai-agents/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.