*Times Are Based On Pacific Standard Time (PST Time Zone)*

Security Code:
security code
Please enter the security code:


Chat Plugin On May 9, 2024, you will no longer be able to access any of the functionality of the Chat Plugin. Effective immediately, Chat Plugin in guest mode is no longer available. Other features like m.me links will still be available for you to use. This document shows you how to programmatically add the Chat Plugin to your Messenger experience on website. If you would like to use the Meta Business Suite to add the Chat Plugin to your webpage (recommended), please visit the Meta Business Help Center for more information. How It Works When you install the Facebook SDK for JavaScript on your webpage, the Chat Plugin will be rendered on the webpage. By default, the greeting dialog will be shown on desktop and mobile and a person may click the close button to minimize the dialog. You can customize the greeting, look, such as the color, and messaging experience, such as menus and quick replies, of the plugin. The state of the dialog is cached, maximized or minimized, and persists from session to session. Logins If the person is logged in to Facebook, the plugin will show the "Continue as [NAME]" and "Continue as Guest" buttons. If the person is not logged in to Facebook, the plugin will show the "Log into Messenger" and "Continue as Guest" buttons. Webhook Notifications When a person clicks on the plugin to start or continue a chat with your business, a webhook notification will be sent to your server that contains: Information about the person, such as Page-scoped IDs (PSID) or User-reference IDs Identify the source of the message as Chat Plugin Referral information included in the notification If you have implemented the Welcome Screen in the plugin and the person clicks the Get Started button to start a conversation with your business, a messaging_postbacks webhook notification will be sent to your server. Your business can then use the user reference ID to send messages to the person within the 24-hour standard messaging window. Existing Conversations If the person has an existing conversation with your business, the chat history will automatically load in the plugin. When the person continues the conversation, either sends a message, clicks a button, or takes some other action you have implemented in the conversation, a messaging webhook notification will be sent to your server or a messaging_referral webhook notification if you include referral information. Your business can then use the PSID to send messages to the person within the 24-hour standard messaging window. Message Types supported by Chat Plugin Audio, Video, Image, and GIFs Call Buttons Persistent Menu Postback Buttons Sender Actions Text Messages Text Quick Replies URL Buttons User Email Quick Replies User Phone Number Quick Replies The plugin does not support: Buy Buttons Game Play Buttons List, Media, or Open Graph Templates Location Quick Replies Log In Buttons Log Out Buttons Messenger in-app browsers Share Buttons Before You Start This guide assumes that you have read the Messenger Platform Overview and implemented the needed components for sending messages and receiving messages and notifications. You will need: The pages_messaging permission A Page access token requested from a person who can perform the MODERATE task on your Facebook Page The app linked to your Facebook Page subscribed to the messaging, messaging_postbacks, and messaging_referrals webhooks fields The domain for your website added to the allowlist using the Messenger Profile API or the Meta Business Suite The Meta Business Tools Terms apply in connection with your usage of the Chat Plugin. Limitations Your website must be live or allowlisted before Chat Plugin can be successfully implemented If your business' Facebook Page has age or country restrictions set in Page settings, the Chat Plugin will not render for people who are not logged into their Facebook account when they visit your website. Greeting dialog is not cached for Safari 12+ and Firefox browsers Add the Chat Plugin Step 1. Add the SDK Add the Facebook SDK for JavaScript to each page of your website where you want to render the plugin.