# Messenger ↔ Odoo Setup Guide

This guide explains the current Messenger setup flow in Odoo.

This applies when the chat_commerce_messenger addon is installed.

The preferred setup is now:

1. enter your Meta App ID and App Secret in Odoo
2. click Connect Facebook
3. sign in to Facebook
4. choose the Facebook Page
5. click Check Connection
6. copy the webhook information into Meta

## What You Need

• the chat_commerce_messenger addon installed
• a Meta app with Messenger enabled
• a Facebook Page connected to that app
• your public Odoo base URL
• one Verify Token that you choose yourself

## Step 1: Open Bot Settings in Odoo

1. Open Odoo.
2. Go to Chat Commerce > Bot Settings.
3. Open or create the record with: - Platform = Messenger - Active = True

## Step 2: Fill the Messenger App Fields

In the Messenger bot record, fill:

• Messenger App ID
• Messenger App Secret
• Verify Token

Then save.

## Step 3: Connect Facebook

1. Click Connect Facebook.
2. Facebook login will open.
3. Sign in with the Facebook account that manages the Page.
4. Approve permissions.
5. Odoo will return to the Messenger bot form.

After this, Odoo will:

• retrieve the Pages you manage
• list them in the Pages section
• auto-fill the first available Page

## Step 4: Select the Page

If multiple Pages are shown:

1. Open the Pages list or use the inline page list.
2. Click Use This Page on the correct Page.

Odoo will then store:

• Facebook Page Name
• Facebook Page ID
• Access Token

## Step 5: Check Connection

Click Check Connection.

This validates:

• a Facebook Page is selected
• the stored Page access token works
• Odoo can read the selected Page from Meta
• Odoo can query the Page subscribed apps endpoint

If successful, the record should show:

• Connection Status = Ready
• Webhook Status = OK

## Step 6: Configure Meta Webhook

In the Messenger bot form, copy these values:

• Webhook URL
• OAuth Callback URL
• Verify Token

Then in Meta Developer Console:

1. open your app
2. go to Messenger or Webhooks setup
3. set the callback URL to the Webhook URL from Odoo
4. set the verify token to the same Verify Token in Odoo
5. save and verify

Typical webhook URL:

• https://<your-domain>/chat_commerce/messenger/webhook

Typical OAuth callback URL:

• https://<your-domain>/chat_commerce/messenger/oauth/callback

## Step 7: Subscribe to Events

Select the Messenger webhook events you need.

For Version 1, at minimum:

• messages
• messaging_postbacks

## Step 8: Test

1. Send a message to the Facebook Page in Messenger.
2. Confirm Odoo receives the webhook.
3. Confirm Odoo can reply back through Messenger.

## Manual Fallback

If Facebook connect is not available yet for your Meta app, you can still use manual setup.

Fill these fields directly in the Messenger bot record:

• Verify Token
• Access Token
• Facebook Page ID
• Facebook Page Name

Then configure the webhook manually in Meta.

## Important Notes

• Verify Token is your own handshake value for webhook verification.
• Access Token is the Facebook Page access token used by Odoo to send messages.
• Messenger App ID and Messenger App Secret are only needed for the one-click connect flow.
• Messenger-specific bot config fields belong to chat_commerce_messenger, not chat_commerce_base.
• Odoo can help with login, Page selection, and connection checks, but Meta still controls permissions and webhook approval.

## Recommended Result

Your Messenger bot record should end with:

• Platform = Messenger
• Active = True
• Connection Status = Ready
• Webhook Status = OK
• selected Facebook Page
• valid Access Token