| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 6344 |
| Technical Name |
d_social_tiktok_business |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 6344 |
| Technical Name |
d_social_tiktok_business |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
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.
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 documentation tab in the right side to see how to configure tiktok developer app and in odoo as well
Support
For support, feature requests, or custom development, please contact us:
TikTok Business Integration Setup Guide (Community Edition)
This guide will walk you through the process of setting up TikTok Business integration with your Odoo Community Edition instance using the d_social_tiktok_business module.
1. Setup TikTok Business API Developer Account
Before you can integrate TikTok Business with Odoo, you need to set up a TikTok Business API Developer account.
1.1. Create a TikTok for Business Account
- Visit the TikTok for Business https://business-api.tiktok.com/ website
- Click Become a developer 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. Configure Odoo Community Module
2.1. Install Module
- Go to Apps in your Odoo Community instance
- Search for "d_social_tiktok_business"
- Click Install
- Note: This module is designed for Odoo Community Edition and requires the d_social module
2.2. Configure TikTok Business Credentials
- Obtain Client ID and Client Secret from your TikTok Business API Developer account
- Go to Settings → General Settings
- Scroll to the "TikTok Business Integration" section
- Enter your TikTok app credentials:
- TikTok Business Client ID
- TikTok Business Client Secret
- Click Save
3. Using TikTok Business in Odoo Community
3.1. Connecting TikTok Business Account
- Go to Social Marketing → Configuration → Social Media
- Find "TikTok Business" and click "Link Account"
- 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 Social Accounts
3.2. Managing TikTok Comments, Replies, and Likes
- Go to Social Marketing → Posts → Live Posts
- You'll see your TikTok Business posts automatically synchronized
- Click on any post to view comments and engagement
- 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
- 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
- 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:
- Generate a verification filename (e.g., tiktok-business-abc123.txt)
- Create a verification file with the required signature content
- 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 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:
- Register your webhook URL with TikTok
- Configure the webhook signature for security
- 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.5. Posting TikTok Videos and Photos
You can create and publish TikTok content directly from Odoo Community.
- 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:
- When you click "Post", Odoo uploads your content to TikTok's servers
- For videos, TikTok processes the video (transcoding, validation)
- A cron job checks the posting status every 5 minutes
- Once published, the post appears in your TikTok profile and in Odoo live posts
- You can track performance metrics in the Odoo analytics dashboard
4. Community Edition Specific Features
4.1. Integration with d_social Framework
This module is built specifically for Odoo Community Edition and integrates seamlessly with the d_social framework:
- Unified Interface: All social media management in one place
- Consistent Experience: Same UI patterns as other social media modules
- Extensible: Easy to extend with custom features
- Community Support: Built by and for the Community Edition users
4.2. Advanced Analytics Dashboard
Access comprehensive analytics for your TikTok Business performance:
- Post Performance: Views, likes, comments, shares, and favorites
- Audience Demographics: Gender, age, and geographic distribution
- Traffic Sources: For You Page, Profile, Following, Search, and Other
- Business Metrics: Website clicks, phone clicks, lead submissions
- Growth Tracking: New followers, profile views, and engagement trends
5. Troubleshooting
Common Issues:
- Authentication Failed: Verify your Client ID and Secret in Settings
- Scope Error: Ensure all required scopes are enabled in your TikTok app
- Upload Failed: Check file format and size limits (videos: MP4, max 4GB; images: JPG/PNG, max 20MB)
- 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
- Module Dependencies:
- Ensure d_social module is installed and configured
- Check that d_mail_chatter_html_link_domain is installed for proper notification links
For additional support: * Email: duongodooapps@gmail.com * Website: https://duong-odoo-apps.odoo.com * Check TikTok's Business API Documentation https://developers.tiktok.com/doc/business-api-overview
6. Security Notes
- Keep your API credentials secure and never share them publicly
- Regularly review app permissions in your TikTok Developer account
- Monitor API usage and rate limits to avoid service interruptions
- Follow TikTok's terms of service and content guidelines
- Ensure your webhooks endpoint is properly secured with signature verification
- Use HTTPS for all API communications
- Regularly update the module to get security patches
7. Performance Optimization
- Cron Jobs: The module includes automated cron jobs for checking post status
- Webhook Integration: Use webhooks for real-time updates instead of frequent polling
- Batch Operations: The module efficiently handles multiple posts and comments
- Caching: API responses are cached where appropriate to reduce API calls
8. Additional Resources
- TikTok Business API Documentation: https://business-api.tiktok.com/portal/docs
- Odoo Community Documentation: https://www.odoo.com/documentation/18.0/
- d_social Framework: https://github.com/your-repo/d_social
- Community Support Forum: https://duong-odoo-apps.odoo.com/forum
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