# Quickstart — Spec 010 Assist & Takeover (draft)

**Status:** 🔄 Fase A+B em produção (2026-06-10)

---

## Visão em uma frase

O Desk deixa de ser só observador: cliente ou técnico **escala**, técnico **assume (ASM)**, cliente **pausa**, acções **só no Desk**, consoles externos **link nova aba**.

---

## Decisões Roger (fechadas)

| Tema | Decisão |
|------|---------|
| Quem escala | Cliente **e** técnico |
| Intervenção | A partir de **`domain.validated`** |
| Modo | **ASM** — técnico substitui cliente |
| Consoles | Links nova aba; **acções só Desk** |
| OTRS | Spec **011** futuro |

---

## Fluxo ASM (Fase A+B — activo)

### Cliente (wizard `/onboard`)

1. Botão **«Preciso de ajuda técnica»** (após passo 1)
2. Overlay «Processo pausado» + webhook `onboarding.escalated`

### Técnico (Desk)

1. Funil clicável ou ticket → **Assumir sessão**
2. Abre ASM: `https://onboard.ligbox.com.br/assist/{session_id}?desk=1`
3. Banner «Modo ASM» — actua no wizard
4. **Devolver ao cliente** → handoff + resume VM112

### Env (VM122)

```env
VM112_ASSIST_CALL_VM112=true
VM112_ASSIST_SERVICE_TOKEN=ligbox-desk-assist-...
VM112_ASSIST_API_URL=http://10.10.10.112:8090/api
```

### Env (VM112)

```env
DESK_ASSIST_TOKEN=ligbox-desk-assist-...
```

---

## Pendente (Fase C)

- Acções Desk (DNS revalidate, infra resync)
- Push escalada (Spec 007)

---

## Docs

- `specs/010-desk-assist-takeover/spec.md`
- `specs/010-desk-assist-takeover/tasks.md`
- `specs/011-integration-otrs/spec.md` (OTRS futuro)
