Contacts

A contact is one TikTok user that has appeared in your workspace — usually because they commented on a post or the bot DM'd them. The Contacts page is the master list.

Open it from the sidebar under Manage → Contacts.

What you see

Each contact row shows:

• Profile photo and TikTok handle.
• Tags the bot or your team added (vip, shade-fair, refund-pending).
• Last seen — the most recent DM or comment.
• Conversations — how many DM conversations you've had with them.
• Qualified leads — how many qualifying conversations trace back to this contact.

Click into any contact to open their profile, which has every conversation, every tag, in one timeline.

Searching and filtering

The top bar searches by:

• TikTok handle.
• Display name (when TikTok provides it).
• TikTok user ID (when you know it).

The filter chips let you narrow by:

• Tag — single or multiple tags, AND or OR.
• Has qualified — only contacts with at least one qualified lead.
• Last seen — within the last 7, 30, or 90 days.
• Source — bot-initiated, human-initiated, or imported.

Save a filter combination as a view and pin it to the sidebar — common ones are VIP buyers, Returned to flow this week, Refund pending.

Tags

Tags are how you segment contacts beyond what TikTok tells you. They come from three places:

1. The bot. Flow nodes can apply tags automatically (e.g. shade-fair, lead-emailed).
2. Your team. Anyone on the team can add or remove tags from a conversation or contact.
3. System tags. Tuku adds a few automatically (new, re-engaged, bounced).

A clean tag taxonomy makes everything downstream — analytics, segments, future re-engagement campaigns — easier.

Tag naming conventions that hold up

• Lowercase, hyphenated. shade-fair, not Shade Fair.
• Prefix by purpose when you have many. intent-price, intent-shade, status-refund.
• Avoid free-text tags from buyer messages. Capture those in a field instead, not a tag.

You can rename a tag across all contacts from Settings → Tags → Edit.

Contact profile

Click a contact's row to open their profile. You'll see:

• Profile header with the TikTok handle and a View on TikTok link.
• Tags — add or remove inline.
• Fields — values the bot captured during flows (e.g. shade: Fair, address: …). Editable by your team.
• Conversations — every DM thread you've had, with a state chip (Bot, Human, Closed) and the trigger that started each.
• Leads — every qualifying conversation attributed to this contact.
• Activity timeline — comments, DMs, flow runs, tag changes, all in time order.

Useful when a teammate jumps into a conversation cold and needs the full context.

When a contact's name looks like a long random string

You may sometimes see a contact whose name is a long random-looking string instead of a normal handle like seechina.io:

+ZMU943vQO8efuOieTEUr27OOFQuLn6xaMy1OX3XVII5MBKao2xoJ9pLJVC9kOJQ

Nothing is broken. The contact is real, the automation worked, and any DMs you send will reach the right person. Only the displayed name is the fallback.

Why it happens

When someone comments on your post, TikTok tells us about the comment using a private internal ID — never the public handle. We then make a second call to TikTok to ask "who posted this?" and use whatever handle comes back. Occasionally that second call comes back without a handle, usually because:

• The comment was only a second or two old and TikTok hadn't fully processed it.
• The commenter's account is brand-new or has unusual privacy settings.
• TikTok briefly returned an incomplete response.

When that happens, the contact name falls back to the internal ID.

Will it fix itself?

Yes, in most cases. The next time that person interacts with you, we get another chance to fetch the handle and the contact updates automatically — whether they comment again, send a DM, or the bot starts a DM with them.

If they never engage again, the long ID sticks around. That's harmless — the contact is still valid, you can still tag it, and it still counts as 1 MAC.

What to do

• Leave it alone if the contact is inactive — it doesn't affect anything downstream.
• Wait if you expect them to comment or DM again — the name will update on its own.
• Rename the contact manually from the profile if you want a friendlier label in the meantime. (This only changes what you see in Tuku; it doesn't change their TikTok handle.)

Only worth contacting support if you see this on every new contact, or the same person has clearly engaged again and the name still hasn't updated after a week.

Editing and merging

You can edit a contact's fields and tags directly. You can also:

• Merge two contacts — when TikTok reports the same buyer under two handles. Contact → ⋯ → Merge. Both timelines combine; tags union; the older contact ID survives.
• Block a contact — the bot will never DM them again, even if a trigger matches. Use for spammers and trolls.

Merging is permanent — there is no unmerge. Double-check before confirming.

Exporting contacts

Contacts → ⋯ → Export CSV dumps:

• TikTok handle, display name, user ID.
• Every tag.
• Every captured field.
• Last seen, source, conversation count, qualified lead count.

Common uses: importing into an email tool, building a lookalike audience for ads, sharing with a partner agency.

Deleting a contact

Contact → ⋯ → Delete removes the contact, their conversations, and their captured fields from your workspace.

• Qualified leads stay in your analytics (just without the contact link).
• This is irreversible — there's a 24-hour soft-delete window in case you change your mind.

If a contact asks for their data to be deleted (GDPR / PDPA), this is the action that does it.