ClientFlow v4.6 — Chatwoot Workflow Hardening

Objetivo

Esta atualização não cria uma segunda inbox. O Chatwoot continua a ser a caixa de entrada e o ClientFlow passa a tratar melhor o trabalho que nasce das mensagens do Chatwoot.

Fluxo alvo:

Chatwoot → webhook → classificação → task/opportunity → Centro de trabalho → timeline

Alterações principais

1. `REVIEW_MANUALLY` passa a ser trabalho pendente

Antes, decisões REVIEW_MANUALLY ficavam como skipped. Isto escondia mensagens que precisavam de operador.

Agora:

REVIEW_MANUALLY → route=rever → status=pending → priority=alta

2. `REMOVE_FROM_LIST` passa a ser operacional

Antes podia ficar tratado como revisão/skip. Agora fica pendente e orientado para marketing:

REMOVE_FROM_LIST → route=marketing → status=pending

3. Só spam e “sem ação” ficam `skipped`

IGNORE_SPAM → skipped
NO_ACTION → skipped

4. Centro de trabalho mostra contexto Chatwoot

Os itens operacionais vindos do Chatwoot passam a trazer:

source_system
conversation_id
contact_id
request_text
chatwoot_url

A UI mostra botão para abrir a conversa no Chatwoot quando CHATWOOT_PUBLIC_URL/CHATWOOT_BASE_URL e CHATWOOT_ACCOUNT_ID estão configurados.

5. Comunicações deixam de ser navegação principal

A rota técnica /communications continua disponível para diagnóstico, mas deixa de ser a inbox principal. O operador deve responder e gerir conversas no Chatwoot.

6. Timeline para tasks associadas à oportunidade

Quando uma task criada pelo Chatwoot está ligada a uma oportunidade, é registado evento de timeline task_created.

7. Script para reabrir revisões antigas

Para corrigir as tasks recentes que já ficaram skipped antes da v4.6:

PYTHONPATH=. python scripts/reopen_chatwoot_review_tasks.py --dry-run
PYTHONPATH=. python scripts/reopen_chatwoot_review_tasks.py --days 7

Por defeito só olha para os últimos 7 dias.

Passos pós-instalação recomendados

cd /mnt/ssd/home/plx/clientflow_backend
source .venv/bin/activate 2>/dev/null || true

PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q

PYTHONPATH=. python scripts/reopen_chatwoot_review_tasks.py --dry-run
PYTHONPATH=. python scripts/reopen_chatwoot_review_tasks.py --days 7

sudo systemctl restart clientflow-api
sudo systemctl status clientflow-api --no-pager

Validação funcional

Verificar:

/tasks?status=pending&route=rever
/operations
/opportunities

E confirmar que novas mensagens Chatwoot classificadas como revisão aparecem como pendentes.

2.6 KiB Raw Blame History