TikTok Channel

Overview

The TikTok channel connects a TikTok Business account so you can manage your presence from WaDesk — view insights, publish videos and photos, run TikTok Shop, and capture lead-form submissions from TikTok ads straight into your Contacts. It connects with TikTok Login and reuses the same Contacts, and (for ad leads) the same capture pipeline as your other channels.

DM messaging is built — but gated by TikTok. The DM inbox is wired end-to-end in WaDesk (connect, store credentials, region gate, inbound webhook, inbox threading and reply). What WaDesk cannot provide is the access itself: TikTok's direct-message API is a partner-gated Business Messaging program that TikTok approves for select partners only, and it is region-limited (not available in the US, EEA, Switzerland or the UK). Until you hold a TikTok-approved Business Messaging partner app, the DM lane stays off; once you do, you activate it per account — see Enabling the DM inbox. Without that approval, use TikTok as a content, insights, commerce and lead-capture channel.

What It Does Today

Requirements

Platform Admin: TikTok App & Credentials

One-time setup by the platform operator. You'll end with a Client Key and Client Secret to paste into WaDesk.

1. Open TikTok for Developers. Go to developers.tiktok.com, log in, and open Manage apps.
2. Create an app and complete the business details TikTok requires.
3. Add Login Kit and the products you need — Display API (insights), Content Posting API (publish), and TikTok Shop if used.
4. Copy the Client Key & Client Secret from the app's credentials page.
5. Set the redirect URI to WaDesk's TikTok callback URL (shown in WaDesk Admin → Settings → WaDesk Message).
6. Paste the keys into WaDesk. In Admin → Settings → WaDesk Message, fill TikTok Client Key and TikTok Client Secret, and turn the TikTok channel on.

Scopes requested by the Login Kit connect: user.info.basic, user.info.profile, user.info.stats, video.list, video.upload. These cover profile, insights and publishing — not messaging.

User: Connecting Your Account

1. Open the TikTok page in WaDesk (/tiktok/accounts) — it appears in the menu when the channel is enabled.
2. Click Connect — you're sent to TikTok Login (Login Kit OAuth).
3. Authorize the requested permissions for your Business account.
4. Done. Your profile, insights and publishing tools are available; ad lead-forms begin flowing into Contacts.

Using It

• Insights. Review profile and video performance without leaving WaDesk.
• Publish. Create and post (or draft) videos and photos through the Content Posting API.
• TikTok Shop. Connect Shop for commerce data alongside your other stores.
• Ad leads. When someone submits a TikTok lead-gen form, they're captured as a contact you can then reach on WhatsApp, Instagram or SMS.
• Unified social. TikTok posts join the unified social posts & calendar view alongside Instagram and Facebook.

Enabling the DM Inbox

The DM inbox is fully wired in WaDesk — connect, credential storage, region gate, inbound webhook, inbox threading and reply. It only needs TikTok's partner access to switch on. Here is why it's gated and exactly how to activate it once you're approved.

Why it's gated

• TikTok exposes direct messaging only through a Business Messaging program that TikTok must approve for your developer app — it is not a scope you request like insights or publishing.
• Even approved, messaging is region-limited (not in the US, EEA, Switzerland or the UK) and reactive-only: a business may send up to 10 messages in the 48h after a user's first message, then unlimited for 48h after each user reply.

Turning it on

1. Get Messaging-Partner approval. Apply to TikTok's Messaging Partner program and create a TikTok API for Business app (business-api.tiktok.com) — separate from the Login Kit app — to obtain its Client Key (app_id) and Client Secret.
2. Admin: set the business app. In Admin → Settings → WaDesk Message, fill tiktok_business_app_id and tiktok_business_app_secret and turn on tiktok_inbox_enabled.
3. Admin: register the webhook. On your TikTok app in the developer portal, set the webhook callback to https://your-domain/webhooks/tiktok/business and subscribe the new_message and new_conversation events. (TikTok has no per-account subscribe API — the webhook is configured on the app, once.)
4. Operator: connect the account. On the TikTok account card, a DM inbox section now appears — paste the Business ID and access token from your partner authorization and click Connect DM inbox. WaDesk stores them and detects the account region.
5. Done. If the region is supported, incoming DMs arrive in the Team Inbox and agents reply from the same composer. Auto-reply rules and flows can then be scoped to TikTok.

Under the hood: WaDesk calls TikTok's Business Messaging v1.3 endpoints — /business/message/conversation/list/, /business/message/content/list/ and /business/message/send/ — with the access token in the Access-Token header. Every call fails soft, so an un-approved account never breaks the page: it simply reports the DM lane as not enabled.

Troubleshooting