=== 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 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 - 04/2026 = * Suporte completo com CartBounty * Tela de logs exclusivos para carrinhos abandonados * Integração com Mercado Pago = 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.