@kirimdev/sdk 3.6.0 → 3.7.0

package/dist/generated/schema.d.ts

@@ -294,7 +294,7 @@ export interface paths {
          * Send a WhatsApp message or mark inbound as read
          * @description Meta-style messages endpoint. Two operations share the same path, distinguished by the request body:
          *
-         *     **Outbound send** — body has a `type` field (`text`, `image`, `document`, `video`, `audio`, `template`, `interactive`). Body shape mirrors the Meta WhatsApp Cloud API; media variants accept either `link` (hosted URL) or `id` (Meta uploaded media). The sender is the WhatsApp account identified by `phone_number_id` in the URL path; there is no `from` field in the body. Pass `Idempotency-Key` to safely retry on network failure.
+         *     **Outbound send** — body has a `type` field (`text`, `image`, `document`, `video`, `audio`, `template`, `interactive`). Body shape mirrors the Meta WhatsApp Cloud API; media variants accept either `link` (hosted URL) or `id` (Meta uploaded media). Optional top-level `context: { message_id }` creates a contextual reply — pass the inbound wamid from your webhook (`messages[0].id`), not a Kirim `msg_*` id. The sender is the WhatsApp account identified by `phone_number_id` in the URL path; there is no `from` field in the body. Pass `Idempotency-Key` to safely retry on network failure.
          *
          *     **Read receipt** — body has `status: "read"` + `message_id` (the inbound wamid from your webhook). Sends a read receipt back to the sender so the double-tick turns blue on their phone. Optional `typing_indicator: { type: "text" }` shows a typing bubble alongside the receipt; Meta auto-dismisses after ~25 seconds or on first outbound message.
          *
@@ -321,6 +321,14 @@ export interface paths {
                         /** @enum {string} */
                         recipient_type?: "individual";
                         to: string;
+                        /** Reply context */
+                        context?: {
+                            /**
+                             * @description Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.
+                             * @example wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA
+                             */
+                            message_id: string;
+                        };
                         /** @enum {string} */
                         type: "text";
                         text: {
@@ -333,6 +341,14 @@ export interface paths {
                         /** @enum {string} */
                         recipient_type?: "individual";
                         to: string;
+                        /** Reply context */
+                        context?: {
+                            /**
+                             * @description Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.
+                             * @example wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA
+                             */
+                            message_id: string;
+                        };
                         /** @enum {string} */
                         type: "image";
                         image: {
@@ -348,6 +364,14 @@ export interface paths {
                         /** @enum {string} */
                         recipient_type?: "individual";
                         to: string;
+                        /** Reply context */
+                        context?: {
+                            /**
+                             * @description Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.
+                             * @example wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA
+                             */
+                            message_id: string;
+                        };
                         /** @enum {string} */
                         type: "document";
                         document: {
@@ -363,6 +387,14 @@ export interface paths {
                         /** @enum {string} */
                         recipient_type?: "individual";
                         to: string;
+                        /** Reply context */
+                        context?: {
+                            /**
+                             * @description Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.
+                             * @example wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA
+                             */
+                            message_id: string;
+                        };
                         /** @enum {string} */
                         type: "video";
                         video: {
@@ -378,6 +410,14 @@ export interface paths {
                         /** @enum {string} */
                         recipient_type?: "individual";
                         to: string;
+                        /** Reply context */
+                        context?: {
+                            /**
+                             * @description Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.
+                             * @example wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA
+                             */
+                            message_id: string;
+                        };
                         /** @enum {string} */
                         type: "audio";
                         audio: {
@@ -394,6 +434,14 @@ export interface paths {
                         /** @enum {string} */
                         recipient_type?: "individual";
                         to: string;
+                        /** Reply context */
+                        context?: {
+                            /**
+                             * @description Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.
+                             * @example wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA
+                             */
+                            message_id: string;
+                        };
                         /** @enum {string} */
                         type: "template";
                         template: {
@@ -421,6 +469,14 @@ export interface paths {
                         /** @enum {string} */
                         recipient_type?: "individual";
                         to: string;
+                        /** Reply context */
+                        context?: {
+                            /**
+                             * @description Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.
+                             * @example wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA
+                             */
+                            message_id: string;
+                        };
                         /** @enum {string} */
                         type: "interactive";
                         interactive: {
@@ -947,6 +1003,15 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
+                /** @description Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorEnvelope"];
+                    };
+                };
                 /** @description Semantic failure (e.g. idempotency key reuse) */
                 422: {
                     headers: {
@@ -1642,7 +1707,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Conflict (e.g. webhook subscription disabled, setup link inactive) */
+                /** @description Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive) */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -2002,7 +2067,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Conflict (e.g. webhook subscription disabled, setup link inactive) */
+                /** @description Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive) */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -2111,7 +2176,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Conflict (e.g. webhook subscription disabled, setup link inactive) */
+                /** @description Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive) */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -4547,7 +4612,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Conflict (e.g. webhook subscription disabled, setup link inactive) */
+                /** @description Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive) */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -4646,7 +4711,7 @@ export interface paths {
                         "application/json": components["schemas"]["ApiErrorEnvelope"];
                     };
                 };
-                /** @description Conflict (e.g. webhook subscription disabled, setup link inactive) */
+                /** @description Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive) */
                 409: {
                     headers: {
                         [name: string]: unknown;

package/dist/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION: "3.6.0";
+export declare const SDK_VERSION: "3.7.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -2,5 +2,5 @@
 // Regenerated on every prebuild / pretypecheck / pretest from
 // package.json so the User-Agent header stays in sync with the
 // published version.
-export const SDK_VERSION = "3.6.0";
+export const SDK_VERSION = "3.7.0";
 //# sourceMappingURL=version.js.map

package/dist/generated/version.ts

@@ -3,4 +3,4 @@
 // package.json so the User-Agent header stays in sync with the
 // published version.
 
-export const SDK_VERSION = "3.6.0" as const
+export const SDK_VERSION = "3.7.0" as const

package/dist/resources/templates.d.ts

@@ -25,8 +25,8 @@ export declare class TemplatesResource {
      * Returns the created template with `status: "pending"`. Meta reviews
      * asynchronously, so poll {@link retrieve} (or {@link sync}) for the
      * eventual `approved` / `rejected` status. A `name`+`language` pair that
-     * already exists for the account throws `InvalidRequestError`
-     * (`invalid_field_value`, `param: "name"`).
+     * already exists for the account throws `ConflictError`
+     * (`template_already_exists`, HTTP 409, `param: "name"`).
      */
     create(params: CreateTemplateParams, options?: RequestOptions): Promise<Template>;
     /**

package/dist/resources/templates.js

@@ -38,8 +38,8 @@ export class TemplatesResource {
      * Returns the created template with `status: "pending"`. Meta reviews
      * asynchronously, so poll {@link retrieve} (or {@link sync}) for the
      * eventual `approved` / `rejected` status. A `name`+`language` pair that
-     * already exists for the account throws `InvalidRequestError`
-     * (`invalid_field_value`, `param: "name"`).
+     * already exists for the account throws `ConflictError`
+     * (`template_already_exists`, HTTP 409, `param: "name"`).
      */
     create(params, options) {
         return this.http.requestData({

package/dist/webhooks.d.ts

@@ -83,10 +83,34 @@ export type ContactUpdatedEvent = KirimEventEnvelope<'contact.updated', {
 export type KirimNativeWebhookEvent = ConversationAssignedEvent | ConversationClosedEvent | ContactCreatedEvent | ContactUpdatedEvent;
 /**
  * Meta passthrough body — `message.received` and `message.status`
- * deliveries forward Meta's WhatsApp Cloud webhook payload unchanged.
+ * deliveries forward Meta's WhatsApp Cloud webhook payload shape.
+ * `message.received` may also include an optional top-level `kirim`
+ * block with Kirimdev resource ids, conversation labels, and media URL.
  * Callers should branch on `X-Kirim-Event` to decide whether to parse
  * the body as `KirimNativeWebhookEvent` or `MetaPassthroughBody`.
  */
+export type MessageReceivedMediaStatus = 'ready' | 'failed' | 'unavailable' | 'pending';
+export interface MessageReceivedKirimContext {
+    conversation_id: string;
+    contact_id: string;
+    message_id: string;
+    phone_number_id: string;
+    labels: Array<{
+        id: string;
+        name: string;
+        color: string;
+    }>;
+    conversation: {
+        status: string;
+        assigned_to: string | null;
+    };
+    contact: {
+        name: string | null;
+        phone_number: string | null;
+    };
+    media_url: string | null;
+    media_status: MessageReceivedMediaStatus | null;
+}
 export interface MetaPassthroughBody {
     object: 'whatsapp_business_account';
     entry: Array<{
@@ -96,6 +120,8 @@ export interface MetaPassthroughBody {
             field: 'messages' | string;
         }>;
     }>;
+    /** Present on `message.received` — Kirimdev routing context. Safe to ignore. */
+    kirim?: MessageReceivedKirimContext;
 }
 export type KirimWebhookEvent = KirimNativeWebhookEvent | MetaPassthroughBody;
 //# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;gBAC9C,OAAO,SAA8B;CAIlD;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;gBAC9C,OAAO,SAAyD;CAI7E;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;gBAC9C,OAAO,SAAsC;CAI1D;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,MAAM,CAAA;CAC1B;AA8BD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAyBlF;AAgCD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK;IAC7D,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,KAAK,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,KAAK,CAAA;CACZ;AAED,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CACxD,uBAAuB,EACvB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAC7D,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CACtD,qBAAqB,EACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAC7D,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAClD,iBAAiB,EACjB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CACxD,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAClD,iBAAiB,EACjB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CACxD,CAAA;AAED,MAAM,MAAM,uBAAuB,GAC/B,yBAAyB,GACzB,uBAAuB,GACvB,mBAAmB,GACnB,mBAAmB,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,2BAA2B,CAAA;IACnC,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAA;QACV,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAA;SAAE,CAAC,CAAA;KAC/D,CAAC,CAAA;CACH;AAED,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,mBAAmB,CAAA"}
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"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"}

package/openapi.json

@@ -2559,7 +2559,7 @@
           "Messages"
         ],
         "summary": "Send a WhatsApp message or mark inbound as read",
-        "description": "Meta-style messages endpoint. Two operations share the same path, distinguished by the request body:\n\n**Outbound send** — body has a `type` field (`text`, `image`, `document`, `video`, `audio`, `template`, `interactive`). Body shape mirrors the Meta WhatsApp Cloud API; media variants accept either `link` (hosted URL) or `id` (Meta uploaded media). The sender is the WhatsApp account identified by `phone_number_id` in the URL path; there is no `from` field in the body. Pass `Idempotency-Key` to safely retry on network failure.\n\n**Read receipt** — body has `status: \"read\"` + `message_id` (the inbound wamid from your webhook). Sends a read receipt back to the sender so the double-tick turns blue on their phone. Optional `typing_indicator: { type: \"text\" }` shows a typing bubble alongside the receipt; Meta auto-dismisses after ~25 seconds or on first outbound message.\n\n**Pre-send validation** — the API performs compliance checks before queuing the send. A 422 response with `error.code` set to `marketing_opted_out` indicates the recipient has stopped marketing messages from your business (the customer did this via the WhatsApp app menu — webhook `user_preferences` notifies you of the change). `account_restricted` indicates Meta has restricted your WhatsApp account; check the account status via the dashboard. `consent_required` indicates the recipient has not opted in. `customer_suspended` indicates the operator has suspended (or archived) the customer that owns this WhatsApp account; sends are blocked until the customer is unsuspended via the dashboard. `upstream_error` indicates the WhatsApp account is disconnected. None of these are retryable until the underlying condition changes.",
+        "description": "Meta-style messages endpoint. Two operations share the same path, distinguished by the request body:\n\n**Outbound send** — body has a `type` field (`text`, `image`, `document`, `video`, `audio`, `template`, `interactive`). Body shape mirrors the Meta WhatsApp Cloud API; media variants accept either `link` (hosted URL) or `id` (Meta uploaded media). Optional top-level `context: { message_id }` creates a contextual reply — pass the inbound wamid from your webhook (`messages[0].id`), not a Kirim `msg_*` id. The sender is the WhatsApp account identified by `phone_number_id` in the URL path; there is no `from` field in the body. Pass `Idempotency-Key` to safely retry on network failure.\n\n**Read receipt** — body has `status: \"read\"` + `message_id` (the inbound wamid from your webhook). Sends a read receipt back to the sender so the double-tick turns blue on their phone. Optional `typing_indicator: { type: \"text\" }` shows a typing bubble alongside the receipt; Meta auto-dismisses after ~25 seconds or on first outbound message.\n\n**Pre-send validation** — the API performs compliance checks before queuing the send. A 422 response with `error.code` set to `marketing_opted_out` indicates the recipient has stopped marketing messages from your business (the customer did this via the WhatsApp app menu — webhook `user_preferences` notifies you of the change). `account_restricted` indicates Meta has restricted your WhatsApp account; check the account status via the dashboard. `consent_required` indicates the recipient has not opted in. `customer_suspended` indicates the operator has suspended (or archived) the customer that owns this WhatsApp account; sends are blocked until the customer is unsuspended via the dashboard. `upstream_error` indicates the WhatsApp account is disconnected. None of these are retryable until the underlying condition changes.",
         "security": [
           {
             "bearerAuth": []
@@ -2612,6 +2612,21 @@
                       "to": {
                         "type": "string"
                       },
+                      "context": {
+                        "type": "object",
+                        "properties": {
+                          "message_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.",
+                            "example": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA"
+                          }
+                        },
+                        "required": [
+                          "message_id"
+                        ],
+                        "title": "Reply context"
+                      },
                       "type": {
                         "type": "string",
                         "enum": [
@@ -2661,6 +2676,21 @@
                       "to": {
                         "type": "string"
                       },
+                      "context": {
+                        "type": "object",
+                        "properties": {
+                          "message_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.",
+                            "example": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA"
+                          }
+                        },
+                        "required": [
+                          "message_id"
+                        ],
+                        "title": "Reply context"
+                      },
                       "type": {
                         "type": "string",
                         "enum": [
@@ -2716,6 +2746,21 @@
                       "to": {
                         "type": "string"
                       },
+                      "context": {
+                        "type": "object",
+                        "properties": {
+                          "message_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.",
+                            "example": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA"
+                          }
+                        },
+                        "required": [
+                          "message_id"
+                        ],
+                        "title": "Reply context"
+                      },
                       "type": {
                         "type": "string",
                         "enum": [
@@ -2771,6 +2816,21 @@
                       "to": {
                         "type": "string"
                       },
+                      "context": {
+                        "type": "object",
+                        "properties": {
+                          "message_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.",
+                            "example": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA"
+                          }
+                        },
+                        "required": [
+                          "message_id"
+                        ],
+                        "title": "Reply context"
+                      },
                       "type": {
                         "type": "string",
                         "enum": [
@@ -2826,6 +2886,21 @@
                       "to": {
                         "type": "string"
                       },
+                      "context": {
+                        "type": "object",
+                        "properties": {
+                          "message_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.",
+                            "example": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA"
+                          }
+                        },
+                        "required": [
+                          "message_id"
+                        ],
+                        "title": "Reply context"
+                      },
                       "type": {
                         "type": "string",
                         "enum": [
@@ -2884,6 +2959,21 @@
                       "to": {
                         "type": "string"
                       },
+                      "context": {
+                        "type": "object",
+                        "properties": {
+                          "message_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.",
+                            "example": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA"
+                          }
+                        },
+                        "required": [
+                          "message_id"
+                        ],
+                        "title": "Reply context"
+                      },
                       "type": {
                         "type": "string",
                         "enum": [
@@ -2997,6 +3087,21 @@
                       "to": {
                         "type": "string"
                       },
+                      "context": {
+                        "type": "object",
+                        "properties": {
+                          "message_id": {
+                            "type": "string",
+                            "minLength": 1,
+                            "description": "Meta WhatsApp message id (wamid) of the message to reply to. From the inbound webhook — NOT a Kirim `msg_*` external id.",
+                            "example": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhggMUE5MDM1QzVDMUYxQTAyRkVCNzZDQjVDMjFFRDQzNTUA"
+                          }
+                        },
+                        "required": [
+                          "message_id"
+                        ],
+                        "title": "Reply context"
+                      },
                       "type": {
                         "type": "string",
                         "enum": [
@@ -4431,6 +4536,16 @@
               }
             }
           },
+          "409": {
+            "description": "Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiErrorEnvelope"
+                }
+              }
+            }
+          },
           "422": {
             "description": "Semantic failure (e.g. idempotency key reuse)",
             "content": {
@@ -5305,7 +5420,7 @@
             }
           },
           "409": {
-            "description": "Conflict (e.g. webhook subscription disabled, setup link inactive)",
+            "description": "Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive)",
             "content": {
               "application/json": {
                 "schema": {
@@ -5738,7 +5853,7 @@
             }
           },
           "409": {
-            "description": "Conflict (e.g. webhook subscription disabled, setup link inactive)",
+            "description": "Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive)",
             "content": {
               "application/json": {
                 "schema": {
@@ -5863,7 +5978,7 @@
             }
           },
           "409": {
-            "description": "Conflict (e.g. webhook subscription disabled, setup link inactive)",
+            "description": "Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive)",
             "content": {
               "application/json": {
                 "schema": {
@@ -9024,7 +9139,7 @@
             }
           },
           "409": {
-            "description": "Conflict (e.g. webhook subscription disabled, setup link inactive)",
+            "description": "Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive)",
             "content": {
               "application/json": {
                 "schema": {
@@ -9138,7 +9253,7 @@
             }
           },
           "409": {
-            "description": "Conflict (e.g. webhook subscription disabled, setup link inactive)",
+            "description": "Conflict (e.g. template already exists, webhook subscription disabled, setup link inactive)",
             "content": {
               "application/json": {
                 "schema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirimdev/sdk",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "Official TypeScript SDK for the Kirimdev Public API.",
   "type": "module",
   "license": "MIT",