A per-user activation session against the shared WhatsApp sandbox number. Transitions pending → active when the inbound webhook receives a reply from the matching phone (the reply itself proves ownership).
| Name |
Type |
Description |
Notes |
| id |
String |
Session id. Use this to revoke via DELETE. |
|
| phoneE164 |
String |
Digits-only E.164 form (no +, spaces, or dashes). |
|
| status |
StatusEnum |
`pending` until the phone replies to the activation template, then `active`. Expired sessions are pruned by TTL and never appear in list responses. |
|
| expiresAt |
OffsetDateTime |
UTC timestamp at which the session becomes invalid. Pending sessions get a 24h window; activated sessions get 7 days. |
|
| activatedAt |
OffsetDateTime |
When the session transitioned `pending → active`, or null. |
[optional] |
| createdAt |
OffsetDateTime |
|
[optional] |
| Name |
Value |
| PENDING |
"pending" |
| ACTIVE |
"active" |