Chat App Brasil

Описание

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

Установка

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.

Часто задаваемые вопросы

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.

Отзывы

Посмотреть 1 отзыв

Участники и разработчики

«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.