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 — one or more tags.
• Has qualified — only contacts with at least one qualified lead.
• Last seen — recently active contacts.

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.

Contact profile

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

• Profile header with the TikTok handle, follower state, and a View on TikTok link.
• Attribution — where this contact came from, including the Source post that first brought them in. The source post is a link straight to that post's page in Tuku (not an opaque internal ID).
• Tags — add or remove inline. Hover a tag to see its provenance — who added it (the bot or a teammate) and when.
• Flow Responses — values the bot captured during flows (e.g. shade: Fair, address: …), with friendly field names. Editable by your team. (This section was previously called Captured Answers.)
• Notes and Custom fields — free-form context your team adds by hand.
• 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

The profile leads with a unified Activity timeline — sourcing, every conversation, the flow lifecycle (started, advanced, ended), and label and custom-field changes, all in time order with who did what. It's the fastest way for a teammate jumping into a conversation cold to get the full context.

Unsaved changes

If you edit tags or fields and try to navigate away (or close the tab) before saving, Tuku warns you so you don't lose the change.

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 a contact

You can edit a contact's fields and tags directly from their profile — add or remove tags, fix a captured field, or rename the contact to a friendlier label.