Chat App Brasil

Description

Chat App Brasil é a integração oficial do WooCommerce com a plataforma ChatAppBrasil, 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. 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.

🛒 Recuperação de carrinho abandonado

Requer CartBounty Free ou Pro. 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.

É necessária uma conta ativa em 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

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

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, clique em Testar Conexão para validar e liberar todas as funcionalidades.

FAQ

Preciso de alguma conta para usar o plugin?

Sim. É necessária uma conta ativa na plataforma ChatAppBrasil 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 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.

Reviews

April 28, 2026
Gostamos bastante atende as expectativas, as mensagens são envidas em real time sem duvidas o melhor que testamos nos ultimos dias!
Read all 1 review

Contributors & Developers

“Chat App Brasil” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Chat App Brasil” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

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.