@signalhousellc/sdk 1.0.65 → 1.0.66

package/src/domains/Landings.js

@@ -1,3 +1,18 @@
+/**
+ * @typedef {Object} TollFreeConsentBox
+ * @property {string} useCase - The use case the checkbox covers
+ * @property {string} channel - The channel the checkbox covers ("SMS" or "MMS")
+ * @property {string} text - The wording rendered beside the checkbox
+ */
+
+/**
+ * @typedef {Object} TollFreeLandingData
+ * @property {string[]} useCases - The campaign's real use cases; one consent box is rendered per use case per channel
+ * @property {string[]} channels - The channels consent covers ("SMS", "MMS", "VOICE")
+ * @property {string} consentDisclosure - The shared disclosure rendered once above the consent boxes (max 1024 characters)
+ * @property {TollFreeConsentBox[]} consentBoxes - The consent boxes the page renders (max 16; each text max 512 characters)
+ */
+
 /**
  * @typedef {Object} CreateLandingData
  * @property {string} brandId - The ID of the brand to associate with the landing page
@@ -7,6 +22,11 @@
  * @property {string} primaryTextColor - The primary text color for the landing page (e.g., "#000000")
  * @property {string} secondaryTextColor - The secondary text color for the landing page (e.g., "#333333")
  * @property {Buffer} logo - A logo image file for the landing page, provided as a Buffer
+ * @property {string} [registrationType] - Which page type to build: "TEN_DLC" (default) or "TOLL_FREE"
+ * @property {TollFreeLandingData} [tollFree] - Toll-Free consent content; required when registrationType is "TOLL_FREE"
+ * @property {boolean} [useBrandTemplate] - Toll-Free only. Build the page from the brand's landing page template,
+ *   taking its colors, logo and webhook URL from there. When set, no logo file is required. `description` is
+ *   still sent by the caller, since the About paragraph names the services this campaign's use cases cover.
  */
 
 /**
@@ -17,6 +37,21 @@
  * @property {string} [primaryTextColor] - The primary text color for the landing page (e.g., "#000000")
  * @property {string} [secondaryTextColor] - The secondary text color for the landing page (e.g., "#333333")
  * @property {Buffer} [logo] - A logo image file for the landing page, provided as a Buffer
+ * @property {string} [registrationType] - Which page type to build: "TEN_DLC" or "TOLL_FREE"
+ * @property {TollFreeLandingData} [tollFree] - Replaces the whole Toll-Free consent subdocument when set
+ * @property {boolean} [useBrandTemplate] - Toll-Free only. Re-copy the brand's landing page template into this
+ *   page, so a corrected logo or color reaches a page that already exists instead of creating a second one.
+ */
+
+/**
+ * @typedef {Object} LandingTemplateData
+ * @property {string} userDescription - The customer's own sentence about their business. Not the finished About
+ *   paragraph: the services clause is added per campaign when a page is generated
+ * @property {string} [primaryBackgroundColor] - The primary background color (e.g., "#FFFFFF")
+ * @property {string} [secondaryBackgroundColor] - The secondary background color (e.g., "#F0F0F0")
+ * @property {string} [primaryTextColor] - The primary text color (e.g., "#000000")
+ * @property {string} [secondaryTextColor] - The secondary text color (e.g., "#333333")
+ * @property {string} [webhookUrl] - Where generated pages post opt-in submissions
  */
 
 export class Landings {
@@ -139,6 +174,55 @@ export class Landings {
 		return this.client(`/landing/brand/${safeBrandId}`, { method: "GET", ...options });
 	}
 
+	/**
+	 * Get a brand's Toll-Free landing page template — the reusable look every page the brand generates
+	 * snapshots. Returns an empty array when the brand has no template.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for getting a landing page template
+	 * @param {string} params.brandId - The brand ID to look up the template for
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @throws {Error} Throws an error if the brandId parameter is missing
+	 * @returns {Promise<Object>} - The template returned from the server
+	 */
+	async getLandingTemplate({ brandId, options = {} }) {
+		this.client._require({ brandId });
+		const safeBrandId = encodeURIComponent(brandId);
+		return this.client(`/landing/template/${safeBrandId}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Create or replace a brand's Toll-Free landing page template. Editing a template never alters a page
+	 * that already exists, so a URL already given to a carrier keeps rendering what was declared.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for saving a landing page template
+	 * @param {string} params.brandId - The brand the template belongs to
+	 * @param {LandingTemplateData} params.templateData - The template fields (see LandingTemplateData typedef)
+	 * @param {Buffer} [params.file] - A logo image file, provided as a Buffer. Required the first time only;
+	 *   omit it on a later save to keep the stored logo
+	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+	 * @throws {Error} Throws an error if the brandId parameter is missing
+	 * @returns {Promise<Object>} - The saved template returned from the server
+	 */
+	async upsertLandingTemplate({ brandId, templateData, file, options = {} }) {
+		this.client._require({ brandId });
+		const safeBrandId = encodeURIComponent(brandId);
+		const formData = new FormData();
+
+		if (file) {
+			formData.append("file", file);
+		}
+
+		Object.entries(templateData).forEach(([key, value]) => {
+			if (value !== undefined) {
+				formData.append(key, typeof value === "object" ? JSON.stringify(value) : value);
+			}
+		});
+
+		return this.multipartClient(`/landing/template/${safeBrandId}`, { method: "PUT", body: formData, ...options });
+	}
+
 	async deleteLanding({ landingId, options = {} }) {
 		this.client._require({ landingId });
 		const safeLandingId = encodeURIComponent(landingId);

package/src/domains/Messages.js

@@ -21,16 +21,19 @@ export class Messages {
 	 * @param {string|string[]} [params.channel] - Filter messages by channel. Accepts a single value or an array. Allowed values: tenDLC, tollFree, shortCode, p2p. Each message records its channel when it is saved, and this filters on that stored value; older messages from before this feature have no channel and count as tenDLC. Ignored when matchAny is true (matchAny takes precedence).
 	 * @param {boolean} [params.matchAny] - When true, the provided campaignId/brandId/phoneNumber filters are OR'd (a message matches ANY of them) instead of the default most-specific-single behavior. subgroupId stays an AND scope. Opt-in/additive.
 	 * @param {string} [params.carrier] - Filter messages by the carrier used for sending
+	 * @param {string|string[]} [params.sentimentLabel] - Filter messages by sentiment bucket. Accepts a single value or an array (e.g. ["positive", "negative"]). Allowed values: positive, neutral, negative. Applied as the sentimentScore range the ±25 label threshold produces, so unscored messages match no bucket and outbound messages (never scored) are excluded.
 	 * @param {string} [params.senderPhoneNumber] - Filter messages by the sender's 5-6 digit Short Code or 10+ digit phone number
 	 * @param {string} [params.recipientPhoneNumber] - Filter messages by the recipient's phone number
 	 * @param {string} [params.startDate] - ISO-8601 date or timestamp; normalized to start-of-UTC-day (inclusive)
 	 * @param {string} [params.endDate] - ISO-8601 date or timestamp; normalized to end-of-UTC-day (inclusive). Hourly resolution is not supported
-	 * @param {string} [params.sortField] - The field to sort the messages by
+	 * @param {string} [params.sortField] - The field to sort the messages by (createdAt, segmentCount, status, sentimentScore)
 	 * @param {string} [params.sortOrder] - The order to sort the messages (asc, desc)
 	 * @param {number} [params.page] - The page number for pagination
 	 * @param {number} [params.limit] - The number of messages per page
 	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @returns {Promise<Object>} - A promise that resolves to the list of messages
+	 * @returns {Promise<Object>} - A promise that resolves to the list of messages. Inbound messages also carry
+	 * sentimentScore (-100..100, null when unscored), sentimentLabel ("positive"|"neutral"|"negative", null when
+	 * sentimentScore is null) and sentimentScoredAt. Outbound messages are never scored.
 	 */
 	async getMessages({
 		id,
@@ -47,6 +50,7 @@ export class Messages {
 		channel,
 		matchAny,
 		carrier,
+		sentimentLabel,
 		startDate,
 		endDate,
 		sortField,
@@ -55,7 +59,7 @@ export class Messages {
 		limit,
 		options = {},
 	}) {
-		const filters = { id, campaignId, brandId, subgroupId, groupId, phoneNumber, senderPhoneNumber, recipientPhoneNumber, status, direction, messageType, channel, matchAny, carrier, startDate, endDate, sortField, sortOrder, page, limit };
+		const filters = { id, campaignId, brandId, subgroupId, groupId, phoneNumber, senderPhoneNumber, recipientPhoneNumber, status, direction, messageType, channel, matchAny, carrier, sentimentLabel, startDate, endDate, sortField, sortOrder, page, limit };
 		const queryString = this.client._getQueryString(filters);
 		return this.client(`/message${queryString}`, { method: "GET", ...options });
 	}
@@ -86,20 +90,28 @@ export class Messages {
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for getting analytics
 	 * @param {string} [params.groupId] - Filter analytics by the ID of the associated group
-	 * @param {string} [params.subgroupId] - Filter analytics by the ID of the associated subgroup
-	 * @param {string} [params.brandId] - Filter analytics by the ID of the associated brand
-	 * @param {string} [params.campaignId] - Filter analytics by the ID of the associated campaign
-	 * @param {string} [params.phoneNumber] - Filter analytics by the phone number involved in the messages
-	 * @param {string} [params.carrier] - Filter analytics by the carrier used for sending
+	 * @param {string|string[]} [params.subgroupId] - Filter analytics by the ID of the associated subgroup. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.brandId] - Filter analytics by the ID of the associated brand. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.campaignId] - Filter analytics by the ID of the associated campaign. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.phoneNumber] - Filter analytics by the phone number involved in the messages. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.carrier] - Filter analytics by the carrier used for sending. Accepts a single value, an array, or a comma-separated string.
 	 * @param {string} [params.startDate] - ISO-8601 date or timestamp; normalized to start-of-UTC-day (inclusive)
 	 * @param {string} [params.endDate] - ISO-8601 date or timestamp; normalized to end-of-UTC-day (inclusive). Hourly resolution is not supported
 	 * @param {boolean} [params.matchAny] - When true, the provided campaignId/brandId/phoneNumber filters are OR'd (match ANY) instead of the default most-specific-single behavior. subgroupId stays an AND scope. Opt-in/additive.
+	 * @param {(string|string[])} [params.messageType] - Message type(s) the SENTIMENT figures are scoped to: SMS, MMS or P2P (single value, array, or comma-separated string). Omit for all scored types. Does NOT narrow the message counts, which are always returned split per type (smsInbound/mmsInbound/p2pInbound) and have no filterable type dimension.
 	 * @param {string|string[]} [params.channel] - Filter analytics by channel (tenDLC, tollFree, shortCode, p2p). Filters on the stored channel column; a tenDLC selection also includes older messages that have no channel, and p2p is a real channel here (matched by carrier). Accepts a single value or an array. Ignored when matchAny is true (matchAny takes precedence).
 	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @returns {Promise<Object>} - A promise that resolves to the analytics data
+	 * @returns {Promise<Object>} - A promise that resolves to the analytics data. Also includes inbound-message
+	 * sentiment for the requested scope: sentimentScore (volume-weighted average of every scored inbound message
+	 * in range, -100..100, null when nothing was scored), sentimentLabel ("positive"|"neutral"|"negative", null
+	 * when sentimentScore is null), sentimentScoredCount, sentimentPositive, sentimentNeutral, sentimentNegative.
+	 * plus the same six per message type under smsSentiment*, mmsSentiment* and p2pSentiment* prefixes. Every
+	 * score is divided server-side and the raw sums are never returned: a score is an average and must never be
+	 * summed or re-averaged across types, rows or responses. To weight a subset of message types, pass
+	 * messageType and read sentimentScore.
 	 */
-	async getAnalytics({ groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel, matchAny, options = {} }) {
-		const filters = { groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel, matchAny };
+	async getAnalytics({ groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel, messageType, matchAny, options = {} }) {
+		const filters = { groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel, messageType, matchAny };
 		const queryString = this.client._getQueryString(filters);
 		return this.client(`/message/analytics${queryString}`, { method: "GET", ...options });
 	}
@@ -110,19 +122,26 @@ export class Messages {
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for getting detailed analytics
 	 * @param {string} [params.groupId] - Filter analytics by the ID of the associated group
-	 * @param {string} [params.subgroupId] - Filter analytics by the ID of the associated subgroup
-	 * @param {string} [params.brandId] - Filter analytics by the ID of the associated brand
-	 * @param {string} [params.campaignId] - Filter analytics by the ID of the associated campaign
-	 * @param {string} [params.phoneNumber] - Filter analytics by the phone number involved in the messages
-	 * @param {string} [params.carrier] - Filter analytics by the carrier used for sending
+	 * @param {string|string[]} [params.subgroupId] - Filter analytics by the ID of the associated subgroup. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.brandId] - Filter analytics by the ID of the associated brand. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.campaignId] - Filter analytics by the ID of the associated campaign. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.phoneNumber] - Filter analytics by the phone number involved in the messages. Accepts a single value, an array, or a comma-separated string.
+	 * @param {string|string[]} [params.carrier] - Filter analytics by the carrier used for sending. Accepts a single value, an array, or a comma-separated string.
 	 * @param {string} [params.startDate] - ISO-8601 date or timestamp; normalized to start-of-UTC-day (inclusive)
 	 * @param {string} [params.endDate] - ISO-8601 date or timestamp; normalized to end-of-UTC-day (inclusive). Hourly resolution is not supported
+	 * @param {(string|string[])} [params.messageType] - Message type(s) the SENTIMENT figures are scoped to: SMS, MMS or P2P (single value, array, or comma-separated string). Omit for all scored types. Does NOT narrow the message counts, which are always returned split per type (smsInbound/mmsInbound/p2pInbound) and have no filterable type dimension.
 	 * @param {string|string[]} [params.channel] - Filter analytics by channel (tenDLC, tollFree, shortCode, p2p). Filters on the stored channel column; a tenDLC selection also includes older messages that have no channel, and p2p is a real channel here. Accepts a single value or an array.
 	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
-	 * @returns {Promise<Array>} - A promise that resolves to an array of analytics snapshot records
+	 * @returns {Promise<Array>} - A promise that resolves to an array of analytics snapshot records. cardTotals and
+	 * every byDate/byPhoneNumber/byCarrier row also carry that row's own inbound-message sentiment: sentimentScore
+	 * (volume-weighted average, -100..100, null when nothing in that row's scope was scored), sentimentLabel,
+	 * sentimentScoredCount, sentimentPositive, sentimentNeutral, sentimentNegative. The fields are always present;
+	 * plus the same six per message type under smsSentiment*, mmsSentiment* and p2pSentiment* prefixes. Every
+	 * score is divided server-side and the raw sums are never returned: a score is an average and must never be
+	 * summed or re-averaged across types, rows or responses.
 	 */
-	async getAnalyticsDetail({ groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel, options = {} }) {
-		const filters = { groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel };
+	async getAnalyticsDetail({ groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel, messageType, options = {} }) {
+		const filters = { groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, channel, messageType };
 		const queryString = this.client._getQueryString(filters);
 		return this.client(`/message/analytics/detail${queryString}`, { method: "GET", ...options });
 	}
@@ -160,11 +179,13 @@ export class Messages {
 	 * @param {number} [params.page=1]
 	 * @param {number} [params.limit=50] - max 50 per page
 	 * @param {("tenDLC"|"tollFree"|"shortCode"|"p2p"|"both")|Array<"tenDLC"|"tollFree"|"shortCode"|"p2p">} [params.channel="both"] - Filter and rank rows by the stored channel column. "both" (default) means all activity. tenDLC/tollFree/shortCode/p2p (single value or array) limit to the selected channel(s).
+	 * @param {(string|string[])} [params.messageType] - Message type(s) the SENTIMENT figures are scoped to: SMS, MMS or P2P (single value, array, or comma-separated string). Omit for all scored types. Does NOT narrow the message counts, which are always returned split per type (smsInbound/mmsInbound/p2pInbound) and have no filterable type dimension.
 	 * @param {import('../SignalHouseSDK').RequestOptions} [params.options]
 	 * @returns {Promise<Object>} - { rows, totalCount, page, limit }. Each row carries sms/mms/p2p metric columns plus `smsOptOuts` and `mmsOptOuts` from the DNC analytics MV (P2P has no opt-outs).
+	 * Each row also carries that subgroup's inbound-message sentiment: `sentimentScore` (volume-weighted average of every scored inbound message in that subgroup, -100..100, null when nothing was scored), `sentimentLabel`, `sentimentScoredCount`, `sentimentPositive`, `sentimentNeutral`, `sentimentNegative`, plus the same six per message type under `smsSentiment*`, `mmsSentiment*` and `p2pSentiment*` prefixes. The score is derived server-side and must never be re-averaged across rows — combine the counts, not the scores.
 	 */
-	async getAnalyticsBySubgroup({ groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, page, limit, channel, options = {} }) {
-		const filters = { groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, page, limit, channel };
+	async getAnalyticsBySubgroup({ groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, page, limit, channel, messageType, options = {} }) {
+		const filters = { groupId, subgroupId, brandId, campaignId, phoneNumber, carrier, startDate, endDate, page, limit, channel, messageType };
 		const queryString = this.client._getQueryString(filters);
 		return this.client(`/message/analytics/by-subgroup${queryString}`, { method: "GET", ...options });
 	}

package/src/domains/Numbers.js

@@ -77,6 +77,15 @@ export class Numbers {
    * @param {number} [params.page] - The page number for pagination (default: 1)
    * @param {number} [params.limit] - The number of items per page for pagination (default: 20)
    * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
+   *
+   * Every record carries a `sentiment` object -- trailing 7-day and 30-day inbound reply sentiment,
+   * refreshed periodically from analytics rather than computed per request: `{ sevenDay, thirtyDay,
+   * updatedAt }`, each window being `{ score, label, scoredCount, positive, neutral, negative }`. The
+   * object is always present and fully populated, so it can be read without a presence check.
+   * `score` is a volume-weighted average in -100..100 and is null when nothing was scored in the
+   * window, which is not the same as a score of 0 -- null means nobody replied, 0 means replies
+   * averaged neutral. `updatedAt` is null until the first rollup writes the record, and it tracks when
+   * the figures last CHANGED, not when the job last ran.
    * @returns {Promise<Object>} A promise that resolves to the list of phone numbers
    */
   async getPhoneNumbers({ phoneNumber, campaignId, brandId, subgroupId, groupId, page, limit, options = {} }) {
@@ -254,6 +263,8 @@ export class Numbers {
    * @param {string} params.phoneNumber - The phone number to update
    * @param {Object} params.updateData - The data to update for the phone number
    * @param {string} [params.updateData.friendlyName] - An optional friendly name for the phone number
+   * @param {string|null} [params.updateData.primaryInboundWebhookUrl] - Primary inbound voice webhook URL (http/https). When set, inbound calls to this number are driven by the SHML your webhook returns (programmable call control). Pass null or an empty string to clear.
+   * @param {string|null} [params.updateData.secondaryInboundWebhookUrl] - Secondary inbound voice webhook URL (http/https), used for failover when the primary returns an error. Pass null or an empty string to clear.
    * @param {import('../SignalHouseSDK').RequestOptions} [params.options] - Additional options for the request
    * @throws {Error} Throws an error if the phoneNumber or updateData parameter is missing
    * @returns {Promise<Object>} A promise that resolves to the updated phone number object

package/src/domains/voice/ProgrammableVoiceProfiles.js

@@ -3,11 +3,12 @@
  * @property {string} name - Profile name (required).
  * @property {string[]} subgroupIds - Subgroups this profile spans (required, at least one).
  * @property {string} [region] - Region/POP label.
- * @property {"FORWARD"|"WEBRTC"|"SIP_TRUNK"|"SIP_PROFILE"} [routeAction] - Inbound call action (default "FORWARD"). Deliver the call to a PSTN number (FORWARD), ring the profile's subgroup registered softphones (WEBRTC), send to a SIP trunk (SIP_TRUNK), or ring a registered SIP endpoint (SIP_PROFILE).
+ * @property {"FORWARD"|"WEBRTC"|"SIP_TRUNK"|"SIP_PROFILE"|"CALL_CONTROL"} [routeAction] - Inbound call action (default "FORWARD"). Deliver the call to a PSTN number (FORWARD), ring the profile's subgroup registered softphones (WEBRTC), send to a SIP trunk (SIP_TRUNK), ring a registered SIP endpoint (SIP_PROFILE), or hand the call to your programmable call-control webhook that returns SHML (CALL_CONTROL).
  * @property {string} [forwardToE164] - Destination number, required when routeAction is "FORWARD".
  * @property {number} [forwardAfterSeconds] - Ring seconds before the action fires.
  * @property {string} [routeSipTrunkId] - SIP trunk id, required when routeAction is "SIP_TRUNK".
  * @property {string} [routeSipProfileId] - SIP endpoint id, required when routeAction is "SIP_PROFILE".
+ * @property {string} [webhookUrl] - Your inbound voice webhook (SHML program URL), required when routeAction is "CALL_CONTROL". Inbound calls to this profile's numbers are driven by the SHML your webhook returns.
  * @property {boolean} [recordingEnabled] - Record calls on this profile.
  * @property {boolean} [enabled] - Active state (default true).
  */
@@ -17,11 +18,12 @@
  * @property {string} [name] - Profile name.
  * @property {string[]} [subgroupIds] - Subgroups this profile spans.
  * @property {string|null} [region] - Region/POP label.
- * @property {"FORWARD"|"WEBRTC"|"SIP_TRUNK"|"SIP_PROFILE"} [routeAction] - Inbound call action (FORWARD | WEBRTC | SIP_TRUNK | SIP_PROFILE).
+ * @property {"FORWARD"|"WEBRTC"|"SIP_TRUNK"|"SIP_PROFILE"|"CALL_CONTROL"} [routeAction] - Inbound call action (FORWARD | WEBRTC | SIP_TRUNK | SIP_PROFILE | CALL_CONTROL).
  * @property {string|null} [forwardToE164] - FORWARD destination.
  * @property {number|null} [forwardAfterSeconds] - Ring seconds before the action fires.
  * @property {string|null} [routeSipTrunkId] - SIP trunk id (required when routeAction is "SIP_TRUNK").
  * @property {string|null} [routeSipProfileId] - SIP endpoint id (required when routeAction is "SIP_PROFILE").
+ * @property {string|null} [webhookUrl] - Inbound voice webhook / SHML program URL (required when routeAction is "CALL_CONTROL"). Pass null to clear.
  * @property {boolean} [recordingEnabled] - Record calls on this profile.
  * @property {boolean} [enabled] - Active state.
  */