MxChat Forms

A form creation and collection add-on for MxChat Pro, enabling chatbot-triggered form collection within WordPress.

== Description ==

Documentation | MxChat Pro

MxChat Form Collection Add-on is a powerful extension for MxChat Pro, designed to enhance your WordPress chatbot with seamless form creation and collection capabilities. This add-on integrates directly with MxChat’s action recognition system, allowing you to trigger custom forms based on user conversations for lead capture, support tickets, surveys, and more.

Key Features

• Custom Form Creation: Build forms with multiple field types (text, dropdowns, checkboxes, etc.) to suit your needs.
• Automatic Action Integration: Forms are tied to MxChat’s action system, triggering naturally during chats based on user input.
• Message-Based Triggers: Trigger forms after a specific number of messages for more controlled interactions.
• Role-Specific Forms: Restrict form triggers to specific WordPress user roles for targeted data collection.
• Chat Input Blocking: Block chat input until the form is submitted, ensuring complete responses.
• Custom Email Notifications: Set custom email addresses for submission notifications instead of the default WordPress admin email.
• Chat Transcript Inclusion: Automatically include chat transcripts with submissions via an attached .txt file.
• Similarity Intent Control: Adjust and fine-tune the similarity intent threshold directly from the form edit page.
• Real-Time Display: Forms appear dynamically in the chat interface for a smooth user experience.
• Submission Management: Collect and manage form submissions with ease, including CSV export functionality.
• Pro-Only Integration: Exclusively available for MxChat Pro users, enhancing the core chatbot experience.

Perfect for businesses looking to streamline lead generation, customer support, or data collection, this add-on makes your chatbot more interactive and functional.

== Installation ==

1. Upload the mxchat-forms folder to the /wp-content/plugins/ directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Ensure MxChat Basic and an active MxChat Pro license are installed and configured.
4. Access the Form Collection settings via the MxChat menu in your WordPress admin panel.

== Frequently Asked Questions ==

What do I need to use this add-on?

You’ll need WordPress 5.0 or higher, the MxChat Basic plugin installed and activated, an active MxChat Pro license, and PHP 7.4 or higher.

How do I create a form?

Navigate to MxChat > Form Collection in your WordPress admin, click "Create New Form," add your desired fields and trigger phrases, then save.

How are forms triggered in the chatbot?

Forms are automatically integrated with MxChat’s action system. When a user’s message matches a form’s trigger phrases, the form appears in the chat interface.

Can I export form submissions?

Yes, submissions can be viewed in the Submissions table and exported as a CSV file for further analysis or record-keeping.

Where can I get support?

Visit https://mxchat.ai/support or contact our support team for assistance.

== Screenshots ==

(Note: Screenshots will be added in future updates)

== Changelog ==

= 1.0.6 =

• Minor bug fix: duplicating message count.

= 1.0.5 =

• Minor bug fix with updating.

= 1.0.4 =

• Added ability to trigger forms based on a specific number of messages.
• Added option to restrict form triggers to specific WordPress user roles.
• Added chat input blocking until form submission is complete.
• Added custom email notification settings for form submissions.
• Added chat transcript attachment (.txt file) with form submissions.
• Added similarity intent threshold control in the form edit page.

= 1.0.3 =

• Fixed UI issue with text not visible on certain buttons.

== Upgrade Notice ==

= 1.0.6 =

• Introduces new features including message-based form triggers, role-specific forms, chat input blocking, custom email notifications, chat transcript attachments, and similarity intent threshold control. Update for enhanced functionality and control.

== License & Warranty ==

This plugin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This plugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

== Credits ==

This plugin was developed by MxChat. No additional third-party libraries are included in this version.