| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Community Apps Dependencies | Show |
| Lines of code | 6885 |
| Technical Name |
d_social_instagram_messenger |
| 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 | 6885 |
| Technical Name |
d_social_instagram_messenger |
| License | OPL-1 |
| Website | https://duong-odoo-apps.odoo.com |
Instagram Messenger Connector
Bring Instagram Messages into Odoo
Integrate Instagram Messenger with Odoo Community Edition and handle all direct messages from your Instagram Professional account inside Odoo. This module uses the Instagram Messenger APIs to synchronize conversations in real-time.
Your team can manage Instagram messages alongside emails, live chat, and other channels in the Odoo Discuss interface.
Two-Way Messaging
Support full two-way conversations with Instagram users:
- Receive messages from Instagram followers in real-time
- Reply directly from Odoo Discuss channels
- Comply with the 24-hour messaging window policy
- Track message status (sent, delivered, read)
All direct messages are stored in Odoo for future reference and reporting.
Rich Message Types
Deliver richer conversations with media support:
- Text messages with support for up to 1000 characters
- Multiple images in a single message
- Videos and other media files
- Shared Instagram posts from your profile
- Reactions and stickers support where available
Combine text and media to provide better product information and support.
Smart Conversation Management
Organize conversations and collaborate with your team:
- Automatic threading per Instagram user
- Customer profile details and avatars in Odoo
- Conversation history accessible from the channel
- Assign conversations to team members
- Multi-operator support for high message volume
Your support, marketing, and sales teams can share the workload efficiently.
Real-Time Notifications
Never miss important messages from your followers:
- Webhook integration for instant delivery of new messages
- Unread counters on Discuss channels
- Browser notifications for new DMs
- Visual indicators for the 24-hour messaging window
Short response times help you provide better customer experience on Instagram.
Use Cases
Instagram Messenger integration is useful in many scenarios:
- Customer support and after-sales assistance
- Lead qualification from Instagram campaigns
- Pre-sales questions and product recommendations
- Order status updates and shipping notifications
- Content creator and influencer collaboration management
All conversations stay linked to your Odoo records for follow-up and analytics.
Documentation
Please open the Documentation tab on the right side of this page to see how to configure the Instagram Messenger integration and required permissions.
Support Email
Contact us for support at duongodooapps@gmail.com
Instagram Messenger Connector Setup
This guide explains the extra steps to enable Instagram Messenger (Direct messages) in Odoo, on top of the base Instagram integration from the d_social_instagram module.
Prerequisites
- Facebook Business app already created on Facebook for Developers <https://developers.facebook.com/.
- Instagram Graph API integration configured in Odoo (see https://apps.odoo.com/apps/modules/18.0/d_social_instagram).
- Instagram Professional (Business/Creator) account linked to a Facebook Page.
1. Add Messenger Product
- Open your app in Facebook for Developers https://developers.facebook.com/
- In Products, click Add product.
- Add Messenger (Instagram messaging also uses this product).
Example:
2. Configure Webhook Callback URL
In the Messenger product, open Messenger > Settings or the Instagram webhook section.
Under Webhook / Callback URL, set:
Callback URL:
https://your-odoo-domain.com/instagram_messenger/webhook
Verify Token: choose a secure string.
In Odoo, go to the Instagram Messenger settings for your company and copy the same value into the Instagram Messenger webhook verify token field.
Back in Facebook, click Verify and Save to validate the callback URL.
Example configuration:
3. Register Webhook Events
In the Instagram section of the Messenger settings, subscribe at least to the following webhook events:
- messages
- message_deliveries
- message_reads
- messaging_postbacks
Then select the Instagram account (via its connected Facebook Page) you want to receive events for.
Example events:
4. App Mode and Review
To receive and send messages with real Instagram users:
- The app must be in Live mode.
- Request the necessary Instagram messaging permissions in App Review > Requests; otherwise, only developers/testers and the Page owner can test the integration.
5. Enable Instagram Messenger on Social Account in Odoo
- In Odoo, go to Social Marketing > Social Accounts.
- Open the Instagram account you want to enable messaging for.
- Go to the Messenger tab.
- Enable the flag for Instagram Messenger (for example "Enable Instagram Messenger").
- Click the Register button.
Odoo will register the webhook subscription and events for that Instagram account.
Example in Odoo:
6. Test the Integration
- From the Instagram mobile app, send a Direct message to the connected account from a personal profile.
- In Odoo, open Discuss and locate the Instagram Messenger conversation channel.
- You should see the incoming message and be able to reply with text, images or other supported media.
If messages are only received from developer/tester accounts, verify that the app is Live and that Instagram messaging permissions were approved in App Review.
Example conversation:
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