TikTok Messaging
Connect a TikTok Business Account to an Andy Agent so the Agent answers its direct messages, and learn the limits TikTok sets.
Outcome
Connect one TikTok Business Account to an Andy Agent. The Agent answers the account's direct messages, and a person can take over a Conversation from the TikTok app at any time.
TikTok Messaging is a Pro Max Channel. It is not open to every Workspace yet: it becomes available after TikTok approves Andy for its Business Messaging API. It is separate from the TikTok connection used by Posts to publish videos.
Who can connect
TikTok decides which accounts can use direct messages through an outside app such as Andy. Check every point before you start:
- Account type. A TikTok Business Account with Advanced Access, or a Verified Business Account, owned by someone over 18. Andy checks this when you connect and refuses an account that has neither.
- Account region. The account must be registered outside the UK, the European Economic Area (EEA) and Switzerland. TikTok gives no direct-message access to accounts registered there. This is the region the TikTok account was registered in, not your company's address or where you are now. Andy does not offer accounts registered in the US.
- Your role in Andy. You are an Owner or Admin of the Workspace, and the Workspace has Pro Max.
- One account, one Agent. A TikTok account that another Agent already answers cannot be connected. Disconnect it there first.
Before you connect
- In the TikTok app, open the account's privacy settings and set Direct messages to Everyone. Otherwise a new customer's message stays a message request, and Andy only receives it after you accept the request in TikTok.
- Turn off TikTok's own automatic replies (welcome message, suggested questions) if you want only the Agent to answer. Andy ignores TikTok's automatic messages; it does not coordinate with them.
- Give the Agent reviewed Knowledge and instructions for the replies you expect.
- Have a second TikTok account, not connected to Andy, for the test message.
Connect TikTok
- In the Andy App, select the Workspace and the Agent.
- Open Connections → Channels → TikTok Messages.
- Choose Connect TikTok.
- Sign in to TikTok as the Business Account and allow every permission Andy asks for: sending messages, reading messages, managing messages and reading the account type.
- Return to Andy. Andy checks the permissions, the account's eligibility and a real read of its messages. The Channel shows Connected only when all three pass.
From the CLI or MCP, andy channel connect --provider tiktok --agent <agent-id> (MCP: manage_channel, action connect) returns an Andy link. Open it in a browser: Andy signs you in if needed and sends you to TikTok. Read the result with andy channel list.
Verify the message path
- From the second TikTok account, send a short direct message to the connected account.
- In Andy, open Messages for the Agent and confirm that the message appears with the TikTok mark.
- Confirm that the Agent's reply appears in the Conversation.
- In TikTok, confirm that the second account received the reply.
Do not test between two TikTok accounts that are both connected to Andy Agents. Two Agents can answer each other in a loop.
What customers can and cannot reach
- Customers in the UK, the EEA and Switzerland. TikTok does not pass their messages to outside apps. Andy never sees them and cannot answer them. Answer them yourself in the TikTok app.
- Text only. The Agent answers in text. A photo, sticker, video or other message type shows in Andy as a placeholder, and the Agent answers the text it has.
- Comments. The Agent answers direct messages only, not comments.
Reply limits
TikTok limits how many messages a business can send in a Conversation. Andy applies this rule to every TikTok Conversation:
- Each customer message opens a 48-hour window. The Agent sends at most 10 messages in that window. A long reply split into parts counts each part.
- After 48 hours with no new customer message, the Agent sends nothing until the customer writes again.
- When the 10 messages are used, the Agent stops and the Conversation goes to a person (Human Handoff). Answer the customer in the TikTok app, or wait for their next message.
TikTok's own documentation describes these limits in two different ways. Andy follows the stricter one.
Take over and Hand back
- Take over. Answer the customer yourself in the TikTok app or on TikTok's website. Andy sees your reply and stops the Agent in that Conversation. TikTok's automatic messages do not stop the Agent.
- Hand back. In Andy, open the Conversation in Messages and choose Hand back to Andy. The Agent answers the customer's next message. A message that arrived while you had the Conversation is not answered again. Agents and scripts can do the same with
andy conversation handoff hand-back(MCP:manage_handoff, actionhand_back).
You cannot send a TikTok message from inside Andy. People answer in the TikTok app.
The one-year permission
TikTok gives Andy access for one year from the day you connect. Andy renews short-term access by itself during that year, but only a new connection starts another year.
Seven days before the year ends, Andy emails the Agent's owner once. To keep the Agent answering, open Connections → Channels → TikTok Messages and connect again before that date.
If TikTok withdraws access earlier, for example because you removed Andy in TikTok's settings, the Channel shows that it needs attention and Andy emails the Agent's owner. Connect again to resume.
Disconnect
Open Connections → Channels → TikTok Messages, choose More options → Disconnect, or run andy channel disconnect --provider tiktok --agent <agent-id> --yes (MCP: manage_channel, action disconnect).
The Agent stops answering at once. Andy deletes the account's access tokens and withdraws its permission at TikTok. Past Conversations stay in Messages. The account can be connected again, to this Agent or another one.
Troubleshooting
TikTok did not give Andy every permission
Connect again and allow every permission on TikTok's screen.
The account needs Advanced Access or a Verified Business Account
TikTok reported that the account has neither. Upgrade the account in TikTok, then connect again.
TikTok did not let Andy read the account's messages
The most common cause is an account registered in the UK, the EEA or Switzerland. TikTok can show its permission screen to these accounts and still refuse their messages. Andy cannot change this. Connect an account registered in another region.
A customer's message does not appear
Check that Direct messages is set to Everyone in TikTok, that the Channel shows Connected, and that the customer is not in the UK, the EEA or Switzerland.
The Agent stopped answering a Conversation
A person answered in the TikTok app, or the Conversation reached its 10 replies in 48 hours. Open the Conversation in Messages. Choose Hand back to Andy if a person took over, or wait for the customer's next message if the limit was reached.
When contacting Support, keep the request ID and the exact status text. Never send access tokens, passwords, authentication codes or private customer Conversations.