Files

T

ealmeida 81d1373977 feat(crm-ops): adiciona plugin crm-ops (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:08:32 +00:00

5.0 KiB

Raw Blame History

name, description, layer

name	description	layer
crm	Operações CRM unificadas. Leads, customers, proposals, estimates e visão 360 do cliente. Consolida crm-ops e crm-admin com verificação obrigatória de duplicados.	wiki

/crm v2.0 - Operações CRM Unificadas

Consolida /crm-ops + /crm-admin numa única skill com subcomandos.

Contexto NotebookLM

ANTES de executar, consultar notebooks para contexto especializado:

Notebook	ID	Consultar quando
Perfex CRM: Gestão de Clientes e Projectos	df4688bb	Sempre

mcp__notebooklm__notebook_query({
  notebook_id: "df4688bb-c2c0-4aba-98c1-38c3b50a353c",
  query: "<adaptar ao contexto do pedido do utilizador>"
})

Integrar insights do NotebookLM nas recomendações e decisões.

Procedimentos Relacionados

PROC-CRM-Operacoes.md — Operações CRM padrão

Comandos

Comando	Função
`/crm`	Resumo: leads recentes, clientes activos
`/crm lead <nome>`	Pesquisar/criar lead
`/crm customer <nome>`	Pesquisar/ver cliente
`/crm convert <lead_id>`	Converter lead → customer
`/crm proposal <lead_id>`	Criar proposta para lead
`/crm estimate <client_id>`	Criar estimate para cliente
`/crm 360 <cliente>`	Visão completa do cliente

Definições Críticas

Lead vs Customer

Aspecto	LEAD	CUSTOMER
O que é	Prospect	Cliente activo
Tabela	tblleads	tblclients + tblcontacts
Recebe	Proposals	Estimates, Invoices
Conversão	→ Customer	Já é cliente

Regra: Novos contactos são SEMPRE leads primeiro.

Proposal vs Estimate

Aspecto	PROPOSAL	ESTIMATE
Para quem	LEADS	CUSTOMERS
Termo PT	Orçamento/Proposta	Estimativa formal
Converte	Lead→Customer	→ Invoice

Regra: "Orçamento" para lead = PROPOSAL

Protocolo

/crm (Resumo)

1. mcp__desk-crm-v3__get_leads({ limit: 5, sort: "-dateadded" })
2. mcp__desk-crm-v3__get_tasks({ status: [1,4], limit: 5 })
3. Mostrar resumo

Output:

## 📊 CRM Resumo

### 🎯 Leads Recentes (5)
| Nome | Empresa | Valor | Status |
|------|---------|-------|--------|
| João Silva | TechCorp | €5.000 | Novo |
| Maria Costa | StartupX | €3.500 | Contactado |

### 📋 Tarefas Pendentes (3)
- #1450 [Alta] Follow-up TechCorp
- #1448 [Normal] Proposta StartupX

/crm lead

Workflow Anti-Duplicados (OBRIGATÓRIO):

1. Pesquisar em leads:
   mcp__desk-crm-v3__get_leads({ search: nome })
2. Pesquisar em customers:
   mcp__desk-crm-v3__search_customers({ query: nome })
3. SE encontrar:
   - Mostrar resultados
   - "Encontrei X. É este ou criar novo?"
4. SE não encontrar:
   - "Não encontrei [nome]. Criar lead?"
   - AGUARDAR confirmação
5. SÓ após confirmação:
   mcp__desk-crm-v3__create_lead({
     name: nome,
     email: email,
     company: empresa,
     source: 1,
     assigned: 1
   })

/crm customer

1. mcp__desk-crm-v3__search_customers({ query: nome })
2. Se encontrar: Mostrar detalhes
3. Se não encontrar: "Não encontrado. Existe lead para converter?"

Nunca criar customer automaticamente!

/crm convert <lead_id>

1. mcp__desk-crm-v3__get_lead({ lead_id })
2. Mostrar dados do lead
3. "Converter lead #X para cliente?"
4. Após confirmação:
   mcp__desk-crm-v3__convert_lead_to_customer({ lead_id })
5. Retornar ID do novo cliente

/crm proposal <lead_id>

1. Verificar que é lead (não customer)
2. Perguntar detalhes:
   - Assunto
   - Itens (descrição, qtd, valor)
3. mcp__desk-crm-v3__create_proposal({
     lead_id: lead_id,
     subject: assunto,
     status: 1
   })
4. mcp__desk-crm-v3__add_proposal_items({
     proposal_id: id,
     items: [...]
   })
5. "Proposta #X criada. Enviar? [Sim/Não]"

/crm estimate <client_id>

1. Verificar que é customer (não lead)
2. mcp__desk-crm-v3__get_customer({ customer_id: client_id })
3. Perguntar detalhes
4. mcp__desk-crm-v3__create_estimate({
     client_id: client_id,
     items: [...],
     status: 1
   })
5. "Estimate #X criado. Enviar? [Sim/Não]"

/crm 360

1. mcp__desk-crm-v3__search_customers({ query: cliente })
2. mcp__desk-crm-v3__get_customer({ customer_id })
3. mcp__desk-crm-v3__get_projects({ client_id })
4. mcp__desk-crm-v3__get_invoices({ client_id })
5. mcp__desk-crm-v3__get_tickets({ client_id })
6. mcp__desk-crm-v3__get_customer_notes({ customer_id })
7. Compilar visão 360