| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 7098 |
| Technical Name |
d_social_tiktok_business |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 7098 |
| Technical Name |
d_social_tiktok_business |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
| Versions | 18.0 19.0 |
TIKTOK BUSINESS SOCIAL FOR ODOO COMMUNITY
Enterprise-Grade Business Analytics & Management
Seamlessly integrate your TikTok Business accounts with Odoo Community Edition. Access advanced analytics, manage comments, publish content, and receive real-time notifications through webhooks.
The Easiest Setup on Odoo Apps Store! No Complex App Generation Needed!
Forget about the nightmare of reviewing developer accounts, creating complex TikTok apps, or handling API keys! This module is powered by our centralized Odoo IAP Proxy, saving you hours of configuration and headache.
Step 1: Get Your License Key
- Purchase the module.
- Send an email to duongodooapps@gmail.com with your Odoo Apps Store Sales Order (SO) number.
- We will reply within 24 hours with your exclusive License Key.
Step 2: Simple Configuration
Go to Settings → Technical → Parameters → System Parameters and set the key duong_platform.license_key to your License Key. That's it â no Developer Portal configuration needed.
Note: The manual custom-app guide further down in the documentation is entirely optional!
Key Features
- Business Authentication: Secure OAuth2 integration with TikTok Business API
- Multiple Accounts: Connect and manage multiple TikTok business accounts
- Advanced Analytics: Comprehensive performance metrics and insights
- Comment Management: Like, reply, and moderate comments directly in Odoo
- Content Publishing: Post videos and photos with customizable settings
- Real-time Webhooks: Instant notifications for post status and comments
- Audience Insights: Demographic data and viewer behavior analytics
- Business Metrics: Track conversions, website clicks, and business KPIs
TikTok Content & Account Synchronization
Automatically sync your TikTok Business posts and account metrics directly into Odoo Community. Keep track of all your TikTok content and performance data in one place.
- Automatic content synchronization from TikTok Business accounts
- Track engagement, trends, and follower growth over time
- Stay informed with the latest metrics from your TikTok Business account
- Access historical data to analyze performance and optimize strategy
Comment Management & Engagement
Manage all your TikTok comments directly from Odoo Community. Like, reply, and moderate comments without ever leaving your Odoo dashboard.
- View all comments on your TikTok posts in real-time
- Respond to comments directly from Odoo interface
- Like comments to engage with your audience
- Manage and moderate inappropriate comments efficiently
- View and manage threaded conversations and replies
Comprehensive Analytics & Insights
Access detailed analytics for each TikTok post and your overall account performance. Make data-driven decisions to optimize your TikTok marketing strategy.
- Track views, likes, comments, shares, and saves for each post
- Analyze audience demographics by country, gender, and behavior
- Monitor average watch time and video completion rates
- See traffic sources (For You Page, Following, Search)
- Track website clicks, profile visits, and conversion actions
- Monitor how each post contributes to follower acquisition
Flexible Content Publishing
Create and publish TikTok content directly from Odoo Community with advanced configuration options for both videos and photos.
- Upload and publish videos with customizable settings
- Share multiple photos with automatic music addition
- Upload custom thumbnails for your videos
- Configure comment permissions and duet/stitch settings
- Set privacy options for your content
- Save posts as drafts before publishing
Real-time Notifications with Webhooks
Receive instant notifications in Odoo when your TikTok content is published or when new comments arrive. Simple one-click webhook configuration.
- Get alerts when your content is successfully published
- Receive notifications for new comments on your posts
- Configure webhooks with a single button click
- Route notifications to specific Odoo users
- Easily enable, disable, or reconfigure webhooks
Documentation
Please go to the documentation tab on the right side to see how to configure the TikTok Business developer app and set it up in Odoo.
SUPPORT EMAIL
Contact me for support at duongodooapps@gmail.com
TikTok Business Social Usage Guide
This guide will help you set up and use the d_social_tiktok_business module in Odoo Community Edition to manage your TikTok Business accounts.
1. Module Overview
The d_social_tiktok_business module integrates TikTok Business API with Odoo Community, allowing you to:
- Connect and manage multiple TikTok Business accounts
- Publish videos and photo carousels directly from Odoo
- Synchronize posts and engagement metrics automatically
- Manage comments, replies, and likes from within Odoo
- Access advanced audience analytics and business KPIs
- Receive real-time comment notifications via webhooks
2. Installation and Configuration
Note
THE EASIEST SETUP ON ODOO APPS STORE!
Forget about the nightmare of creating a developer account, waiting for partner approval, or configuring complex API scopes. This module operates via our centralized Proxy Server (IAP) to save you hours of setup.
How to get started in 2 minutes:
- Purchase the module on the Odoo Apps Store.
- Send an email to duongodooapps@gmail.com containing your Sales Order (SO) number.
- We will reply with your License Key.
- In your Odoo, go to Settings → Technical → Parameters → System Parameters.
- Create (or update) the key duong_platform.license_key and set its value to your License Key.
- Save. Done — you can now connect your TikTok Business account immediately.
Note
TODO (Odoo 20): Add a dedicated License Key field directly in the Settings UI so users no longer need to navigate to System Parameters.
That's it! You can now jump straight to Section 2.5 - Connect TikTok Business Account without doing any of the complex TikTok Developer Portal setup described below.
(The manual App creation guide below is purely optional and only required if you explicitly want to use your own private Custom Developer App instead of our ready-to-use Proxy system.)
2.1. (Optional) Create a TikTok for Business Developer Account
If you decide to use your own private developer app instead of the IAP proxy, you must first register on the TikTok Business API portal.
- Visit the TikTok for Business API portal: https://business-api.tiktok.com/
- Click Become a developer and complete the registration form
- Complete your business profile information
- For detailed instructions, refer to the official documentation: https://business-api.tiktok.com/portal/docs?id=1738855242728450
2.2. (Optional) Register as a Developer
- Log in to your TikTok for Business account
- Visit the TikTok Business API portal: https://business-api.tiktok.com/
- 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
2.3. (Optional) Submit TikTok Partner Application
Note
This step is required to obtain the TikTok Accounts scope needed for full Business API access.
- Go to: https://partners.tiktok.com/sign-up/pc/en?rid=us2viqcqtk
- Fill in your business information to become a TikTok Official Partner
- Note: the application can take up to 10 days to be reviewed by the TikTok team
2.3. (Optional) Create a Developer App
Once your partner application is approved:
- In the TikTok Business API portal, go to My Apps
- Click Create App and fill in the required information:
- App Name: a descriptive name for your integration
- App Description: briefly describe your Odoo integration
- App Type: select Business
- Configure the OAuth redirect URL:
- Set it to: https://{your-odoo-domain}/tiktok_business/authentication
- Replace {your-odoo-domain} with your actual Odoo domain
- Under Scope of permission, enable the following scopes:
- user.info.basic, user.info.username, user.info.profile
- user.info.stats, user.account.type, user.insights
- video.list, video.insights, video.upload, video.publish
- comment.list, comment.list.manage
2.4. (Optional) Configure Custom Credentials in Odoo
If you are using the IAP Proxy with a License Key, skip this step entirely.
If you are using your own custom developer app:
- Install the d_social_tiktok_business module
- Go to Settings → TikTok Business Integration
- Enter your credentials:
- App ID: the Client ID from TikTok Business API portal
- App Secret: the Client Secret from TikTok Business API portal
- Click Save
2.5. Connect TikTok Business Account
Whether you used the IAP Proxy or your own custom app:
- Go to Social Marketing → Configuration → Social Media
- Find TikTok Business and click Link Account
- You will be redirected to TikTok's authorization page
- Log in to your TikTok account if prompted
- Grant the requested permissions
- After successful authorization, you will be redirected back to Odoo
- Your TikTok Business account now appears in Social Accounts
3. Publishing TikTok Content
3.1. Create and Publish a Post
- Go to Social Marketing → Posts
- Click Create to start a new post
- Select your TikTok Business account
- Choose your content type:
- Video Post: upload one video file (MP4 recommended, max 4 GB)
- Photo Post: upload up to 35 images (JPG/WebP format)
Video Post Configuration:
- Caption: write your post caption (max 2200 characters)
- Custom Thumbnail: optionally upload a custom thumbnail (JPG/PNG/WebP, max 20 MB)
- Privacy: Public, Friends, Followers Only, or Private
- Comment / Duet / Stitch: enable or disable each permission
- Brand Content: flag as Brand Organic, Branded Content, or AI-generated
- Upload as Draft: save to TikTok drafts instead of publishing immediately
Photo Post Configuration:
- Title: post title (max 90 characters)
- Caption: description text (max 4000 characters)
- Cover Photo: select which image to use as the cover
- Auto Add Music: automatically add recommended background music
- Privacy: same options as video posts
3.2. Publishing Workflow
- Click Post — Odoo uploads your content to TikTok's servers
- For videos, TikTok processes the file (transcoding and validation)
- A cron job checks the publishing status every 5 minutes
- Once published, the post appears in your TikTok profile and in Odoo Live Posts
- Performance metrics are tracked in the Odoo analytics dashboard
4. Content & Account Synchronization
- Go to Social Marketing → Configuration → Social Accounts
- Click Sync Posts on your TikTok Business account to import all existing videos
- All engagement data (views, likes, comments, shares) is synchronized automatically
- Account-level metrics (follower count, total likes, etc.) are updated via scheduled jobs
5. Comment Management & Engagement
5.1. Viewing and Managing Comments
- Go to Social Marketing → Posts → Live Posts
- Click any post to open its detail view and see the comment feed
- For each comment you can:
- Reply: type a response (max 150 characters) and click Post
- Like / Unlike: click the like button to engage with the commenter
- Delete: remove inappropriate or spam comments
- View Replies: expand threaded reply conversations
5.2. Setting Up Comment Webhooks
Webhooks deliver real-time comment notifications so you never miss an engagement:
- Go to Social Marketing → Configuration → Social Accounts
- Open your TikTok Business account
- In the Webhooks section, click Setup Comment Webhooks
- Optionally select specific Live Posts to monitor, or leave empty to monitor all
- The system automatically registers your webhook URL with TikTok and configures signature verification
- Status changes to Active once successfully configured
Benefits:
- Instant notification when a new comment is posted
- Comment feed in Odoo updates in real-time
- No manual refresh required
6. Analytics & Business Insights
Access comprehensive analytics for each post and your overall account:
Post-level metrics:
- Views, likes, comments, shares, and favorites
- Average watch time and full-video completion rate
- Reach (unique viewers) and new followers acquired
- Profile views from the post
Business conversion metrics:
- Website clicks, phone number clicks, lead submissions
- App download clicks, email clicks, address clicks
Audience demographics:
- Gender breakdown (male / female / other)
- Top 3 countries with percentage share
- New vs returning viewers
- Followers vs non-followers
Traffic sources:
- For You Page, Profile, Following, Search, Other
7. URL Verification (for media hosting)
URL verification is required before TikTok can access videos and images hosted on your Odoo server.
- Go to Social Marketing → Configuration → Social Accounts
- Click on your TikTok Business account
- In the URL Verification section, click Setup URL Verification
- The system automatically generates a verification file and makes it available at the required URL
- Click Check Verification Status to confirm the domain is verified
- Status changes from Pending to Verified on success
8. Troubleshooting
- Authentication Failed
- Verify your App ID and App Secret in Settings → TikTok Business Integration, or ensure your License Key is correctly set under Settings → Technical → Parameters → System Parameters (key: duong_platform.license_key).
- Scope Error
- Ensure all required API scopes are enabled in your TikTok developer app (see Section 2.3).
- Upload Failed
- Check file format and size limits: videos must be MP4/MOV/MKV/WMV/WEBM, max 4 GB; images must be JPG/WebP, max 20 MB per image.
- Callback URL Error
- Verify the OAuth callback URL in your TikTok app exactly matches https://{your-odoo-domain}/tiktok_business/authentication.
- Webhook Errors
- Confirm your Odoo server is publicly accessible from the internet and that the webhook signature is correctly configured.
- URL Verification Failed
- Ensure the verification file is accessible at the URL shown in the account form before clicking Check Verification Status.
- Module Dependencies
- Ensure both d_social and d_mail_chatter_html_link_domain are installed and active.
9. Security Notes
- Keep your API credentials secure and never share them publicly
- Regularly review app permissions in the TikTok Business API portal
- Monitor API usage and rate limits to avoid service interruptions
- Ensure your webhook endpoint is protected with signature verification
- Use HTTPS for all communications
- Regularly update the module to receive security patches
10. Additional Support
- Email: duongodooapps@gmail.com
- Website: https://duong-odoo-apps.odoo.com
- TikTok Business API docs: https://business-api.tiktok.com/portal/docs
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module