Photon 2.0 beta webhooks: message.received nests the message at data.object
Verified against a live webhook delivery (apiVersion 2026-07-01, iMessage line). The envelope is { id, apiVersion, type: "message.received", source: "imessage.photon", timestamp, data: { object: <message>, projectId } }. The message itself has id, platform, status ("received"), content, sentBy { kind: "human" }, receivedBy { id, kind: "agent" } and space { id }. Text content is { type: "text", text }.
The bug: our mapper looked for the message at data or data.message, found nothing, and silently dropped every inbound text while the signature check passed. Read data.object first. Keeping a couple of fallbacks (data, data.message) makes an envelope change fail soft, and logging only the event type when nothing matches makes it debuggable without logging message content.
To reply, send to the message's space.id (with receivedBy.id as the sender). Keying reply targets by space.id is also what keeps two people texting the same line from getting each other's replies. Signing and dedupe are covered in the existing Standard Webhooks note (webhook-id does not change on retries).