App Logo
tiktok.com

Send a TikTok direct message

Send a direct message to a TikTok user by @username, as the signed-in account. The message reaches a real person the moment this runs, so show the exact recipient and text to the person asking and get their confirmation first. An existing conversation is reused, otherwise one is started from the person's profile, and the thread's own header is checked against the handle you asked for before anything is typed, so a message cannot land in the wrong conversation. If the newest message in the thread is already the same text from your account, nothing is sent again. Delivery is then confirmed by re-opening the thread fresh, because a message TikTok will not deliver still shows up in the thread at first: messages refused by TikTok's content moderation, or by the recipient's privacy settings, are reported as not sent, with TikTok's own explanation, rather than counted as delivered.

Input

text required

Message text. Sent as one message, exactly as given.

username required

Handle of the person to message, with or without a leading @.

Output

sent required

True when this run delivered the message.

text required
username required

Handle the message was addressed to, as the thread header reports it.

already_sent required

True when the newest message in the thread was already this exact text from your account, so nothing was sent again.

verified_in_thread required

True when the message was still in the thread after a fresh page load, which is the only evidence TikTok really accepted it. A message that does not survive was refused, and that is reported as an error rather than as a send.

userId optional
nickname optional
account_used optional

Handle the message was sent from, read from the signed-in session rather than assumed.

conversationId optional

Thread the message went to; pass it to the get-conversation script to read the thread.

new_conversation optional

True when no conversation with that account existed and one was started.

Start building not clicking