$ 52.70
In-App Purchases| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Social Marketing (social)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 1065 |
| Technical Name |
d_social_instagram_video |
| License | OPL-1 |
| Website | https://apps.odoo.com |
| Versions | 17.0 18.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Social Marketing (social)
• Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 1065 |
| Technical Name |
d_social_instagram_video |
| License | OPL-1 |
| Website | https://apps.odoo.com |
| Versions | 17.0 18.0 |
Social Enterprise Instagram Video (Reels/Stories)
Complete Instagram Content Solution for Odoo Social Marketing
The most comprehensive Instagram integration for Odoo! Post videos and photos to Instagram Reels and Stories with professional previews, automatic insights fetching, detailed analytics, and stream integration. Everything you need for modern Instagram marketing in one module.
Key Features
Instagram Reels
- Vertical Video Support: Post short-form vertical videos (3 seconds to 15 minutes, 9:16 ratio recommended)
- Share to Feed Option: Toggle to show Reels in both Feed and Reels tabs (enabled by default)
- Standard Preview: Video player preview before publishing
- Format Validation: Automatic checks for video format (MP4/MOV), size (max 300MB), and aspect ratio
Instagram Stories
- Photo Stories: Post images (.jpeg, max 8MB, 9:16 ratio recommended) with public URL method
- Video Stories: Post short videos (MP4/MOV, 3-60 seconds, max 100MB, 9:16 ratio) with 4-step resumable upload
- Full-Screen Preview: Clean Instagram-style story preview with simple header and reply box
- 24-Hour Content: Temporary content that expires automatically after 24 hours
- Stream Integration: Auto-fetch Stories from your Instagram account with comprehensive insights
- Story Analytics: Track reach, views, shares, replies, profile visits, follows, and navigation behavior via Media Insights API
Stream & Analytics
- Dedicated Stream Type: Separate stream for Instagram Stories with automatic content detection
- Auto-Fetch Insights: Cron job runs every 5 minutes to fetch story insights before 24-hour expiration
- Rich Metrics Display: Detailed analytics displayed in comments modal with grid layout
- Story Performance: Reach, views, shares, replies, profile visits, new followers
- Navigation Tracking: Tap forward/back, swipe forward, tap exit - understand how users interact
- Profile Activity: Track profile actions taken after viewing story
- Smart Handling: Gracefully handles <5 viewers error (Instagram privacy requirement)
Technical Features
- Resumable Uploads: 4-step upload process for videos (create container, upload binary, poll status, publish)
- URL-Based Upload: 3-step process for photos (create container with image_url, auto-download, publish)
- Smart Routing: Automatic selection of upload method based on media type (Reels/Stories, Photo/Video)
- Error Handling: Comprehensive error detection in response body (Partial request errors, format issues)
- Native Integration: Extends Odoo Enterprise social_instagram module with zero conflicts
- Official APIs: Uses Instagram Graph API v24.0+ (Media API, Stories API, Insights API)
- API v22.0+ Compatible: Uses 'views' metric instead of deprecated 'impressions' for newer stories
Instagram Stories: 24-Hour Limitation
â ï¸ CRITICAL: Stories and Insights Expire After 24 Hours
Instagram Stories are temporary content that automatically expires after 24 hours. This is an Instagram platform limitation that affects both story content and insights data.
What This Means:
- Story Content: Disappears from Instagram after 24 hours
- Story Insights: Can ONLY be fetched within 24 hours of publication via API
- After 24 Hours: Both story content and insights become permanently unavailable via API
- Late Discovery: If a story is discovered after 24 hours, insights cannot be retrieved
How This Module Handles It:
- Auto-Fetch: Cron job runs every 5 minutes to fetch new stories and their insights
- Quick Response: Stories are typically fetched within 5 minutes of publication
- Insights Stored: Once fetched, insights are permanently stored in Odoo for reporting
- Minimum Viewers: Stories with less than 5 viewers won't show insights (Instagram privacy policy)
Best Practice: Set up your Instagram Stories stream immediately after installing this module to ensure all new stories are captured and their insights are fetched before the 24-hour window expires.
Important Notes & Requirements
Instagram API Limitations
- 24-Hour Window: Stories content and insights ONLY available for 24 hours (see section above)
- Minimum Viewers: Stories with <5 viewers won't show insights (Instagram privacy requirement)
- Data Delay: Insights data can be delayed up to 48 hours by Instagram API
- No Comments API: Instagram does not support fetching individual story replies via API (only total count available in insights)
- Single Media: Reels and Stories support only one video OR one photo (not both, not multiple)
- No Video Mix: Cannot mix videos with images in the same post
Format Requirements
- Reels: MP4/MOV, 3 seconds to 15 minutes, max 300MB, 9:16 aspect ratio recommended
- Video Stories: MP4/MOV, 3-60 seconds, max 100MB, 9:16 aspect ratio recommended
- Photo Stories: JPEG format, max 8MB, 9:16 aspect ratio recommended
- Aspect Ratio: 9:16 (vertical) recommended for all Reels and Stories to avoid cropping
How to Use
Posting Instagram Reels/Stories
- 1. Go to Social Marketing â New Post
- 2. Select your Instagram Business account
- 3. Upload a video or image
- 4. Select Instagram Media Type:
- Reels: For short-form videos in Reels tab
- Stories: For 24-hour temporary content
- 5. For Reels: Toggle "Share Reel to Feed" (enabled by default)
- 6. Add your caption (up to 2,200 characters)
- 7. Click Post and wait for upload completion
Setting Up Instagram Stories Stream
- 1. Go to Social Marketing â Streams
- 2. Click Add a Stream
- 3. Select your Instagram Business account
- 4. Choose stream type: Instagram Stories
- 5. Stories will be auto-fetched every 5 minutes
- 6. Click on any story to view detailed insights in comment popup
Viewing Story Analytics
- 1. Open your Instagram Stories stream
- 2. Click on any story card to open comment popup
- 3. View detailed analytics in grid layout:
- Story Performance: Reach, Views, Shares, Replies, Profile Visits, Follows
- Story Navigation: Tap Forward, Swipe Forward, Tap Back, Tap Exit
- Profile Activity: Total profile actions after viewing story
- 4. All metrics are automatically fetched by cron job within 24 hours
Screenshots
Support
For support, feature requests, or custom development, please contact us:
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