# Lead alterado

**Evento:** `lead.updated` · **Transporte:** POST para o seu receptor

Mudou etapa, etiqueta, campo personalizado ou outro dado do lead no CRM. O responsável e o atendimento aberto são da conversa: chegam em `chat.updated`. `lead` traz o estado novo e `changes`, o que mudou. Assine `lead.updated` num webhook (`POST /webhooks`) ou receba pelo `GET /events`. Só conversa direta (grupo não tem lead). Não sai quando uma tag é renomeada, apagada ou vira coluna do kanban (a mudança atinge várias conversas de uma vez: busque de novo).

**Estado:** Disponível

## Compatibilidade de canais

| Canal | Compatível | Observação |
|---|---|---|
| WhatsApp (Web) | Sim |  |
| WhatsApp (API oficial) | Sim |  |
| Instagram | Sim |  |
| Messenger | Sim |  |
| Telegram | Sim |  |

### Lead alterado

```json
{
  "id": "evt_01JAB3K9ZQ7V0M4T8R2X6WYD5H",
  "type": "lead.updated",
  "created_at": "2026-10-17T12:00:00.000Z",
  "inbox": {
    "id": "r0269625d29bfbd",
    "name": "loja",
    "phone": "5511888888888",
    "channel": "whatsapp_web"
  },
  "data": {
    "lead": {
      "id": "rbb629d0fdfa7b3",
      "status": "Fechado"
    },
    "chat": {
      "id": "5511999999999@s.whatsapp.net",
      "lid": "123456789012345@lid",
      "type": "direct",
      "name": "Maria Souza"
    },
    "changes": [
      "status"
    ]
  }
}
```

## Referências

- [Eventos e webhooks](/docs/webhook)
- [Contrato OpenAPI completo](/openapi-bundled.json)