Chat App Brasil
| 开发者 |
Luiz Mariano
lupeedesign |
|---|---|
| 更新时间 | 2026年6月6日 02:42 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
详情介绍:
常见问题:
Como enviar mensagem WhatsApp automática no WooCommerce?
Configure seu token em Chat App Brasil > Configuração e defina as mensagens em Chat App Brasil > Notificações. O WhatsApp é enviado automaticamente em cada mudança de status do pedido.
É possível enviar o QR code do PIX pelo WhatsApp?
Sim. O plugin integra com Mercado Pago PIX e Asaas PIX. O QR code é enviado automaticamente como imagem junto com o código copia e cola quando o pedido é criado.
Funciona com WhatsApp Business?
Sim. A plataforma ChatAppBrasil usa a API do WhatsApp Business. Você precisa de uma conta ativa em chatappbrasil.com.
Como recuperar carrinho abandonado pelo WhatsApp?
Instale o CartBounty Free ou Pro, configure os follow-ups na aba Carrinho Abandonado e o plugin envia mensagens automáticas via WhatsApp para clientes que abandonaram o carrinho.
Posso enviar código de rastreamento pelo WhatsApp?
Sim. Instale WooCommerce Correios ou Melhor Envio. Quando o pedido for concluído com código de rastreio, o plugin envia automaticamente na aba Rastreamento.
O botão não aparece
Preencha o número em Chat App Brasil > Botão.
Mensagens não enviadas
Confirme o Access Token, verifique os Logs e certifique que a mensagem não está vazia. Veja se há alerta de "Envios pausados" no painel.
PIX Asaas não envia
Verifique se o plugin WooCommerce Asaas está ativo e se o método de pagamento do pedido é "asaas-pix". O meta __ASAAS_ORDER precisa estar salvo.
Tracking não envia
O código de rastreio precisa estar disponível no momento em que o pedido é marcado como Concluído. Verifique se WooCommerce Correios ou Melhor Envio está ativo e com código cadastrado no pedido.
Vi "Envios pausados"
WhatsApp desconectado. Acesse dashboard.chatappbrasil.com, reconecte e clique em "Reativar envios" no alerta do painel.
更新日志:
3.2.1
- CONFIABILIDADE: Lembretes de PIX (Mercado Pago e Asaas) migrados do WP-Cron para o Action Scheduler — funciona mesmo com DISABLE_WP_CRON=true e WP Rocket, pois o AS tem runner próprio ativado por requisições AJAX, REST e admin
- CONFIABILIDADE: Dupla garantia para lembretes PIX — além do AS, uma fila em wp_options é processada em toda requisição WordPress (frontend, admin, AJAX), garantindo disparo em segundos independente de cron ou tráfego
- CONFIABILIDADE: Trava de idempotência (transient 2h) impede duplo envio quando Action Scheduler e fila de requests disparam o mesmo lembrete quase simultaneamente
- CONFIABILIDADE: Helpers internos wlp_schedule_single e wlp_unschedule_all com fallback automático para WP-Cron quando o Action Scheduler não estiver disponível
- CORRECAO: Quando um pedido PIX é cancelado pelo gateway (PIX expirado sem pagamento), a mensagem de "PIX expirado" é enviada IMEDIATAMENTE via hook woocommerce_order_status_cancelled — antes dependia do AS executar ação agendada, podendo demorar minutos sem avisar o cliente
- CORRECAO: Notificação de novo pedido (wlp_wa_order_receive) agora passa order_id corretamente para o log e para as notas de pedido
- LIMPEZA: Removido método morto wlp_mp_pix_delayed_send que tinha hook registrado mas nunca era chamado
- MELHORIA: Toda mensagem WhatsApp relacionada a pedidos (status, PIX, lembrete, expirado, rastreamento, novo pedido) registra automaticamente nota privada no pedido WooCommerce com: fonte, telefone mascarado, status de envio, prévia e link ↺ Reenviar
- LOG: wlp_debug_log registra agendamento via AS ou WP-Cron (fallback), aviso se AS indisponível, e cada disparo da fila de requests com atraso em segundos
- DIAGNÓSTICO: Relatório de debug exibe status do Action Scheduler (versão, disponibilidade, ações pendentes do plugin)
- NOVO: Notificação do admin e formulários CF7/Caldera aceitam múltiplos números separados por vírgula — envia para cada destinatário individualmente
- SEGURANÇA: Verificação do header Content-Length antes do download de imagens externas — rejeita arquivos acima de 2 MB sem desperdiçar banda
- SEGURANÇA: Rate limiting por IP no endpoint de rastreamento de cliques do botão (máx. 10 cliques/hora por IP) para evitar flood na tabela
- SEGURANÇA: Hash de deduplicação migrado de MD5 para SHA-256
- SEGURANÇA: Construção da URL do botão WhatsApp corrigida (esc_url_raw em vez de esc_attr) e número sanitizado com regex antes de compor a URL
- CONFIABILIDADE: file_put_contents do QR PIX verifica retorno e registra erro no log de debug se a escrita falhar
- CONFIABILIDADE: Resposta HTTP 4xx/5xx da API ChatAppBrasil agora é tratada como erro (antes era registrada como sucesso se o JSON fosse válido)
- CONFIABILIDADE: Lock do cron de carrinho abandonado usa transient atômico (além do UPDATE condicional) para prevenir envios duplicados em crons paralelos
- CONFIABILIDADE: normalize_phone_number valida tamanho mínimo (DDI + 7 dígitos) e máximo (15 dígitos E.164) — números inválidos são descartados antes de chegar à API
- FLEXIBILIDADE: Timeouts da API (60s) e de download de imagens (30s) agora são configuráveis via filtros wlp_api_timeout e wlp_download_timeout
- LIMPEZA: Blocos de comentário vazios remanescentes da refatoração para traits removidos de wlp-main.php
- CORRECAO: Adicionado o callback que faltava para o retry do Asaas PIX (wlp_asaas_pix_retry). Antes o evento era agendado quando o meta __ASAAS_ORDER ainda nao estava salvo, mas nunca era tratado, e a mensagem podia nunca ser enviada
- CORRECAO: A deduplicacao deixou de bloquear lembretes, PIX expirado e reenvios manuais (envios com parametro resend), que agora sempre passam
- MELHORIA: Unificado o log das mensagens de Back In Stock (removida a gravacao manual duplicada); agora ha um unico registro por envio, identificado como Back in Stock e com o nome do cliente
- MELHORIA: A aba Debug agora exibe um quadro fixo com as integracoes suportadas e suas versoes instaladas (Melhor Envio, Mercado Pago, Asaas, Correios, CartBounty, Back In Stock Notifier, WooCommerce, etc), indicando ativo/nao instalado, alem da versao do plugin, do WordPress e do PHP
- CORRECAO: Back In Stock voltou a disparar o WhatsApp quando o e-mail de retorno ao estoque e enviado. O handler resolvia o produto do assinante por uma chave de meta errada (cwginstock_product_id) e abortava; agora usa cwginstock_pid/cwginstock_bypass_pid. Tambem passou a ouvir os eventos de envio automatico e manual (cwginstock_auto_email_sent e cwginstock_manual_email_sent)
- MELHORIA: Nova aba Back In Stock no log, no mesmo estilo dos Carrinhos abandonados, listando os assinantes elegiveis (com telefone) com status "Aguardando estoque" (ampulheta), "E-mail enviado" e "WhatsApp enviado", alem do status de estoque atual do produto
- CORRECAO: PIX expirado nao era agendado quando o modo de envio estava em "Lembrete" (a funcao retornava antes de agendar). Agora o PIX expirado e agendado em qualquer modo, no Mercado Pago e no Asaas
- CORRECAO: A mensagem de PIX expirado nunca disparava porque exigia o pedido em pending/on-hold, mas ao expirar o gateway ja cancela o pedido. Agora ela e enviada a menos que o cliente tenha pago (processando/concluido/reembolsado)
- MELHORIA: Back In Stock mais robusto na leitura do telefone do assinante (tenta multiplas chaves de meta, incluindo subscriber_phone) e o cron deixou de excluir assinantes por causa do nome da chave de telefone
- MELHORIA: Log de mensagens agora tem busca por nome, telefone ou numero do pedido, e filtro por tipo de mensagem (pedido concluido, processando, falhou, aguardando, PIX gerado, envio de rastreio, carrinho abandonado, assinatura, Back in Stock, etc). A busca e o filtro respeitam a paginacao
- MELHORIA: Cada envio agora registra o nome do cliente no log e a mensagem de carrinho abandonado passou a ser identificada como tal (antes caia em "Pedido")
- CORREÇÃO: Deteccao do plugin Melhor Envio na aba Rastreamento. O plugin verificava o arquivo melhor-envio-cotacao.php (inexistente) e a classe MelhorEnvio\MelhorEnvio (inexistente), exibindo "nao esta instalado ou ativo" mesmo com o Melhor Envio ativo. Agora detecta pela constante MELHORENVIO_VERSION, pela classe Melhor_Envio_Plugin e pelo arquivo correto melhor-envio-beta.php
- CORREÇÃO: Lembrete de carrinho abandonado não é mais enviado quando o cliente já fez a compra. Antes de disparar, o plugin verifica via wc_get_orders (compatível com HPOS) se já existe pedido pago (processando ou concluído) para o e-mail ou telefone do carrinho e, em caso positivo, marca o carrinho como concluído para não reenviar
- UX: Tela de Carrinhos abandonados passa a ocultar carrinhos sem número de telefone e a exibir apenas carrinhos criados após a ativação do plugin (wlp_install_date). Contagem e paginação ajustadas aos mesmos filtros
- UX: Carrinhos que viraram venda agora exibem o selo "(recuperado)" na coluna Status WA e um aviso no detalhe; o botão de envio manual fica oculto nesses casos
- FILTRO: Novo hook wlp_converted_order_statuses para personalizar quais status de pedido contam como "já comprou" (padrão: processando e concluído)
- ARQUITETURA: wlp-main.php refatorado de 3.300 para 1.942 linhas com separação em 7 PHP Traits
- ARQUITETURA: Criado includes/trait-wlp-api.php — HTTP client, send_msg, process_variables, QR image
- ARQUITETURA: Criado includes/trait-wlp-orders.php — process_states, order_receive, resend
- ARQUITETURA: Criado includes/trait-wlp-payments.php — MP PIX, Asaas PIX, Asaas Boleto, expirados
- ARQUITETURA: Criado includes/trait-wlp-cart.php — CartBounty, abandoned_order, aftersales
- ARQUITETURA: Criado includes/trait-wlp-subscriptions.php — 7 eventos de assinatura WCS
- ARQUITETURA: Criado includes/trait-wlp-tracking.php — Correios e Melhor Envio
- ARQUITETURA: Criado includes/trait-wlp-bis.php — Back In Stock + watchers + cron
- PERFORMANCE: CSS do painel extraído para assets/css/wlp-admin.css (cache do browser)
- PERFORMANCE: Endpoint público AJAX get_base_url removido; URL injetada via wp_localize_script
- PERFORMANCE: Limpeza de cliques (90 dias) movida do AJAX público para cron diário
- SEGURANÇA: Validação de tamanho (máx. 2 MB) e MIME (JPEG/PNG/WebP/GIF) antes do envio de mídia
- CORREÇÃO: Normalização de posição do botão agora aplica corretamente o mapa de variantes legadas
- LIMPEZA: Variável $curl_err morta removida
- LIMPEZA: UI de wlp_autoresponders sem backend removida do JS administrativo
- CONFIABILIDADE: Watchers BIS (save_post, meta, transition_post_status) registrados como hooks
- UX: Aba "📚 Tags" adicionada ao painel de Notificações com referência completa de variáveis
- UX: Frequência do cron de carrinho abandonado configurável na tela de Segurança (1/2/5/10 min)
- DEPRECIADO: wlp_bis_legacy_hook(), remove_emoji(), wlp_wa_encoding() marcados @deprecated
- PERFORMANCE: Cron do carrinho abandonado configurável (1, 2, 5 ou 10 min) com padrão de 5 min
- CONFIABILIDADE: Watchers BIS registrados como hooks formais (save_post, updated_post_meta, transition_post_status)
- DEPRECIADO: wlp_bis_legacy_hook(), remove_emoji(), wlp_wa_encoding() marcados com @deprecated
- UX: Aba "📚 Tags" exposta no painel de Notificações (render_help)
- SEGURANÇA: Endpoint público AJAX get_base_url removido; URL injetada via wp_localize_script
- PERFORMANCE: DELETE de retenção de cliques movido do AJAX para cron diário wlp_button_cleanup_clicks
- SEGURANÇA: Validação de tamanho (máx. 2 MB) e MIME antes do envio de mídia
- LIMPEZA: Variável $curl_err morta removida
- CORREÇÃO: Normalização de posição do botão aplica corretamente $pos_map[$val]
- LIMPEZA: UI wlp_autoresponders removida do JS (backend nunca implementado)
- SEGURANÇA: MD5 substituído por wp_hash() na validação do Access Token
- SEGURANÇA: @unserialize substituído por is_serialized() + allowed_classes false
- SEGURANÇA: cURL manual substituído por WP_Http no envio de imagens
- PERFORMANCE: Hook admin_init de migração com guard (só registra se necessário)
- LIMPEZA: Lottie Player removido (hook + método enqueue_lottie)
- CORREÇÃO: Posições do botão normalizadas (left-bottom → bottom-left)
- LIMPEZA: uninstall.php remove logs JSONL, flags de migração e transients
- SEGURANÇA: MD5 substituído por wp_hash() (HMAC-SHA256) na validação do Access Token
- SEGURANÇA: @unserialize substituído por verificação com is_serialized() + allowed_classes false
- SEGURANÇA: cURL manual substituído por WP_Http (wp_remote_post) no envio de imagens
- SEGURANÇA: Todos os dados de log já usam esc_html() na renderização (proteção XSS)
- PERFORMANCE: Hook admin_init de migração agora só registra se a migração ainda não ocorreu
- PERFORMANCE: Código morto do Lottie Player removido (hook + método enqueue_lottie)
- CORREÇÃO: Posições do botão flutuante normalizadas (left-bottom → bottom-left)
- LIMPEZA: uninstall.php agora remove logs JSONL, flags de migração e transients
- NOVO: Integração Asaas PIX — QR code + código copia e cola, modos imediato/lembrete
- NOVO: Integração Asaas Boleto — link do boleto via %boleto_url%
- NOVO: Notificação de PIX expirado — compartilhada entre Mercado Pago e Asaas
- NOVO: Aba Pagamentos — centraliza Mercado Pago PIX, Asaas PIX, Asaas Boleto e PIX Expirado
- NOVO: Aba Rastreamento — Correios e Melhor Envio com detecção automática
- NOVO: Tags %tracking_code%, %tracking_url% — código e link de rastreio
- NOVO: Tags %order_status%, %order_time%, %payment_url% — novas tags para mensagens
- CORRIGIDO: Notificação de "envios pausados" aparecia duplicada no painel admin
- ATUALIZADO: readme.txt e readme-en_US.txt completos para v2.9.0
- NOVO: Lembrete PIX, notas privadas nos pedidos, toggle por notificação
- NOVO: Linhas expansíveis nos logs, monitoramento de erros, friendly errors
- CORRIGIDO: Estatísticas de logs, quebra de linha CF7, botão Limpar Logs
- Rate limiting, filtro de horário, dedup configurável, Back In Stock, debug mode
- Compatibilidade HPOS, wc_get_order(), WC_Order API
- Botão flutuante SVG com preview, rastreamento de cliques
- Lançamento inicial