---
name: lead-approach
description: >
  Abordagem estratégica de leads com análise completa, estratégia de proposta e primeiro contacto. Lança agentes especializados em paralelo (marketing-planning-expert, sales-manager), consulta datasets Dify, cria documento proposta e actualiza CRM. Use when new lead to approach, abandoned lead recovery, or when user mentions "lead", "abordagem", "proposta", "estratégia comercial", "primeiro contacto".
author: Descomplicar® Crescimento Digital
version: 1.1.0
quality_score: 80
user_invocable: true
category: business
tags: [leads, sales, strategy, approach, marketing, crm, agents, parallel-execution]
desk_task: 1475
desk_project: 65
allowed-tools: Read, Write, Bash, mcp__desk-crm-v3, mcp__dify-kb, WebFetch
mcps: desk-crm-v3, dify-kb
agents:
  - name: marketing-planning-expert
    usage: Strategy, packages, differentiation
  - name: sales-manager
    usage: Approach, templates, follow-up
datasets:
  - id: c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24
    name: Marketing Digital
    priority: 1
    usage: Lead generation strategies, funnel
  - id: a7ba6005-517c-41ab-ac5e-da1c1a1c62ef
    name: Vendas
    priority: 1
    usage: Sales techniques, objection handling
  - id: bd65f36e-6004-4584-b478-129b2c21b4d2
    name: Serviços Descomplicar
    priority: 1
    usage: Packages, pricing
  - id: c8489151-de94-42b2-8cee-c0b961cfac6d
    name: Websites
    priority: 2
    usage: Website features
dependencies:
  skills: [orcamento]
  mcps: [desk-crm-v3, dify-kb]
  agents: [marketing-planning-expert, sales-manager]
triggers:
  - "User mentions 'lead', 'abordagem', 'approach'"
  - "New lead to process"
  - "Abandoned lead recovery"
  - "User says 'estratégia comercial', 'proposta'"
parallel_execution:
  enabled: true
  agents: [marketing-planning-expert, sales-manager]
performance:
  baseline_duration_ms: 1500000
  target_duration_ms: 720000
  last_run_duration_ms: null
  success_rate: 0.90
---

# Skill /lead-approach - Abordagem Estratégica de Leads

Skill para analisar leads e criar estratégia de abordagem completa, usando agentes especializados e datasets Dify.

## Quando Usar

- Novo lead para abordar
- Lead de abandono de formulário
- Lead que não respondeu (reactivação)
- Necessidade de estratégia comercial completa
- Preparar proposta de valor

## Quando NÃO Usar

- Para criar orçamento directo (usar /orcamento)
- Para operações CRM simples (usar /crm-ops)
- Para leads já qualificados com proposta pronta

---

## Protocolo

### Sintaxe

```
/lead-approach [lead_id]
/lead-approach [nome_empresa]
```

**Parâmetros:**
- `lead_id` - ID do lead no CRM (opcional)
- `nome_empresa` - Nome para pesquisar (opcional)

Se nenhum parâmetro fornecido, solicita informação ao utilizador.

## Fluxo de Execução

### Fase 1: Identificação do Lead

1. Se `lead_id` fornecido:
   ```javascript
   mcp__desk-crm-v3__get_leads({ search: lead_id })
   ```

2. Se `nome_empresa` fornecido:
   ```javascript
   mcp__desk-crm-v3__get_leads({ search: nome_empresa })
   ```

3. Verificar tickets associados:
   ```javascript
   mcp__desk-crm-v3__get_tickets({ search: email_lead })
   ```

### Fase 2: Recolha de Dados

**Do CRM:**
- Nome, email, telefone
- Empresa, cargo
- Origem (source)
- Descrição/notas existentes

**Do Ticket (se existir):**
- Serviços pedidos
- Objectivo declarado
- Situação técnica (domínio, alojamento)

**Externa:**
- Website da empresa (WebFetch se existir)
- Redes sociais (Facebook, LinkedIn)
- Google My Business

### Fase 3: Análise Estratégica (Agentes)

**Lançar em paralelo:**

```javascript
// Agente 1: Estratégia de proposta
Task({
  subagent_type: "marketing-planning-expert",
  model: "sonnet",
  prompt: `CONTEXTO DO LEAD:
    - Empresa: ${empresa}
    - Setor: ${setor}
    - Localidade: ${localidade}
    - Tamanho: ${colaboradores}
    - Situação actual: ${situacao}

    O QUE PEDIRAM: ${servicosPedidos}
    OBJECTIVO: ${objectivo}

    PERGUNTAS:
    1. Que tipo de site/solução faz sentido?
    2. Estratégia de conteúdo para o setor?
    3. Como diferenciareçã de concorrentes?
    4. Que pacotes propor? Que valores?
    5. Quick wins imediatos?`
});

// Agente 2: Abordagem comercial
Task({
  subagent_type: "sales-manager",
  model: "sonnet",
  prompt: `LEAD: ${nome} - ${cargo}
    EMPRESA: ${empresa}
    ORIGEM: ${origem}
    EMAIL: ${email}
    TELEFONE: ${telefone}

    SERVIÇOS PEDIDOS: ${servicosPedidos}
    OBJECTIVO: ${objectivo}

    PERGUNTAS:
    1. Como abordar? (canal, timing)
    2. Que tom usar?
    3. Template email primeiro contacto
    4. Script telefónico se não responder
    5. Perguntas de qualificação
    6. Sequência follow-up`
});
```

