@ikatec/digisac-api-sdk 4.7.0 → 4.9.0

package/src/apis/campaigns/CampaignsApi.test.ts

@@ -3,6 +3,8 @@ import { CampaignsApi } from './CampaignsApi'
 import type { ApiClient } from '../../core/ApiClient'
 import type {
   Campaign,
+  CampaignContactsPage,
+  CampaignTimelineEvent,
   CreateCampaignPayload,
   CampaignStats,
   SetIntervalPayload,
@@ -43,11 +45,7 @@ const campaign: Campaign = {
   totalContacts: null,
   totalContactsImported: null,
   totalValidContacts: null,
-  sentContacts: null,
-  viewedContacts: null,
-  contactCount: null,
   mustOpenTicket: false,
-  marketingIntegration: false,
   accountId: 'acc-1',
   serviceId: 'svc-1',
   defaultDepartmentId: null,
@@ -188,32 +186,44 @@ describe('CampaignsApi', () => {
 
   describe('sendById', () => {
     it('calls client.post with /campaigns/:id/send', async () => {
-      vi.mocked(client.post).mockResolvedValue(campaign)
+      vi.mocked(client.post).mockResolvedValue({ ...campaign, status: 'processing' })
       const result = await api.sendById('cmp-1')
-      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/send')
-      expect(result).toEqual(campaign)
+      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/send', undefined, undefined)
+      expect(result).toEqual({ ...campaign, status: 'processing' })
     })
   })
 
-  // ── pauseById ────────────────────────────────────────────────────
+  // ── pauseById / resumeById / retryById ───────────────────────────
 
   describe('pauseById', () => {
-    it('calls client.post with /campaigns/:id/pause', async () => {
-      vi.mocked(client.post).mockResolvedValue(campaign)
+    it('calls client.post with /campaigns/:id/pause and resolves the boolean', async () => {
+      vi.mocked(client.post).mockResolvedValue(true)
       const result = await api.pauseById('cmp-1')
-      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/pause')
-      expect(result).toEqual(campaign)
+      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/pause', undefined, undefined)
+      expect(result).toBe(true)
     })
   })
 
-  // ── resumeById ───────────────────────────────────────────────────
-
   describe('resumeById', () => {
-    it('calls client.post with /campaigns/:id/resume', async () => {
-      vi.mocked(client.post).mockResolvedValue(campaign)
+    it('calls client.post with /campaigns/:id/resume and resolves the boolean', async () => {
+      vi.mocked(client.post).mockResolvedValue(true)
       const result = await api.resumeById('cmp-1')
-      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/resume')
-      expect(result).toEqual(campaign)
+      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/resume', undefined, undefined)
+      expect(result).toBe(true)
+    })
+  })
+
+  describe('retryById', () => {
+    it('calls client.post with /campaigns/:id/retry', async () => {
+      vi.mocked(client.post).mockResolvedValue('OK')
+      const result = await api.retryById('cmp-1')
+      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/retry', undefined, undefined)
+      expect(result).toBe('OK')
+    })
+
+    it('resolves false for an unknown campaign', async () => {
+      vi.mocked(client.post).mockResolvedValue(false)
+      await expect(api.retryById('unknown')).resolves.toBe(false)
     })
   })
 
@@ -223,7 +233,7 @@ describe('CampaignsApi', () => {
     it('calls client.post with /campaigns/:id/duplicate', async () => {
       vi.mocked(client.post).mockResolvedValue(campaign)
       const result = await api.duplicateById('cmp-1')
-      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/duplicate')
+      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/duplicate', undefined, undefined)
       expect(result).toEqual(campaign)
     })
   })
@@ -233,6 +243,16 @@ describe('CampaignsApi', () => {
   describe('getStatsById', () => {
     it('calls client.get with /campaigns/:id/stats', async () => {
       const stats: CampaignStats = {
+        total: 100,
+        sent: 100,
+        failed: 10,
+        sending: 0,
+        sentToServer: 5,
+        received: 85,
+        viewed: 70,
+        played: 0,
+        answered: 30,
+        sentAndNotReceived: 5,
         campaignInfo: {
           totalValidContacts: 100,
           totalContacts: 110,
@@ -240,74 +260,184 @@ describe('CampaignsApi', () => {
           firedSuccessCount: 90,
           firedFailedCount: 10,
           totalMessagesCount: 100,
+          sentMessagesCount: 100,
           totalFiredCount: 100,
           firedBlockedByMessageRuleCount: 0,
         },
-        messageInfo: { error: 5, received: 85, viewed: 70, answered: 30 },
+        messageInfo: {
+          error: 5,
+          sending: 0,
+          sentToServer: 5,
+          received: 85,
+          viewed: 70,
+          played: 0,
+          answered: 30,
+        },
       }
       vi.mocked(client.get).mockResolvedValue(stats)
       const result = await api.getStatsById('cmp-1')
-      expect(client.get).toHaveBeenCalledWith('/campaigns/cmp-1/stats')
+      expect(client.get).toHaveBeenCalledWith('/campaigns/cmp-1/stats', undefined)
       expect(result).toEqual(stats)
     })
   })
 
+  // ── getTimeline ──────────────────────────────────────────────────
+
+  describe('getTimeline', () => {
+    it('calls client.get with /campaigns/:id/timeline', async () => {
+      const events: CampaignTimelineEvent[] = [
+        {
+          id: 'finished',
+          type: 'finished',
+          timestamp: '2026-10-14T15:02:40.770Z',
+          actor: 'Sistema',
+          triggerType: 'automatic',
+        },
+        {
+          id: 'created',
+          type: 'created',
+          timestamp: '2026-10-14T15:02:33.795Z',
+          actor: 'Ana',
+          triggerType: 'manual',
+        },
+      ]
+      vi.mocked(client.get).mockResolvedValue(events)
+      const result = await api.getTimeline('cmp-1')
+      expect(client.get).toHaveBeenCalledWith('/campaigns/cmp-1/timeline', undefined)
+      expect(result).toEqual(events)
+    })
+  })
+
+  // ── getContacts ──────────────────────────────────────────────────
+
+  describe('getContacts', () => {
+    const page: CampaignContactsPage = {
+      data: [],
+      total: 0,
+      limit: 15,
+      skip: 0,
+      currentPage: 1,
+      lastPage: 1,
+      from: 0,
+      to: 0,
+    }
+
+    it('calls client.get with /campaigns/:id/contacts when no query is provided', async () => {
+      vi.mocked(client.get).mockResolvedValue(page)
+      const result = await api.getContacts('cmp-1')
+      expect(client.get).toHaveBeenCalledWith('/campaigns/cmp-1/contacts', undefined)
+      expect(result).toEqual(page)
+    })
+
+    it('serializes the query', async () => {
+      vi.mocked(client.get).mockResolvedValue(page)
+      await api.getContacts('cmp-1', { page: 2, contactStatus: ['not_sent'], sortBy: 'sentAt' })
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
+      expect(url.startsWith('/campaigns/cmp-1/contacts?')).toBe(true)
+      expect(decodeURIComponent(url)).toContain('"contactStatus":["not_sent"]')
+    })
+  })
+
   // ── setIntervalById ──────────────────────────────────────────────
 
   describe('setIntervalById', () => {
     it('calls client.post with /campaigns/:id/interval and body', async () => {
-      vi.mocked(client.post).mockResolvedValue(campaign)
-      const data: SetIntervalPayload = { minInterval: '1000', maxInterval: '5000' }
+      vi.mocked(client.post).mockResolvedValue(true)
+      const data: SetIntervalPayload = { minInterval: 5, maxInterval: 10 }
       const result = await api.setIntervalById('cmp-1', data)
-      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/interval', data)
-      expect(result).toEqual(campaign)
+      expect(client.post).toHaveBeenCalledWith('/campaigns/cmp-1/interval', data, undefined)
+      expect(result).toBe(true)
     })
   })
 
-  // ── getContactCount ──────────────────────────────────────────────
+  // ── getContactCount / countReadyByService ────────────────────────
 
   describe('getContactCount', () => {
     it('calls client.get with /campaigns/:id/contactCount', async () => {
       vi.mocked(client.get).mockResolvedValue(42)
       const result = await api.getContactCount('cmp-1')
-      expect(client.get).toHaveBeenCalledWith('/campaigns/cmp-1/contactCount')
+      expect(client.get).toHaveBeenCalledWith('/campaigns/cmp-1/contactCount', undefined)
       expect(result).toBe(42)
     })
   })
 
+  describe('countReadyByService', () => {
+    it('calls client.get with /campaigns/count-ready/:serviceId', async () => {
+      vi.mocked(client.get).mockResolvedValue(4)
+      const result = await api.countReadyByService('svc-1')
+      expect(client.get).toHaveBeenCalledWith('/campaigns/count-ready/svc-1', undefined)
+      expect(result).toBe(4)
+    })
+  })
+
   // ── setAutoPauseMode ─────────────────────────────────────────────
 
   describe('setAutoPauseMode', () => {
     it('calls client.put with /campaigns/autoPauseMode and body', async () => {
-      vi.mocked(client.put).mockResolvedValue({ ok: true })
-      const data: AutoPauseModePayload = { mode: 'auto' }
+      vi.mocked(client.put).mockResolvedValue('OK')
+      const data: AutoPauseModePayload = { mode: 'medium-health' }
       const result = await api.setAutoPauseMode(data)
-      expect(client.put).toHaveBeenCalledWith('/campaigns/autoPauseMode', data)
-      expect(result).toEqual({ ok: true })
+      expect(client.put).toHaveBeenCalledWith('/campaigns/autoPauseMode', data, undefined)
+      expect(result).toBe('OK')
     })
   })
 
-  // ── exportCampaignResult ─────────────────────────────────────────
+  // ── exports ──────────────────────────────────────────────────────
 
   describe('exportCampaignResult', () => {
-    it('calls client.post with /campaigns/export/csv and body', async () => {
-      vi.mocked(client.post).mockResolvedValue({ ok: true })
-      const data: ExportCampaignResultPayload = { campaignId: 'cmp-1' }
+    it('calls client.post with /campaigns/export/csv and the where of the campaign', async () => {
+      vi.mocked(client.post).mockResolvedValue('Nome do contato;Número do contato\n')
+      const data: ExportCampaignResultPayload = {
+        where: { campaignId: 'cmp-1' },
+        type: 'semiColon',
+      }
       const result = await api.exportCampaignResult(data)
-      expect(client.post).toHaveBeenCalledWith('/campaigns/export/csv', data)
-      expect(result).toEqual({ ok: true })
+      expect(client.post).toHaveBeenCalledWith('/campaigns/export/csv', data, undefined)
+      expect(result).toBe('Nome do contato;Número do contato\n')
     })
   })
 
-  // ── exportTemplateCsv ────────────────────────────────────────────
-
   describe('exportTemplateCsv', () => {
     it('calls client.post with /campaigns/exportTemplate and body', async () => {
-      vi.mocked(client.post).mockResolvedValue({ ok: true })
+      vi.mocked(client.post).mockResolvedValue('Nome;Telefone;Username\n')
       const data: ExportTemplateCsvPayload = { hsmId: 'hsm-1' }
       const result = await api.exportTemplateCsv(data)
-      expect(client.post).toHaveBeenCalledWith('/campaigns/exportTemplate', data)
-      expect(result).toEqual({ ok: true })
+      expect(client.post).toHaveBeenCalledWith('/campaigns/exportTemplate', data, undefined)
+      expect(result).toBe('Nome;Telefone;Username\n')
+    })
+  })
+
+  describe('exportImportErrors', () => {
+    it('calls client.get with /campaigns/:id/import-errors', async () => {
+      vi.mocked(client.get).mockResolvedValue('Linha,Nome,Número,Username,Motivo\n')
+      const result = await api.exportImportErrors('cmp-1')
+      expect(client.get).toHaveBeenCalledWith('/campaigns/cmp-1/import-errors', undefined)
+      expect(result).toBe('Linha,Nome,Número,Username,Motivo\n')
+    })
+
+    it('sends the delimiter in the query string', async () => {
+      vi.mocked(client.get).mockResolvedValue('Linha;Nome;Número;Username;Motivo\n')
+      await api.exportImportErrors('cmp-1', { delimiter: ';' })
+      expect(client.get).toHaveBeenCalledWith(
+        '/campaigns/cmp-1/import-errors?delimiter=%3B',
+        undefined,
+      )
+    })
+  })
+
+  // ── deleteMany ───────────────────────────────────────────────────
+
+  describe('deleteMany', () => {
+    it('calls client.request with DELETE /campaigns/delete-many and the ids', async () => {
+      vi.mocked(client.request).mockResolvedValue(true)
+      const result = await api.deleteMany(['cmp-1', 'cmp-2'])
+      expect(client.request).toHaveBeenCalledWith(
+        'DELETE',
+        '/campaigns/delete-many',
+        { ids: ['cmp-1', 'cmp-2'] },
+        undefined,
+      )
+      expect(result).toBe(true)
     })
   })
 
@@ -315,10 +445,13 @@ describe('CampaignsApi', () => {
 
   describe('getHsmLimit', () => {
     it('calls client.get with /whatsapp-business-templates/:accountId/hsmLimit', async () => {
-      const limit: HsmLimit = { hsmLimit: 1000, hsmUsedLimit: 150 }
+      const limit: HsmLimit = { hsmLimit: 1000, hsmUsedLimit: 150, hasLimit: 850 }
       vi.mocked(client.get).mockResolvedValue(limit)
       const result = await api.getHsmLimit('acc-1')
-      expect(client.get).toHaveBeenCalledWith('/whatsapp-business-templates/acc-1/hsmLimit')
+      expect(client.get).toHaveBeenCalledWith(
+        '/whatsapp-business-templates/acc-1/hsmLimit',
+        undefined,
+      )
       expect(result).toEqual(limit)
     })
   })

package/src/apis/campaigns/CampaignsApi.ts

@@ -1,10 +1,16 @@
+import qs from 'qs'
 import type { ApiClient } from '../../core'
 import { BaseCrudApi } from '../../core'
 import type {
   AutoPauseModePayload,
   Campaign,
+  CampaignContactsPage,
+  CampaignContactsQuery,
+  CampaignListQuery,
   CampaignStats,
+  CampaignTimelineEvent,
   CreateCampaignPayload,
+  ExportCampaignImportErrorsQuery,
   ExportCampaignResultPayload,
   ExportTemplateCsvPayload,
   HsmLimit,
@@ -12,79 +18,195 @@ import type {
   UpdateCampaignPayload,
 } from './types'
 
+/**
+ * Campaigns (mass sending). Every `/campaigns` route requires the campaigns feature in the plan of
+ * the account.
+ * `getMany` takes the `where` of a `ListQuery` and the flat filters of the Campaigns screen (see
+ * {@link CampaignListQuery}); `getById` of an unknown id resolves `null`. `deleteById` answers the
+ * text `'OK'`. `getMany({ paginate: false })` answers 400 `FILTER_PARAM_INVALID` with the default
+ * `'json'` query format (the route only takes `paginate` as a string): use `withQueryFormat('qs')`.
+ */
 export class CampaignsApi extends BaseCrudApi<
   Campaign,
   CreateCampaignPayload,
-  UpdateCampaignPayload
+  UpdateCampaignPayload,
+  CampaignListQuery,
+  'OK'
 > {
   constructor(client: ApiClient) {
     super(client, '/campaigns')
+  }
+
+  /**
+   * Starts sending the campaign: answers it as `processing` (an `import_error` campaign goes back
+   * to `importing_contacts`). It becomes `done` once every contact is fired.
+   * @permissions campaigns.view
+   */
+  sendById(id: string, headers?: Record<string, string>): Promise<Campaign> {
+    return this.client.post<Campaign>(`${this.basePath}/${id}/send`, undefined, headers)
+  }
+
+  /**
+   * Sets the campaign as `paused` and answers `true`. An unknown id answers 500.
+   * @permissions campaigns.view
+   */
+  pauseById(id: string, headers?: Record<string, string>): Promise<boolean> {
+    return this.client.post<boolean>(`${this.basePath}/${id}/pause`, undefined, headers)
+  }
+
+  /**
+   * Sets the campaign back to `processing` and answers `true`. An unknown id answers 500.
+   * @permissions campaigns.view
+   */
+  resumeById(id: string, headers?: Record<string, string>): Promise<boolean> {
+    return this.client.post<boolean>(`${this.basePath}/${id}/resume`, undefined, headers)
+  }
+
+  /**
+   * Fires again the messages that failed: sets them as pending and the campaign as `processing`.
+   * Answers the text `'OK'` (also when nothing failed, and then the status does not change); an
+   * unknown id answers `false` (status 200).
+   * @permissions campaigns.view
+   */
+  retryById(id: string, headers?: Record<string, string>): Promise<'OK' | false> {
+    return this.client.post<'OK' | false>(`${this.basePath}/${id}/retry`, undefined, headers)
+  }
+
+  /**
+   * Creates a copy of the campaign (`ready`, same title, messages and tags), answered without the
+   * messages. An unknown id answers 500.
+   * @permissions campaigns.view
+   */
+  duplicateById(id: string, headers?: Record<string, string>): Promise<Campaign> {
+    return this.client.post<Campaign>(`${this.basePath}/${id}/duplicate`, undefined, headers)
+  }
 
-    this.sendById = this.sendById.bind(this)
-    this.pauseById = this.pauseById.bind(this)
-    this.resumeById = this.resumeById.bind(this)
-    this.duplicateById = this.duplicateById.bind(this)
-    this.getStatsById = this.getStatsById.bind(this)
-    this.setIntervalById = this.setIntervalById.bind(this)
-    this.getContactCount = this.getContactCount.bind(this)
-    this.setAutoPauseMode = this.setAutoPauseMode.bind(this)
-    this.exportCampaignResult = this.exportCampaignResult.bind(this)
-    this.exportTemplateCsv = this.exportTemplateCsv.bind(this)
-    this.getHsmLimit = this.getHsmLimit.bind(this)
+  /** Returns the send, delivery and interaction statistics of the campaign. */
+  getStatsById(id: string, headers?: Record<string, string>): Promise<CampaignStats> {
+    return this.client.get<CampaignStats>(`${this.basePath}/${id}/stats`, headers)
   }
 
-  /** Starts sending messages for the given campaign. */
-  sendById(id: string): Promise<Campaign> {
-    return this.client.post<Campaign>(`${this.basePath}/${id}/send`)
+  /**
+   * Returns the events of the campaign (created, scheduled, started, finished and the last
+   * interruption), the most recent first.
+   */
+  getTimeline(id: string, headers?: Record<string, string>): Promise<CampaignTimelineEvent[]> {
+    return this.client.get<CampaignTimelineEvent[]>(`${this.basePath}/${id}/timeline`, headers)
   }
 
-  /** Pauses a campaign that is currently sending. */
-  pauseById(id: string): Promise<Campaign> {
-    return this.client.post<Campaign>(`${this.basePath}/${id}/pause`)
+  /**
+   * Returns a page of the contacts of the campaign with their sending status (15 per page by
+   * default). An unknown id answers an empty page.
+   */
+  getContacts(
+    id: string,
+    query?: CampaignContactsQuery,
+    headers?: Record<string, string>,
+  ): Promise<CampaignContactsPage> {
+    return this.client.get<CampaignContactsPage>(
+      `${this.basePath}/${id}/contacts${this.toQueryString(query)}`,
+      headers,
+    )
   }
 
-  /** Resumes a previously paused campaign. */
-  resumeById(id: string): Promise<Campaign> {
-    return this.client.post<Campaign>(`${this.basePath}/${id}/resume`)
+  /**
+   * Sets the min/max interval between the sends (whole numbers, `0` or more) and answers `true`.
+   * An unknown id answers 500.
+   * @permissions campaigns.view
+   */
+  setIntervalById(
+    id: string,
+    data: SetIntervalPayload,
+    headers?: Record<string, string>,
+  ): Promise<boolean> {
+    return this.client.post<boolean, SetIntervalPayload>(
+      `${this.basePath}/${id}/interval`,
+      data,
+      headers,
+    )
   }
 
-  /** Creates a copy of an existing campaign. */
-  duplicateById(id: string): Promise<Campaign> {
-    return this.client.post<Campaign>(`${this.basePath}/${id}/duplicate`)
+  /** Returns the number of contacts targeted by the campaign. */
+  getContactCount(id: string, headers?: Record<string, string>): Promise<number> {
+    return this.client.get<number>(`${this.basePath}/${id}/contactCount`, headers)
   }
 
-  /** Returns send/delivery/view statistics for a campaign. */
-  getStatsById(id: string): Promise<CampaignStats> {
-    return this.client.get<CampaignStats>(`${this.basePath}/${id}/stats`)
+  /** Counts the `ready` campaigns of a connection. An unknown id counts 0. */
+  countReadyByService(serviceId: string, headers?: Record<string, string>): Promise<number> {
+    return this.client.get<number>(`${this.basePath}/count-ready/${serviceId}`, headers)
   }
 
-  /** Updates the min/max send interval for a campaign. */
-  setIntervalById(id: string, data: SetIntervalPayload): Promise<Campaign> {
-    return this.client.post<Campaign, SetIntervalPayload>(`${this.basePath}/${id}/interval`, data)
+  /**
+   * Sets the auto-pause mode of the campaigns of the account (`settings.campaign`). Answers the
+   * text `'OK'`, or `false` when the account was not updated.
+   */
+  setAutoPauseMode(
+    data: AutoPauseModePayload,
+    headers?: Record<string, string>,
+  ): Promise<'OK' | false> {
+    return this.client.put<'OK' | false, AutoPauseModePayload>(
+      `${this.basePath}/autoPauseMode`,
+      data,
+      headers,
+    )
   }
 
-  /** Returns the total number of contacts targeted by a campaign. */
-  getContactCount(id: string): Promise<number> {
-    return this.client.get<number>(`${this.basePath}/${id}/contactCount`)
+  /**
+   * Exports the contacts of the campaign and their sending result as CSV (13 columns in the
+   * language of the user; `,`, or `;` with `type: 'semiColon'`), streamed without a Content-Type.
+   */
+  exportCampaignResult(
+    data: ExportCampaignResultPayload,
+    headers?: Record<string, string>,
+  ): Promise<string> {
+    return this.client.post<string, ExportCampaignResultPayload>(
+      `${this.basePath}/export/csv`,
+      data,
+      headers,
+    )
   }
 
-  /** Configures the auto-pause behavior for campaigns. */
-  setAutoPauseMode(data: AutoPauseModePayload): Promise<unknown> {
-    return this.client.put(`${this.basePath}/autoPauseMode`, data)
+  /** Exports the CSV (`;`) to fill in the contacts of a campaign of the given HSM template. */
+  exportTemplateCsv(
+    data: ExportTemplateCsvPayload,
+    headers?: Record<string, string>,
+  ): Promise<string> {
+    return this.client.post<string, ExportTemplateCsvPayload>(
+      `${this.basePath}/exportTemplate`,
+      data,
+      headers,
+    )
   }
 
-  /** Exports campaign send results as a CSV file. */
-  exportCampaignResult(data: ExportCampaignResultPayload): Promise<unknown> {
-    return this.client.post(`${this.basePath}/export/csv`, data)
+  /**
+   * Exports the rows of the import file that were not imported (invalid number, unknown or
+   * ambiguous username) as CSV: line, name, number, username and reason.
+   */
+  exportImportErrors(
+    id: string,
+    query?: ExportCampaignImportErrorsQuery,
+    headers?: Record<string, string>,
+  ): Promise<string> {
+    const queryString = query?.delimiter ? `?${qs.stringify({ delimiter: query.delimiter })}` : ''
+    return this.client.get<string>(`${this.basePath}/${id}/import-errors${queryString}`, headers)
   }
 
-  /** Exports a CSV template for importing contacts into an HSM campaign. */
-  exportTemplateCsv(data: ExportTemplateCsvPayload): Promise<unknown> {
-    return this.client.post(`${this.basePath}/exportTemplate`, data)
+  /**
+   * Deletes the campaigns of the given ids and answers `true` (unknown ids are skipped). No id, or
+   * an id that is not a UUID, answers 400 `{ error: 'Invalid ids', code: 'INVALID_IDS' }`.
+   * @permissions campaigns.view OR campaigns.destroy
+   */
+  deleteMany(ids: string[], headers?: Record<string, string>): Promise<true> {
+    return this.client.request<true, { ids: string[] }>(
+      'DELETE',
+      `${this.basePath}/delete-many`,
+      { ids },
+      headers,
+    )
   }
 
-  /** Returns the HSM message usage and limit for an account. */
-  getHsmLimit(accountId: string): Promise<HsmLimit> {
-    return this.client.get<HsmLimit>(`/whatsapp-business-templates/${accountId}/hsmLimit`)
+  /** Returns the HSM message usage and limit of an account. */
+  getHsmLimit(accountId: string, headers?: Record<string, string>): Promise<HsmLimit> {
+    return this.client.get<HsmLimit>(`/whatsapp-business-templates/${accountId}/hsmLimit`, headers)
   }
 }