claude-plugins/marketing/skills/lead-approach/SKILL.md

---
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, consulta datasets Dify, cria proposta e actualiza CRM.
---

# 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.

## Contexto NotebookLM

ANTES de executar, consultar notebooks para contexto especializado:

| Notebook | ID | Consultar quando |
|----------|-----|-----------------|
| Copywriting e Persuasão | `7b8fec17` | Sempre |
| Marketing Digital PT | `4c595973` | Para contexto do mercado PT |

```
mcp__notebooklm__notebook_query({
  notebook_id: "7b8fec17-d34f-4e3f-a8c6-8231e51f6323",
  query: "<adaptar ao contexto — ex: abordagem comercial, email primeiro contacto, persuasão>"
})

mcp__notebooklm__notebook_query({
  notebook_id: "4c595973-ba10-420a-a3bf-e4389e424ad3",
  query: "<adaptar — ex: mercado português, leads PME, estratégia digital PT>"
})
```

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

---

## 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__notebooklm__notebook_query, 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