Corresponde ao evento interno lead.created. Este evento usa um envelope diferente dos eventos de pedido — não contém purchase nem buyer.
Quando é disparado
- Comprador acessa o checkout e preenche nome e e-mail
- Lead é registrado mesmo que o pagamento não seja concluído
Payload
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"lead_id": 456,
"creation_date": 1736524800000,
"event": "LEAD_CREATED",
"version": "2.0.0",
"data": {
"lead": {
"code": "uuid-unico-do-lead",
"name": "Maria Souza",
"email": "maria@exemplo.com",
"phone": "+5521988880000",
"status": "new",
"ip": "177.0.0.1",
"country": "BR",
"city": "São Paulo",
"region": "SP",
"tracking": {
"source": "google",
"utm_source": "google",
"utm_medium": "cpc",
"utm_campaign": "black-friday",
"utm_content": null,
"utm_term": null,
"src": null,
"sck": null
}
},
"product": {
"id": 1,
"name": "Curso de Marketing Digital",
"type": "digital",
"offer_code": "abc12345",
"price": 197.00
}
}
}
Diferenças em relação aos eventos de pedido
| Propriedade | Eventos order.* | lead.created |
|---|
| Chave raiz do ID | order_id | lead_id |
| Chave de idempotência | data.purchase.transaction | data.lead.code |
Objeto data.purchase | ✓ | — |
Objeto data.buyer | ✓ | — |
Objeto data.lead | — | ✓ |
| UTM / rastreamento | data.purchase.tracking | data.lead.tracking |
Campos-chave
| Campo | Descrição |
|---|
data.lead.code | UUID único do lead — use como chave de idempotência |
data.lead.status | new no momento do registro |
data.lead.tracking | UTMs padronizados + todos os parâmetros de URL capturados no checkout |
data.product.offer_code | Oferta acessada pelo lead |
Use data.lead.code (não id) como chave de idempotência. O id muda a cada tentativa de entrega.
