@messagebird/sdk 0.38.0 → 0.38.2

package/dist/index.d.mts

@@ -3700,7 +3700,7 @@ type WhatsAppMessageTemplateComponent = {
    */
   type: string;
   /**
-   * The values that fill this part's placeholders. A positional template takes them in `{{n}}` placeholder order; a template with named parameters requires each parameter's `name` to match one the template declares, and order then carries no meaning. Send it on every part except `carousel`, which carries its values on `cards`.
+   * The values that fill this part's placeholders. A positional template takes them in `{{n}}` placeholder order; a template with named parameters requires each parameter's `name` to match one the template declares, and order then carries no meaning. Send it on every part except `carousel`, which carries its values on `cards`. Send no `button` part at all for a button that takes no value, such as a `quick_reply` or `request_contact_info` button, or a `url` button whose address has no placeholder: a part the template has no slot for is refused here, before the message is sent and charged.
    *
    */
   parameters?: Array<WhatsAppMessageTemplateComponentParameter>;
@@ -4117,37 +4117,37 @@ type WhatsAppMessageSendRequest = {
    */
   template?: WhatsAppTemplateSend;
   /**
-   * Free-form text to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. We do not track the window, so a send outside one is accepted and then fails, with `service_window_expired` on the message's `last_error`.
+   * Free-form text to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.
    *
    */
   text?: WhatsAppTextSend;
   /**
-   * A free-form image to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. We do not track the window, so a send outside one is accepted and then fails, with `service_window_expired` on the message's `last_error`.
+   * A free-form image to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.
    *
    */
   image?: WhatsAppImageSend;
   /**
-   * A free-form video to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. We do not track the window, so a send outside one is accepted and then fails, with `service_window_expired` on the message's `last_error`.
+   * A free-form video to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.
    *
    */
   video?: WhatsAppVideoSend;
   /**
-   * Free-form audio to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. We do not track the window, so a send outside one is accepted and then fails, with `service_window_expired` on the message's `last_error`.
+   * Free-form audio to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.
    *
    */
   audio?: WhatsAppAudioSend;
   /**
-   * A free-form sticker to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. We do not track the window, so a send outside one is accepted and then fails, with `service_window_expired` on the message's `last_error`.
+   * A free-form sticker to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.
    *
    */
   sticker?: WhatsAppStickerSend;
   /**
-   * A free-form document to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. We do not track the window, so a send outside one is accepted and then fails, with `service_window_expired` on the message's `last_error`.
+   * A free-form document to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.
    *
    */
   document?: WhatsAppDocumentSend;
   /**
-   * A free-form location to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. We do not track the window, so a send outside one is accepted and then fails, with `service_window_expired` on the message's `last_error`.
+   * A free-form location to send instead of a template. Deliverable only inside an open 24-hour customer service window, which the contact opens by messaging or calling you and resets each time they do it again. A send into a closed window is refused with a `422` `WhatsAppServiceWindowClosed` before anything is created or charged; one whose window closes between accept and dispatch fails asynchronously, with `service_window_expired` on the message's `last_error`.
    *
    */
   location?: WhatsAppLocationSend;

package/dist/index.mjs

@@ -2951,9 +2951,13 @@ const listWhatsAppMessages = (options) => (options?.client ?? client).get({
 *
 * **Free-form content** is deliverable only inside an open 24-hour customer
 * service window, which the contact opens by messaging or calling you and
-* resets each time they do it again. We do not track the window, so a send
-* outside one is accepted and then fails, carrying `service_window_expired` on
-* the message's `last_error`. Every free-form send requires `from`.
+* resets each time they do it again. Bird tracks that window, so a send into a
+* closed one is refused with a `422` `WhatsAppServiceWindowClosed` before
+* anything is created or charged;
+* send a template instead, which reopens the window once the contact replies.
+* A window that closes between accept and dispatch still fails
+* asynchronously, carrying `service_window_expired` on the message's
+* `last_error`. Every free-form send requires `from`.
 *
 * The `202` response is the accepted message, echoing the resolved content; it
 * is not a delivery confirmation. Follow delivery with
@@ -2968,6 +2972,8 @@ const listWhatsAppMessages = (options) => (options?.client ?? client).get({
 * - Parameter values that do not match the template's declared placeholders.
 * - A `from` this workspace cannot send from.
 * - A recipient that is neither a valid phone number nor a business-scoped user ID.
+* - Free-form content sent into a closed customer service window
+* (`WhatsAppServiceWindowClosed`).
 *
 * A send from a workspace with no wallet balance fails with a `402`.
 *
@@ -7372,9 +7378,9 @@ var BirdClient = class {
 		this.#headers = {
 			...opts.defaultHeaders,
 			Authorization: `Bearer ${opts.apiKey}`,
-			"User-Agent": `bird-sdk-js/0.38.0`,
+			"User-Agent": `bird-sdk-js/0.38.2`,
 			"Bird-Surface": "sdk-js",
-			"Bird-Version": "0.38.0"
+			"Bird-Version": "0.38.2"
 		};
 		const caller = detectCaller();
 		if (caller) this.#headers["Bird-Caller"] = caller;