Описание
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()esanitize_* - 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
Установка
Via painel WordPress (recomendado)
- Acesse Plugins Adicionar Novo Enviar Plugin.
- Selecione o arquivo
.zipe clique em Instalar Agora. - Ative o plugin.
- Acesse Chat App Brasil Configuração, insira seu Access Token e clique em Testar Conexão.
- Configure as mensagens em Chat App Brasil Notificações.
- Personalize o botão em Chat App Brasil Botão WhatsApp.
Instalação manual (FTP/SFTP)
- Descompacte o
.zip. - Envie a pasta
chat-app-brasilpara/wp-content/plugins/. - 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.
Часто задаваемые вопросы
-
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.
-
- Certifique-se de que o Access Token foi validado com sucesso em Chat App Brasil Configuração.
- Verifique se a mensagem do status correspondente não está em branco em Notificações.
- 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.
Отзывы
Участники и разработчики
«Chat App Brasil» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
УчастникиПеревести «Chat App Brasil» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
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.
