# Configuração Técnica — Agente SDR Angel | Linkia (GoHighLevel)
## Sweet Angels Gastronomia
> Agência Climb Digital | Versão 1.0 — 2026-07-06

---

## 1. CREDENCIAIS E IDENTIFICADORES

| Dado | Valor |
|---|---|
| Plataforma | Linkia (GoHighLevel white-label) |
| Location ID | `4z6Fjpgj2soAQZpu8Ddk` |
| API Token | `pit-5c81b5cf-19ef-4b6d-8d90-2df3a3e054b7` |
| Arquivo de credenciais | `/opt/mia/workspace/clientes/sweet_angels/linkia.env` |
| Canal ativo | WhatsApp only |

---

## 2. PIPELINE — PROSPECÇÃO ATIVA

### Nome do pipeline: PROSPECÇÃO ATIVA

| Stage | Nome exibido | Descrição funcional |
|---|---|---|
| 1 | NOVO LEAD | Lead entrou no pipeline — mensagem inicial ainda não disparada ou sendo disparada |
| 2 | LEAD RESPONDEU | Lead respondeu à mensagem de prospecção — **agente Angel assume aqui** |
| 3 | QUALIFICADO | Coletou: tipo de evento + pessoas + data + cidade |
| 4 | AGENDAMENTO | Lead aceitou falar com a Angélica e contato foi passado |
| 5 | NO SHOW | Agendamento confirmado e lead não apareceu |
| 6 | GANHO | Contrato fechado e sinal de pagamento confirmado |

> Notas de tags adicionais (não são stages, são labels):
> - `sem_resposta` — lead parou de responder após follow-up
> - `fora_de_perfil` — evento muito pequeno ou fora de área sem exceção
> - `reativar_futuro` — lead interessado mas sem data no momento

---

## 3. CONFIGURAÇÃO DO AI EMPLOYEE NO LINKIA

### Onde configurar:
`Linkia > Settings > AI Employee` (ou via sub-menu do Location)

### Campos obrigatórios:

| Campo | Valor |
|---|---|
| Nome do agente | Angel |
| Empresa | Sweet Angels Gastronomia |
| Objetivo | Qualificar lead e agendar conversa com a Angélica |
| Canal | WhatsApp |
| Tom | Semiformal, elegante, consultivo |
| System prompt | Colar o conteúdo completo de `prompt_sdr_alma.md` |

### Configurações de comportamento recomendadas:

| Parâmetro | Configuração sugerida |
|---|---|
| Max tokens por resposta | 300 (forcar respostas curtas) |
| Temperatura do modelo | 0.7 (equilibrio entre criatividade e consistência) |
| Delay de resposta | 3-8 segundos (parecer humano, não instantaneo) |
| Horário de ativação | Seg-Sex 08h-19h / Sab 08h-13h |
| Fora do horário | Mensagem automática: "Retorno no próximo dia útil! 🍫" |

---

## 4. AUTOMAÇÃO DE PIPELINE — FLUXO RECOMENDADO NO GHL

### Workflow 1 — Entrada no pipeline e disparo da prospecção

```
Trigger: Contato adicionado ao pipeline PROSPECÇÃO ATIVA (stage: NOVO LEAD)
  |
  v
Action: Aguardar 5 min (evitar spam imediato)
  |
  v
Action: Enviar mensagem WhatsApp (template de prospecção — ver Seção 5)
  |
  v
Action: Mover para stage: NOVO LEAD (aguardando resposta)
```

### Workflow 2 — Lead respondeu (ativa o agente)

```
Trigger: Lead responde no WhatsApp
  |
  v
Condition: Stage atual = NOVO LEAD
  |-- SIM → Mover para LEAD RESPONDEU → Ativar AI Employee (Angel)
  |-- NÃO → Verificar stage e agir conforme fluxo
```

### Workflow 3 — Qualificação concluída

