docs(webhooks): distinguish schema identifiers

Author: qwerzl

webhooks/managing-webhooks.mdx

@@ -31,6 +31,11 @@ curl -X POST "https://spectrum.photon.codes/projects/$PROJECT_ID/webhooks/" \
 Standard Webhooks signatures. Choose `normalized-events.v1` only when you need
 the original normalized Spectrum event shape.
 
+This management field is a string endpoint schema ID. It is distinct from the
+numeric `schemaVersion: 1` inside a delivered raw event, which identifies only
+the revision of that envelope. Do not send the numeric value to this API or
+compare the two fields.
+
 The create response is the only time both `signingSecret` and
 `standardSigningSecret` are returned. Store both before discarding the response.
 For a `normalized-events.v1` endpoint, use `signingSecret` for current

webhooks/troubleshooting.mdx

@@ -16,7 +16,9 @@ Check the endpoint record first:
 
 - `enabled` must be `true` and `status` must be `active`.
 - `eventTypes` must include `message.received`.
-- `schemaVersion` should be `raw-inbound.v1` for Standard Webhooks delivery.
+- The endpoint record's string `schemaVersion` must be `raw-inbound.v1` for
+  Standard Webhooks delivery. It is distinct from the delivered raw envelope's
+  numeric `schemaVersion: 1`.
 - The event must belong to the same project as the registration.
 
 Then check the destination: