Social Instagram (Community)
Integrate Your Odoo with Instagram
Connect your Odoo Community Edition to Instagram Business and Creator accounts using the Instagram Graph API. Manage your content, comments, and insights from Odoo without logging into Instagram.
With Social Instagram, you can publish posts, track engagement, analyze performance, and handle comments in one unified platform.
Content Publishing
Publish and manage Instagram content directly from Odoo:
- Create image posts with captions
- Publish video posts as Reels
- Create carousel posts with multiple images
- Add alt text for accessibility
- Support for collaborators and user tags
- Draft mode support for internal review
Marketing teams can plan and execute Instagram campaigns without leaving Odoo.
Comment & Interaction Management
Moderate and respond to Instagram comments from Odoo:
- Real-time synchronization of comments from Instagram
- Reply to comments directly from Odoo
- Hide, unhide, or delete comments
- Private reply support for sensitive conversations
- Nested comment threading for complex discussions
This allows you to centralize customer engagement and keep all interactions recorded in Odoo.
Analytics & Insights
Track the performance of your Instagram profile and content:
- Post reach, impressions, and engagement rates
- Likes, comments, saves, and shares
- Profile views and follower growth
- Story insights such as reach, impressions, and replies
- Audience demographics and peak activity times
Use these insights to optimize your content strategy and grow your Instagram presence.
Automatic Synchronization
Keep Odoo and Instagram in sync at all times:
- Automatic synchronization of media and metadata
- Regular cron jobs for insights and engagement updates
- Error handling and retries for failed requests
- Manual synchronization buttons for specific posts
You always have the latest Instagram data available in your Odoo database.
Documentation
Please go to the Documentation tab on the right side of this page to see how to configure the Instagram developer app and the Odoo integration.
Support Email
Contact us for support at duongodooapps@gmail.com
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 5695 |
| Technical Name |
d_social_instagram |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
Instagram Connector Setup Guide
This guide explains how to connect Instagram Business or Creator accounts to Odoo using the d_social_instagram module and Meta's current Use Cases interface.
The Instagram connector can reuse the same Meta App, App ID, and App Secret as the Facebook Pages connector. When the same Meta App is used for both platforms, add both use cases and both OAuth callback URLs to that app.
Important
The Instagram API with Facebook Login supports Instagram Professional accounts only. The Instagram account must be a Business or Creator account connected to a Facebook Page.
1. Create or Select a Meta App
- Go to Meta for Developers https://developers.facebook.com/.
- Register as a Meta Developer if necessary.
- Open My Apps.
- Create a new app or select the Meta App already used by the Facebook Pages connector.
- Complete the app name and contact information requested by Meta.
For the latest app-creation instructions, refer to Meta's official Create an App documentation https://developers.facebook.com/documentation/development/create-an-app.
Older guides may instruct you to create a fixed Business App and manually add products from a Products page. Do not follow that obsolete flow. In the current Meta Developer interface, select integrations from Use cases.
Note
If d_social_facebook is already configured, you may reuse the same Meta App. You do not need a separate Meta App for Instagram.
2. Select the Required Use Cases
In the Meta App Dashboard, open Use cases.
Select the use case that matches the Odoo modules you have installed. If the same Meta App is used for both Facebook and Instagram integrations, select both use cases.
2.1 Instagram
For the following modules, select Manage messaging & content on Instagram:
- d_social_instagram
- d_social_instagram_messenger
- d_ee_social_instagram_messenger
This use case provides access to Instagram publishing, comments, insights, and messaging features, depending on the permissions added to the app.
Note
The Instagram account must be a Business or Creator account connected to a Facebook Page when using Instagram API with Facebook Login.
2.2 Facebook Pages (Optional)
If the same Meta App is also used for the following modules, select Manage everything on your Page:
- d_social_facebook
- d_social_facebook_messenger
- d_ee_social_facebook_messenger
This use case allows the shared Meta App to publish Facebook Page content, read engagement, manage comments, retrieve Page insights, and support the Facebook Messenger integration when the required messaging permissions are also added.
3. Add and Review Instagram Permissions
After selecting the Instagram use case, open:
Use cases > Instagram API > API setup with Facebook login
3.1 Add Content Permissions
For d_social_instagram, click Add required content permissions.
The base Instagram connector uses these permissions:
- instagram_basic
- instagram_content_publish
- instagram_manage_comments
- instagram_manage_insights
- pages_show_list
- pages_read_engagement
Meta may also add business_management when it is required by the selected use case or business asset configuration.
3.2 Add Messaging Permissions (Optional)
This step is required only when one of the following modules is installed:
- d_social_instagram_messenger
- d_ee_social_instagram_messenger
Under Send messages on Instagram, click Add required messaging permissions.
The Instagram Messenger integration additionally uses:
- instagram_manage_messages
- pages_manage_metadata
- business_management
3.3 Review Permissions and Features
Open Instagram API > Permissions and features.
Search for each permission required by the installed Odoo modules.
For Instagram analytics, verify that instagram_manage_insights has been added.
For Instagram Messenger, verify that instagram_manage_messages shows Ready for testing.
Important
Ready for testing means that the permission can be tested by Meta App Administrators, Developers, and Testers.
Add to App Review adds the permission to the app's review configuration. It does not submit the complete review request by itself.
Do not request unrelated permissions. Every permission submitted to Meta must be connected to a real feature that can be demonstrated in Odoo.
4. Configure OAuth Callback URLs
In the Meta App Dashboard, expand Facebook Login for Business.
Open Settings.
Ensure that Client OAuth Login and Web OAuth Login are enabled.
In Valid OAuth Redirect URIs, add the Instagram callback URL:
https://your-odoo-domain.com/social_instagram/authentication
If the same Meta App is also used by the Facebook Pages connector, add the Facebook callback URL as a separate entry:
https://your-odoo-domain.com/social_facebook/authentication
Save the configuration.
The callback URL must exactly match the public Odoo URL, including the https protocol, domain, subdomain, path, and trailing-slash behavior.
Warning
The example screenshot may contain temporary development domains. Always configure the final public HTTPS domain before production release.
5. Get the App ID and App Secret
- Open App settings > Basic.
- Complete the information required by Meta, including:
- App name
- Contact email
- App domains
- Privacy Policy URL
- Terms of Service URL, when applicable
- User data deletion instructions or callback URL
- App icon
- Business Portfolio
- App category
- Copy the App ID and App Secret.
When the same Meta App is used for Facebook and Instagram, enter the same App ID and App Secret in both Odoo integration settings.
Warning
Keep the App Secret confidential. Never expose it in screenshots, source code, public documentation, or support messages.
6. Prepare the Instagram Account
- Make sure that the Instagram account is a Business or Creator account.
- Connect the Instagram account to a Facebook Page.
- Confirm that the Facebook user used during authorization has sufficient access to both the Facebook Page and the Instagram account.
- When testing an unpublished Meta App, add the Facebook user as an Administrator, Developer, or Tester under App roles.
The Instagram API with Facebook Login cannot connect a personal Instagram consumer account.
See Instagram Help https://help.instagram.com/502981923235522 for information about switching to a Professional account.
7. Test Before Production Review
While the Meta App is unpublished, or while permissions only have testing access:
- Use Facebook users assigned as an Administrator, Developer, or Tester.
- Confirm that the required permissions show Ready for testing.
- Test account linking from Odoo.
- Test Instagram publishing.
- Test comment synchronization and moderation.
- Test insights.
- When an Instagram Messenger module is installed, test receiving and replying to Instagram Direct messages.
Testing access is intended for app-role users. It is not sufficient when customers or other businesses need to connect their own Instagram accounts.
8. Verification, App Review, and Production Release
App Review is required when Facebook users who are not assigned a role in the Meta App need to connect their own Instagram Professional accounts or business assets to Odoo.
App Review allows the app to use the permissions approved by Meta for production users. It does not automatically provide undocumented profile data or additional fields. The data returned still depends on the API endpoint, granted permissions, access token, asset ownership, privacy rules, and Meta Platform Terms.
8.1 Complete Verification
Open Review > Verification.
Depending on the requested permissions and how the app is distributed, Meta may require:
- Business verification — confirms the legal business that owns the app.
- Access verification — may be required when the app operates as a technology provider and accesses Meta business assets belonging to other businesses.
Complete every verification requirement displayed in your Meta App Dashboard before submitting the production review.
For additional information, see Meta's Business Verification documentation https://developers.facebook.com/documentation/development/release/business-verification.
8.2 Prepare the App Review Request
- Open Review > App Review.
- Confirm that only the permissions required by the installed Odoo modules are included.
- Remove unrelated permissions.
- Click Next.
- Explain why Odoo needs each permission.
- Provide a screen recording demonstrating the complete feature.
- Provide reviewer access instructions and test credentials when requested.
- Complete the data handling and compliance questions.
- Submit the review request.
Examples of features to demonstrate:
- instagram_basic — link an Instagram Professional account and display its basic account information in Odoo.
- instagram_content_publish — create and publish an Instagram post from Odoo.
- instagram_manage_comments — synchronize, reply to, hide, unhide, or delete an Instagram comment from Odoo where supported.
- instagram_manage_insights — display Instagram account or media analytics in Odoo.
- pages_show_list and pages_read_engagement — retrieve the Facebook Page connected to the Instagram Professional account during authorization.
- instagram_manage_messages — receive an Instagram Direct message and reply from Odoo.
- pages_manage_metadata — configure or maintain the Page subscription required by the Instagram messaging webhook.
Each permission must be demonstrated through the exact Odoo feature that requires it.
For the latest process, refer to Meta's App Review documentation https://developers.facebook.com/documentation/resp-plat-initiatives/individual-processes/app-review and App Review Submission Guide https://developers.facebook.com/documentation/resp-plat-initiatives/individual-processes/app-review/submission-guide.
8.3 Publish the Meta App
After the required permissions are approved:
- Open Publish.
- Resolve any remaining required actions.
- Publish the Meta App.
Production access and publication allow customers who are not Meta App Administrators, Developers, or Testers to authorize the integration, subject to the permissions and assets approved by Meta.
9. Configure Instagram in Odoo
- Log in to Odoo as an administrator.
- Go to Settings.
- Find the Instagram Integration or Social Marketing section.
- Enter:
- OAuth Client ID: the Meta App ID
- OAuth Client Secret: the Meta App Secret
- Save the settings.
- Confirm that the Instagram callback URL displayed by Odoo matches the OAuth redirect URI configured in Meta.
If the Facebook Pages connector uses the same Meta App, the same App ID and App Secret can be entered in both Odoo configuration sections.
10. Link the Instagram Account
- Go to Social Marketing > Social Media.
- Open the Instagram media record.
- Click Link Account.
- Odoo redirects you to Facebook Login for Business.
- Log in with the Facebook user who manages the connected Facebook Page.
- Accept the requested permissions.
- Select the required business assets and Facebook Page when prompted.
- Complete authorization and return to Odoo.
Odoo retrieves the Instagram Professional account connected to the selected Facebook Page and creates or updates the corresponding social account.
11. Create and Publish Instagram Posts
- Go to Social Marketing > Social Posts.
- Click New or Create.
- Enter the caption.
- Add the supported image or video content.
- Select the Instagram account.
- Choose Post Now or schedule a future publication time.
- Publish the post.
12. Monitor Live Posts, Comments, and Insights
- Go to Social Marketing > Live Posts.
- Open an Instagram post.
- Review its publication status and available engagement information.
- Use the comments or engagement actions to:
- Synchronize comments
- Reply to comments
- Hide or unhide comments
- Delete comments when supported
- Open the available analytics views to review account or media insights.
Replies and moderation actions are sent to Instagram through the API using the connected account credentials.
13. Troubleshooting
OAuth redirect URI mismatch
Confirm that the Meta redirect URI exactly matches:
https://your-odoo-domain.com/social_instagram/authentication
Also confirm that Odoo's web.base.url uses the same public HTTPS domain.
A required permission does not appear during login
- Verify that the permission was added under the Instagram use case.
- Confirm that it shows Ready for testing or has approved production access.
- Remove the previous authorization from Facebook Business Integrations and run Link Account again so Meta can request the updated scopes.
No Instagram account is found
- Confirm that the Instagram account is Business or Creator.
- Confirm that it is connected to a Facebook Page.
- Confirm that the Facebook user has access to both assets.
- Confirm that the correct Page was selected during authorization.
- Confirm that pages_show_list and pages_read_engagement were granted.
The integration works for the app administrator but not for customers
The permissions are still limited to app-role testing, a required verification is incomplete, the App Review request has not been approved, or the Meta App has not been published.
Complete verification, obtain the required production access, and publish the Meta App.
Posts cannot be published
- Confirm that instagram_content_publish was granted.
- Confirm that the media format and dimensions are supported by Instagram.
- Confirm that the connected Instagram account is still linked to the Facebook Page.
Instagram messages are not received
- Confirm that an Instagram Messenger module is installed.
- Confirm that instagram_manage_messages is available for testing or approved for production.
- Confirm that pages_manage_metadata and business_management were granted.
- Confirm that the webhook callback URL and verify token are correct.
- Confirm that the Instagram account is subscribed to the required webhook fields.
Official Meta Documentation
- Create a Meta App https://developers.facebook.com/documentation/development/create-an-app
- Facebook Pages API https://developers.facebook.com/documentation/pages-api
- Instagram API with Facebook Login https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-facebook-login
- Messenger Platform https://developers.facebook.com/documentation/business-messaging/messenger-platform
- Meta Permissions Reference https://developers.facebook.com/docs/permissions/
- App Review https://developers.facebook.com/documentation/resp-plat-initiatives/individual-processes/app-review
- App Review Submission Guide https://developers.facebook.com/documentation/resp-plat-initiatives/individual-processes/app-review/submission-guide
- Business Verification https://developers.facebook.com/documentation/development/release/business-verification
- Publish a Meta App https://developers.facebook.com/documentation/development/release
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