1.1. Create a TikTok for Business Account

• Visit the TikTok for Business https://business-api.tiktok.com/ website
• Click Register for TikTok for Business and follow the registration process
• Complete your business profile information
• For detailed instructions, refer to the official documentation https://business-api.tiktok.com/portal/docs?id=1738855242728450

1.2. Register as a Developer

• Log in to your TikTok for Business account
• Visit the TikTok Business API https://business-api.tiktok.com/ portal
• Click Become a developer and complete the registration form
• For detailed instructions, refer to the developer registration guide https://business-api.tiktok.com/portal/docs?id=1738855176671234

1.3. Create a Developer App

• In the TikTok Business API portal, go to "My Apps"
• Click "Create App" to create a new application

• Fill in the required app information:

  • App Name: Choose a descriptive name for your integration
  • App Description: Briefly describe your integration with Odoo
  • App Icon: Upload your app icon (optional)
  • App Type: Select "Business"

• Configure the TikTok account holder authorization URL:

  • Set the URL to: https://{your-odoo-instance}/tiktok_business/authentication
  • Replace {your-odoo-instance} with your actual Odoo domain

• Under Scope of permission, make sure to select "TikTok Accounts"
• For detailed instructions, refer to the app creation guide <https://business-api.tiktok.com/portal/docs?id=1738855242728450

2.1. Install Module

• Go to Apps in your Odoo instance
• Search for "d_ee_social_tiktok_business"
• Click Install
• Note: This module requires Odoo Enterprise Edition

2.2. Configure TikTok Business Credentials

• Obtain Client ID and Client Secret from your TikTok Business API Developer account
• Go to Settings → Social Media
• Scroll to the "TikTok Business Integration" section

• Enter your TikTok app credentials:

  • Client ID
  • Client Secret

• Click Save

3.1. Connecting TikTok Business Account (Add a Tiktok Stream)

• Go to Social Marketing → Feed → Add a stream
• Click "Tiktok Business" button at the top
• A popup window will appear asking you to authorize Odoo to access your TikTok account
• Log in to your TikTok account if prompted
• Grant the requested permissions
• After successful authorization, you'll be redirected back to Odoo
• Your TikTok Business account is now connected and appears in the list of social accounts

3.2. Managing TikTok Comments, Replies, and Likes

• Go to Social Marketing → Feed → Streams
• You'll see a stream for your TikTok Business account automatically created
• Click on any post view your TikTok posts and their comments
• For each comment, you have several actions available:

Viewing Comments:

• Comments appear chronologically under each post
• You can see the commenter's name, profile picture, comment text, and timestamp
• The number of likes on each comment is displayed

Liking Comments:

• Click the "Like" button (heart icon) next to any comment to like it
• The heart icon turns solid to indicate you've liked the comment
• Click again to unlike the comment

Replying to Comments:

• Click the "Reply" button under any comment
• A text box appears where you can type your response
• Click "Post" to publish your reply
• Your reply will appear nested under the original comment

Deleting Comments:

• Click the "Delete" button (trash icon) to remove inappropriate comments
• A confirmation dialog appears
• Click "Confirm" to permanently delete the comment

Comment Moderation:

• Comments with potential policy violations are flagged automatically
• You can review these comments and decide whether to keep or delete them

3.3. Setting Up URL Verification

URL verification is essential for TikTok to access videos and images hosted on your server. This process creates a verification file that TikTok can access to verify your domain ownership.

• Go to Social Marketing → Configuration → Social Accounts
• Click on your TikTok Business account
• In the account form, you'll see a "URL Verification" section
• Click the "Setup URL Verification" button

• The system will automatically:

  1. Generate a verification filename (e.g., tiktok-business-abc123.txt)
  2. Create a verification file with the required signature content
  3. Make this file accessible at a specific URL on your server

• After setup, click "Check Verification Status" to confirm the verification is complete
• When successful, the status will change from "Pending" to "Verified"

How URL Verification Works:

