Chatbot Integration with Facebook Messenger

If you can't see the "Create App" button, the possible reasons are:

• You are not logged into your Facebook account
• Your account does not yet have developer account status
• The Facebook Developers interface may have changed

Solution: Make sure you are logged into your account. If so, try refreshing the page. If the problem persists, look for another option to create an application in the interface or contact our technical support.

If you're getting an error while trying to create the application, the possible causes are:

• An application with that name already exists on your account
• Your developer account requires additional verification
• You have reached the app creation limit for your account

Solution: Try using a different app name. If that doesn't help, check whether your account requires additional verification (Facebook usually displays an appropriate message). If necessary, follow the account verification instructions.

This application type is intended for companies and organizations that want to use Facebook's business features, such as:

• Integration with Facebook Messenger for customer service
• Creating and managing advertising campaigns
• Analyzing business data and statistics
• Accessing Facebook API for commercial purposes

Business applications are subject to verification by Facebook, especially if they require access to additional permissions or user data.

This application type is intended for applications aimed directly at individual users, such as:

• Games and entertainment applications
• Social applications
• Personalization tools and lifestyle applications

Consumer applications may also be subject to verification, especially if they require access to user data or use Facebook login features.

This type is not recommended for business chatbots, as it may restrict access to some Messenger API features.

If you don't have a business portfolio yet, you can create one by following these steps:

1. Go to https://business.facebook.com/overview
2. Click the "Create account" button
3. Enter the company name, your first and last name, and your business email address
4. Provide company details such as address, industry, and website
5. After creating the portfolio, you can add your business pages that you own or manage
6. After creating the portfolio, return to the app creation process and select the newly created portfolio from the list

Important: A business portfolio is essential for business applications that are intended to operate in a production environment. It provides an additional level of security and enables access management for different employees.

If you're having problems connecting a business portfolio, check the following:

• Make sure you have administrator permissions in the business portfolio
• Check whether the business portfolio has been fully configured and verified by Facebook
• If the portfolio requires verification, follow Facebook's instructions to complete the verification process
• If problems persist, try refreshing the page or clearing your browser cache

If problems continue, it's worth contacting Facebook's technical support or our support team for additional help.

The sidebar menu in the Facebook Developers panel is divided into several main sections:

• Dashboard - the main application dashboard
• App settings - general application settings, including basic information, advanced settings, and user roles
• Product sections - each added product (like Messenger) has its own section in the menu
• Analytics - statistics and analytics about application usage
• Alerts - notifications and alerts related to the application

When configuring the chatbot, you will primarily work with the Messenger section and App settings.

If you can't see the Messenger section in the sidebar menu after adding the product, try the following steps:

1. Refresh the page - sometimes menu changes are not immediately visible
2. Check whether the Messenger product was correctly added - return to the dashboard and make sure Messenger is listed among the products
3. If you still can't see the Messenger section, go back to the dashboard and click "Set up" again on the Messenger tile
4. In extreme cases, you may need to log out and log back into the Facebook Developers panel or delete and recreate the application with the "Other" type

If you can't see your page on the list when trying to connect, the possible causes are:

• You don't have administrator permissions for that page
• The page has not yet been added to your business portfolio
• You are logged into the wrong Facebook account

Solution: Make sure you have administrator permissions for the page and that it is connected to your business portfolio. If the problem persists, try logging into the appropriate account or adding the page to your business portfolio.

If you're getting an error while trying to generate the token, the possible causes are:

• Internet connection issues
• Temporary issues with the Facebook Developers platform
• Insufficient permissions for the page
• The application doesn't have the required permissions to generate tokens

Solution: Refresh the page and try again. Make sure your application has "Live" status (if not, it may be operating in developer mode, which restricts some features). Also check that you have all the necessary permissions to manage the page.

Page Access Tokens can expire for various reasons, such as:

• Changing the Facebook account password
• Revoking application permissions
• Changes in Facebook security settings
• Natural token expiration after a long period

Solution: If the token has stopped working, generate a new token by repeating the process described above. Then update the token in the chatbot configuration on our platform.

If you need to reset the app secret, follow these steps:

1. Go to the basic application settings (App settings > Basic)
2. In the App Secret section, click the "Reset" button located next to the "Show" button
3. Confirm the operation by entering your Facebook account password
4. Facebook will generate a new app secret that will replace the previous one
5. Copy the new secret and update it in all places where the previous one was used

