=== Chat App Brasil ===
Contributors: lupee
Tags: woocommerce, notifications, abandoned cart, chat, mensagens
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.7.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automação de mensagens para WooCommerce via ChatAppBrasil. Notificações de pedidos, carrinho abandonado, botão flutuante e disparos em massa.

== Description ==

**Chat App Brasil** é a integração oficial do WooCommerce com a plataforma [ChatAppBrasil](https://chatappbrasil.com/), permitindo que você envie mensagens WhatsApp automaticamente para seus clientes diretamente do seu site ou loja.

Sem complicações técnicas, sem APIs complexas — basta inserir seu Access Token e começar a enviar.

= Por que usar o Chat App Brasil? =

O WhatsApp é o principal canal de comunicação no Brasil. Com este plugin você alcança seus clientes onde eles já estão, no momento certo, com a mensagem certa — de forma automática.

> **Requer uma conta ativa em [chatappbrasil.com](https://chatappbrasil.com/).** Crie sua conta gratuitamente e obtenha seu Access Token para começar.

---

= 🛒 Notificações automáticas de pedido (WooCommerce) =

Configure uma mensagem diferente para cada status de pedido e o plugin disparará automaticamente quando o status mudar:

* **Novo pedido** — enviado na página de agradecimento, logo após a compra
* **Pedido pendente** — aguardando pagamento
* **Pedido em espera** — pagamento aguardando confirmação manual
* **Pedido processando** — pagamento confirmado, em separação
* **Pedido completo** — entregue ou finalizado
* **Pedido cancelado, reembolsado ou com falha**
* **Nota do pedido** — quando o lojista adiciona uma observação ao pedido
* **Notificação para o administrador** — receba uma cópia de cada pedido no seu WhatsApp
* **Status personalizados** — compatível com qualquer status customizado criado por outros plugins

Todas as mensagens suportam **spintax** `{Olá|Oi|Bom dia}` para variações aleatórias, e **tags dinâmicas** como `%billing_first_name%`, `%order_total%`, `%product_name%` e [mais de 20 variáveis disponíveis](https://chatappbrasil.com/).

---

= 🛒 Recuperação de carrinho abandonado =

Requer [CartBounty Free ou Pro](https://wordpress.org/plugins/woo-save-abandoned-carts/). Detecta automaticamente a versão instalada e ativa os follow-ups correspondentes:

* Até **3 mensagens de follow-up** com intervalo configurável em horas
* Mensagem de **pós-venda (aftersales)** enviada X horas após a conclusão do pedido — ideal para pedir avaliações ou oferecer um próximo produto

---

= 💬 Botão flutuante WhatsApp =

Um botão de WhatsApp moderno e configurável para qualquer página do seu site:

* Ícone SVG inline — sem imagens externas, carrega instantaneamente
* **4 posições** disponíveis (cantos da tela) com offset horizontal e vertical ajustáveis
* Tamanho configurável de 40 a 200 px
* **Efeito pulsante** para chamar atenção
* **Tooltip** com texto personalizável
* **Mensagem pré-preenchida** — o cliente abre o WhatsApp já com a mensagem digitada
* Ocultar em dispositivos móveis, desktop ou em páginas específicas
* **Rastreamento de cliques** com painel de estatísticas (total, hoje, últimos 7 dias)

---

= 📋 Integração com formulários =

**Contact Form 7** — A aba WhatsApp aparece diretamente no editor do formulário. Configure número, mensagem e imagem usando as tags do CF7 como `[your-name]` e `[your-tel]`. Cada formulário tem sua própria configuração independente.

**Caldera Forms** — Mesmo conceito, com painel nativo no editor. Usa `{slug}` no lugar de `[tag]`, e o painel lista automaticamente todos os campos disponíveis no formulário para facilitar a configuração.

---

= 🛍️ Easy Digital Downloads =

Para lojas de produtos digitais:

* Campo de telefone adicionado automaticamente no checkout do EDD
* **Notificação de novo pedido** — enviada na página de recibo
* **Notificação de pedido completo** — enviada quando o pagamento é confirmado

---

= 💳 Mercado Pago PIX =

Integração nativa com o plugin **WooCommerce Mercado Pago** (versão 8.x):

* Detecta automaticamente pedidos pagos via PIX
* Envia o **código copia e cola** do PIX diretamente por mensagem
* Envia o **QR code** como imagem junto com a mensagem
* Tag especial `%pix_code%` disponível na mensagem configurada
* Funciona com o gateway `woo-mercado-pago-pix`
* Se o plugin Mercado Pago não estiver instalado, o painel exibe um aviso informativo com link de instalação
* QR code temporário excluído automaticamente em 30 minutos via cron


= 📢 Disparos em massa =

Envie mensagens WhatsApp para uma lista de contatos diretamente do painel:

* **Compartilhar posts** — envie links de posts para uma lista de números
* **Compartilhar produtos** — envie produtos da loja com imagem e link
* **Mensagem para clientes** — importe clientes do WooCommerce ou cole uma lista personalizada
* Suporte a `%fname%` e `%lname%` para personalização por nome

---

= 📊 Logs e monitoramento =

* Histórico completo de todas as mensagens enviadas
* Status de cada envio (sucesso ou erro)
* Paginação com 25 registros por página
* Reenvio com um clique diretamente do log
* Exportação e limpeza do histórico

---

= 🔒 Segurança e boas práticas =

* Token validado antes de liberar acesso às funcionalidades
* Todas as entradas sanitizadas com `wp_unslash()` e `sanitize_*`
* Nonces em todos os formulários e ações AJAX
* Token nunca exposto no frontend — requisições à API feitas exclusivamente via PHP
* Compatível com **HPOS** (High-Performance Order Storage do WooCommerce 7.1+)
* Integração com a **Política de Privacidade** nativa do WordPress

---

= Serviço externo =

Este plugin transmite dados (número de telefone, mensagem, imagem) para a API da plataforma **ChatAppBrasil** (`https://api.chatappbrasil.com`) exclusivamente para viabilizar o envio de mensagens WhatsApp. Nenhum dado é armazenado além do necessário para o processamento.

* [Termos de Uso](https://chatappbrasil.com/termos)
* [Política de Privacidade](https://chatappbrasil.com/privacidade)

É necessária uma conta ativa em [chatappbrasil.com](https://chatappbrasil.com/) com um Access Token válido.

---

= Compatibilidade =

* WordPress 6.0+
* WooCommerce 7.0+ com suporte total a HPOS
* PHP 7.4+
* Contact Form 7 (qualquer versão recente)
* Caldera Forms (qualquer versão recente)
* Easy Digital Downloads (qualquer versão recente)
* CartBounty Free e Pro

== Installation ==

**Via painel WordPress (recomendado)**

1. Acesse **Plugins → Adicionar Novo → Enviar Plugin**.
2. Selecione o arquivo `.zip` e clique em **Instalar Agora**.
3. Ative o plugin.
4. Acesse **Chat App Brasil → Configuração**, insira seu Access Token e clique em **Testar Conexão**.
5. Configure as mensagens em **Chat App Brasil → Notificações**.
6. Personalize o botão em **Chat App Brasil → Botão WhatsApp**.

**Instalação manual (FTP/SFTP)**

1. Descompacte o `.zip`.
2. Envie a pasta `chat-app-brasil` para `/wp-content/plugins/`.
3. Ative o plugin em **Plugins** no painel WordPress.

**Primeiro uso**

Após ativar, acesse **Chat App Brasil → Configuração**. Insira seu Access Token obtido em [chatappbrasil.com](https://chatappbrasil.com/), clique em **Testar Conexão** para validar e liberar todas as funcionalidades.

== Frequently Asked Questions ==

= Preciso de alguma conta para usar o plugin? =

Sim. É necessária uma conta ativa na plataforma [ChatAppBrasil](https://chatappbrasil.com/) com um Access Token válido. O cadastro pode ser feito diretamente no site.

= O botão flutuante não aparece no site. =

Verifique se o número de telefone está preenchido em **Chat App Brasil → Botão WhatsApp**. Sem número o botão não é exibido. Confira também se o botão não foi ocultado para o dispositivo ou página atual nas configurações.

= As mensagens não são enviadas. =

1. Certifique-se de que o Access Token foi validado com sucesso em **Chat App Brasil → Configuração**.
2. Verifique se a mensagem do status correspondente não está em branco em **Notificações**.
3. Consulte o histórico em **Chat App Brasil → Logs de mensagens** para ver o status de cada envio.

= A aba WhatsApp não aparece no editor do Contact Form 7. =

Certifique-se de que o plugin Chat App Brasil está ativo. A aba é adicionada automaticamente ao editor de qualquer formulário CF7.

= Como usar o Caldera Forms? =

Abra o editor do formulário no Caldera, clique na aba **WhatsApp** e configure usando `{slug_do_campo}`. O painel exibe todos os slugs disponíveis naquele formulário.

= O carrinho abandonado não envia. =

Instale o plugin [CartBounty Free](https://wordpress.org/plugins/woo-save-abandoned-carts/) ou Pro e configure as mensagens em **Notificações → Carrinho Abandonado**. Verifique também se o cron do WordPress está funcionando (recomendamos o plugin WP Crontrol para diagnóstico).

= Posso usar em mais de um site? =

Sim, desde que cada instalação tenha um Access Token válido associado à respectiva instância na plataforma ChatAppBrasil.

= O plugin é compatível com HPOS do WooCommerce? =

Sim. A compatibilidade com High-Performance Order Storage é declarada automaticamente e testada com WooCommerce 7.1+.

= Como envio mensagens com imagem? =

Em qualquer campo de imagem nas configurações de notificação, insira a URL da imagem ou use o botão de upload para selecionar uma da biblioteca de mídia. A imagem é enviada como anexo junto com a mensagem.

== Screenshots ==

1. Painel de configuração com validação de token e status da conexão
2. Notificações — accordion com todos os status de pedido e indicador ativo/inativo
3. Botão flutuante com preview ao vivo e estatísticas de cliques
4. Logs de mensagens com status, paginação e reenvio
5. Configuração de carrinho abandonado e pós-venda
6. Aba WhatsApp no editor do Contact Form 7

== Third-party Libraries ==

Este plugin inclui as seguintes bibliotecas de terceiros:

**International Telephone Input v15.0.2**
* Repositório: https://github.com/jackocnr/intl-tel-input
* Licença: MIT — https://github.com/jackocnr/intl-tel-input/blob/master/LICENSE
* Arquivos: assets/js/intlTelInput.js, assets/css/intlTelInput.css, assets/js/utils.js

**jQuery Modal v0.9.1**
* Repositório: https://github.com/kylefox/jquery-modal
* Licença: MIT — https://github.com/kylefox/jquery-modal/blob/master/LICENSE
* Arquivo: assets/js/jquery.modal.min.js

== Changelog ==

= 2.7.3 - 05/2026 =
* Integração com Back In Stock Notifier for WooCommerce — envio automático de WhatsApp quando produto volta ao estoque
* Nova aba exclusiva "🔔 Back In Stock" em Notificações com gate bloqueado quando plugin não instalado
* Tags disponíveis: %name%, %product_name%, %product_url%
* Imagem do produto enviada automaticamente; opção de imagem fixa manual
* Corrigido link "Ver assinantes" na aba Back In Stock (URL correta: edit.php?post_type=cwginstocknotifier)
* Sistema de debug: wlp_debug_log() nos pontos de envio do Back In Stock

= 2.7.1 - 04/2026 =
* Tela de Logs com aba exclusiva para Carrinhos Abandonados — visualize todos os carrinhos com itens, dados do cliente e tempo de abandono
* Gate visual bloqueado na aba Carrinhos Abandonados quando CartBounty não está instalado
* Suporte completo ao CartBounty Free e CartBounty Pro (detecção automática)
* Envio automático dos 3 follow-ups de carrinho abandonado compatível com CartBounty Pro (wp_steps_completed) e Free (followup_1/2/3)
* Botão de reenvio manual por carrinho diretamente nos Logs
* Motivo de não envio exibido para cada carrinho (sem telefone, sem mensagem configurada)
* Integração com Mercado Pago PIX — envio automático do QR code e código copia e cola via WhatsApp após compra PIX
* Card informativo do Mercado Pago PIX quando plugin não está instalado
* Recurso de segurança: bloqueio de mensagens idênticas (deduplicação) — configurável em Configuração
* Recurso de segurança: limite de mensagens por minuto (rate limit) — configurável de 1 a 100
* Tags %product_name%, %cart_contents% e %cart_total% disponíveis nas mensagens de carrinho abandonado
* Card de tags disponíveis na aba Carrinho Abandonado das Notificações
* WLP_VERSION sincronizada com a versão do plugin
* flags@2x.png adicionado para suporte a telas Retina
* Arquivo .pot atualizado com novas strings (43 strings, sem flag fuzzy)
* Tradução en_US incluída (.po e .mo compilado)

= 1.5.0 - 04/2026 =
* Suporte completo a HPOS (WooCommerce 7.1+)
* Validação de token via API antes de liberar funcionalidades
* Botão flutuante com SVG inline (sem dependência de Lottie), offset configurável e efeito pulsante
* Logs em formato JSONL com paginação (25 por página) e reenvio com um clique
* Rastreamento de cliques disponível para visitantes não logados
* Integração Contact Form 7 corrigida — hooks wpcf7_editor_panels, wpcf7_after_save e wpcf7_before_send_mail
* Integração Caldera Forms implementada com painel nativo e resolução de {slug}
* Proxy PHP para ações de instância — token nunca exposto no JavaScript
* wp_localize_script substituindo variáveis JS inline
* register_setting com sanitize_callback para todos os campos
* wp_unslash() em todas as entradas $_POST
* SSL obrigatório nas chamadas cURL (CURLOPT_SSL_VERIFYPEER)
* Arquivo .pot com 40 strings para tradução
* Integração com wp_add_privacy_policy_content()
* Migração automática de dados para usuários que atualizam de versões anteriores
* Constante WLP_API_URL para endpoint da API
* Headers GPL e @package em todos os arquivos PHP

= 1.4 - 2024 =
* Funcionalidades de compartilhamento e disparos em massa.

= 1.1 - 04/2024 =
* Notificações automáticas via WhatsApp para WooCommerce.

= 1.0 - 07/2023 =
* Lançamento inicial do plugin.

== Upgrade Notice ==

= 1.5.0 =
Atualização importante com suporte a HPOS, correções de segurança, validação de token e integração corrigida com CF7 e Caldera Forms. Recomendada para todos os usuários.