```
Trigger: AI Employee marca campo "Status" = "qualificado"
  |
  v
Action: Mover para stage QUALIFICADO
  |
  v
Action: Notificar Angélica via WhatsApp interno:
  "Novo lead qualificado! [NOME], [tipo de evento], [N] pessoas, [data], [cidade]. Aguardando agendamento."
```

### Workflow 4 — Agendamento confirmado

```
Trigger: AI Employee marca campo "Status" = "agendado"
  |
  v
Action: Mover para stage AGENDAMENTO
  |
  v
Action: Notificar Angélica: "Lead [NOME] aguarda seu contato no WhatsApp para fechar a proposta."
  |
  v
Action: Iniciar contagem para NO SHOW (se não houver atualização em 48h após data do evento agendado)
```

### Workflow 5 — Follow-up (lead parou de responder)

```
Trigger: Última mensagem do lead há mais de 24h + stage = LEAD RESPONDEU ou QUALIFICADO
  |
  v
Action: Enviar follow-up 1 (ver Seção 6)
  |
  Aguardar 48h sem resposta
  |
  v
Action: Enviar follow-up 2
  |
  Aguardar 24h sem resposta
  |
  v
Action: Enviar mensagem de encerramento + adicionar tag "sem_resposta" + pausar automações
```

---

## 5. MENSAGEM INICIAL DE PROSPECÇÃO (disparada antes do agente entrar)

> Esta mensagem é enviada automaticamente quando o lead entra no pipeline (stage NOVO LEAD). O agente Angel só entra quando o lead responde.

```
Olá! 🍫

Aqui é a Angel, da Sweet Angels Gastronomia.

A Sweet Angels cria experiências gastronômicas para eventos corporativos e particulares — coffee break gourmet, estações ao vivo, brunches, coquetéis e cestas corporativas personalizadas.

Você tem interesse em catering para algum evento? Podemos conversar rapidinho!
```

*(Quando o lead responder, o AI Employee Angel assume automaticamente.)*

---

## 6. MENSAGENS DE FOLLOW-UP (configurar como templates no GHL)

### Follow-up 1 (24h sem resposta)

```
Oi [NOME]! Só passando para ver se ficou alguma dúvida sobre a Sweet Angels. 🍫

Se ainda fizer sentido, estou aqui para ajudar a montar a proposta ideal para o seu evento!
```

### Follow-up 2 (48h sem resposta após follow-up 1)

```
[NOME], tudo bem? Fico feliz em ajudar a criar algo especial para o seu evento.

Quando quiser dar continuidade, é só me chamar aqui!
```

### Mensagem de encerramento (72h sem resposta total)

```
[NOME], vou deixar você tranquilo(a) por enquanto.

Quando precisar de catering ou cestas para um evento especial, estamos aqui: (11) 91828-9312. 🎁
```

---

## 7. CUSTOM FIELDS RECOMENDADOS (criar no GHL > Settings > Custom Fields)

| Nome do campo | Tipo | Valores / Observações |
|---|---|---|
| `tipo_servico` | Dropdown | coffee_break / brunch / coquetel / estacao_gourmet / cesta_corporativa / catering_completo |
| `num_pessoas` | Number | Número inteiro |
| `data_evento` | Date | Data do evento |
| `cidade_evento` | Text | Cidade e estado |
| `restricoes_alimentares` | Multi-select | sem_gluten / sem_lactose / vegetariano / vegano / nenhuma |
| `perfil_lead` | Dropdown | corporativo_rh / corporativo_marketing / corporativo_executivo / pme / particular |
| `temperatura_lead` | Dropdown | quente / morno / frio |
| `fornecedor_atual` | Dropdown | sim / nao |
| `status_sdr` | Dropdown | respondeu / qualificando / qualificado / agendado / no_show / ganho / sem_resposta / fora_de_perfil |
| `objecoes` | Text Area | Texto livre — preencher pelo agente |
| `resumo_conversa` | Text Area | Gerado ao finalizar atendimento |

---

## 8. TAGS RECOMENDADAS (criar no GHL > Settings > Tags)

