$ 47.62
In-App Purchases| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Social Marketing (social) |
| Community Apps Dependencies | Show |
| Lines of code | 2276 |
| Technical Name |
d_ee_social_instagram_messenger |
| License | OPL-1 |
| Website | http://messiduong2709@gmail.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Social Marketing (social) |
| Community Apps Dependencies | Show |
| Lines of code | 2276 |
| Technical Name |
d_ee_social_instagram_messenger |
| License | OPL-1 |
| Website | http://messiduong2709@gmail.com |
EE Social Instagram Messenger
Handle Instagram Direct messages in Odoo Enterprise
Connect Instagram messaging to Odoo Discuss so your team can receive, answer, and track customer direct messages from one workspace.
Instagram Direct Messaging
Bring Instagram conversations into the same Discuss interface used by your Odoo team.
- Receive new Instagram direct messages from Meta webhooks.
- Reply with text messages from Odoo Discuss channels.
- Track sent, delivered, read, received, and failed message states.
- Show the 24-hour conversation window state on Instagram channels.
Media and Shared Content
Keep richer Instagram conversations visible in Odoo.
- Receive inbound image, video, audio, and file attachments where available from the webhook payload.
- Preserve shared post and story URLs in the conversation body.
- Keep downloaded attachments on the Odoo mail message for later review.
Conversation Management
Organize Instagram messages for daily support and sales workflows.
- Create one Discuss channel per Instagram customer.
- Assign operators from the Instagram Social Account form.
- Link customers to Odoo partners with Instagram-scoped sender IDs.
- Download conversation history and inspect sync jobs from Odoo.
Focused Direct Message Connector
This module focuses on Instagram direct messages: real-time inbound messages, text replies, media reception, status updates, operators, and history sync. Proactive campaign-style outbound formats are intentionally excluded from the Instagram connector.
Documentation
Please go to documentation tab in the right side to see how to configure meta developer app and in odoo as well
Support
For support, feature requests, or custom development, contact messiduong2709@gmail.com.
EE Social Instagram Messenger Setup
This guide explains how to enable Instagram Direct messages in Odoo Enterprise with the d_ee_social_instagram_messenger module.
Prerequisites
- Odoo Enterprise 17 with Social Marketing enabled.
- A Meta developer app at https://developers.facebook.com/.
- An Instagram Professional account connected to a Facebook Page.
- Administrator access to the connected Facebook Page and Meta app.
- A public HTTPS Odoo URL reachable by Meta webhooks.
- Meta permissions required by the module, including instagram_manage_messages, instagram_basic, pages_show_list, and Page metadata permissions.
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. Add instagram page
In the Access Token section of the Messenger settings, click on button Add page:
A popup appear will required you to login your instagram account.
4. 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:
5. 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.
6. Enable Instagram Messaging on the Social Account
- Go to Social Marketing > Configuration > Social Accounts.
- Open the Instagram account.
- In the Instagram Messenger section, enable IG Messenger Enabled.
- Confirm the webhook verify token is filled.
- Add Instagram Messenger operators.
- Click Register Instagram Messaging.
After registration, Odoo can receive Instagram messaging webhook events for that account.
7. Test Direct Messages
- From the Instagram mobile app, send a direct message to the connected Instagram account.
- In Odoo, open Instagram Messenger > Conversations or Discuss.
- Confirm the incoming message appears in an Instagram Messenger channel.
- Reply from Odoo with a text message.
- Check the message status on the Odoo message: sent, delivered, read, received, or failed.
Replies follow Meta's 24-hour customer messaging window. If the window is closed, wait for the customer to send a new message.
8. Media and Shared Content
Inbound webhook handling keeps Instagram message content visible in Odoo:
- text appears in the Discuss message body;
- image, video, audio, and file attachments are downloaded when Meta provides a URL;
- shared post and story URLs are appended to the message body;
- empty inbound payloads are marked as empty messages instead of being silently ignored.
9. Download Conversation History
- Open the Instagram Social Account.
- In Conversation History, click Download Conversation History.
- Use View Sync Jobs to monitor progress and errors.
History sync downloads conversations and messages in background jobs so large inboxes can be processed safely.
10. Current Instagram Messaging Scope
This module is focused on direct-message support:
- real-time inbound direct messages;
- text replies from Odoo Discuss;
- media and shared-content reception;
- read, delivery, echo, and failure tracking;
- operator assignment and history sync.
Proactive campaign-style outbound formats are intentionally excluded from the Instagram connector.
Troubleshooting
- Webhook verification fails: confirm the callback URL is public HTTPS and the verify token matches Odoo.
- Messages arrive but replies fail: re-authorize the Instagram account and confirm instagram_manage_messages is granted.
- Reply blocked by policy: check whether the 24-hour customer messaging window is closed.
- Media arrives as an empty message: inspect the webhook payload and confirm Meta includes an attachment URL.
- Status does not update: confirm the webhook events are subscribed and the outbound message ID matches the webhook echo/read event.
- History sync errors: open View Sync Jobs and inspect the error message.
Support
For support, feature requests, or custom development, contact messiduong2709@gmail.com.
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