Important: Resetting the app secret will invalidate all existing connections and tokens. You will need to update the secret in all services that use it, including the chatbot configuration on our platform.

Resetting the app secret has several significant consequences:

• All existing access tokens will stop working and will need to be regenerated
• All integrations using the old app secret will stop working
• You will need to update the secret in all places where it was used
• Users may experience temporary service interruptions during the update

Due to these consequences, resetting the app secret should only be done in justified cases, such as suspected leaks or compromise.

Enter key information that will allow the chatbot to quickly identify the company.

• Name - full and abbreviated form (if applicable).
• Year of establishment / brief history - key milestones and turning points.
• Mission / values - main goals and principles of operation.
• Location / area of operation - addresses, regions, online vs. on-site.
• Business hours - days of the week, possible breaks, holiday exceptions.
• Contact channels - phone, email, chat, social media, web form.

Describe what the company does, who it serves, and what makes it stand out.

• Industry and specialization - main areas of operation (products, services).
• Target audience - customer segments, their needs and expectations.
• Unique selling proposition (USP) - what sets the company apart from competitors.

Present available products or services in a clear format.

• Main categories - major product lines or service packages.
• Subcategories and examples - selected products/services from each category.
• Parameters / variants - technical specifications, sizes, colors, service levels.
• Approximate prices - price ranges or sample price lists.

Describe order fulfillment procedures, support, and return policies.

• Delivery / service fulfillment - area, turnaround time, costs.
• Professional additional services - assembly, installation, training.
• Payment methods - available methods, possible installments or leasing.
• Complaints / returns / warranties - conditions, procedures, deadlines.

Define how the chatbot will convey information in line with your brand.

• Tone selection - formal, informal, expert, friendly.
• Language level - industry jargon vs. colloquial, avoiding unclear terms.
• Unique phrases - distinctive brand phrases and slogans.
• Consistency - maintaining a uniform style throughout the description.

If you're getting an error during webhook verification, the possible causes are:

• Incorrect webhook URL - make sure you copied it exactly from the AI Chatbot platform
• Incorrect verification token - check that the token was copied without extra spaces

To solve these problems:

1. Check the URL address and verification token carefully
2. Try resetting the access token on the Facebook Developers platform and update it in the chatbot configuration
3. Try deleting the chatbot on the ChatBotAssistant site and creating it again

If the webhook was verified but the chatbot is not receiving messages, possible causes are:

• No active subscription for the field "messages"
• No subscription for the page
• Application permission issues
• Application is in development mode

To solve these problems:

1. Make sure the field "messages" is in state "Subscribed" in the webhook configuration
2. Check if you added the subscription "messages" for your page
3. Verify that the application has all necessary permissions
4. Make sure the application is in live mode, not in development mode

Our platform offers advanced analytical tools that allow you to monitor and optimize chatbot performance:

• General statistics: total number of queries and sessions, average conversation length, average response time (with automatic comparison to the previous period)
• User activity: interactive charts (day/week/month) with zoom in/out functionality and traffic distribution by day of the week and hour
• User behavior: session length divided into ranges (1-2, 3-5, 6-10, 10+ messages) and return rate
• Popular topics analysis: Top 5 most frequently discussed topics with percentage share
• Optimization suggestions: automatically generated recommendations based on collected data
• Data export: ability to download reports for further analysis

To access analytics:

1. Log in to the chatbot administration panel
2. Go to the "Dashboard" section
3. Then scroll down to your chatbot list
4. Select the chatbot you're interested in and click the "Analytics" button
5. Browse detailed data and usage statistics for your chatbot

Facebook often rejects verification requests when the documentation is incomplete or imprecise:

• Missing or incomplete testing instructions
• Unclear description of application functionality
• No explanation of what the requested permissions will be used for
• Insufficient visual materials (screenshots, videos)

Solution: Prepare detailed documentation containing an exact description of chatbot functionality, step-by-step instructions for testers, and an explanation of why you need specific permissions. Include high-quality screenshots and demo videos.

An inadequate privacy policy is a common reason for rejection:

• Missing privacy policy or a broken link to it
• The policy doesn't explain what data is collected and how it is used
• No information about cookies and other tracking technologies
• Insufficient explanation of users' rights regarding their data

Solution: Make sure your privacy policy is complete, up-to-date, and compliant with GDPR and other data protection regulations. It should clearly explain what data the chatbot collects, how it is used, stored, and secured.

Facebook rejects requests when the application asks for permissions that are not essential for its functioning:

