Release v4928.1.4.2 stable

docs/CLIENTFLOW_V467_CHATWOOT_AUTOCOMPLETE_GUARDRAILS.md

@@ -0,0 +1,26 @@
+# ClientFlow v4.6.7 — Chatwoot Auto-complete Guardrails
+
+Esta versão endurece o comportamento de auto-completar tarefas quando chega uma mensagem `outgoing` do Chatwoot.
+
+## Objetivo
+
+Manter o Chatwoot como inbox, mas evitar que uma resposta enviada feche tarefas que exigem validação humana.
+
+## Alterações
+
+- `CONFIRM_PAYMENT` deixa de estar nos action codes auto-completados por defeito.
+- `MARK_NO_INTEREST` e `REVIEW_MANUALLY` também não são auto-completados por resposta outgoing.
+- Se a task tiver `opportunity_linking_status=ambiguous`, a resposta outgoing não fecha a tarefa.
+- Tarefas auto-completadas registam evento de timeline como `task_auto_completed` quando existe oportunidade associada.
+
+## Continua configurável
+
+É possível sobrescrever a lista via:
+
+```env
+CHATWOOT_AUTO_COMPLETE_ACTION_CODES=SEND_INFO,SEND_QUOTE,SUPPORT
+```
+
+## Regra operacional
+
+O sistema pode fechar automaticamente tasks em que a resposta ao cliente é a própria ação.  Não deve fechar tasks que confirmam pagamento, validam associação ou exigem decisão fiscal/operacional.