WordPane Woo

Notificações de pedidos WooCommerce via WhatsApp

Envie notificações automáticas para os seus clientes via WhatsApp a cada mudança de status do pedido — com links de download seguros, templates personalizáveis e painel de administração completo.

wordpane.cloud

---

Visão Geral

O WordPane Woo conecta sua loja WooCommerce ao WhatsApp usando a API do WhatsPane / ZPro. Com ele, seus clientes recebem mensagens personalizadas no momento certo — desde a confirmação do pedido até a entrega dos arquivos digitais — sem precisar acessar o site ou fazer login em nenhuma conta.

---

Recursos

Notificações Automáticas por Status

Dispare mensagens WhatsApp em qualquer transição de status do pedido. Cada status pode ser ativado ou desativado de forma independente:

Status	Slug	Padrão
Aguardando Pagamento	pending	—
Em Processamento	processing	✅
Aguardando	on-hold	✅
Concluído	completed	✅
Cancelado	cancelled	✅
Reembolsado	refunded	✅
Falhou	failed	—

---

Templates de Mensagem Personalizáveis

Crie a mensagem perfeita para cada etapa usando variáveis dinâmicas. Os templates suportam formatação nativa do WhatsApp (*negrito*, _itálico_, emojis).

Variáveis disponíveis:

Variável	Descrição
{nome}	Nome completo do cliente
{numero_pedido}	Número do pedido
{total}	Valor total (ex: R$ 149,90)
{status}	Status atual do pedido
{itens}	Lista de produtos do pedido
{downloads}	Links de download seguros (pedidos concluídos)
{link_pedido}	URL da página do pedido
{email}	E-mail do cliente
{telefone}	Telefone do cliente

---

Download Seguro via WhatsApp

Para lojas que vendem produtos digitais, o plugin gera links de download exclusivos e os envia diretamente no WhatsApp do cliente — sem exigir login ou acesso à conta.

• Tokens únicos de 64 caracteres gerados com random_bytes
• Validade configurável (padrão: 7 dias)
• Limite de usos por link (padrão: 3 downloads)
• Verificação de número opcional — o cliente confirma o WhatsApp do pedido antes de baixar
• Fallback automático para a página do pedido caso o produto não tenha arquivo

---

Janela de Envio Programada

Evite incomodar clientes fora do horário comercial. Defina um intervalo de horário para que as mensagens só sejam disparadas dentro da janela permitida. Pedidos gerados fora desse período são registrados nos logs como skipped.

---

Painel Administrativo Completo

Interface moderna com tema WhatsApp Green, organizada em 5 abas:

Aba	Conteúdo
⚙️ Configurações	Credenciais da API, toggles por status, janela de envio, opções de download
✏️ Mensagens	Editor de templates com contador de caracteres e restauração do padrão
📋 Logs	Histórico de envios com filtro por nível (sucesso, erro, aviso), busca e paginação
📥 Downloads	Tabela de tokens gerados com status (ativo, expirado, esgotado) e links diretos
🧪 Teste	Envio manual de mensagem de teste + painel de diagnóstico da integração

---

Reenvio Manual de Notificações

Na aba de Logs, é possível reenviar manualmente uma notificação para qualquer pedido, escolhendo o status/template desejado — útil para testes e suporte ao cliente.

---

Formatação Automática de Números Brasileiros

O plugin normaliza automaticamente os números para o formato E.164 (+55...), adicionando DDI e o dígito 9 quando necessário. Funciona com números no formato (11) 9XXXX-XXXX, 11 XXXX-XXXX ou já com DDI.

---

Requisitos

Requisito	Versão mínima
WordPress	6.0
WooCommerce	7.0
PHP	7.4
PHP cURL	qualquer
Conta WhatsPane / ZPro	—

O plugin é compatível com o HPOS (High-Performance Order Storage) do WooCommerce.

---

Instalação

1. Faça o upload da pasta woo-wordpane para /wp-content/plugins/
2. Ative o plugin em Plugins → Plugins instalados
3. Acesse WordPane Woo no menu do WordPress
4. Na aba Configurações, insira a URL da API e o Bearer Token do WhatsPane

---

Configuração da API

O plugin utiliza a API do WhatsPane / ZPro para envio de mensagens.

Endpoint: POST https://api.whatspane.com.br/v2/api/external/{UUID}

Headers:

Authorization: Bearer {seu_token}
Content-Type: application/json

Payload:

{
  "externalKey": "wwn_<uniqid>",
  "number": "+5511912345678",
  "body": "Sua mensagem aqui"
}

---

Estrutura do Projeto

woo-wordpane/
├── woo-whatsapp-notifications.php   # Arquivo principal do plugin
├── includes/
│   ├── class-wwn-settings.php       # Gerenciamento de configurações (wp_options)
│   ├── class-wwn-api.php            # Cliente HTTP da API WhatsApp
│   ├── class-wwn-logger.php         # Logs em tabela {prefix}wwn_logs
│   ├── class-wwn-notifications.php  # Hooks WooCommerce e build de mensagens
│   └── class-wwn-secure-download.php# Tokens de download ({prefix}wwn_download_tokens)
└── admin/
    ├── class-wwn-admin.php          # Interface administrativa + handlers AJAX
    ├── views/
    │   └── page-main.php            # View HTML com as 5 abas
    ├── css/
    │   └── admin.css                # Tema moderno com WhatsApp Green
    └── js/
        └── admin.js                 # Tabs, AJAX, contador de chars, logs paginados

---

Tabelas do Banco de Dados

O plugin cria duas tabelas adicionais na ativação:

{prefix}wwn_logs — Histórico de todos os envios realizados pelo plugin.

{prefix}wwn_download_tokens — Tokens de download seguros gerados por pedido.

---

Autor

Desenvolvido por WordPane — Hospedagem e Tecnologia.

---

Feito com ❤️ para lojas WooCommerce brasileiras