> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olanna.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Messenger
By the end of this, messages people send to your Facebook Page will land in Olanna. Your agent will answer them.
Messenger is owned by Meta, the company behind Facebook. So most of this happens on Meta's website, not in Olanna. Here is the whole job:
1. Set up an account with Meta.
2. Copy four things from Meta into a note.
3. Paste those four things into Olanna.
4. Tell Meta to start sending your messages to Olanna.
Set aside 15 to 20 minutes. Use a computer, not your phone.
Meta changes these pages now and then. A button might not be exactly where this guide says. Look for the words, not the place, and you will find it.
### **Before you start**
You need a Facebook Page for your business, and you need to be an admin of it. If you do not have one, make it at facebook.com/pages/create first.
You also need a Meta business account with that Page added to it. Part 2 covers making one.
### **Part 1: Open a blank note**
You are about to collect four things from Meta. Keep them in one place so you do not lose any.
Open a blank note on your computer. Leave it open in its own window.
Type these four lines into it. Fill each one in as you reach it.
```text theme={null}
Page ID:
Page access token:
App secret:
Verify token:
```
### **Part 2: Set up your Meta business account**
Skip to Part 3 if you already have one. Meta calls it Meta Business Suite, or Business Manager. It is the same thing.
Go to business.facebook.com.
The button is near the top of the page.
Your business name, your own name, and your work email. Then choose **Submit**.
Fill in what Meta asks for.
Open the email Meta sends you and click the link in it.
If your Page is not already in this account, add it now.
### **Part 3: Create a Meta app**
Meta will ask you to make something called an app. It is not an app anyone downloads. It is a box that holds your connection. Meta will not let Olanna handle your messages without one. You make it once, then leave it alone.
If you already made one while connecting WhatsApp or Instagram for this business, use that one and skip to Part 4.
Open developers.facebook.com and log in with the same account as Part 2.
Choose **My Apps**, then **Create App**.
Meta asks what type of app this is. Choose **Business**.
Something you will recognise in a year, like "Marina Property Olanna".
Link it to the business account from Part 2, then choose **Create App**.
### **Part 4: Add Messenger and pick your Page**
On your app's dashboard, find **Messenger** and choose **Set up**.
Look for **Access Tokens**, then choose **Add or Remove Pages**.
Select the Facebook Page you want to connect. Say yes to the permissions Meta asks for.
### **Part 5: Copy your Page ID**
An ID is a number Meta uses to tell one thing from another.
Go to the Page itself, not the developer site.
Choose **About** in the left menu. On some Pages it is called **Page transparency**.
Scroll down until you see **Page ID**. It is a long number. Copy it into your note.
### **Part 6: Make your page access token**
An access token is a long password. It is what lets Olanna into your Page.
Go back to developers.facebook.com. Open your app, then **Messenger**, then **Settings**.
Under **Access Tokens**, find your Page in the list and choose **Generate Token** next to it.
Say yes to anything Meta asks for. A long line of letters and numbers appears.
Do this before you close the window.
The token made on this page is quick to get, but it may stop working after a while. For one that lasts, go to business.facebook.com and choose **Settings**, then **Users**, then **System Users**. Add one named "Olanna Integration" with the role Admin. Choose **Add Assets** and pick your Page. Then choose **Generate New Token**, pick your app, and tick the permission **pages\_messaging**.
### **Part 7: Copy your app secret, then make up a verify token**
**App secret.** This is another password. It proves the app belongs to you.
Go to developers.facebook.com and open the app you made.
Both are in the left menu.
Find **App Secret** and choose **Show**. Meta might ask for your password.
That is three of your four lines done.
**Verify token.** You make this one up yourself. It is not copied from anywhere. Any word or phrase will do, like `marina-fb-2026`.
Write it into your note exactly as you typed it. You will type the same thing in two places later, and they have to match.
Your note should now have all four lines filled in.
### **Part 8: Paste it into Olanna**
In Olanna, choose **Channels** in the left menu.
A form opens with a box for each of your four things.
Each line of your note goes in the box with the same name.
Olanna checks with Meta that your page access token really works for the Page ID you entered, and that your app secret belongs to the same app.
If something does not match, the message tells you which one. Troubleshooting is at the bottom of this page.
### **Part 9: Tell Meta where to send your messages**
Meta now trusts Olanna. But it still does not know where to send your messages. This part gives it the address.
That address is called a webhook URL. It is a long web address. You copy it out of Olanna and paste it into Meta. Nothing will arrive until you do.
On the Channels page, open your Messenger row and copy the **Webhook URL**.
Go to developers.facebook.com, open your app, then **Messenger**, then **Settings**, then **Webhooks**.
Choose **Add Callback URL**. If there is one there already, choose **Edit**.
Put the Webhook URL into the **Callback URL** box.
In the **Verify Token** box, type the phrase you made up in Part 7. It has to match what is in Olanna exactly. Same capital letters. No spaces at either end.
Choose **Verify and Save**.
Below that, find your Page in the **Webhook subscriptions** list. Make sure **messages** is ticked.
### **Part 10: Test it**
Not the Page's owner. Open Messenger on it.
Send it any short message.
It should be there within a few seconds. If nothing arrives after a minute, see Troubleshooting.
When your agent replies on Messenger, Facebook sends that reply back to Olanna as a copy. Olanna ignores those, so you will not see your own replies twice in the inbox.
You can close your note now. Or keep it somewhere safe, in case you ever need to connect again.
### **Questions**
One Page per business through this screen. Contact support if you need more.
Yes. Facebook Pages are always run through a personal login. The Page itself is what your customers see and message.
Yes. One Meta app can hold WhatsApp, Messenger and Instagram together. You do not need a separate one for each.
Yes. It is what keeps the connection alive. You do not have to open it again, but do not delete it.
### **Troubleshooting**
The page access token does not belong to the Page ID you entered, or it has expired. Go back to Part 6 and make it again. Then open the connection in Olanna, choose Edit, paste the new token, and save.
The app secret came from a different Meta app than the one that made your page access token. Copy it again from Settings, then Basic, on that same app.
The verify token you typed into Meta does not match the one saved in Olanna. A space on the end is the usual cause. Also check you finished Part 8 first, because Meta's check needs a live connection to work against.
Check that your Page shows under Webhook subscriptions with messages ticked. Check the channel says Active in Olanna, not Error.
Neither can be looked up once hidden. But you can make a new one from Part 6 or Part 7 and update it in Olanna. You will not lose your Page or your messages.
Contact support. Tell us which part you are on, and the exact words of the error. A screenshot is best.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.