=== Clixx CRM - Formulários para Captação de Leads ===
Contributors: clixxcrm
Tags: crm, formulários, leads, marketing, captação
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.5.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Conecte sua conta Clixx CRM ao WordPress e incorpore formulários de captação de leads em qualquer página ou postagem.

== Description ==

O plugin Clixx CRM conecta seu site WordPress à sua conta Clixx CRM, permitindo incorporar formulários de captação de leads diretamente em páginas e posts.

Você pode inserir formulários utilizando:

* Shortcode: `[clixxcrm_formulario hash="..."]`
* Bloco Gutenberg: "Formulário Clixx CRM"
* Código HTML incorporável (Embed) com personalização visual integrada

A conexão é realizada através do e-mail cadastrado no Clixx CRM e do token de API gerado dentro da plataforma.

O token é validado diretamente nos servidores do Clixx CRM para garantir que a conta pertença à empresa correta e possua uma assinatura ativa.

Os dados enviados pelos visitantes são transmitidos diretamente para o Clixx CRM. Nenhuma informação dos formulários é armazenada no banco de dados do WordPress.

### Principais Recursos

* Integração oficial com o Clixx CRM
* Captura automática de leads
* Bloco Gutenberg nativo
* Shortcodes para qualquer página ou post
* Formulários responsivos
* Código Embed para utilização em qualquer site
* Campos personalizados configurados no CRM
* Suporte a parâmetros UTM para rastreamento de campanhas
* Personalização visual dos formulários
* Integração simples e rápida

== Installation ==

1. Faça o upload da pasta `clixxcrm` para `/wp-content/plugins/` ou instale o plugin diretamente pelo painel do WordPress.
2. Ative o plugin na tela de Plugins.
3. Acesse o menu "Clixx CRM".
4. Informe o e-mail da sua conta e o token de API.
5. Após conectar, acesse "Clixx CRM > Formulários".
6. Copie o shortcode, iframe ou código Embed do formulário desejado.
7. Publique seus formulários em qualquer página ou postagem.

== External services ==

This plugin connects to the Clixx CRM SaaS platform (https://app.clixx.com.br), which provides the lead capture forms and CRM integration features used by this plugin.

The plugin communicates with Clixx CRM in the following situations:

1. **Account connection (admin only)**

When an administrator enters their email address and API token on the "Clixx CRM > Connection" screen, the plugin sends a POST request to:

`https://app.clixx.com.br/api/auth/verify`

Data sent:

* Account email address
* API token

Purpose:

* Validate the API token
* Identify the associated company account
* Verify that the subscription is active

2. **Listing forms (admin only)**

When accessing the "Clixx CRM > Forms" screen, the plugin sends a GET request to:

`https://app.clixx.com.br/api/anuncios`

Data sent:

* API token

Purpose:

* Retrieve the list of campaigns and forms available in the connected account

The response is cached for 5 minutes using the WordPress Transient API.

3. **Form submissions (website visitors)**

When a visitor submits a form embedded through the plugin, the data is sent directly to:

`https://app.clixx.com.br/api/webhook/inscricao/{hash}`

Data that may be transmitted:

* Name
* Email address
* Phone number
* Custom fields configured in Clixx CRM
* UTM parameters present in the URL

Important:

The plugin does NOT store form submission data in the WordPress database.

The data is sent directly from the visitor's browser to Clixx CRM servers.

Terms of Service:

https://app.clixx.com.br/terms-of-use.html

Privacy Policy:

https://app.clixx.com.br/privacy-policy.html

== Frequently Asked Questions ==

= Onde encontro meu token de API? =

No Clixx CRM, acesse Configurações > API e gere um novo token.

= O plugin armazena os dados dos visitantes no WordPress? =

Não. Todos os dados enviados pelos formulários são encaminhados diretamente para o Clixx CRM.

= Posso personalizar o visual dos formulários? =

Sim. A aba "Embed HTML" possui um personalizador visual que permite alterar cores, tipografia, espaçamentos e textos dos botões.

= O plugin funciona com o editor Gutenberg? =

Sim. O bloco "Formulário Clixx CRM" permite selecionar formulários e ajustar a altura do iframe diretamente pelo editor.

= Posso utilizar os formulários em outros sites além do WordPress? =

Sim. O código Embed HTML pode ser copiado e utilizado em qualquer site ou sistema compatível com HTML.

= Preciso ter uma conta no Clixx CRM? =

Sim. É necessário possuir uma conta ativa no Clixx CRM para utilizar os formulários e recursos de integração.

== Screenshots ==

1. Tela de conexão com a conta Clixx CRM.
2. Tela de listagem dos formulários disponíveis.
3. Personalização visual do formulário com preview em tempo real.

== Changelog ==

= 1.5.1 =

* Adequações para conformidade com as diretrizes do WordPress.org.
* Documentação completa dos serviços externos utilizados pelo plugin.
* Melhorias na estrutura administrativa e carregamento dos estilos do menu.
* Ajustes internos para aprovação no diretório oficial de plugins do WordPress.

= 1.5.0 =

* Correção do personalizador visual que não exibia corretamente campos personalizados configurados no CRM.

= 1.4.9 =

* Nome alterado para "Clixx CRM - Formulários para Captação de Leads".

= 1.0.0 =

* Lançamento inicial do plugin.
* Integração com Clixx CRM.
* Shortcode para formulários.
* Bloco Gutenberg nativo.
