@unboundcx/sdk 4.13.34 → 4.13.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.34",
+  "version": "4.13.35",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/ai/playbooks.js

@@ -114,7 +114,13 @@ export class PlaybooksService {
    *   isPublished: true
    * });
    */
-  async updatePlaybook({ playbookId, name, isPublished, recordTypeId }) {
+  async updatePlaybook({
+    playbookId,
+    name,
+    isPublished,
+    recordTypeId,
+    passScore,
+  }) {
     this.sdk.validateParams(
       { playbookId },
       {
@@ -122,11 +128,12 @@ export class PlaybooksService {
         name: { type: 'string', required: false },
         isPublished: { type: 'boolean', required: false },
         recordTypeId: { type: 'string', required: false },
+        passScore: { type: 'number', required: false },
       },
     );
 
     const params = {
-      body: { name, isPublished, recordTypeId },
+      body: { name, isPublished, recordTypeId, passScore },
     };
 
     const result = await internalRequest(this.sdk, 
@@ -202,6 +209,8 @@ export class PlaybooksService {
     requiredForPass,
     role,
     signal,
+    window,
+    windowTurns,
     recordTypeId,
   }) {
     this.sdk.validateParams(
@@ -229,6 +238,8 @@ export class PlaybooksService {
         requiredForPass: { type: 'boolean', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         recordTypeId: { type: 'string', required: false },
       },
     );
@@ -244,6 +255,8 @@ export class PlaybooksService {
         requiredForPass,
         role,
         signal,
+        window,
+        windowTurns,
         recordTypeId,
       },
     };
@@ -345,6 +358,8 @@ export class PlaybooksService {
     requiredForPass,
     role,
     signal,
+    window,
+    windowTurns,
     recordTypeId,
   }) {
     this.sdk.validateParams(
@@ -372,6 +387,8 @@ export class PlaybooksService {
         requiredForPass: { type: 'boolean', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         recordTypeId: { type: 'string', required: false },
       },
     );
@@ -387,6 +404,8 @@ export class PlaybooksService {
         requiredForPass,
         role,
         signal,
+        window,
+        windowTurns,
         recordTypeId,
       },
     };
@@ -491,6 +510,8 @@ export class PlaybooksService {
     description,
     keywords,
     recommendedPhase,
+    window,
+    windowTurns,
     role,
     signal,
     recordTypeId,
@@ -502,6 +523,8 @@ export class PlaybooksService {
         description: { type: 'string', required: false },
         keywords: { type: 'array', required: false },
         recommendedPhase: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
         recordTypeId: { type: 'string', required: false },
@@ -509,7 +532,17 @@ export class PlaybooksService {
     );
 
     const params = {
-      body: { name, description, keywords, recommendedPhase, role, signal, recordTypeId },
+      body: {
+        name,
+        description,
+        keywords,
+        recommendedPhase,
+        window,
+        windowTurns,
+        role,
+        signal,
+        recordTypeId,
+      },
     };
 
     const result = await internalRequest(this.sdk, 
@@ -604,22 +637,28 @@ export class PlaybooksService {
    */
   async updatePlaybookGoalType({
     goalTypeId,
+    playbookGoalTypeId,
     name,
     description,
     keywords,
     recommendedPhase,
+    window,
+    windowTurns,
     role,
     signal,
     recordTypeId,
   }) {
+    const id = goalTypeId || playbookGoalTypeId;
     this.sdk.validateParams(
-      { goalTypeId },
+      { goalTypeId: id },
       {
         goalTypeId: { type: 'string', required: true },
         name: { type: 'string', required: false },
         description: { type: 'string', required: false },
         keywords: { type: 'array', required: false },
         recommendedPhase: { type: 'string', required: false },
+        window: { type: 'string', required: false },
+        windowTurns: { type: 'number', required: false },
         role: { type: 'string', required: false },
         signal: { type: 'string', required: false },
         recordTypeId: { type: 'string', required: false },
@@ -627,11 +666,21 @@ export class PlaybooksService {
     );
 
     const params = {
-      body: { name, description, keywords, recommendedPhase, role, signal, recordTypeId },
+      body: {
+        name,
+        description,
+        keywords,
+        recommendedPhase,
+        window,
+        windowTurns,
+        role,
+        signal,
+        recordTypeId,
+      },
     };
 
     const result = await internalRequest(this.sdk, 
-      `/ai/playbooks/goalTypes/${goalTypeId}`,
+      `/ai/playbooks/goalTypes/${id}`,
       'PUT',
       params,
     );

package/services/messaging/TenDlcCampaignManagementService.js

@@ -447,6 +447,36 @@ export class TenDlcCampaignManagementService {
     return result;
   }
 
+  /**
+   * Bulk-add/move phone numbers onto a campaign
+   * @param {string} campaignId - Campaign ID
+   * @param {Object} options
+   * @param {string[]} options.phoneNumbers - Phone numbers in E.164 format (1-200)
+   * @param {boolean} [options.force] - Move numbers off another campaign instead
+   *   of returning a 409 conflict
+   * @returns {Promise<Object>} `{ id, results: [{ phoneNumber, status, ... }] }`
+   */
+  async addPhoneNumbers(campaignId, { phoneNumbers, force } = {}) {
+    this.sdk.validateParams(
+      { campaignId, phoneNumbers },
+      {
+        campaignId: { type: 'string', required: true },
+        phoneNumbers: { type: 'array', required: true },
+      },
+    );
+
+    const options = {
+      body: { phoneNumbers, force },
+    };
+
+    const result = await internalRequest(this.sdk,
+      `/messaging/campaigns/10dlc/campaign/${campaignId}/phoneNumbers`,
+      'POST',
+      options,
+    );
+    return result;
+  }
+
   /**
    * Remove phone number from campaign
    */

package/services/messaging/TenDlcCampaignsService.js

@@ -22,7 +22,7 @@ export class TenDlcCampaignsService {
       },
     );
 
-    const result = await internalRequest(this.sdk, 
+    const result = await internalRequest(this.sdk,
       `/messaging/campaigns/10dlc/phoneNumber/${encodeURIComponent(
         phoneNumber,
       )}/campaignStatus`,
@@ -30,4 +30,41 @@ export class TenDlcCampaignsService {
     );
     return result;
   }
+
+  /**
+   * List every account phone number with its 10DLC campaign link (if any)
+   * @returns {Promise<Array>} `[{ id, phoneNumber, name, city, state, country,
+   *   campaignId, campaignName, campaignLinkingStatus, linkedAt }]`
+   */
+  async listPhoneNumberAssignments() {
+    const result = await internalRequest(this.sdk,
+      `/messaging/campaigns/10dlc/phoneNumbers/assignments`,
+      'GET',
+    );
+    return result;
+  }
+
+  /**
+   * Get the current 10DLC campaign link for one phone number
+   * @param {string} phoneNumber - Phone number to check
+   * @returns {Promise<Object>} `{ phoneNumber, campaignId, campaignName,
+   *   campaignStatus, campaignLinkingStatus, linkedAt }` (campaignId is null
+   *   when the number is unassigned)
+   */
+  async getPhoneNumberCampaign(phoneNumber) {
+    this.sdk.validateParams(
+      { phoneNumber },
+      {
+        phoneNumber: { type: 'string', required: true },
+      },
+    );
+
+    const result = await internalRequest(this.sdk,
+      `/messaging/campaigns/10dlc/phoneNumber/${encodeURIComponent(
+        phoneNumber,
+      )}/campaign`,
+      'GET',
+    );
+    return result;
+  }
 }

package/services/webchat.js

@@ -165,6 +165,32 @@ export class WebchatConversationMessagesService {
       params,
     );
   }
+
+  /**
+   * Hide a link preview on a webchat message (same as chat.hideUnfurl).
+   * @param {string} widgetId
+   * @param {string} engagementSessionId
+   * @param {string} messageId
+   * @param {Object} options
+   * @param {string} options.url
+   */
+  async hideUnfurl(widgetId, engagementSessionId, messageId, { url } = {}) {
+    this.sdk.validateParams(
+      { widgetId, engagementSessionId, messageId, url },
+      {
+        widgetId: { type: 'string', required: true },
+        engagementSessionId: { type: 'string', required: true },
+        messageId: { type: 'string', required: true },
+        url: { type: 'string', required: true },
+      },
+    );
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/${widgetId}/conversations/${engagementSessionId}/messages/${messageId}/unfurls/hide`,
+      'POST',
+      { body: { url } },
+    );
+  }
 }
 
 export class WebchatConversationsService {