Import ClientFlow production v4928.1.5.132.4

RELEASE_NOTES_v4928_1_5_25.md

@@ -0,0 +1,32 @@
+# v4928.1.5.25 — Chatwoot inbound ingestion recovery
+
+Correção focada no pipeline Chatwoot → ClientFlow.
+
+## Corrige
+
+- Emails inbound do Chatwoot são identificados por `payload.message_type = incoming`.
+- Deixa de depender de `sender.type = contact`, porque em webhooks de email esse campo pode vir vazio.
+- O webhook já não deixa eventos em `processed=false`, `ignored=false`, `processing_error=null` se o processamento levantar exceção.
+- Mensagens outgoing do operador sem task pendente deixam de contar como `processing_error`.
+- System health passa a mostrar `Chatwoot inbound pendente`.
+
+## Scripts
+
+- `scripts/reprocess_pending_chatwoot_raw_events.py`
+  - Reprocessa inbound pendente de `raw_events`.
+  - Suporta `--dry-run`, `--limit`, `--include-errors`, `--source-event-id`.
+- `scripts/audit_chatwoot_ingestion_gap.py`
+  - Auditoria inbound correta por `payload.message_type`.
+  - Separa outgoing de inbound para evitar falsos positivos.
+
+## Comandos recomendados pós-instalação
+
+```bash
+cd /mnt/ssd/home/plx/clientflow_backend
+source .venv/bin/activate
+export PYTHONPATH=.
+
+python scripts/audit_chatwoot_ingestion_gap.py --hours 168
+python scripts/reprocess_pending_chatwoot_raw_events.py --dry-run --limit 50
+python scripts/reprocess_pending_chatwoot_raw_events.py --limit 50
+```