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:
Set up an account with Meta.
Copy four things from Meta into a note.
Paste those four things into Olanna.
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.
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.
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.
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.
1
Go to Meta's developer site
Open developers.facebook.com and log in with the same account as Part 2.
2
Start a new app
Choose My Apps, then Create App.
3
Pick Business as the type
Meta asks what type of app this is. Choose Business.
4
Name it after your business
Something you will recognise in a year, like “Marina Property Olanna”.
5
Finish creating it
Link it to the business account from Part 2, then choose Create App.
An access token is a long password. It is what lets Olanna into your Page.
1
Open Messenger settings
Go back to developers.facebook.com. Open your app, then Messenger, then Settings.
2
Generate a token for your Page
Under Access Tokens, find your Page in the list and choose Generate Token next to it.
Generate Token sits beside your Page, not above it.
3
Approve the permissions
Say yes to anything Meta asks for. A long line of letters and numbers appears.
4
Copy it into your note
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.
1
Open your app
Go to developers.facebook.com and open the app you made.
2
Go to Settings, then Basic
Both are in the left menu.
3
Reveal the app secret
Find App Secret and choose Show. Meta might ask for your password.
4
Copy it into your note
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.
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.
1
Copy your webhook URL from Olanna
On the Channels page, open your Messenger row and copy the Webhook URL.
2
Open Webhooks in Meta
Go to developers.facebook.com, open your app, then Messenger, then Settings, then Webhooks.
3
Add a callback URL
Choose Add Callback URL. If there is one there already, choose Edit.
4
Paste in the address
Put the Webhook URL into the Callback URL box.
5
Type your verify token
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.
Callback URL from Olanna, verify token from your note.
6
Verify and save
Choose Verify and Save.
7
Tick messages for your Page
Below that, find your Page in the Webhook subscriptions list. Make sure messages is ticked.
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.
Access token is not valid on either graph.facebook.com or graph.instagram.com
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.
App Secret is incorrect for this app
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.
Meta shows an error when I choose Verify and Save
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.
Messages are not arriving in Olanna
Check that your Page shows under Webhook subscriptions with messages ticked. Check the channel says Active in Olanna, not Error.
I lost my access token or app secret
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.
Still stuck
Contact support. Tell us which part you are on, and the exact words of the error. A screenshot is best.
Last modified on September 14, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Olanna Help Center","description":"SMB, AI, customer support, Agent","colors":{"primary":"#166E3F","light":"#26BD6C","dark":"#166E3F"},"logo":{"light":"https://mintcdn.com/olanna/GL1Ex0j2R6c8W1Zs/images/WorkBrown.png?fit=max\u0026auto=format\u0026n=GL1Ex0j2R6c8W1Zs\u0026q=85\u0026s=9c699785083519f6753fe8cd35de0da6","dark":"https://mintcdn.com/olanna/GL1Ex0j2R6c8W1Zs/images/WorkBrown.png?fit=max\u0026auto=format\u0026n=GL1Ex0j2R6c8W1Zs\u0026q=85\u0026s=9c699785083519f6753fe8cd35de0da6","href":"https://www.olanna.ai/"},"favicon":{"light":"https://mintcdn.com/olanna/GL1Ex0j2R6c8W1Zs/images/WorkBrown.png?fit=max\u0026auto=format\u0026n=GL1Ex0j2R6c8W1Zs\u0026q=85\u0026s=9c699785083519f6753fe8cd35de0da6","dark":"https://mintcdn.com/olanna/GL1Ex0j2R6c8W1Zs/images/WorkBrown.png?fit=max\u0026auto=format\u0026n=GL1Ex0j2R6c8W1Zs\u0026q=85\u0026s=9c699785083519f6753fe8cd35de0da6"},"navbar":{"links":[],"primary":{"type":"button","label":"Employee portal","href":"https://dashboard.mintlify.com"}},"footer":{"socials":{"x":"https://x.com/discoverolanna","linkedin":"https://linkedin.com/company/olanna-platforms","instagram":"https://instagram.com/discoverolanna"}},"fonts":{"heading":{"family":"Inter","weight":800}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","assistant","mcp","add-mcp"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"olanna","hasAudioNarration":false,"actualSubdomain":"olanna","customDomains":["docs.olanna.ai"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-olanna-28d77701","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6aa7443543fe57b758094c1e","collectionId":"7813ad04-4529-4e4d-9e72-1fbeaefd48ed","liveDeploymentHistoryId":"6aa7443543fe57b758094c1e","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa7443543fe57b758094c1e","clientVersion":"0.0.3894","searchFilterCounts":[{"language":"default","tag":"Help Guide","count":16},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"Quick start","count":7},{"language":"default","tag":"Getting started","count":6},{"language":"default","tag":"Connect your channels","count":5},{"language":"default","tag":"Connect your business apps","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"teamspace","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"toc-item>a{position:relative;padding-left:1rem!important}toc-item[data-active-deepest]>a::before{content:\"\";position:absolute;left:0;top:50%;width:.75rem;height:.75rem;transform:translateY(-50%);background-color:currentColor;-webkit-mask:url(\"data:image/svg+xml;utf8,\u003csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'>\u003cpolyline points='9 18 15 12 9 6'/>\u003c/svg>\") no-repeat center/contain;mask:url(\"data:image/svg+xml;utf8,\u003csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'>\u003cpolyline points='9 18 15 12 9 6'/>\u003c/svg>\") no-repeat center/contain;pointer-events:none}#navbar a[href=\"/\"] img,#navbar a[href=\"/\"] svg,#sidebar a[href=\"/\"] img,#sidebar a[href=\"/\"] svg{max-width:14rem;height:auto}a[nav-tabs-item]{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.kb-feature-card{background-color:rgb(var(--foreground-light, 17 24 39))}.kb-feature-card::before{content:\"\";position:absolute;inset:0;background-image:url(/images/texture.png);background-position:center;background-size:cover;opacity:.875}"}],"page":{"pagePath":"messenger","slug":"/messenger","pageMetadata":{"title":"Messenger","sidebarTitle":"Messenger","description":null,"href":"/messenger"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Frame,Heading,Note,OptimizedImage,Step,Steps,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`By the end of this, messages people send to your Facebook Page will land in Olanna. Your agent will answer them.`}),`\n`,_jsx(_components.p,{children:`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:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Set up an account with Meta.`}),`\n`,_jsx(_components.li,{children:`Copy four things from Meta into a note.`}),`\n`,_jsx(_components.li,{children:`Paste those four things into Olanna.`}),`\n`,_jsx(_components.li,{children:`Tell Meta to start sending your messages to Olanna.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Set aside 15 to 20 minutes. Use a computer, not your phone.`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(Heading,{level:`3`,id:`before-you-start`,children:_jsx(_components.strong,{children:`Before you start`})}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`You also need a Meta business account with that Page added to it. Part 2 covers making one.`}),`\n`,_jsx(Heading,{level:`3`,id:`part-1-open-a-blank-note`,children:_jsx(_components.strong,{children:`Part 1: Open a blank note`})}),`\n`,_jsx(_components.p,{children:`You are about to collect four things from Meta. Keep them in one place so you do not lose any.`}),`\n`,_jsx(_components.p,{children:`Open a blank note on your computer. Leave it open in its own window.`}),`\n`,_jsx(_components.p,{children:`Type these four lines into it. Fill each one in as you reach it.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Page ID:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Page access token:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`App secret:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Verify token:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`part-2-set-up-your-meta-business-account`,children:_jsx(_components.strong,{children:`Part 2: Set up your Meta business account`})}),`\n`,_jsx(_components.p,{children:`Skip to Part 3 if you already have one. Meta calls it Meta Business Suite, or Business Manager. It is the same thing.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Meta's business site`,children:_jsx(_components.p,{children:`Go to business.facebook.com.`})}),_jsx(Step,{title:`Choose Create Account`,children:_jsx(_components.p,{children:`The button is near the top of the page.`})}),_jsx(Step,{title:`Type your name and email`,children:_jsxs(_components.p,{children:[`Your business name, your own name, and your work email. Then choose `,_jsx(_components.strong,{children:`Submit`}),`.`]})}),_jsx(Step,{title:`Add your business details`,children:_jsx(_components.p,{children:`Fill in what Meta asks for.`})}),_jsx(Step,{title:`Confirm your email`,children:_jsx(_components.p,{children:`Open the email Meta sends you and click the link in it.`})}),_jsx(Step,{title:`Add your Facebook Page`,children:_jsx(_components.p,{children:`If your Page is not already in this account, add it now.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`part-3-create-a-meta-app`,children:_jsx(_components.strong,{children:`Part 3: Create a Meta app`})}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`If you already made one while connecting WhatsApp or Instagram for this business, use that one and skip to Part 4.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Go to Meta's developer site`,children:_jsx(_components.p,{children:`Open developers.facebook.com and log in with the same account as Part 2.`})}),_jsx(Step,{title:`Start a new app`,children:_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`My Apps`}),`, then `,_jsx(_components.strong,{children:`Create App`}),`.`]})}),_jsx(Step,{title:`Pick Business as the type`,children:_jsxs(_components.p,{children:[`Meta asks what type of app this is. Choose `,_jsx(_components.strong,{children:`Business`}),`.`]})}),_jsx(Step,{title:`Name it after your business`,children:_jsx(_components.p,{children:`Something you will recognise in a year, like “Marina Property Olanna”.`})}),_jsx(Step,{title:`Finish creating it`,children:_jsxs(_components.p,{children:[`Link it to the business account from Part 2, then choose `,_jsx(_components.strong,{children:`Create App`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`part-4-add-messenger-and-pick-your-page`,children:_jsx(_components.strong,{children:`Part 4: Add Messenger and pick your Page`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Set up Messenger`,children:_jsxs(_components.p,{children:[`On your app’s dashboard, find `,_jsx(_components.strong,{children:`Messenger`}),` and choose `,_jsx(_components.strong,{children:`Set up`}),`.`]})}),_jsxs(Step,{title:`Open the Pages list`,children:[_jsxs(_components.p,{children:[`Look for `,_jsx(_components.strong,{children:`Access Tokens`}),`, then choose `,_jsx(_components.strong,{children:`Add or Remove Pages`}),`.`]}),_jsx(Frame,{caption:`Your Pages are chosen under Access Tokens.`,children:_jsx(OptimizedImage,{src:`https://mintlify.s3.us-west-1.amazonaws.com/olanna/images/messenger/01-add-remove-pages.png`,alt:`The Messenger Access Tokens section with the Add or Remove Pages button`})})]}),_jsx(Step,{title:`Pick your Page`,children:_jsx(_components.p,{children:`Select the Facebook Page you want to connect. Say yes to the permissions Meta asks for.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`part-5-copy-your-page-id`,children:_jsx(_components.strong,{children:`Part 5: Copy your Page ID`})}),`\n`,_jsx(_components.p,{children:`An ID is a number Meta uses to tell one thing from another.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open your Facebook Page`,children:_jsx(_components.p,{children:`Go to the Page itself, not the developer site.`})}),_jsx(Step,{title:`Go to About`,children:_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`About`}),` in the left menu. On some Pages it is called `,_jsx(_components.strong,{children:`Page transparency`}),`.`]})}),_jsxs(Step,{title:`Find the Page ID`,children:[_jsxs(_components.p,{children:[`Scroll down until you see `,_jsx(_components.strong,{children:`Page ID`}),`. It is a long number. Copy it into your note.`]}),_jsx(Frame,{caption:`The Page ID is far down the About section.`,children:_jsx(OptimizedImage,{src:`https://mintlify.s3.us-west-1.amazonaws.com/olanna/images/messenger/02-page-id.png`,alt:`The Facebook Page About section showing the Page ID`})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`part-6-make-your-page-access-token`,children:_jsx(_components.strong,{children:`Part 6: Make your page access token`})}),`\n`,_jsx(_components.p,{children:`An access token is a long password. It is what lets Olanna into your Page.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Messenger settings`,children:_jsxs(_components.p,{children:[`Go back to developers.facebook.com. Open your app, then `,_jsx(_components.strong,{children:`Messenger`}),`, then `,_jsx(_components.strong,{children:`Settings`}),`.`]})}),_jsxs(Step,{title:`Generate a token for your Page`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Access Tokens`}),`, find your Page in the list and choose `,_jsx(_components.strong,{children:`Generate Token`}),` next to it.`]}),_jsx(Frame,{caption:`Generate Token sits beside your Page, not above it.`,children:_jsx(OptimizedImage,{src:`https://mintlify.s3.us-west-1.amazonaws.com/olanna/images/messenger/03-generate-token.png`,alt:`The Messenger settings page generating a page access token`})})]}),_jsx(Step,{title:`Approve the permissions`,children:_jsx(_components.p,{children:`Say yes to anything Meta asks for. A long line of letters and numbers appears.`})}),_jsx(Step,{title:`Copy it into your note`,children:_jsx(_components.p,{children:`Do this before you close the window.`})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`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 `,_jsx(_components.strong,{children:`Settings`}),`, then `,_jsx(_components.strong,{children:`Users`}),`, then `,_jsx(_components.strong,{children:`System Users`}),`. Add one named “Olanna Integration” with the role Admin. Choose `,_jsx(_components.strong,{children:`Add Assets`}),` and pick your Page. Then choose `,_jsx(_components.strong,{children:`Generate New Token`}),`, pick your app, and tick the permission `,_jsx(_components.strong,{children:`pages_messaging`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`part-7-copy-your-app-secret-then-make-up-a-verify-token`,children:_jsx(_components.strong,{children:`Part 7: Copy your app secret, then make up a verify token`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`App secret.`}),` This is another password. It proves the app belongs to you.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open your app`,children:_jsx(_components.p,{children:`Go to developers.facebook.com and open the app you made.`})}),_jsx(Step,{title:`Go to Settings, then Basic`,children:_jsx(_components.p,{children:`Both are in the left menu.`})}),_jsx(Step,{title:`Reveal the app secret`,children:_jsxs(_components.p,{children:[`Find `,_jsx(_components.strong,{children:`App Secret`}),` and choose `,_jsx(_components.strong,{children:`Show`}),`. Meta might ask for your password.`]})}),_jsx(Step,{title:`Copy it into your note`,children:_jsx(_components.p,{children:`That is three of your four lines done.`})})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Verify token.`}),` You make this one up yourself. It is not copied from anywhere. Any word or phrase will do, like `,_jsx(_components.code,{children:`marina-fb-2026`}),`.`]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`Your note should now have all four lines filled in.`}),`\n`,_jsx(Heading,{level:`3`,id:`part-8-paste-it-into-olanna`,children:_jsx(_components.strong,{children:`Part 8: Paste it into Olanna`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Channels`,children:_jsxs(_components.p,{children:[`In Olanna, choose `,_jsx(_components.strong,{children:`Channels`}),` in the left menu.`]})}),_jsx(Step,{title:`Choose Connect on the Messenger row`,children:_jsx(_components.p,{children:`A form opens with a box for each of your four things.`})}),_jsxs(Step,{title:`Copy your note into the boxes`,children:[_jsx(_components.p,{children:`Each line of your note goes in the box with the same name.`}),_jsx(Frame,{caption:`All four values from your note, in Olanna.`,children:_jsx(OptimizedImage,{src:`https://mintlify.s3.us-west-1.amazonaws.com/olanna/images/messenger/04-olanna-connect-form.png`,alt:`Olanna's Messenger connect form filled in`})})]}),_jsx(Step,{title:`Choose Install`,children:_jsx(_components.p,{children:`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.`})})]}),`\n`,_jsx(_components.p,{children:`If something does not match, the message tells you which one. Troubleshooting is at the bottom of this page.`}),`\n`,_jsx(Heading,{level:`3`,id:`part-9-tell-meta-where-to-send-your-messages`,children:_jsx(_components.strong,{children:`Part 9: Tell Meta where to send your messages`})}),`\n`,_jsx(_components.p,{children:`Meta now trusts Olanna. But it still does not know where to send your messages. This part gives it the address.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Copy your webhook URL from Olanna`,children:_jsxs(_components.p,{children:[`On the Channels page, open your Messenger row and copy the `,_jsx(_components.strong,{children:`Webhook URL`}),`.`]})}),_jsx(Step,{title:`Open Webhooks in Meta`,children:_jsxs(_components.p,{children:[`Go to developers.facebook.com, open your app, then `,_jsx(_components.strong,{children:`Messenger`}),`, then `,_jsx(_components.strong,{children:`Settings`}),`, then `,_jsx(_components.strong,{children:`Webhooks`}),`.`]})}),_jsx(Step,{title:`Add a callback URL`,children:_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`Add Callback URL`}),`. If there is one there already, choose `,_jsx(_components.strong,{children:`Edit`}),`.`]})}),_jsx(Step,{title:`Paste in the address`,children:_jsxs(_components.p,{children:[`Put the Webhook URL into the `,_jsx(_components.strong,{children:`Callback URL`}),` box.`]})}),_jsxs(Step,{title:`Type your verify token`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`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.`]}),_jsx(Frame,{caption:`Callback URL from Olanna, verify token from your note.`,children:_jsx(OptimizedImage,{src:`https://mintlify.s3.us-west-1.amazonaws.com/olanna/images/messenger/05-webhook-config.png`,alt:`The Messenger Webhooks section with Callback URL and Verify Token fields`})})]}),_jsx(Step,{title:`Verify and save`,children:_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`Verify and Save`}),`.`]})}),_jsx(Step,{title:`Tick messages for your Page`,children:_jsxs(_components.p,{children:[`Below that, find your Page in the `,_jsx(_components.strong,{children:`Webhook subscriptions`}),` list. Make sure `,_jsx(_components.strong,{children:`messages`}),` is ticked.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`part-10-test-it`,children:_jsx(_components.strong,{children:`Part 10: Test it`})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Use a different Facebook account`,children:_jsx(_components.p,{children:`Not the Page’s owner. Open Messenger on it.`})}),_jsx(Step,{title:`Message your Page`,children:_jsx(_components.p,{children:`Send it any short message.`})}),_jsx(Step,{title:`Check your Olanna inbox`,children:_jsx(_components.p,{children:`It should be there within a few seconds. If nothing arrives after a minute, see Troubleshooting.`})})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsx(_components.p,{children:`You can close your note now. Or keep it somewhere safe, in case you ever need to connect again.`}),`\n`,_jsx(Heading,{level:`3`,id:`questions`,children:_jsx(_components.strong,{children:`Questions`})}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Can I connect more than one Facebook Page?`,id:`can-i-connect-more-than-one-facebook-page`,children:_jsx(_components.p,{children:`One Page per business through this screen. Contact support if you need more.`})}),_jsx(Accordion,{title:`Do I need a personal Facebook account to manage the Page?`,id:`do-i-need-a-personal-facebook-account-to-manage-the-page`,children:_jsx(_components.p,{children:`Yes. Facebook Pages are always run through a personal login. The Page itself is what your customers see and message.`})}),_jsx(Accordion,{title:`Can I reuse the Meta app I made for WhatsApp or Instagram?`,id:`can-i-reuse-the-meta-app-i-made-for-whatsapp-or-instagram`,children:_jsx(_components.p,{children:`Yes. One Meta app can hold WhatsApp, Messenger and Instagram together. You do not need a separate one for each.`})}),_jsx(Accordion,{title:`Do I need to keep the Meta app after this?`,id:`do-i-need-to-keep-the-meta-app-after-this`,children:_jsx(_components.p,{children:`Yes. It is what keeps the connection alive. You do not have to open it again, but do not delete it.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`troubleshooting`,children:_jsx(_components.strong,{children:`Troubleshooting`})}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Access token is not valid on either graph.facebook.com or graph.instagram.com`,id:`access-token-is-not-valid-on-either-graph-facebook-com-or-graph-instagram-com`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Accordion,{title:`App Secret is incorrect for this app`,id:`app-secret-is-incorrect-for-this-app`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Accordion,{title:`Meta shows an error when I choose Verify and Save`,id:`meta-shows-an-error-when-i-choose-verify-and-save`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Accordion,{title:`Messages are not arriving in Olanna`,id:`messages-are-not-arriving-in-olanna`,children:_jsx(_components.p,{children:`Check that your Page shows under Webhook subscriptions with messages ticked. Check the channel says Active in Olanna, not Error.`})}),_jsx(Accordion,{title:`I lost my access token or app secret`,id:`i-lost-my-access-token-or-app-secret`,children:_jsx(_components.p,{children:`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.`})}),_jsx(Accordion,{title:`Still stuck`,id:`still-stuck`,children:_jsx(_components.p,{children:`Contact support. Tell us which part you are on, and the exact words of the error. A screenshot is best.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Messenger","sidebarTitle":"Messenger","description":null,"href":"/messenger"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":3,"children":[]},{"title":"Part 1: Open a blank note","slug":"part-1-open-a-blank-note","depth":3,"children":[]},{"title":"Part 2: Set up your Meta business account","slug":"part-2-set-up-your-meta-business-account","depth":3,"children":[]},{"title":"Part 3: Create a Meta app","slug":"part-3-create-a-meta-app","depth":3,"children":[]},{"title":"Part 4: Add Messenger and pick your Page","slug":"part-4-add-messenger-and-pick-your-page","depth":3,"children":[]},{"title":"Part 5: Copy your Page ID","slug":"part-5-copy-your-page-id","depth":3,"children":[]},{"title":"Part 6: Make your page access token","slug":"part-6-make-your-page-access-token","depth":3,"children":[]},{"title":"Part 7: Copy your app secret, then make up a verify token","slug":"part-7-copy-your-app-secret-then-make-up-a-verify-token","depth":3,"children":[]},{"title":"Part 8: Paste it into Olanna","slug":"part-8-paste-it-into-olanna","depth":3,"children":[]},{"title":"Part 9: Tell Meta where to send your messages","slug":"part-9-tell-meta-where-to-send-your-messages","depth":3,"children":[]},{"title":"Part 10: Test it","slug":"part-10-test-it","depth":3,"children":[]},{"title":"Questions","slug":"questions","depth":3,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"olanna","siteName":"Olanna Help Center","title":"Messenger - Olanna Help Center","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T00:48:05.458Z","gitLastModified":"2026-09-14T00:47:47.000Z","originalFileLocation":"messenger.mdx"},"headHtml":"\u003cmeta data-mint-head name=\"application-name\" content=\"Olanna Help Center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Messenger - Olanna Help Center\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Olanna Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.olanna.ai/messenger\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Messenger - Olanna Help Center\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/olanna/C0-HXM3KGKHNADh_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Olanna Help Center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#166E3F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.olanna.ai/messenger\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/messenger.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.olanna.ai/#organization\",\"name\":\"Olanna Help Center\",\"url\":\"https://docs.olanna.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/olanna/GL1Ex0j2R6c8W1Zs/images/WorkBrown.png?fit=max\u0026auto=format\u0026n=GL1Ex0j2R6c8W1Zs\u0026q=85\u0026s=9c699785083519f6753fe8cd35de0da6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.olanna.ai#website\",\"name\":\"Olanna Help Center\",\"url\":\"https://docs.olanna.ai\",\"publisher\":{\"@id\":\"https://docs.olanna.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.olanna.ai/messenger#webpage\",\"url\":\"https://docs.olanna.ai/messenger\",\"name\":\"Messenger\",\"dateModified\":\"2026-09-14T00:47:47.000Z\",\"isPartOf\":{\"@id\":\"https://docs.olanna.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.olanna.ai/messenger#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.olanna.ai/messenger#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Integrations\",\"item\":\"https://docs.olanna.ai/calendly\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect your channels\",\"item\":\"https://docs.olanna.ai/voice\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Messenger\",\"item\":\"https://docs.olanna.ai/messenger\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.olanna.ai/messenger#article\",\"headline\":\"Messenger\",\"name\":\"Messenger\",\"url\":\"https://docs.olanna.ai/messenger\",\"mainEntityOfPage\":{\"@id\":\"https://docs.olanna.ai/messenger#webpage\"},\"dateModified\":\"2026-09-14T00:47:47.000Z\",\"publisher\":{\"@id\":\"https://docs.olanna.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.olanna.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Olanna Help Center\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Olanna Help Center","nav":{"global":null,"tabs":[{"tab":"Help Guide","groups":[{"group":"Quick start","pages":[{"title":"Welcome to Olanna","sidebarTitle":"Welcome to Olanna","href":""},{"group":"Getting started","pages":[{"title":"Introduction","sidebarTitle":"Introduction","href":"/introduction"},{"title":"Add business knowledge","sidebarTitle":"Add business knowledge","href":"/knowledge"},{"title":"Connect your business apps","sidebarTitle":"Connect business apps","href":"/bus-apps"},{"title":"Connect messaging channels","sidebarTitle":"Connect messaging channels","href":"/bus-channels"},{"title":"Add teams","sidebarTitle":"Add teams","href":"/add-teams"},{"title":"Preview and go live","sidebarTitle":"Preview and go live","href":"/go-live"}]}]},{"group":"Agent Management","pages":[]},{"group":"Using Olanna","pages":[]},{"group":"Integrations","pages":[{"group":"Connect your business apps","pages":[{"title":"Calendly","sidebarTitle":"Calendly","href":"/calendly"},{"title":"Vagaro","sidebarTitle":"Vagaro","href":"/vagaro"},{"title":"Setmore","sidebarTitle":"Setmore","href":"/setmore"},{"title":"Mindbody","sidebarTitle":"Mindbody","href":"/mindbody"}]},{"group":"Connect your channels","pages":[{"title":"Voice","sidebarTitle":"Voice","href":"/voice"},{"title":"Whatsapp","sidebarTitle":"Whatsapp","href":"/whatsapp"},{"title":"Instagram","sidebarTitle":"Instagram","description":null,"href":"/instagram"},{"title":"Messenger","sidebarTitle":"Messenger","href":"/messenger"},{"title":"Telegram","sidebarTitle":"Telegram","description":null,"href":"/telegram"}]}]},{"group":"Workspace","pages":[]}]}]},"title":"Messenger - Olanna Help Center","buildId":"dpl_8LJVMfxYNq6LJkohTrn2iyWT8umj","deploymentId":"dpl_8LJVMfxYNq6LJkohTrn2iyWT8umj","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DgIorxK1.js","DynamicMarkdown-43fmNsOD.js","zoom-image-lightbox-D9lJgLSo.js","PlusIcon-C1lem43w.js","lightbox-handle-r17bVUz3.js"]}