Facebook Messenger Chatbot for Prestashop 8 1.0.0

I'd like to express my gratitude to the community for sharing such valuable resources. My journey with PrestaShop has been incredibly educational. I'm excited to share a module I've developed that enables automatic responses to Facebook Messenger inquiries based on message keywords. This tool ensures your Facebook business page can instantly address frequent customer questions without delay.

My motivation for creating this solution came from two key challenges: Facebook's built-in keyword response system limits you to just one reply every quarter hour, and most available chatbots come with hidden costs or limitations. This module, by contrast, is completely free and straightforward, functioning seamlessly within PrestaShop as a self-contained system.

The setup process follows standard Facebook integration procedures - while it requires some initial patience, the instructions are designed to make the process accessible to anyone willing to learn. I hope you find this tool as useful as I have!




# Facebook Messenger Chatbot Module for PrestaShop 8.x

## Description
The Facebook Messenger Chatbot module allows your PrestaShop store to automatically respond to customer inquiries through Facebook Messenger. The module provides an easy-to-use interface to set up automated keyword-based responses, including support for interactive buttons.

## Key Features
- Automated keyword-based responses
- Support for multiple question patterns per response
- Text normalization to handle accents and case sensitivity
- Interactive buttons in responses (up to 3 per message)
- Detailed logging system to verify interactions
- Conversation storage for follow-up
- Intuitive admin interface

## Requirements
- PrestaShop 8.0 or higher
- PHP 7.4 or higher
- A Facebook page and Facebook application

## Installation Instructions

### 1. Module Installation
1. Download the module ZIP file
2. In the PrestaShop Admin Panel, go to "Modules > Module Manager"
3. Click "Upload a module"
4. Select the downloaded ZIP file
5. Once installed, click "Configure"

### 2. Facebook Application Setup

#### 2.1. Create a Facebook Application
1. Go to [developers.facebook.com](https://developers.facebook.com/)
2. Click "My Apps" > "Create App"
3. Select the "Business" type
4. Complete the required information and create the application

#### 2.2. Configure Messenger Permissions
1. In your app dashboard, go to "Add Products"
2. Select "Messenger"
3. In the Messenger settings:
- Go to "Access Tokens"
- Select or connect your Facebook page
- Generate a page access token
- Copy this token for use in the module configuration

#### 2.3. Configure the Webhook
1. In the Messenger settings, find "Webhooks"
2. Click "Add Callback URL"
3. In the "Callback URL" field, enter:
```
https://your-domain.com/module/fbmessenger/webhook```
4. In "Verify Token", enter the same token you configured in the module
5. Select these events:
- messages
- messaging_postbacks
- message_deliveries
- message_reads

#### 2.4. Request Review for pages_messaging Permission
1. Go to "App Review" > "Permissions and Features"
2. Request the `pages_messaging` permission
3. In the description, explain how your chatbot will help customers get quick, automated answers to their queries

### 3. Module Configuration
1. In the module configuration in PrestaShop:
- Enter the "Page Access Token" generated in Facebook
- Enter a "Verify Token" (any string, but must match the webhook configuration)
- Enter the "App Secret" of your Facebook application (found in Settings > Basic)
2. Save the configuration

### 4. Add Questions and Answers
1. In the "Predefined Questions and Answers" section of the module:
- Click "Add new Q&A"
- Enter the question pattern (you can use multiple patterns separated by |)
- Enter the response
- Add buttons if desired (maximum of 3)
- Activate the Q&A
- Save

## How It Works
- When a user sends a message to your Facebook page, the webhook receives the notification
- The module normalizes the text (removes accents, converts to uppercase, etc.)
- It looks for a match in the configured question patterns
- If it finds a match, it sends the configured response
- If buttons are configured, it sends them along with the response
- All interaction is logged and can be viewed in the logs section

## Troubleshooting
- If webhooks aren't working, check the logs in the corresponding section of the module
- Make sure the webhook URL is publicly accessible
- Verify that the tokens match in Facebook and the module configuration
- Check that the pages_messaging permission has been approved

## Limitations
- Facebook Messenger allows a maximum of 3 buttons per message
- Button titles must be 20 characters or less
- Responses are limited to text, buttons, and URLs (no file attachments)