| Tag | Quando aplicar |
|---|---|
| `prospecção-ativa` | Todo lead que entrar neste pipeline |
| `whatsapp` | Confirmar canal de origem |
| `sem_resposta` | Após encerramento por ausência de retorno |
| `fora_de_perfil` | Lead desqualificado (fora de área, evento muito pequeno) |
| `reativar_futuro` | Lead interessado mas sem data definida |
| `urgente` | Evento em menos de 48h — notificar Angélica imediatamente |
| `aguardando_angelica` | Lead qualificado aguardando contato da Angélica |
| `nota_fiscal` | Lead solicitou nota fiscal (corporativo confirmado) |

---

## 9. NOTIFICAÇÃO INTERNA PARA ANGELICA

Configurar notificação automática via GHL sempre que:

1. Lead for movido para QUALIFICADO
2. Lead for movido para AGENDAMENTO
3. Tag `urgente` for aplicada

**Formato de notificação (WhatsApp interno ou e-mail):**

```
🔔 Novo lead qualificado — Sweet Angels

Nome: [NOME]
Tipo de evento: [tipo_servico]
Pessoas: [num_pessoas]
Data: [data_evento]
Cidade: [cidade_evento]
Restrições: [restricoes_alimentares]
Temperatura: [temperatura_lead]
Resumo: [resumo_conversa]

→ Aguardando contato da Angélica para proposta.
```

---

## 10. API — ENDPOINTS UTEIS (GoHighLevel v2)

Base URL: `https://services.leadconnectorhq.com`

### Mover contato de stage

```
POST /opportunities/{opportunityId}
Headers:
  Authorization: Bearer pit-5c81b5cf-19ef-4b6d-8d90-2df3a3e054b7
  Version: 2021-07-28

Body:
{
  "stageId": "ID_DO_STAGE_AQUI"
}
```

### Atualizar campo customizado

```
PUT /contacts/{contactId}
Headers:
  Authorization: Bearer pit-5c81b5cf-19ef-4b6d-8d90-2df3a3e054b7
  Version: 2021-07-28

Body:
{
  "customFields": [
    {
      "id": "ID_DO_CAMPO",
      "value": "valor_aqui"
    }
  ]
}
```

### Adicionar tag ao contato

```
POST /contacts/{contactId}/tags
Headers:
  Authorization: Bearer pit-5c81b5cf-19ef-4b6d-8d90-2df3a3e054b7
  Version: 2021-07-28

Body:
{
  "tags": ["nome-da-tag"]
}
```

> Para obter os IDs dos stages, fazer GET no pipeline:
> `GET /opportunities/pipelines` com o mesmo header de autorizaçao.
> Location ID: `4z6Fjpgj2soAQZpu8Ddk`

---

## 11. CHECKLIST DE IMPLANTAÇÃO

- [ ] Criar pipeline "PROSPECÇÃO ATIVA" com os 6 stages listados na Seção 2
- [ ] Criar os Custom Fields listados na Seção 7
- [ ] Criar as Tags listadas na Seção 8
- [ ] Criar AI Employee "Angel" com o system prompt de `prompt_sdr_alma.md`
- [ ] Configurar horário de operação do AI Employee (Seg-Sex 08h-19h / Sab 08h-13h)
- [ ] Criar Workflow 1 (entrada no pipeline e disparo da prospecção)
- [ ] Criar Workflow 2 (lead respondeu → ativa AI Employee)
- [ ] Criar Workflow 3 (qualificação concluída → notifica Angélica)
- [ ] Criar Workflow 4 (agendamento confirmado)
- [ ] Criar Workflow 5 (follow-up por ausência de resposta)
- [ ] Configurar templates de follow-up (Seção 6)
- [ ] Configurar notificação automática para Angélica (Seção 9)
- [ ] Testar fluxo completo com contato de teste antes de ativar em produção

---

*Agência Climb Digital | Implantação Sweet Angels Gastronomia*
*Versão 1.0 — 2026-07-06*