BK-186 · WA Chat + Console de Cancelamento

Escopo vivo

1. WA Chat

• herdar etiquetas do WhatsApp Business no chat admin
• manter apelidos manuais e fixacao de conversas sem conflitar com labels reais
• permitir vinculo manual de numero a cliente na propria conversa
• permitir editar mensagem enviada quando o historico possuir message_id
• persistir message_id e edited_at em whatsapp_mensagens para sustentar o recurso

1. Console de Cancelamento

• corrigir a primeira tela de cancelamento em admin/modulos/pecas/index.php
• impedir que a mensagem editada para compradores 3/4 seja sobrescrita ao gerar pre-visualizacao
• melhorar a UX para carregar o texto base assim que a sessao for escolhida

Arquivos alvo

• admin/modulos/bot/whatsapp.php
• admin/modulos/bot/stats.php
• bot/whatsapp/server.js
• bot/whatsapp/webhook.php
• includes/whatsapp_helper.php
• sql_updates/create_whatsapp_table.sql
• admin/modulos/pecas/index.php
• docs/LOCK.md

Observacoes

• trabalho regularizado em branch vps/BK-186-wa-chat-cancelamento
• orquestracao via CLIs (gemini e opencode) como apoio de analise, sem spawn_agent
• o painel Status WhatsApp agora tambem faz parte do escopo para recuperar sessao presa e exibir QR de reconexao

Entrega

• WA Chat
• labels reais do WhatsApp Business passaram a coexistir com apelidos manuais e conversas fixadas
• historico ganhou suporte a message_id / edited_at para edicao de mensagem enviada
• webhook/helper/schema foram alinhados para persistir o message_id
• Console de Cancelamento
• a primeira tela passou a preservar a mensagem editada na pre-visualizacao
• Runtime WhatsApp
• o microservico passou a expor estado authenticated/client_state
• admin/index.php e admin/whatsapp_qr.php passaram a parar o loop visual de QR antigo
• bot/whatsapp/server.js ganhou recovery automatico de bootstrap apos authenticated, evitando ficar preso sem READY

Validacoes

• node -c bot/whatsapp/server.js
• php -l admin/index.php
• php -l admin/whatsapp_qr.php
• php -l includes/whatsapp_helper.php
• systemctl restart rnt-whatsapp
• curl http://127.0.0.1:3033/status retornando connected / READY
• curl -H 'apikey: ...' http://127.0.0.1:3033/me retornando connected=true
• curl -X POST http://127.0.0.1:3033/check-number ... retornando exists=true

Observacao final

• o runtime ainda registra ruído de console sobre WAPhoneUtils, mas o recovery automatico recompõe Store/WWebJS e fecha o bootstrap com Conectado com sucesso!