=== Botleads ===
Contributors: roboticon
Tags: lead capture, contact form, crm, leads, form builder
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build lead capture forms in WordPress and send every submission straight to your Botleads account.

== Description ==

This is the official WordPress plugin for [Botleads](https://www.roboticon.com.br/botleads.html), developed and maintained by [Roboticon](https://www.roboticon.com.br/), the company that owns and operates Botleads.

Botleads is a lead management platform (CRM) for sales teams. With this plugin, the contacts that arrive through your website go straight to your Botleads dashboard and to your sales team. You build the form inside WordPress, place it on a page and every visitor who fills it in becomes a lead in Botleads.

= Features =

* **Ready-made templates.** Start from Contact, Quote request, Callback or Blank, then adjust the fields.
* **Field mapping.** Name, email and phone go to the right lead fields. Every other question goes to the lead history.
* **Match your site.** Pick the button color and the form background. Text color adjusts automatically to stay readable.
* **Live preview.** See the form and the confirmation message exactly as visitors will.
* **One-click publishing.** Create a new page with the form already on it, or paste the shortcode on any page.
* **No lost contacts.** If Botleads does not accept a submission, it stays saved in the plugin with the reason. Fix the reason and resend one by one or all at once.
* **Live status.** The plugin screen shows whether the connection is active, how many contacts were delivered and which ones are waiting, without reloading the page.
* **Existing forms (optional).** Submissions from forms already on the site (Elementor, Contact Form 7, plain HTML) can also be captured. This is turned off on new installs.

A Botleads account is required.

== External services ==

This plugin connects to the Botleads API to deliver the leads collected by your forms to your own Botleads account. Nothing is sent until the site owner connects the plugin with the credentials from their Botleads dashboard (hash key, API URL and company code).

What is sent and when:

* When the site owner connects or checks the connection: the hash key and company code, to confirm the account.
* When a form is first shown on a public page: the form name, its field names and the page URL, so the form appears in the Botleads dashboard.
* When a visitor submits a form: the values the visitor typed (usually name, email and phone, plus any other questions in the form), the form name and the page URL.

Everything is sent from the site's server through the WordPress HTTP API. The hash key and company code stay on the server and are never printed on public pages. If the API rejects a submission from a form built with this plugin, it is stored in the site's database so the owner can resend or delete it from the plugin screen.

The optional "capture existing forms" feature (off on new installs) adds a small script to public pages. It sends the fields and the submissions of other forms on the site (Elementor, Contact Form 7, plain HTML) to the site's own REST API, which forwards them to Botleads.

The service is Botleads, owned and operated by Roboticon Soluções Digitais: [Botleads](https://www.roboticon.com.br/botleads.html), [Privacy Policy](https://botleads.app/privacy-policy).

== Installation ==

1. Upload the plugin through Plugins > Add New > Upload Plugin, then activate it.
2. Open the Botleads menu, go to the Connection tab and paste the Hash key, API URL and Company code. They are in your Botleads dashboard under Settings > Integrations > WordPress.
3. Create a form from a template and place it on a page.
4. In the Botleads dashboard, activate the form and choose the product. From then on, contacts arrive automatically.

== Frequently Asked Questions ==

= Do I need to know how to code? =

No. Everything is done in the plugin screen, with templates and a live preview.

= What happens if the connection drops? =

Contacts stay saved in the plugin and can be resent when the connection is back. None are lost.

= Can I pause sending? =

Yes. In Connection > More options you can pause sending. Contacts are kept until you resume.

== Screenshots ==

1. See the whole path of a lead, from your site to your sales team.
2. Start from a ready-made template.
3. Edit the fields, choose where each answer goes in the lead and preview the form live.
4. All your forms in one place, with status and delivered contacts.
5. The form on your site, using your theme fonts.

== Changelog ==

= 2.0.0 =
* New form builder with templates, field mapping, colors and live preview.
* One-click page creation and shortcode.
* Waiting contacts list with resend and delete per contact.
* Connection check and live status on the plugin screen.
* Capture of existing forms now goes through the site's server: credentials are no longer printed on public pages.

= 1.0.0 =
* Capture of existing forms on the site.
