Skip to main content
Connect your TikTok Business account to Chatwoot to manage TikTok Direct Messages from your unified inbox.

​
Prerequisites

  • TikTok Business account
  • TikTok Developer account
  • OAuth credentials from TikTok for Developers

​
Setup

1

Create TikTok Business account

  1. Go to TikTok for Business
  2. Create a business account
  3. Complete business verification
2

Set up TikTok Developer App

  1. Visit TikTok for Developers
  2. Create a new app
  3. Enable the Messaging API product
  4. Configure OAuth redirect URLs
3

Get OAuth credentials

From your TikTok Developer app settings, copy:
  • Client Key (App ID)
  • Client Secret
4

Add TikTok inbox in Chatwoot

Navigate to Settings → Inboxes → Add Inbox → TikTok
5

Authorize TikTok

Click Sign in with TikTok and authorize Chatwoot to access your TikTok Business account.Required permissions:
  • user.info.basic - Basic profile information
  • user.info.profile - Profile details
  • user.info.stats - Account statistics
  • video.list - Video list access
6

Configure and test

  • Select your TikTok Business account
  • Add agents to the inbox
  • Send a test DM to your TikTok account
  • Verify it appears in Chatwoot

​
Features

  • Direct messages - Receive and reply to TikTok DMs
  • OAuth authentication - Secure token-based authentication
  • Automatic token refresh - Tokens refresh automatically before expiry
  • Rich media - Send images and videos
  • Business account integration - Connect verified business accounts

​
OAuth Token Management

TikTok uses OAuth 2.0 with token expiration:
​
access_token
string
required
OAuth access token for API authentication (encrypted at rest)
​
refresh_token
string
required
Token used to refresh access token when expired (encrypted at rest)
​
expires_at
datetime
required
Access token expiration timestamp
​
refresh_token_expires_at
datetime
required
Refresh token expiration timestamp
​
business_id
string
required
Unique TikTok Business account identifier

​
Token Refresh

Chatwoot automatically refreshes access tokens before they expire. The Tiktok::TokenService handles:
  • Checking token expiration
  • Refreshing tokens using refresh token
  • Updating token values in database
  • Handling authorization errors

​
Best Practices

Respond quickly to maintain engagement with users
Use automation rules for initial responses
Monitor token expiration and reauthorize if needed
Keep business account information up to date
Set up CSAT surveys to gather feedback

​
Troubleshooting

  • Verify it’s a TikTok Business account (not personal)
  • Ensure business verification is complete
  • Check OAuth credentials are correct
  • Verify redirect URLs match in TikTok Developer settings
  • Clear browser cache and try again
  • Reconnect TikTok account in Chatwoot
  • Check access token hasn’t expired
  • Verify TikTok Developer app status is active
  • Ensure Messaging API product is enabled
  • Check Chatwoot logs for authorization errors
  • Access tokens expire periodically
  • Chatwoot shows reauthorization alert
  • Click reauthorize in inbox settings
  • Complete OAuth flow again
  • Tokens will be refreshed automatically
  • Check if user has messaged you first (TikTok requires this)
  • Verify access token is valid
  • Ensure business account is not restricted
  • Check message content complies with TikTok policies

​
Limitations

  • TikTok requires users to message you first before you can initiate conversation
  • Access tokens expire and require refresh
  • Business account verification required
  • Some TikTok features may not be available through API
  • Message types and media formats have restrictions

Build docs developers (and LLMs) love

Get started for freeTalk to us