# Troubleshooting

If something isn't working, check this page first. Most problems match one of the cases below.

## Start here: the connection checklist

Many problems come from the TikTok connection. Check it first.

1. Open **Settings → General**.
2. Find your account in the TikTok account card.
3. Look at its checks. You want **All checks passed**. If you see *N checks failed*, click **Show checks** to see which check failed and why.
4. Fix the problem the check describes (for example, reconnect and allow every permission), then click **Check again**.

See [Connect TikTok → Connection checklist](/getting-started/connect-tiktok#connection-checklist) for what each check means.

:::tip
A **DMs unavailable** or **Reconnect needed** badge or banner means the same thing: something in the checklist failed. Click **View checks** on the banner.
:::

## Automation didn't fire

**Problem.** Someone commented or sent a DM, and nothing happened.

**Check, in order:**

1. **The connection checklist passes.** See [Start here](#start-here-the-connection-checklist).
2. **The automation is published and on.** In **Automations**, it should show as **Active**. A **Draft** or **Paused** automation doesn't run. Edits only go live after you click **Publish** — **Unpublished changes** means the live version is still the old one.
3. **You tested from another TikTok account.** Comments and messages from the connected account itself never trigger automations. Test from a different TikTok account.
4. **The keyword matches.** Check the match type (contains, exact or starts with) and the spelling. See [Keywords](/automations/keywords).
5. **The post and account are in scope.** A trigger set to specific posts, or to one account, ignores everything else. See [Comment triggers](/automations/comment-triggers).
6. **The comment wasn't hidden.** Comments hidden by [Comment moderation](/posts#comment-moderation) never trigger automations.
7. **Another automation didn't answer first.** For each comment, only the first matching automation runs.
8. **You haven't hit your contact limit.** A banner like *"MAC limit reached"* means automations won't take new contacts. See [Billing](/settings/billing#monthly-active-contacts).

## A comment matched, but got no DM and no reply

**Problem.** The comment matched your keyword (it may even show as liked), but no DM went out and no public reply was posted.

This is usually TikTok's rule, not a bug:

- **TikTok only allows a comment-to-DM for comments it flags as "high intent"** (for example questions about price or how to order). If your flow sends a DM, Tuku runs the whole flow, including its **Reply to comment** step, only for those comments. For other matching comments, Tuku only applies **Like the comment** if you turned it on. A flow that only replies to the comment runs on every matching comment. **Hide the comment after replying** waits for the flow, so those comments stay visible. In [Analytics](/analytics), these show as *"matched but TikTok didn't flag as high intent"*.
- **Comment-to-DM only works for eligible accounts registered in Vietnam, Indonesia or Thailand.** Check the **Comment-to-DM** item in the connection checklist.

If the comment got a public reply but **no DM**, either the DM couldn't be delivered and your **Reply to comment** step comes before the DM, or a teammate had paused automation in that customer's chat (Tuku skips the DM but still posts the reply). See [Reply to comment](/automations/flow-nodes#reply-to-comment).

## DM was sent, but the buyer didn't get it

**Problem.** Tuku shows the DM as sent, but the buyer says they didn't receive it.

- **The messaging window closed.** TikTok only lets you message a contact for a limited time after they last messaged you. See [Messaging limits](/inbox/messaging-limits).
- **The buyer's privacy settings** can stop or hide messages from accounts they don't follow.
- **The buyer's app hasn't updated.** Ask them to refresh or update TikTok.

## A campaign reached fewer people than expected

The audience number is an estimate. Contacts are skipped when their messaging window closed, when they already got the most messages TikTok allows, or when you reached your contact limit. Open the campaign and check the outcome of each recipient. See [Campaigns](/campaigns).

## The AI Expert keeps sending the fallback message

- The Expert may be **Paused**. Switch it to **Active**.
- **Only answer from attached knowledge** is on, but no document is **Indexed** yet.
- No document covers the question. Add or improve a document.

Use **Test your Expert** on the Expert page to see the reason. See [Experts](/ai/experts) and [Knowledge Base](/ai/knowledge-base).

## A contact shows as "TikTok contact" with a code

TikTok didn't send the person's name yet. It usually fixes itself the next time they comment or message. See [Contacts → When a contact has no name](/contacts#when-a-contact-has-no-name).

## My teammate can't see the workspace or a page

1. **They accepted the invite.** In **Settings → Members**, they should not be under **Pending Invitations**.
2. **They signed in with the invited email.** A different email has no access.
3. **Their role allows it.** For example, Agents can't open Analytics, and only Admins and Managers can send campaigns. In **Settings → Members**, click **View roles & permissions** to see what each role can do.

## Still stuck

- **Ask Tuku Assistant.** Click the chat button in the bottom-right corner of the app and describe the problem. See [Tuku Assistant](/assistant).
- **Chat with the founder.** Click the green **LINE** bubble above it — **Chat with Tuku Founder for help or enquiry** — or hover over it to scan the QR code.

Tell us your workspace name, the TikTok account, what you expected and what happened. A screenshot helps.