• Requesting access to data not used by the chatbot
• Requesting too broad a scope of permissions relative to the functionality
• No justification for the need for specific permissions

Solution: Only request permissions that are absolutely necessary for your chatbot to function. For each requested permission, prepare a clear justification explaining why it is needed and how it will be used.

Possible causes:

• The webhook is not properly configured or verified
• No active subscription for the "messages" field
• The Page Access Token has expired or is invalid
• The application is in development mode and the user is not a tester
• Network connection issues

Solution:

1. Check the webhook configuration - make sure the URL and verification token are correct
2. Verify that the "messages" field has "Subscribed" status both in the webhook configuration and in the page subscriptions
3. Generate a new page access token and update it in the chatbot configuration
4. If the application is in developer mode, make sure the testing user is added as a tester

Possible causes:

• Incorrect webhook URL
• Incorrect verification token

Solution:

1. Make sure the webhook URL is correct and does not contain extra spaces
2. Check that the verification token is exactly the same as the one generated on the ChatBotAssistant platform
3. Try resetting the access token on the Facebook Developers platform and update it in the chatbot configuration
4. Try deleting the chatbot on the ChatBotAssistant site and creating it again

Possible causes:

• Insufficient contextual data for the AI model (Company Information)
• Lack of support for specific scenarios in the chatbot configuration

Solution:

1. Expand the chatbot's knowledge base with additional scenarios and example questions
2. Add more synonyms and phrase variants to existing intents
3. Regularly analyze and test the chatbot based on analytics

Possible causes:

• Incomplete documentation or testing instructions
• Privacy policy issues
• Excessive permission requests without justification

Solution:

1. Carefully read the feedback from Facebook's review team
2. Prepare complete and detailed documentation containing step-by-step instructions
3. Make sure your privacy policy is complete and compliant with requirements
4. Only request permissions that are absolutely necessary and justify their need

Yes, you can integrate the chatbot with multiple Facebook pages. There are two approaches:

1. One Facebook application, multiple pages:
   • In the "Generate access tokens" section, you can add multiple pages to one application
   • You need to generate a separate access token for each page
   • On our platform, create a separate chatbot for each page using the appropriate token
   • This method is recommended when the chatbots have similar functionality
2. Multiple Facebook applications:
   • Create a separate Facebook application for each page
   • Perform the full integration process for each application
   • This method provides greater flexibility and isolation but requires more administrative work
   • It is recommended when chatbots have significantly different functionality or require different permissions

The choice of method depends on your specific needs and organizational structure.

Page Access Tokens can expire for various reasons:

• Standard tokens: Tokens generated directly from the Facebook Developers interface can expire after approximately 60 days
• Long-lived tokens: Tokens generated using the appropriate process can be valid for much longer, even up to several years
• Events forcing expiration: Changing the administrator's password, revoking application permissions, or changes in security configuration can cause premature token expiration

How to renew tokens:

1. Monitor the chatbot's operation - if it stops responding, it may indicate token expiration
2. In the Facebook Developers panel, go to the Messenger API settings and generate a new access token
3. Update the token in the chatbot configuration on our platform
4. Test the chatbot after updating the token to make sure it works correctly

Facebook Messenger offers limited visual customization options for chatbots:

• Profile icon: You can customize the chatbot's profile icon by changing the profile picture of your Facebook page
• Chatbot name: The chatbot name will be the same as your Facebook page name

There are several ways to monitor user interactions with the chatbot:

1. Analytics panel on the ChatBotAssistant platform:
   • General statistics: total number of queries and sessions, average conversation length, average response time (with automatic comparison to the previous period)
   • User activity: interactive charts (day/week/month) with zoom in/out functionality and traffic distribution by day of the week and hour
   • User behavior: session length divided into ranges (1-2, 3-5, 6-10, 10+ messages) and return rate
   • Popular topics analysis: Top 5 most frequently discussed topics with percentage share
   • Optimization suggestions: automatically generated recommendations based on collected data
   • Data export: ability to download reports for further analysis
2. Facebook Page Insights:
   • Total number of messages sent to your page
   • Demographic data of users using Messenger
   • Response times and engagement metrics
3. Data export and analysis:
   • Our platform allows exporting conversation data to CSV or JSON formats
   • You can analyze this data using external analytical tools
   • This allows you to create custom reports and in-depth analysis

Regular monitoring and analysis of this data will help you optimize the chatbot and better adapt it to user needs.