• TikTok needs to verify that you own the domain you're using for content hosting
• The verification file serves as proof of domain ownership
• Once verified, TikTok can access media files (videos and images) from your server
• This is required for features like photo posting and video thumbnails

3.4. Setting Up Video Webhooks (Optional)

Video webhooks provide real-time notifications about the status of your video posts. This is optional because there is a schedule action run each 5 minutes to check the status of your video posts.

• Go to Social Media → Configuration → Social Accounts
• Click on your TikTok Business account
• In the account form, find the "Webhooks" section
• Click the "Setup Video Webhooks" button

• The system will automatically:

  1. Register your webhook URL with TikTok
  2. Configure the webhook signature for security
  3. Set up event subscriptions for video publishing events

• The status will change to "Active" when successfully configured

Benefits of Video Webhooks:

• Receive instant notifications when videos are successfully published
• Get alerts if video publishing fails, with error details
• Track when videos become publicly available
• Update post status in Odoo automatically without manual checking

3.5. Setting Up Comment Webhooks

Comment webhooks provide real-time notifications when new comments are posted on your TikTok videos.

• Go to Social Marketing → Configuration → Social Accounts
• Click on your TikTok Business account
• In the account form, find the "Webhooks" section
• Click the "Setup Comment Webhooks" button
• Optionally, select specific posts to monitor for comments or leave it blank to monitor all posts

• The system will automatically:

  1. Register your webhook URL with TikTok
  2. Configure the webhook signature for security
  3. Set up event subscriptions for comment events

• The status will change to "Active" when successfully configured

Benefits of Comment Webhooks:

• Receive instant notifications when new comments are posted
• Update comment streams in Odoo in real-time
• Respond to comments more quickly
• No need to manually refresh to see new comments

3.6. Posting TikTok Videos and Photos

You can create and publish TikTok content directly from Odoo.

• Go to Social Marketing → Posts
• Click "Create" to start a new post
• Select your TikTok Business account

• Choose your content type:

  • Video Post: Upload a video file
  • Photo Post: Upload one or more images

Video Post Configuration:

• Upload Video: Click "Add file" to upload your video (MP4 format recommended)
• Add Caption: Write your post caption/description
• Custom Thumbnail: Optionally upload a custom thumbnail image
• Privacy Settings: Choose who can view your video (Public, Friends, Private)
• Comment Settings: Enable or disable comments on your video
• Duet/Stitch Settings: Allow or prevent others from using Duet/Stitch features

• Brand Content Settings:

  • Brand Organic Content: Label as promoting your own business
  • Branded Content: Label as paid partnership with another brand
  • AI Generated: Label as AI-generated content

• Upload Options:

  • Direct Post: Publish immediately after processing
  • Upload as Draft: Save to TikTok drafts for later editing

Photo Post Configuration:

• Upload Photos: Add up to 35 images
• Add Caption: Write your post caption/description
• Cover Photo: Select which image to use as the cover
• Auto Add Music: Automatically add recommended music to your photo post
• Privacy Settings: Choose who can view your photos

How TikTok Posting Works:

1. When you click "Post", Odoo uploads your content to TikTok's servers
2. For videos, TikTok processes the video (transcoding, validation)
3. If webhooks are enabled, you'll receive status updates automatically
4. Once published, the post appears in your TikTok profile and in Odoo streams
5. You can track performance metrics in the Odoo analytics dashboard

Common Issues:

• Authentication Failed: Verify your Client Key and Secret
• Scope Error: Ensure all required scopes are enabled
• Upload Failed: Check file format and size limits
• Callback URL Error: Verify the OAuth callback URL matches your Odoo domain
• Webhook Errors: Check your server is accessible from the internet and the webhook signature is correctly configured
• Comment Management Issues: Verify you have the comment.list and comment.post scopes
• URL Verification Failed: Make sure the verification file is accessible at the correct URL

For additional support: * Email: messiduong2709@gmail.com * Check TikTok's Business API Documentation