@ingenx-io/valets-schema-mcp-server 0.2.5 → 0.2.6

package/data/docs/models/payment-webhook-endpoint.md

@@ -0,0 +1,191 @@
+---
+title: "PaymentWebhookEndpoint"
+sidebar_label: "PaymentWebhookEndpoint"
+sidebar_position: 28
+---
+
+# PaymentWebhookEndpoint
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "token": "token",
+  "company": "company",
+  "provider": "wave",
+  "secret": "secret",
+  "active": true,
+  "createdAt": "createdAt"
+}
+```
+
+</details>
+
+
+- [1. Property `token`](#token)
+- [2. Property `company`](#company)
+- [3. Property `provider`](#provider)
+- [4. Property `secret`](#secret)
+- [5. Property `active`](#active)
+- [6. Property `createdAt`](#createdAt)
+  - [6.1. Property `firestore-timestamp`](#createdAt_anyOf_i0)
+    - [6.1.1. Property `_seconds`](#createdAt_anyOf_i0__seconds)
+    - [6.1.2. Property `_nanoseconds`](#createdAt_anyOf_i0__nanoseconds)
+  - [6.2. Property `item 1`](#createdAt_anyOf_i1)
+
+|                           |                                        |
+| ------------------------- | -------------------------------------- |
+| **Type**                  | `object`                               |
+| **Required**              | No                                     |
+| **Additional properties** | Not allowed                            |
+| **Defined in**            | #/definitions/payment-webhook-endpoint |
+
+**Description:** PaymentWebhookEndpoint (GH#41). Collection: payment_webhook_endpoints/\{token\}. Top-level, not tenant-scoped. Provisioned by superadmin; used by the backend to verify inbound payment webhooks from Wave and Jeko. The delivery log collection (raw webhook payloads + verification outcomes) is tracked in GH#41 — shape TBD.
+
+| Property                   | Pattern | Type             | Deprecated | Definition | Title/Description                                                                                            |
+| -------------------------- | ------- | ---------------- | ---------- | ---------- | ------------------------------------------------------------------------------------------------------------ |
+| + [token](#token )         | No      | string           | No         | -          | (Immutable) base64url-encoded 24-byte random token. Also the Firestore document ID and the URL path segment. |
+| + [company](#company )     | No      | string           | No         | -          | (Immutable) Company slug (e.g. gerko_studios). Identifies the tenant that owns this endpoint.                |
+| + [provider](#provider )   | No      | enum (of string) | No         | -          | (Immutable) Payment provider whose webhooks this endpoint accepts.                                           |
+| + [secret](#secret )       | No      | string           | No         | -          | Webhook signing secret for HMAC verification. Backend-only — never returned to dashboard or mobile clients.  |
+| + [active](#active )       | No      | boolean          | No         | -          | Whether this endpoint is currently active. Inactive endpoints reject incoming webhooks.                      |
+| - [createdAt](#createdAt ) | No      | Combination      | No         | -          | (Read-only) When this endpoint was provisioned.                                                              |
+
+## <a name="token"></a>1. Property `token`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) base64url-encoded 24-byte random token. Also the Firestore document ID and the URL path segment.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="company"></a>2. Property `company`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Immutable) Company slug (e.g. gerko_studios). Identifies the tenant that owns this endpoint.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="provider"></a>3. Property `provider`
+
+|              |                    |
+| ------------ | ------------------ |
+| **Type**     | `enum (of string)` |
+| **Required** | Yes                |
+
+**Description:** (Immutable) Payment provider whose webhooks this endpoint accepts.
+
+Must be one of:
+* "wave"
+* "jeko"
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="secret"></a>4. Property `secret`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** Webhook signing secret for HMAC verification. Backend-only — never returned to dashboard or mobile clients.
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+:::note
+Provider-specific webhook signing secret. Used to verify HMAC-SHA256 signatures on inbound payloads. Never expose to clients.
+:::
+
+## <a name="active"></a>5. Property `active`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `boolean` |
+| **Required** | Yes       |
+
+**Description:** Whether this endpoint is currently active. Inactive endpoints reject incoming webhooks.
+
+## <a name="createdAt"></a>6. Property `createdAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) When this endpoint was provisioned.
+
+| Any of(Option)                             |
+| ------------------------------------------ |
+| [firestore-timestamp](#createdAt_anyOf_i0) |
+| [item 1](#createdAt_anyOf_i1)              |
+
+### <a name="createdAt_anyOf_i0"></a>6.1. Property `firestore-timestamp`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | No                                |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** Firestore Timestamp — Admin SDK form: \{ _seconds, _nanoseconds \}. See types/firestore.ts for REST API v1 and client SDK serialization notes (#10).
+
+| Property                                            | Pattern | Type    | Deprecated | Definition | Title/Description |
+| --------------------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#createdAt_anyOf_i0__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#createdAt_anyOf_i0__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+#### <a name="createdAt_anyOf_i0__seconds"></a>6.1.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+#### <a name="createdAt_anyOf_i0__nanoseconds"></a>6.1.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="createdAt_anyOf_i1"></a>6.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::

package/data/docs/models/sale.md

@@ -1,7 +1,7 @@
 ---
 title: "Sale"
 sidebar_label: "Sale"
-sidebar_position: 25
+sidebar_position: 29
 ---
 
 # Sale
@@ -524,7 +524,7 @@ Set at creation only. This field cannot be modified after the document is create
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/site-payment.md

@@ -1,7 +1,7 @@
 ---
 title: "SitePayment"
 sidebar_label: "SitePayment"
-sidebar_position: 27
+sidebar_position: 31
 ---
 
 # SitePayment
@@ -197,4 +197,4 @@ Set at creation only. This field cannot be modified after the document is create
 | **Maximum**  | ≤ 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000

package/data/docs/models/site.md

@@ -1,7 +1,7 @@
 ---
 title: "Site"
 sidebar_label: "Site"
-sidebar_position: 26
+sidebar_position: 30
 ---
 
 # Site
@@ -546,7 +546,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** Timestamp of the most recent analytics event seen for this site.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/stocktake-item.md

@@ -1,7 +1,7 @@
 ---
 title: "StocktakeItem"
 sidebar_label: "StocktakeItem"
-sidebar_position: 29
+sidebar_position: 33
 ---
 
 # StocktakeItem
@@ -497,4 +497,4 @@ Read-time hint snapshot of the verifier's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000

package/data/docs/models/stocktake.md

@@ -1,7 +1,7 @@
 ---
 title: "Stocktake"
 sidebar_label: "Stocktake"
-sidebar_position: 28
+sidebar_position: 32
 ---
 
 # Stocktake
@@ -642,7 +642,7 @@ Read-time hint snapshot of the completer's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/ticket.md

@@ -1,7 +1,7 @@
 ---
 title: "Ticket"
 sidebar_label: "Ticket"
-sidebar_position: 30
+sidebar_position: 34
 ---
 
 # Ticket
@@ -388,7 +388,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Immutable) FK → User/staff UID who created this ticket.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.

package/data/docs/models/user.md

@@ -1,7 +1,7 @@
 ---
 title: "User"
 sidebar_label: "User"
-sidebar_position: 31
+sidebar_position: 35
 ---
 
 # User
@@ -242,7 +242,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/whatsapp-inbound-message.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappInboundMessage"
 sidebar_label: "WhatsappInboundMessage"
-sidebar_position: 32
+sidebar_position: 36
 ---
 
 # WhatsappInboundMessage
@@ -122,6 +122,10 @@ Must be one of:
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
 :::
 
+:::note
+cmz = "IngenX - Chez Miss Zahoui", phone number ID 446424085225188, used for chez_miss_zahoui_* companies. val = "IngenX - Valets", phone number ID 425582173979125, used for all other companies. Templates are approved at WABA level — if cmz and val share a WABA ID, all templates are available to both. Routing logic: functions/src/orders/order.ts#isSender2Company. See messaging/whatsapp-platform-constraints (#50).
+:::
+
 ## <a name="messageId"></a>4. Property `messageId`
 
 |              |          |
@@ -366,4 +370,4 @@ Do not include in write requests. This field is set exclusively by the server (F
 Specific value: `true`
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000

package/data/docs/models/whatsapp-outbound-lifecycle-event.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundLifecycleEvent"
 sidebar_label: "WhatsappOutboundLifecycleEvent"
-sidebar_position: 33
+sidebar_position: 37
 ---
 
 # WhatsappOutboundLifecycleEvent
@@ -303,7 +303,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Raw Meta error object(s).
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/whatsapp-outbound-message.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundMessage"
 sidebar_label: "WhatsappOutboundMessage"
-sidebar_position: 34
+sidebar_position: 38
 ---
 
 # WhatsappOutboundMessage
@@ -83,26 +83,26 @@ sidebar_position: 34
 
 **Description:** WhatsappOutboundMessage — Firestore-as-the-bus outbox doc (GH#43). Collection: whatsapp_outbound_messages/\{docId\}. Top-level scope; mirrors WhatsappInboundMessage. Dashboard enqueues `queued`; backend sends and owns the lifecycle.
 
-| Property                       | Pattern | Type             | Deprecated | Definition                               | Title/Description                                                                                                                       |
-| ------------------------------ | ------- | ---------------- | ---------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| - [id](#id )                   | No      | string or null   | No         | -                                        | (Read-only) Firestore document ID — auto-generated at enqueue time.                                                                     |
-| + [to](#to )                   | No      | string           | No         | -                                        | (Immutable) Recipient phone number in E.164 format. Must match the inbound \`from\` for the same conversation.                          |
-| + [waba](#waba )               | No      | enum (of string) | No         | In #/definitions/waba-label              | (Immutable) WABA that will send the message. Mirrors inbound \`waba\`.                                                                  |
-| + [wabaId](#wabaId )           | No      | string           | No         | -                                        | (Immutable) Meta WABA ID. Mirrors inbound \`wabaId\`.                                                                                   |
-| + [kind](#kind )               | No      | enum (of string) | No         | In #/definitions/outbound-message-format | (Immutable) Message format: \`text\` or \`template\`. Set \`text\` xor \`template\` to match.                                           |
-| - [text](#text )               | No      | string or null   | No         | -                                        | Free-form message body. Present only when kind=text.                                                                                    |
-| - [template](#template )       | No      | object or null   | No         | -                                        | Template send payload. Present only when kind=template.                                                                                 |
-| - [purpose](#purpose )         | No      | Combination      | No         | -                                        | Business purpose (otp \| review_request \| adhoc \| conversational). Optional.                                                          |
-| - [orderUuid](#orderUuid )     | No      | string or null   | No         | -                                        | Order reference. Present on review_request messages.                                                                                    |
-| + [sentBy](#sentBy )           | No      | object           | No         | -                                        | (Immutable) Dashboard actor who enqueued the message.                                                                                   |
-| + [createdAt](#createdAt )     | No      | object           | No         | In #/definitions/firestore-timestamp     | (Immutable) Enqueue timestamp, set by the dashboard at create.                                                                          |
-| + [status](#status )           | No      | enum (of string) | No         | In #/definitions/outbound-message-status | Delivery status. Created as \`queued\` by the dashboard; updated in place by the backend.                                               |
-| - [wamid](#wamid )             | No      | string or null   | No         | -                                        | (Read-only) WhatsApp message ID returned by Meta once the backend sends. Absent while queued or on failure.                             |
-| - [error](#error )             | No      | string or null   | No         | -                                        | (Read-only) Human-readable failure reason. Present on status=failed. Raw Meta error detail lives in the lifecycle_events subcollection. |
-| - [sentAt](#sentAt )           | No      | Combination      | No         | -                                        | (Read-only) When the backend sent the message to Meta.                                                                                  |
-| - [deliveredAt](#deliveredAt ) | No      | Combination      | No         | -                                        | (Read-only) When Meta reported delivery.                                                                                                |
-| - [readAt](#readAt )           | No      | Combination      | No         | -                                        | (Read-only) When Meta reported the recipient read the message.                                                                          |
-| - [failedAt](#failedAt )       | No      | Combination      | No         | -                                        | (Read-only) When the send failed.                                                                                                       |
+| Property                       | Pattern | Type             | Deprecated | Definition                               | Title/Description                                                                                                                                                              |
+| ------------------------------ | ------- | ---------------- | ---------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| - [id](#id )                   | No      | string or null   | No         | -                                        | (Read-only) Firestore document ID — auto-generated at enqueue time.                                                                                                            |
+| + [to](#to )                   | No      | string           | No         | -                                        | (Immutable) Recipient Meta wa_id — digits only, no leading + (e.g. 22577471485). Equal to the inbound \`from\` for the same conversation. NOT literal E.164; see x-note (#54). |
+| + [waba](#waba )               | No      | enum (of string) | No         | In #/definitions/waba-label              | (Immutable) WABA that will send the message. Mirrors inbound \`waba\`.                                                                                                         |
+| + [wabaId](#wabaId )           | No      | string           | No         | -                                        | (Immutable) Meta WABA ID. Mirrors inbound \`wabaId\`.                                                                                                                          |
+| + [kind](#kind )               | No      | enum (of string) | No         | In #/definitions/outbound-message-format | (Immutable) Message format: \`text\` or \`template\`. Set \`text\` xor \`template\` to match.                                                                                  |
+| - [text](#text )               | No      | string or null   | No         | -                                        | Free-form message body. Present only when kind=text.                                                                                                                           |
+| - [template](#template )       | No      | object or null   | No         | -                                        | Template send payload. Present only when kind=template.                                                                                                                        |
+| - [purpose](#purpose )         | No      | Combination      | No         | -                                        | Business purpose (otp \| review_request \| adhoc \| conversational). Optional.                                                                                                 |
+| - [orderUuid](#orderUuid )     | No      | string or null   | No         | -                                        | Order reference. Present on review_request messages.                                                                                                                           |
+| + [sentBy](#sentBy )           | No      | object           | No         | -                                        | (Immutable) Dashboard actor who enqueued the message.                                                                                                                          |
+| + [createdAt](#createdAt )     | No      | object           | No         | In #/definitions/firestore-timestamp     | (Immutable) Enqueue timestamp, set by the dashboard at create.                                                                                                                 |
+| + [status](#status )           | No      | enum (of string) | No         | In #/definitions/outbound-message-status | Delivery status. Created as \`queued\` by the dashboard; updated in place by the backend.                                                                                      |
+| - [wamid](#wamid )             | No      | string or null   | No         | -                                        | (Read-only) WhatsApp message ID returned by Meta once the backend sends. Absent while queued or on failure.                                                                    |
+| - [error](#error )             | No      | string or null   | No         | -                                        | (Read-only) Human-readable failure reason. Present on status=failed. Raw Meta error detail lives in the lifecycle_events subcollection.                                        |
+| - [sentAt](#sentAt )           | No      | Combination      | No         | -                                        | (Read-only) When the backend sent the message to Meta.                                                                                                                         |
+| - [deliveredAt](#deliveredAt ) | No      | Combination      | No         | -                                        | (Read-only) When Meta reported delivery.                                                                                                                                       |
+| - [readAt](#readAt )           | No      | Combination      | No         | -                                        | (Read-only) When Meta reported the recipient read the message.                                                                                                                 |
+| - [failedAt](#failedAt )       | No      | Combination      | No         | -                                        | (Read-only) When the send failed.                                                                                                                                              |
 
 ## <a name="id"></a>1. Property `id`
 
@@ -124,12 +124,20 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Type**     | `string` |
 | **Required** | Yes      |
 
-**Description:** (Immutable) Recipient phone number in E.164 format. Must match the inbound `from` for the same conversation.
+**Description:** (Immutable) Recipient Meta wa_id — digits only, no leading + (e.g. 22577471485). Equal to the inbound `from` for the same conversation. NOT literal E.164; see x-note (#54).
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
 :::
 
+:::note
+This is the Meta wa_id (digits only, no leading +), NOT a literal E.164 string. Meta normalizes phone numbers in non-obvious ways (e.g. +2250777471485 → wa_id 22577471485, dropping the trunk zero). The only reliable source is Meta's contacts[].wa_id from the send response — do not derive from E.164 by stripping + alone. The dashboard conversational sends and the whatsapp-server OTP path both use the wa_id form. Confirmed in prod: ING-368.
+:::
+
+:::tip When to set
+Set at enqueue time to the recipient's Meta wa_id. Use inbound WhatsappInboundMessage.from (also wa_id) as the join key for the conversation thread.
+:::
+
 ## <a name="waba"></a>3. Property `waba`
 
 |                |                          |
@@ -148,6 +156,10 @@ Must be one of:
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
 :::
 
+:::note
+cmz = "IngenX - Chez Miss Zahoui", phone number ID 446424085225188, used for chez_miss_zahoui_* companies. val = "IngenX - Valets", phone number ID 425582173979125, used for all other companies. Templates are approved at WABA level — if cmz and val share a WABA ID, all templates are available to both. Routing logic: functions/src/orders/order.ts#isSender2Company. See messaging/whatsapp-platform-constraints (#50).
+:::
+
 ## <a name="wabaId"></a>4. Property `wabaId`
 
 |              |          |
@@ -424,6 +436,10 @@ Dashboard must create with `queued`. The backend owns every transition after (se
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
+:::note
+Useful for audit and dedup. Does NOT enable reply-threading for template messages — Meta silently ignores context.message_id on templates. Threading only works for kind=text within the 24-hour service window (#50).
+:::
+
 ## <a name="error"></a>14. Property `error`
 
 |              |                  |
@@ -582,7 +598,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/whatsapp-template.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappTemplate"
 sidebar_label: "WhatsappTemplate"
-sidebar_position: 35
+sidebar_position: 39
 ---
 
 # WhatsappTemplate
@@ -99,6 +99,10 @@ Must be one of:
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
+:::note
+cmz = "IngenX - Chez Miss Zahoui", phone number ID 446424085225188, used for chez_miss_zahoui_* companies. val = "IngenX - Valets", phone number ID 425582173979125, used for all other companies. Templates are approved at WABA level — if cmz and val share a WABA ID, all templates are available to both. Routing logic: functions/src/orders/order.ts#isSender2Company. See messaging/whatsapp-platform-constraints (#50).
+:::
+
 ## <a name="wabaId"></a>3. Property `wabaId`
 
 |              |          |
@@ -287,7 +291,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Rendered preview text for display in the dashboard picker.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 12:42:51 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-30 at 13:38:45 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.