claude-plugins/crm-ops/skills/crm-admin/SKILL.md

name, description, disable-model-invocation, layer

name	description	disable-model-invocation	layer
crm-admin	Administração e manutenção do Desk CRM. Gestão de utilizadores, permissões, campos personalizados, configuração de sistema e módulos Perfex.	true	wiki

CRM Admin Specialist

Skill para gestão e desenvolvimento Perfex CRM seguindo padrões Descomplicar®.

Quando Usar

• Consultas de dados CRM (clientes, projectos, tarefas)
• Relatórios e analytics de facturação
• Desenvolvimento de módulos Perfex
• Automação de processos CRM
• Integração com sistemas externos

Protocolo Obrigatório

1. MCP First (SEMPRE)

Antes de qualquer operação, usar MCPs:

mcp__desk-crm-v3__get_customers - verificar dados existentes
mcp__mem_search_memories "[contexto crm]"
mcp__wikijs__search_pages "perfex crm [funcionalidade]"

2. Dados Reais Obrigatórios

• NUNCA simular dados quando MCPs disponíveis
• Usar mcp__desk-crm-v3__* para TODAS operações CRM
• Validar IDs de clientes/projectos antes de modificar

3. Segurança de Dados

• NUNCA expor dados sensíveis de clientes em logs
• Confirmar antes de operações destrutivas (delete)
• Backup mental do estado antes de modificações bulk

MCPs Disponíveis - DeskCRM v3

Clientes

mcp__desk-crm-v3__get_customers      # Listar (filtros: search, active, country)
mcp__desk-crm-v3__get_customer       # Detalhes (client_id)
mcp__desk-crm-v3__create_customer    # Criar (company obrigatório)
mcp__desk-crm-v3__update_customer    # Actualizar (client_id)
mcp__desk-crm-v3__customer_analytics # Analytics (client_id, period)
mcp__desk-crm-v3__search_customers   # Pesquisa multi-campo (query, fields)

Projectos

mcp__desk-crm-v3__get_projects       # Listar (status, client_id, billing_type)
mcp__desk-crm-v3__get_project        # Detalhes (project_id)
mcp__desk-crm-v3__create_project     # Criar (name, client_id, billing_type)
mcp__desk-crm-v3__update_project     # Actualizar (project_id)
mcp__desk-crm-v3__project_analytics  # Analytics (period, status)

Tarefas

mcp__desk-crm-v3__get_tasks          # Listar (status, assigned_to, rel_type)
mcp__desk-crm-v3__get_task           # Detalhes (task_id)
mcp__desk-crm-v3__create_task        # Criar (name obrigatório)
mcp__desk-crm-v3__update_task        # Actualizar (task_id)
mcp__desk-crm-v3__task_analytics     # Analytics (period, staff_id)

Leads

mcp__desk-crm-v3__get_leads          # Listar (status, source, assigned)
mcp__desk-crm-v3__create_lead        # Criar (name obrigatório)
mcp__desk-crm-v3__update_lead        # Actualizar (lead_id)
mcp__desk-crm-v3__convert_lead_to_customer  # Converter (lead_id)
mcp__desk-crm-v3__lead_analytics     # Funil e conversões (report_type)

Financeiro

mcp__desk-crm-v3__get_payments             # Pagamentos
mcp__desk-crm-v3__get_estimates            # Orçamentos
mcp__desk-crm-v3__financial_kpi_dashboard  # KPIs (period)
mcp__desk-crm-v3__profit_loss_statement    # DRE (date_from, date_to)
mcp__desk-crm-v3__cash_flow_statement      # Fluxo caixa
mcp__desk-crm-v3__accounts_receivable_aging # Contas a receber

Tickets/Suporte

mcp__desk-crm-v3__get_tickets        # Listar (status, priority, assigned)
mcp__desk-crm-v3__create_ticket      # Criar (subject, message)
mcp__desk-crm-v3__reply_ticket       # Responder (ticket_id, message)
mcp__desk-crm-v3__ticket_analytics   # Analytics (period, department_id)

Assinatura para Módulos

<?php
/**
 * [Nome do Módulo/Ficheiro]
 *
 * @author Descomplicar® Crescimento Digital
 * @link https://descomplicar.pt
 * @copyright 2025 Descomplicar®
 */

Padrões de Relatórios

Ao gerar relatórios, incluir:

1. Período: Data início/fim claramente indicada
2. Totais: Agregações relevantes
3. Top N: Rankings quando aplicável
4. Comparação: Com período anterior se relevante

Checklist Consultas

• Usar MCPs para dados reais
• Validar IDs antes de operações
• Não expor dados sensíveis
• Confirmar operações destrutivas
• Apresentar dados formatados PT-PT

---

Datasets Dify (Consulta Obrigatória)

Em caso de dúvidas ou para aprofundar conhecimento, consultar os seguintes datasets via MCP:

Dataset	ID	Prioridade
PerfexCRM	43354eb6-f0b2-40cc-aa53-44e375ab347c	1
Vendas	a7ba6005-517c-41ab-ac5e-da1c1a1c62ef	2
Gestão	22799925-8dc5-4a1f-92b9-233468a5048b	2
Gestão de Processos	cae2a27e-f5bc-4d75-8a7a-9f83064f2512	3

Como Consultar

// Pesquisar funcionalidades Perfex
mcp__notebooklm__notebook_query, mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "43354eb6-f0b2-40cc-aa53-44e375ab347c",
  query: "modulo facturas automaticas"
})

// Pesquisar técnicas de vendas
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
  query: "pipeline vendas conversao"
})

Quando Consultar

• Desenvolver módulos Perfex CRM
• Configurar automações de