### Fase 4: Consultar Datasets Dify

```javascript
// Estratégias de marketing do setor
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24",
  query: `${setor} lead generation estratégia`,
  retrieval_mode: "hybrid_search",
  top_k: 5
});

// Técnicas de venda
mcp__dify-kb__dify_kb_retrieve_segments({
  dataset_id: "a7ba6005-517c-41ab-ac5e-da1c1a1c62ef",
  query: "primeiro contacto lead quente abordagem",
  retrieval_mode: "hybrid_search",
  top_k: 5
});
```

### Fase 5: Compilar Resultados

Criar documento no vault:
```
01-Projectos/Profissional/PRJ-{Empresa}-Proposta.md
```

**Estrutura do documento:**
- Dados do cliente
- Diagnóstico
- Proposta de valor
- Pacotes/Preços
- ROI projectado
- Timeline
- Template email de abordagem

### Fase 6: Actualizar CRM

```javascript
mcp__desk-crm-v3__update_lead({
  lead_id: id,
  assigned: 1, // Emanuel
  description: `[notas completas com dados recolhidos e estratégia]`
});
```

## Datasets Dify

| Dataset | ID | Usar Para |
|---------|----|-----------|
| Marketing Digital | `c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24` | Estratégias, funil, leads |
| Vendas | `a7ba6005-517c-41ab-ac5e-da1c1a1c62ef` | Técnicas fecho, objecções |
| Serviços Descomplicar | `bd65f36e-6004-4584-b478-129b2c21b4d2` | Pacotes, preços |
| Websites | `c8489151-de94-42b2-8cee-c0b961cfac6d` | Funcionalidades |

## Agentes Utilizados

| Agente | Função |
|--------|--------|
| `marketing-planning-expert` | Estratégia, pacotes, diferenciação |
| `sales-manager` | Abordagem, templates, follow-up |

## Outputs

1. **Documento proposta** em `01-Projectos/Profissional/`
2. **Lead actualizado** no CRM com dados completos
3. **Template email** pronto a enviar
4. **Estratégia follow-up** documentada

## Exemplos de Uso

### Lead de abandono de formulário
```
User: /lead-approach 215
→ Busca lead #215
→ Encontra ticket associado
→ Extrai dados do formulário
→ Lança agentes em paralelo
→ Cria proposta + estratégia abordagem
→ Documento: PRJ-EmpresaX-Proposta.md
→ Lead actualizado no CRM
```

### Exemplo 2: Lead por nome
```
User: /lead-approach "Century 21"
→ Pesquisa leads com "Century 21"
→ Encontra match
→ Executa workflow completo
→ Consulta datasets Dify
→ Gera estratégia completa
```

### Exemplo 3: Interactivo
```
User: /lead-approach
→ Pergunta: "Qual o lead? (ID ou nome empresa)"
→ Utilizador responde: "João Silva - TechStart"
→ Executa workflow
→ Agentes em paralelo (marketing + sales)
→ Resultado: documento + CRM actualizado
```

## Checklist de Execução

- [ ] Lead identificado no CRM
- [ ] Dados completos extraídos
- [ ] Ticket associado verificado
- [ ] Empresa pesquisada (web, redes)
- [ ] Agente marketing lançado
- [ ] Agente sales lançado
- [ ] Datasets Dify consultados
- [ ] Documento proposta criado
- [ ] Lead actualizado no CRM
- [ ] Template email pronto

## Referências

- `03-Recursos/Procedimentos/PROC-CRM-Operacoes.md`
- `/media/ealmeida/Dados/GDrive/Cloud/Docs/Produtos_Servicos/tabela-geral.csv`
- Skill `/orcamento` para preços oficiais

---

**Versão:** 1.0.0 | **Data:** 2026-01-28

---

## Instrumentação Automática

Esta skill grava métricas automaticamente para análise PDCA.

### Baseline

| Métrica | Valor |
|---------|-------|
| Tempo baseline | 25 min |
| Tempo target | 12 min |
| Melhoria esperada | -52% |

### Query para Gravar (executar no final)

```sql
INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/lead-approach', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);
```

### Ver Métricas

```bash
/metrics /lead-approach
```

---

**Versão**: 1.1.0 | **Data**: 2026-02-03 | **Instrumentação**: Activa