@getlatedev/node 0.2.342 → 0.2.344

package/dist/index.d.mts

@@ -5539,7 +5539,7 @@ type platform7 = 'instagram' | 'facebook' | 'twitter' | 'youtube' | 'linkedin' |
  * Fired once when a new conversation begins, in either direction. A conversation
  * starts the first time an account and a contact exchange a message on any DM
  * platform (Instagram, Messenger/Facebook, Telegram, WhatsApp, Twitter, Reddit,
- * Bluesky). Platform-agnostic — one subscription covers every DM platform.
+ * Bluesky, SMS). Platform-agnostic — one subscription covers every DM platform.
  *
  */
 type WebhookPayloadConversationStarted = {
@@ -5553,7 +5553,7 @@ type WebhookPayloadConversationStarted = {
          * Internal conversation ID
          */
         id: string;
-        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
+        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms';
         platformConversationId: string;
         /**
          * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
@@ -5585,7 +5585,7 @@ type WebhookPayloadConversationStarted = {
     timestamp: string;
 };
 type event10 = 'conversation.started';
-type platform8 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
+type platform8 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms';
 /**
  * Webhook payload for post.external.created / post.external.updated /
  * post.external.deleted. Fired by Zernio's background sync when it detects a
@@ -13864,9 +13864,30 @@ type CreateInboxConversationData = {
          */
         templateLanguage?: string;
         /**
-         * WhatsApp only. Template variable values as one flat array, in the order the variables appear across the whole template: text-header variables first, then body variables, then one value per dynamic URL button (in button order). Works with positional placeholders ({{1}}, {{2}}, ...) and with named placeholders ({{name}}, {{company}} - how Meta Business Manager creates templates), where values fill the named slots in order of appearance. Example - a body with {{1}}, {{2}} plus a URL button https://example.com/{{1}} takes three values: [body1, body2, buttonSuffix]. Media headers (image, video, document) are filled automatically from the approved template and take no value here.
+         * WhatsApp only. Template variable values as one flat array, in the order the variables appear across the whole template: text-header variables first, then body variables, then one value per dynamic URL button (in button order). Works with positional placeholders ({{1}}, {{2}}, ...) and with named placeholders ({{name}}, {{company}} - how Meta Business Manager creates templates), where values fill the named slots in order of appearance. Example - a body with {{1}}, {{2}} plus a URL button https://example.com/{{1}} takes three values: [body1, body2, buttonSuffix]. Media headers (image, video, document) are filled automatically from the approved template and take no value here (use headerMedia to override the header asset per send).
          */
         templateParams?: Array<(string)>;
+        /**
+         * WhatsApp only. Overrides a media-header template's header asset for THIS send, so a template with an image/video/document header can carry a different asset per message (e.g. each recipient their own invoice PDF). Without it, the template's approved sample asset is sent. Provide exactly one of link or id.
+         */
+        headerMedia?: {
+            /**
+             * Must match the template header's media type.
+             */
+            type: 'image' | 'video' | 'document';
+            /**
+             * Public URL of the asset to send. Must be reachable without auth.
+             */
+            link?: string;
+            /**
+             * A Meta media id (from the media upload endpoint), as an alternative to link.
+             */
+            id?: string;
+            /**
+             * Document display name shown to the recipient (e.g. "Factura 0001-123.pdf"). document type only; ignored for image/video.
+             */
+            filename?: string;
+        };
     };
 };
 type CreateInboxConversationResponse = ({

package/dist/index.d.ts

@@ -5539,7 +5539,7 @@ type platform7 = 'instagram' | 'facebook' | 'twitter' | 'youtube' | 'linkedin' |
  * Fired once when a new conversation begins, in either direction. A conversation
  * starts the first time an account and a contact exchange a message on any DM
  * platform (Instagram, Messenger/Facebook, Telegram, WhatsApp, Twitter, Reddit,
- * Bluesky). Platform-agnostic — one subscription covers every DM platform.
+ * Bluesky, SMS). Platform-agnostic — one subscription covers every DM platform.
  *
  */
 type WebhookPayloadConversationStarted = {
@@ -5553,7 +5553,7 @@ type WebhookPayloadConversationStarted = {
          * Internal conversation ID
          */
         id: string;
-        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
+        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms';
         platformConversationId: string;
         /**
          * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
@@ -5585,7 +5585,7 @@ type WebhookPayloadConversationStarted = {
     timestamp: string;
 };
 type event10 = 'conversation.started';
-type platform8 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
+type platform8 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms';
 /**
  * Webhook payload for post.external.created / post.external.updated /
  * post.external.deleted. Fired by Zernio's background sync when it detects a
@@ -13864,9 +13864,30 @@ type CreateInboxConversationData = {
          */
         templateLanguage?: string;
         /**
-         * WhatsApp only. Template variable values as one flat array, in the order the variables appear across the whole template: text-header variables first, then body variables, then one value per dynamic URL button (in button order). Works with positional placeholders ({{1}}, {{2}}, ...) and with named placeholders ({{name}}, {{company}} - how Meta Business Manager creates templates), where values fill the named slots in order of appearance. Example - a body with {{1}}, {{2}} plus a URL button https://example.com/{{1}} takes three values: [body1, body2, buttonSuffix]. Media headers (image, video, document) are filled automatically from the approved template and take no value here.
+         * WhatsApp only. Template variable values as one flat array, in the order the variables appear across the whole template: text-header variables first, then body variables, then one value per dynamic URL button (in button order). Works with positional placeholders ({{1}}, {{2}}, ...) and with named placeholders ({{name}}, {{company}} - how Meta Business Manager creates templates), where values fill the named slots in order of appearance. Example - a body with {{1}}, {{2}} plus a URL button https://example.com/{{1}} takes three values: [body1, body2, buttonSuffix]. Media headers (image, video, document) are filled automatically from the approved template and take no value here (use headerMedia to override the header asset per send).
          */
         templateParams?: Array<(string)>;
+        /**
+         * WhatsApp only. Overrides a media-header template's header asset for THIS send, so a template with an image/video/document header can carry a different asset per message (e.g. each recipient their own invoice PDF). Without it, the template's approved sample asset is sent. Provide exactly one of link or id.
+         */
+        headerMedia?: {
+            /**
+             * Must match the template header's media type.
+             */
+            type: 'image' | 'video' | 'document';
+            /**
+             * Public URL of the asset to send. Must be reachable without auth.
+             */
+            link?: string;
+            /**
+             * A Meta media id (from the media upload endpoint), as an alternative to link.
+             */
+            id?: string;
+            /**
+             * Document display name shown to the recipient (e.g. "Factura 0001-123.pdf"). document type only; ignored for image/video.
+             */
+            filename?: string;
+        };
     };
 };
 type CreateInboxConversationResponse = ({

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.342",
+  version: "0.2.344",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.342",
+  version: "0.2.344",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.342",
+  "version": "0.2.344",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -2700,7 +2700,7 @@ export const listInboxConversations = <ThrowOnError extends boolean = false>(opt
  *
  * Supported platforms: X/Twitter, Bluesky, Reddit, and WhatsApp. Other platforms return PLATFORM_NOT_SUPPORTED.
  *
- * WhatsApp: this is the endpoint for sending an approved template message to a phone number. Provide templateName, templateLanguage, and templateParams (variable values for the text header, body and dynamic URL buttons, in that order), with the recipient phone in participantId. A template is required because WhatsApp does not permit freeform messages to open a conversation; a missing template returns TEMPLATE_REQUIRED. Templates with media headers (image, video, document) are handled automatically: Zernio reads the approved template definition and fills the header at send time. Calling this for a number you already have a thread with simply sends the template into that thread, which also makes it the way to re-engage a contact after the 24-hour customer-service window has closed. Once the recipient replies (opening the 24h window), send freeform messages with the send-message endpoint (POST /v1/inbox/conversations/{conversationId}/messages). Template fields are accepted on the JSON body only, not on multipart requests.
+ * WhatsApp: this is the endpoint for sending an approved template message to a phone number. Provide templateName, templateLanguage, and templateParams (variable values for the text header, body and dynamic URL buttons, in that order), with the recipient phone in participantId. A template is required because WhatsApp does not permit freeform messages to open a conversation; a missing template returns TEMPLATE_REQUIRED. Templates with media headers (image, video, document) are handled automatically: Zernio reads the approved template definition and fills the header at send time with the template's approved sample asset. To send a DIFFERENT asset per message (e.g. a distinct invoice PDF for each recipient), pass the headerMedia field with a public link (or a Meta media id); it overrides the sample for that send. Calling this for a number you already have a thread with simply sends the template into that thread, which also makes it the way to re-engage a contact after the 24-hour customer-service window has closed. Once the recipient replies (opening the 24h window), send freeform messages with the send-message endpoint (POST /v1/inbox/conversations/{conversationId}/messages). Template fields are accepted on the JSON body only, not on multipart requests.
  *
  * DM eligibility (X/Twitter): Before sending, the endpoint checks if the recipient accepts DMs from your account (via the receives_your_dm field). If not, a 422 error with code DM_NOT_ALLOWED is returned. You can skip this check with skipDmCheck: true if you have already verified eligibility.
  *

package/src/generated/types.gen.ts

@@ -4871,7 +4871,7 @@ export type platform7 = 'instagram' | 'facebook' | 'twitter' | 'youtube' | 'link
  * Fired once when a new conversation begins, in either direction. A conversation
  * starts the first time an account and a contact exchange a message on any DM
  * platform (Instagram, Messenger/Facebook, Telegram, WhatsApp, Twitter, Reddit,
- * Bluesky). Platform-agnostic — one subscription covers every DM platform.
+ * Bluesky, SMS). Platform-agnostic — one subscription covers every DM platform.
  *
  */
 export type WebhookPayloadConversationStarted = {
@@ -4885,7 +4885,7 @@ export type WebhookPayloadConversationStarted = {
          * Internal conversation ID
          */
         id: string;
-        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
+        platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms';
         platformConversationId: string;
         /**
          * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
@@ -4919,7 +4919,7 @@ export type WebhookPayloadConversationStarted = {
 
 export type event10 = 'conversation.started';
 
-export type platform8 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
+export type platform8 = 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky' | 'sms';
 
 /**
  * Webhook payload for post.external.created / post.external.updated /
@@ -13784,9 +13784,30 @@ export type CreateInboxConversationData = {
          */
         templateLanguage?: string;
         /**
-         * WhatsApp only. Template variable values as one flat array, in the order the variables appear across the whole template: text-header variables first, then body variables, then one value per dynamic URL button (in button order). Works with positional placeholders ({{1}}, {{2}}, ...) and with named placeholders ({{name}}, {{company}} - how Meta Business Manager creates templates), where values fill the named slots in order of appearance. Example - a body with {{1}}, {{2}} plus a URL button https://example.com/{{1}} takes three values: [body1, body2, buttonSuffix]. Media headers (image, video, document) are filled automatically from the approved template and take no value here.
+         * WhatsApp only. Template variable values as one flat array, in the order the variables appear across the whole template: text-header variables first, then body variables, then one value per dynamic URL button (in button order). Works with positional placeholders ({{1}}, {{2}}, ...) and with named placeholders ({{name}}, {{company}} - how Meta Business Manager creates templates), where values fill the named slots in order of appearance. Example - a body with {{1}}, {{2}} plus a URL button https://example.com/{{1}} takes three values: [body1, body2, buttonSuffix]. Media headers (image, video, document) are filled automatically from the approved template and take no value here (use headerMedia to override the header asset per send).
          */
         templateParams?: Array<(string)>;
+        /**
+         * WhatsApp only. Overrides a media-header template's header asset for THIS send, so a template with an image/video/document header can carry a different asset per message (e.g. each recipient their own invoice PDF). Without it, the template's approved sample asset is sent. Provide exactly one of link or id.
+         */
+        headerMedia?: {
+            /**
+             * Must match the template header's media type.
+             */
+            type: 'image' | 'video' | 'document';
+            /**
+             * Public URL of the asset to send. Must be reachable without auth.
+             */
+            link?: string;
+            /**
+             * A Meta media id (from the media upload endpoint), as an alternative to link.
+             */
+            id?: string;
+            /**
+             * Document display name shown to the recipient (e.g. "Factura 0001-123.pdf"). document type only; ignored for image/video.
+             */
+            filename?: string;
+        };
     };
 };