Meta Developers (Facebook) setup

Create app and add products

• If you have already Facebook business account. Open developers.facebook.com and create an app (type: Business).
• Click on "Create App" then follow the instructions (Instruction)

• Go to the dashboard and App customization and requirements, then click on Instagram messaging.
• 1. Add the necessary permissions for messaging
• 2. Add instagram account. You must have access as a developer

Generate access token

• Generate a Access Token with required scopes for Instagram messaging.
• Copy the token — you will paste it into Odoo in the messenger configuration.

Choose subscriptions

• In Webhooks, subscribe your app to the instagram object.
• Select the messages field (and other fields if your flow requires them).
• If your setup uses a Facebook Page routing, also subscribe to the page object's messaging events (if applicable).

Installation

• Install the us_instagram_messenger module on Odoo
• Make sure queue_job is listed in server_wide_modules in your odoo.conf. If it's missing, starting a bot will show: "Required configuration missing: ... add 'queue_job' to the 'server_wide_modules' field".
• In Developer mode, go to Settings > Technical > Queue Jobs > Job Functions, open <us.messenger.task>.run and enable Allow Commit. Without this, sending an outgoing message will fail with "Commit is forbidden in queue jobs" (this Job Function is shared by all messenger channels, not only Instagram).

Configuration

In Odoo

• Open Messengers >> Messengers and create/select your Instagram integration.
• Set a Token. You have already configured it above
• Set a Verify Token — any secure string you choose (also visible/editable under the bot's Parameters tab as VERIFY_TOKEN).
• Set the Instagram App Secret field — copy it from the Meta App Dashboard: Products > Instagram > API setup with Instagram login, field "Instagram app secret" (this is not the main App Secret under App Settings > Basic). It is used to verify the signature of every incoming webhook so a third party cannot forge events. If left empty, signature verification is simply skipped.
• You can select default bot language

Create webhook (Callback URL + Verify Token)

• Every bot gets its own, unique Callback URL — open the bot's Webhooks smart button in Odoo and copy the generated URL, it looks like: https://YOUR-ODOO-DOMAIN/instagram/webhook/<unique-id>. Each bot has a different <unique-id>, so don't copy it from another bot.
• Paste that URL as the Callback URL in Meta.
• Paste your VERIFY_TOKEN you used in Odoo.
• Click Verify/Save to complete the challenge. Then subscribe the required Instagram account/Page to your app.

Connecting multiple Instagram accounts

• Two (or more) Instagram accounts can only be used with this module if each one is connected through a different, separate Meta App. Meta lets you add several Instagram accounts to a single App, but in that case they all share the same Callback URL — so Odoo has no way to tell which bot a message belongs to. One App = one Callback URL = one Odoo bot.
• Callback URL, Verify Token and App Secret are all configured per App in the Meta dashboard, not per account.
• While your App is in Development mode, add the Instagram account under App roles > Instagram Testers, then have the account owner accept the invite from inside the Instagram app (Settings > Apps and websites > Tester invites).
• If the App is managed by a Business Manager, role changes (including adding Instagram Testers) may need to be done from Business Manager > Business Settings > People, not from the classic App roles page.
• In Odoo, create a new bot (New) for each account. It automatically gets its own unique Callback URL, and its own Token, Instagram App Secret and VERIFY_TOKEN — each account is fully isolated from the others.

Usage

Operators menu

• In the Operators menu, you can see who is an operator and how many channels each operator is assigned to.

Supported data (Currently)

• Sending messages works like in Whatsapp (Odoo enforces a 24-hour sending window).
• Chatter works like in other messengers.
• Not all file types are supported:

Supported

• Forwarding a post (only the first image is saved; videos may not be saved properly)
• Photos/videos from the phone
• Voice messages
• Stickers

Not supported

• Reels
• Photo and video galleries
• Location pin (not supported in the meta dashboard either)
• One-to-one story photos (not supported in the meta dashboard)