meta-cloud-api 2.1.0 → 2.3.0

package/dist/types/index.d.ts

@@ -418,7 +418,7 @@ interface TextMessageParams extends MessageRequestParams<TextObject | string> {
 //#region src/api/messages/types/template.d.ts
 type LanguageObject = {
   policy: 'deterministic';
-  code: LanguagesEnum;
+  code: LanguagesEnum | (string & {});
 };
 type ParametersObject<T extends ParametersTypesEnum> = {
   type: T;
@@ -631,28 +631,28 @@ type HeaderObject = {
   video?: VideoMediaObject$1;
 };
 type ButtonInteractiveObject = {
-  type: InteractiveTypesEnum.Button;
+  type: InteractiveTypesEnum.Button | 'button';
   body: SimpleTextObject;
   footer?: SimpleTextObject;
   header?: HeaderObject;
   action: ActionObject;
 };
 type ListInteractiveObject = {
-  type: InteractiveTypesEnum.List;
+  type: InteractiveTypesEnum.List | 'list';
   body: SimpleTextObject;
   footer?: SimpleTextObject;
   header?: HeaderObject;
   action: ActionObject;
 };
 type ProductInteractiveObject = {
-  type: InteractiveTypesEnum.Product;
+  type: InteractiveTypesEnum.Product | 'product';
   body?: SimpleTextObject;
   footer?: SimpleTextObject;
   header?: HeaderObject;
   action: ActionObject;
 };
 type ProductListInteractiveObject = {
-  type: InteractiveTypesEnum.ProductList;
+  type: InteractiveTypesEnum.ProductList | 'product_list';
   body: SimpleTextObject;
   footer?: SimpleTextObject;
   header: HeaderObject;
@@ -667,7 +667,7 @@ type CtaUrlActionObject = {
   parameters: CtaUrlParameters;
 };
 type CtaUrlInteractiveObject = {
-  type: InteractiveTypesEnum.CtaUrl;
+  type: InteractiveTypesEnum.CtaUrl | 'cta_url';
   body?: SimpleTextObject;
   footer?: SimpleTextObject;
   header?: HeaderObject;
@@ -677,7 +677,7 @@ type LocationRequestActionObject = {
   name: 'send_location';
 };
 type LocationRequestInteractiveObject = {
-  type: InteractiveTypesEnum.LocationRequest;
+  type: InteractiveTypesEnum.LocationRequest | 'location_request_message';
   body: SimpleTextObject;
   footer?: SimpleTextObject;
   header?: HeaderObject;
@@ -712,7 +712,7 @@ type AddressMessageActionObject = {
   parameters: AddressMessageParameters;
 };
 type AddressMessageInteractiveObject = {
-  type: InteractiveTypesEnum.AddressMessage;
+  type: InteractiveTypesEnum.AddressMessage | 'address_message';
   body: SimpleTextObject;
   footer?: SimpleTextObject;
   header?: HeaderObject;
@@ -724,8 +724,8 @@ type FlowParameters = {
   flow_name?: string;
   flow_cta: string;
   mode?: 'draft' | 'published';
-  flow_token: string;
-  flow_action: 'navigate' | 'data_exchange';
+  flow_token?: string;
+  flow_action?: 'navigate' | 'data_exchange';
   flow_action_payload?: {
     screen?: string;
     data?: Record<string, string>;
@@ -736,7 +736,7 @@ type FlowActionObject = {
   parameters: FlowParameters;
 };
 type FlowInteractiveObject = {
-  type: InteractiveTypesEnum.Flow;
+  type: InteractiveTypesEnum.Flow | 'flow';
   body: SimpleTextObject;
   footer?: SimpleTextObject;
   header?: HeaderObject;
@@ -782,7 +782,7 @@ type CarouselActionObject = {
   cards: Array<MediaCarouselCard$1 | ProductCarouselCard$1>;
 };
 type CarouselInteractiveObject = {
-  type: InteractiveTypesEnum.Carousel;
+  type: InteractiveTypesEnum.Carousel | 'carousel';
   body: SimpleTextObject;
   action: CarouselActionObject;
 };
@@ -922,7 +922,7 @@ declare class MessagesClass extends BaseClass {
   image(params: MessageRequestParams<ImageMediaObject>): Promise<MessagesResponse>;
   video(params: MessageRequestParams<VideoMediaObject>): Promise<MessagesResponse>;
   sticker(params: MessageRequestParams<StickerMediaObject>): Promise<MessagesResponse>;
-  contacts(params: MessageRequestParams<[ContactObject]>): Promise<MessagesResponse>;
+  contacts(params: MessageRequestParams<ContactObject[]>): Promise<MessagesResponse>;
   location(params: MessageRequestParams<LocationObject>): Promise<MessagesResponse>;
   interactive(params: MessageRequestParams<InteractiveObject>): Promise<MessagesResponse>;
   interactiveList(params: MessageRequestParams<InteractiveObject & {
@@ -1520,7 +1520,7 @@ type TemplateGetParams = {
   status?: TemplateStatusEnum;
 };
 type TemplateDeleteParams = {
-  hsm_id: string;
+  hsm_id?: string;
   name: string;
 };
 declare class TemplateClass {
@@ -1867,43 +1867,135 @@ interface WABAClass {
 //#endregion
 //#region src/core/webhook/types/account.d.ts
 /**
- * Account update event types
- * @see https://developers.facebook.com/docs/whatsapp/business-management-api/webhooks/components#value--event
+ * WABA event types for account_update webhook.
+ * @see https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/account_update
  */
-type AccountUpdateEvent = 'VERIFIED_ACCOUNT' | 'DISABLED_UPDATE' | 'ACCOUNT_VIOLATION' | 'ACCOUNT_RESTRICTION' | 'ACCOUNT_DELETED' | 'PARTNER_REMOVED' | 'PARTNER_APP_UNINSTALLED';
+type AccountUpdateEvent = 'ACCOUNT_DELETED' | 'ACCOUNT_OFFBOARDED' | 'ACCOUNT_RECONNECTED' | 'ACCOUNT_RESTRICTION' | 'ACCOUNT_VIOLATION' | 'AD_ACCOUNT_LINKED' | 'AUTH_INTL_PRICE_ELIGIBILITY_UPDATE' | 'BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE' | 'DISABLED_UPDATE' | 'MM_LITE_TERMS_SIGNED' | 'PARTNER_ADDED' | 'PARTNER_APP_INSTALLED' | 'PARTNER_APP_UNINSTALLED' | 'PARTNER_CLIENT_CERTIFICATION_STATUS_UPDATE' | 'PARTNER_REMOVED' | 'VERIFIED_ACCOUNT' | 'VOLUME_BASED_PRICING_TIER_UPDATE';
 /**
- * WABA ban state
- * @see https://developers.facebook.com/docs/whatsapp/business-management-api/webhooks/components#value--ban_info
+ * WABA ban state — present on DISABLED_UPDATE events.
  */
 type WabaBanState = 'SCHEDULE_FOR_DISABLE' | 'DISABLE' | 'REINSTATE';
 /**
- * Restriction types imposed on WABA
- * @see https://developers.facebook.com/docs/whatsapp/business-management-api/webhooks/components#value--restriction_info
+ * Restriction types imposed on WABA — present on ACCOUNT_RESTRICTION events.
  */
 type RestrictionType = 'RESTRICTION_ADD_PHONE_NUMBER_ACTION' | 'RESTRICTED_BIZ_INITIATED_MESSAGING' | 'RESTRICTED_CUSTOMER_INITIATED_MESSAGING';
+/**
+ * Reason for the disconnection — present on PARTNER_REMOVED events where
+ * the business used both WhatsApp Business app and Cloud API.
+ */
+type DisconnectionReason = 'ACCOUNT_DISCONNECTED' | 'BUSINESS_DOWNGRADE' | 'CHANGE_NUMBER' | 'COMPANION_INACTIVITY' | 'PRIMARY_INACTIVITY' | 'USER_RE_REGISTERED';
+/**
+ * Who initiated the disconnection — present on PARTNER_REMOVED events.
+ */
+type DisconnectionInitiatedBy = 'SYSTEM' | 'USER';
+/**
+ * Status of the partner-led business verification submission.
+ */
+type PartnerClientCertificationStatus = 'APPROVED' | 'REJECTED' | 'DISCARDED';
+/** Present on DISABLED_UPDATE events */
 interface AccountUpdateBanInfo {
   waba_ban_state: WabaBanState;
-  waba_ban_date?: number;
+  /** Unix timestamp of the ban date */
+  waba_ban_date?: string;
 }
+/** Present on ACCOUNT_VIOLATION events */
 interface AccountUpdateViolationInfo {
   violation_type: string;
 }
+/** Present on ACCOUNT_RESTRICTION events */
 interface AccountUpdateRestrictionInfo {
   restriction_type: RestrictionType;
+  /** Unix timestamp when the restriction expires */
   expiration?: number;
+  /** Steps the business can take to remediate the restriction */
+  remediation?: string;
 }
+/**
+ * Present on PARTNER_ADDED, PARTNER_APP_INSTALLED, PARTNER_APP_UNINSTALLED,
+ * PARTNER_REMOVED, AD_ACCOUNT_LINKED, and MM_LITE_TERMS_SIGNED events.
+ */
 interface AccountUpdateWabaInfo {
+  /** Customer or own WABA ID */
   waba_id: string;
+  /** Business portfolio ID */
   owner_business_id: string;
+  /** Partner app ID — present on PARTNER_APP_INSTALLED / PARTNER_APP_UNINSTALLED */
   partner_app_id?: string;
+  /** Ad account ID — present on AD_ACCOUNT_LINKED */
+  ad_account_linked?: string;
+  /** Solution ID — present when customer onboarded via multi-partner solution */
+  solution_id?: string;
+  /** Partner business portfolio IDs — present for multi-partner solutions */
+  solution_partner_business_ids?: string[];
+}
+/** Present on AUTH_INTL_PRICE_ELIGIBILITY_UPDATE events */
+interface AuthInternationalRateEligibility {
+  /** Unix timestamp when authentication-international rates become effective */
+  start_time: number;
+  /** Countries with different start times */
+  exception_countries?: Array<{
+    /** ISO 3166-1 alpha-2 country code */
+    country_code: string;
+    /** Unix timestamp for this country's start time */
+    start_time: number;
+  }>;
+}
+/** Present on VOLUME_BASED_PRICING_TIER_UPDATE events */
+interface VolumeTierInfo {
+  /** Unix timestamp of the tier update */
+  tier_update_time: number;
+  /** Pricing category (e.g. "UTILITY") */
+  pricing_category: string;
+  /** Pricing tier identifier */
+  tier: string;
+  /** Effective month in YYYY-MM format (e.g. "2025-11") */
+  effective_month: string;
+  /** Region for the tier update (e.g. "India") */
+  region: string;
+}
+/** Present on PARTNER_REMOVED events where disconnection_info is applicable */
+interface DisconnectionInfo {
+  reason: DisconnectionReason;
+  initiated_by: DisconnectionInitiatedBy;
+}
+/** Present on PARTNER_CLIENT_CERTIFICATION_STATUS_UPDATE events */
+interface PartnerClientCertificationInfo {
+  /** Customer's business portfolio ID */
+  client_business_id: string;
+  /** Status of the verification submission */
+  status: PartnerClientCertificationStatus;
+  /** Rejection reasons — present when status is REJECTED */
+  rejection_reasons?: string[];
 }
 interface AccountUpdateValue {
+  /** Phone number associated with the WABA, if applicable */
   phone_number?: string;
+  /**
+   * Event type describing what changed.
+   * @see AccountUpdateEvent
+   */
   event: AccountUpdateEvent;
+  /**
+   * ISO 3166-1 alpha-2 country code.
+   * Only included for BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE events.
+   */
+  country?: string;
+  /** Present on DISABLED_UPDATE events */
   ban_info?: AccountUpdateBanInfo;
+  /** Present on ACCOUNT_VIOLATION events */
   violation_info?: AccountUpdateViolationInfo;
+  /** Present on ACCOUNT_RESTRICTION events */
   restriction_info?: AccountUpdateRestrictionInfo[];
+  /** Present on partner-related and AD_ACCOUNT_LINKED events */
   waba_info?: AccountUpdateWabaInfo;
+  /** Present on AUTH_INTL_PRICE_ELIGIBILITY_UPDATE events */
+  auth_international_rate_eligibility?: AuthInternationalRateEligibility;
+  /** Present on VOLUME_BASED_PRICING_TIER_UPDATE events */
+  volume_tier_info?: VolumeTierInfo;
+  /** Present on PARTNER_REMOVED events where business used WhatsApp Business app + Cloud API */
+  disconnection_info?: DisconnectionInfo;
+  /** Present on PARTNER_CLIENT_CERTIFICATION_STATUS_UPDATE events */
+  partner_client_certification_info?: PartnerClientCertificationInfo;
 }
 interface AccountUpdateWebhookValue {
   field: 'account_update';
@@ -1953,6 +2045,44 @@ interface AccountAlertsWebhookValue {
   field: 'account_alerts';
   value: AccountAlertsValue;
 }
+interface AccountSettingsCallingConfig {
+  /** Whether calling is enabled for this phone number */
+  status: 'ENABLED' | 'DISABLED' | string;
+  /** Visibility of the call icon in WhatsApp */
+  call_icon_visibility?: string;
+  /** Status of callback permission */
+  callback_permission_status?: 'ENABLED' | 'DISABLED' | string;
+  /** Call hours configuration */
+  call_hours?: {
+    status: 'ENABLED' | 'DISABLED' | string;
+  };
+  /** SIP (Session Initiation Protocol) configuration */
+  sip?: {
+    status: 'ENABLED' | 'DISABLED' | string;
+  };
+}
+interface AccountSettingsPhoneNumberSettings {
+  /** The phone number ID these settings apply to */
+  phone_number_id: string;
+  /** Calling feature configuration */
+  calling?: AccountSettingsCallingConfig;
+}
+interface AccountSettingsUpdateValue {
+  messaging_product: 'whatsapp';
+  /** Unix timestamp of the settings change */
+  timestamp: string;
+  /**
+   * Type of settings that changed.
+   * Known value: "phone_number_settings"
+   */
+  type: 'phone_number_settings' | string;
+  /** Present when type is "phone_number_settings" */
+  phone_number_settings?: AccountSettingsPhoneNumberSettings;
+}
+interface AccountSettingsUpdateWebhookValue {
+  field: 'account_settings_update';
+  value: AccountSettingsUpdateValue;
+}
 //#endregion
 //#region src/core/webhook/types/common.d.ts
 /**
@@ -2080,6 +2210,121 @@ interface BusinessCapabilityUpdateWebhookValue {
   field: 'business_capability_update';
   value: BusinessCapabilityUpdateValue;
 }
+type BusinessStatusUpdateEvent = 'ACCOUNT_DELETED' | 'ACCOUNT_RESTRICTION' | 'ACCOUNT_VIOLATION' | 'DISABLED_UPDATE' | string;
+interface BusinessStatusUpdateValue {
+  /** Event type describing the status change */
+  event: BusinessStatusUpdateEvent;
+  [key: string]: unknown;
+}
+interface BusinessStatusUpdateWebhookValue {
+  field: 'business_status_update';
+  value: BusinessStatusUpdateValue;
+}
+//#endregion
+//#region src/core/webhook/types/calls.d.ts
+/**
+ * Lifecycle event type for a call.
+ *
+ * - "connect"      — Call initiated; for consumer-initiated calls, respond with action=accept
+ * - "call_status"  — Business-initiated call started ringing or was accepted (business-initiated only)
+ * - "media_update" — Consumer-side media event; apply the new SDP to your peer connection (business-initiated only)
+ * - "terminate"    — Call ended for any reason
+ */
+type CallEventType = 'connect' | 'call_status' | 'media_update' | 'terminate';
+/**
+ * Direction of the call.
+ *
+ * - "business_initiated" — The business placed the call
+ * - "user_initiated"     — The user placed the call
+ */
+type CallDirection = 'business_initiated' | 'user_initiated';
+/**
+ * Status for business-initiated calls (call_status event).
+ *
+ * - "ringing"  — The outgoing call is ringing on the consumer's device
+ * - "accepted" — The consumer accepted the call
+ */
+type CallStatusValue = 'ringing' | 'accepted';
+/**
+ * Final call outcome (terminate event).
+ *
+ * - "Completed" — Call finished normally (includes calls rejected by either party)
+ * - "Failed"    — Call failed mid-connection
+ */
+type CallTerminateStatus = 'Completed' | 'Failed';
+interface CallSdpRenegotiation {
+  /** SDP type — always "offer" for incoming media_update events */
+  sdp_type: 'offer';
+  /** SDP data compliant with RFC 4566 */
+  sdp: string;
+}
+interface CallSession$1 {
+  /**
+   * Incremented each time Meta provides new SDP.
+   * If multiple media_update webhooks arrive, apply the one with the highest version.
+   */
+  version: number;
+  /** Contains the SDP offer from Meta; generate an answer and apply to your peer connection */
+  sdp_renegotiation: CallSdpRenegotiation;
+}
+interface CallEntry {
+  /** Unique ID for the call — use in accept / reject / terminate API calls */
+  id: string;
+  /**
+   * Lifecycle event type.
+   * @see CallEventType
+   */
+  event: CallEventType;
+  /** Unix timestamp */
+  timestamp: number;
+  /** Callee of the call (Page ID) — present on connect */
+  to?: string;
+  /** Caller of the call (PSID) — present on connect */
+  from?: string;
+  /** Whether the call was business- or user-initiated — present on connect */
+  call_direction?: CallDirection;
+  /** PSID of the consumer — present on call_status */
+  recipient_id?: string;
+  /** Ringing or accepted — present on call_status */
+  call_status?: CallStatusValue;
+  /** SDP session information; apply the offer to your local peer connection — present on media_update */
+  session?: CallSession$1;
+  /** Final status of the call — present on terminate */
+  status?: CallTerminateStatus;
+  /** When the call started (Unix timestamp) — present on terminate */
+  start_time?: number;
+  /** When the call ended (Unix timestamp) — present on terminate */
+  end_time?: number;
+  /**
+   * Call duration in seconds, counted from when the business connects.
+   * Empty if the business did not successfully connect.
+   * Present on terminate.
+   */
+  duration?: number;
+}
+interface CallContact {
+  profile: {
+    /** Display name of the caller */
+    name: string;
+  };
+  /** WhatsApp ID of the caller */
+  wa_id: string;
+}
+interface CallsValue {
+  messaging_product: 'whatsapp';
+  metadata: {
+    display_phone_number: string;
+    phone_number_id: string;
+  };
+  /** Array of call lifecycle events */
+  calls: CallEntry[];
+  /** Contact profile information for the caller */
+  contacts?: CallContact[];
+}
+interface CallsWebhookValue {
+  field: 'calls';
+  value: CallsValue;
+}
 //#endregion
 //#region src/core/webhook/types/flows.d.ts
 /**
@@ -2129,6 +2374,165 @@ interface FlowsWebhookValue {
   value: FlowsValue;
 }
 //#endregion
+//#region src/core/webhook/types/groups.d.ts
+interface GroupWebhookError {
+  /** Error code */
+  code: string;
+  /** Human-readable error message */
+  message: string;
+  /** Short title for the error */
+  title: string;
+  error_data?: {
+    /** Detailed error description */
+    details: string;
+  };
+}
+interface GroupAddedParticipant {
+  /** WhatsApp ID of the participant */
+  wa_id: string;
+  /** Phone number input provided when adding (optional) */
+  input?: string;
+}
+interface GroupRemovedParticipant {
+  /** Phone number or WhatsApp ID of the removed participant */
+  input: string;
+}
+interface GroupFailedParticipant {
+  /** Phone number or WhatsApp ID that failed */
+  input: string;
+  errors: GroupWebhookError[];
+}
+type GroupLifecycleEventType = 'group_create' | 'group_delete';
+interface GroupLifecycleEntry {
+  /** Unix timestamp of the event */
+  timestamp: string;
+  /** The group's WhatsApp ID */
+  group_id: string;
+  /** Event type: group_create or group_delete */
+  type: GroupLifecycleEventType;
+  /** Correlation ID for the API request that triggered this event */
+  request_id: string;
+  /** Group subject/name — present on group_create */
+  subject?: string;
+  /** Group description — present on group_create */
+  description?: string;
+  /** Invite link for the group — present on successful group_create */
+  invite_link?: string;
+  /** Whether users need admin approval to join — present on group_create */
+  join_approval_mode?: string;
+  /** Present when the operation failed */
+  errors?: GroupWebhookError[];
+}
+interface GroupLifecycleUpdateValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  /** Array of group lifecycle events */
+  groups: GroupLifecycleEntry[];
+}
+interface GroupLifecycleUpdateWebhookValue {
+  field: 'group_lifecycle_update';
+  value: GroupLifecycleUpdateValue;
+}
+type GroupParticipantsEventType = 'group_participants_add' | 'group_participants_remove' | 'group_join_request_created' | 'group_join_request_revoked';
+type GroupParticipantsAddReason = 'invite_link' | 'admin_added';
+/** Who initiated the remove action */
+type GroupParticipantsInitiatedBy = 'business' | 'participant';
+interface GroupParticipantsEntry {
+  /** Unix timestamp of the event */
+  timestamp: string;
+  /** The group's WhatsApp ID */
+  group_id: string;
+  /** Event type */
+  type: GroupParticipantsEventType;
+  /** Correlation ID for the API request */
+  request_id?: string;
+  /** Reason participants were added (e.g. invite_link) */
+  reason?: GroupParticipantsAddReason | string;
+  /** Participants successfully added */
+  added_participants?: GroupAddedParticipant[];
+  /** Whether business or participant initiated the removal */
+  initiated_by?: GroupParticipantsInitiatedBy;
+  /** Participants successfully removed */
+  removed_participants?: GroupRemovedParticipant[];
+  /** Participants that could not be removed */
+  failed_participants?: GroupFailedParticipant[];
+  /** ID of the join request */
+  join_request_id?: string;
+  /** WhatsApp ID of the user who submitted or cancelled the request */
+  wa_id?: string;
+  /** Present when the operation partially or fully failed */
+  errors?: GroupWebhookError[];
+}
+interface GroupParticipantsUpdateValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  /** Array of participant update events */
+  groups: GroupParticipantsEntry[];
+}
+interface GroupParticipantsUpdateWebhookValue {
+  field: 'group_participants_update';
+  value: GroupParticipantsUpdateValue;
+}
+interface GroupSettingFieldResult {
+  /** Whether this specific field was successfully updated */
+  update_successful: boolean;
+  /** Present on profile_picture updates */
+  mime_type?: string;
+  /** SHA-256 hash of the uploaded image — present on profile_picture updates */
+  sha256?: string;
+  /** New text value — present on group_subject / group_description updates */
+  text?: string;
+  /** Present when update_successful is false */
+  errors?: GroupWebhookError[];
+}
+interface GroupSettingsEntry {
+  /** Unix timestamp of the event */
+  timestamp: string;
+  /** The group's WhatsApp ID */
+  group_id: string;
+  /** Always "group_settings_update" */
+  type: 'group_settings_update';
+  /** Correlation ID for the API request */
+  request_id?: string;
+  /** Result of the profile picture update */
+  profile_picture?: GroupSettingFieldResult;
+  /** Result of the group subject (name) update */
+  group_subject?: GroupSettingFieldResult;
+  /** Result of the group description update */
+  group_description?: GroupSettingFieldResult;
+  /** Top-level errors when the entire update failed */
+  errors?: GroupWebhookError[];
+}
+interface GroupSettingsUpdateValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  /** Array of group settings update events */
+  groups: GroupSettingsEntry[];
+}
+interface GroupSettingsUpdateWebhookValue {
+  field: 'group_settings_update';
+  value: GroupSettingsUpdateValue;
+}
+type GroupStatusEventType = 'group_suspend' | 'group_suspend_cleared';
+interface GroupStatusEntry {
+  /** Unix timestamp of the event */
+  timestamp: string;
+  /** The group's WhatsApp ID */
+  group_id: string;
+  /** Event type: group_suspend or group_suspend_cleared */
+  type: GroupStatusEventType;
+}
+interface GroupStatusUpdateValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  /** Array of group status events */
+  groups: GroupStatusEntry[];
+}
+interface GroupStatusUpdateWebhookValue {
+  field: 'group_status_update';
+  value: GroupStatusUpdateValue;
+}
+//#endregion
 //#region src/core/webhook/types/message.d.ts
 /**
  * Base message properties common to all message types
@@ -2419,6 +2823,75 @@ interface HistoryWebhookValue {
   value: HistoryValue;
 }
 //#endregion
+//#region src/core/webhook/types/marketing.d.ts
+/**
+ * Detected event type.
+ * Sample payload uses lowercase ("purchase"), docs use PascalCase ("Purchase").
+ * Accept both forms.
+ */
+type AutomaticEventName = 'LeadSubmitted' | 'Purchase' | 'purchase' | 'lead_submitted' | string;
+interface AutomaticEventCustomData {
+  /** ISO 4217 currency code (e.g. "USD") — present on Purchase events */
+  currency: string;
+  /** Monetary value of the purchase — present on Purchase events */
+  value: number;
+}
+interface AutomaticEvent {
+  /** WhatsApp message ID that triggered the event detection */
+  id: string;
+  /**
+   * Detected event type.
+   * @see AutomaticEventName
+   */
+  event_name: AutomaticEventName;
+  /** Unix timestamp of when the event was detected */
+  timestamp: number;
+  /**
+   * Click-to-WhatsApp ad click ID — use with Conversions API.
+   * Present when the event originated from a Click-to-WhatsApp ad.
+   */
+  ctwa_clid?: string;
+  /** Present on Purchase events */
+  custom_data?: AutomaticEventCustomData;
+}
+interface AutomaticEventsValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  /** Array of detected automatic events */
+  automatic_events: AutomaticEvent[];
+}
+interface AutomaticEventsWebhookValue {
+  field: 'automatic_events';
+  value: AutomaticEventsValue;
+}
+interface TrackingEventData {
+  /** Unique identifier for the click, also appended to the destination URL */
+  click_id?: string;
+  /** Internal Meta token for processing and tracking */
+  tracking_token?: string;
+}
+interface TrackingEvent {
+  /**
+   * Name of the tracked event.
+   * Known values: "sent"
+   */
+  event_name: string;
+  /** Unix timestamp of the event */
+  timestamp: number;
+  /** Tracking data associated with the event */
+  tracking_data?: TrackingEventData;
+}
+interface TrackingEventsValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  /** Array of tracking events */
+  events: TrackingEvent[];
+}
+interface TrackingEventsWebhookValue {
+  field: 'tracking_events';
+  value: TrackingEventsValue;
+}
+//#endregion
 //#region src/core/webhook/types/messageEchoes.d.ts
 /**
  * Message echo error
@@ -2474,6 +2947,179 @@ interface SmbMessageEchoesWebhookValue {
   field: 'smb_message_echoes';
   value: SmbMessageEchoesValue;
 }
+interface MessageEchoSender {
+  /** Page ID that sent the message */
+  id: string;
+}
+interface MessageEchoRecipient {
+  /** Page-scoped ID of the user who received the message */
+  id: string;
+}
+interface MessageEchoAttachment {
+  /** Attachment type: image, audio, video, file, template, fallback */
+  type: string;
+  /** URL of the attachment or fallback URL */
+  url?: string;
+  /** Template payload for template attachments */
+  payload?: unknown;
+  title?: string;
+}
+interface MessageEchoBody {
+  /** Indicates the message was sent by the page */
+  is_echo: true;
+  /** ID of the app that sent the message */
+  app_id: number;
+  /** Custom metadata string set in the Send API request */
+  metadata?: string;
+  /** Message ID */
+  mid: string;
+  /** Text content — present on text messages */
+  text?: string;
+  /** Attachments — present on media/template messages */
+  attachments?: MessageEchoAttachment[];
+}
+interface MessageEchoEntry {
+  sender: MessageEchoSender;
+  recipient: MessageEchoRecipient;
+  /** Unix timestamp in milliseconds */
+  timestamp: number;
+  message: MessageEchoBody;
+}
+interface MessageEchoesValue {
+  /** Array of echoed messages */
+  messaging: MessageEchoEntry[];
+}
+interface MessageEchoesWebhookValue {
+  field: 'message_echoes';
+  value: MessageEchoesValue;
+}
+//#endregion
+//#region src/core/webhook/types/messaging.d.ts
+interface MessagingHandoverControlPassed {
+  /** Optional metadata string passed with the handover */
+  metadata?: string;
+}
+interface MessagingHandoversValue {
+  messaging_product: 'whatsapp';
+  /** The business phone number that received the handover event */
+  recipient: {
+    display_phone_number: string;
+    phone_number_id: string;
+  };
+  /** The user involved in the handover */
+  sender: {
+    phone_number: string;
+  };
+  /** Unix timestamp of the event */
+  timestamp: string;
+  /** Present when thread control is passed to another app */
+  control_passed?: MessagingHandoverControlPassed;
+}
+interface MessagingHandoversWebhookValue {
+  field: 'messaging_handovers';
+  value: MessagingHandoversValue;
+}
+interface StandbyValue {
+  messaging_product: 'whatsapp';
+  [key: string]: unknown;
+}
+interface StandbyWebhookValue {
+  field: 'standby';
+  value: StandbyValue;
+}
+interface UserPreferenceEntry {
+  /** WhatsApp ID of the user */
+  wa_id: string;
+  /** Meta user ID (e.g. "US.1234567") */
+  user_id: string;
+  /** Human-readable description of the preference change */
+  detail: string;
+  /**
+   * Category of the preference that changed.
+   * Known value: "marketing_messages"
+   */
+  category: 'marketing_messages' | string;
+  /**
+   * New preference value.
+   * Known value: "stop" (user opted out)
+   */
+  value: 'stop' | string;
+  /** Unix timestamp of when the preference was changed */
+  timestamp: number;
+  /** Signup ID associated with the preference, if applicable */
+  signup_id?: string;
+}
+interface UserPreferencesContact {
+  profile: {
+    /** Display name of the user */
+    name: string;
+    /** WhatsApp username, if available */
+    username?: string;
+  };
+  /** WhatsApp ID of the user */
+  wa_id: string;
+  /** Meta user ID */
+  user_id?: string;
+}
+interface UserPreferencesValue {
+  messaging_product: 'whatsapp';
+  metadata: WebhookMetadata;
+  /** Array of user preference change events */
+  user_preferences: UserPreferenceEntry[];
+  /** Contact profile information for the users */
+  contacts?: UserPreferencesContact[];
+}
+interface UserPreferencesWebhookValue {
+  field: 'user_preferences';
+  value: UserPreferencesValue;
+}
+//#endregion
+//#region src/core/webhook/types/partner.d.ts
+/**
+ * Partner solution event types.
+ * Known value: "SOLUTION_CREATED"
+ */
+type PartnerSolutionEvent = 'SOLUTION_CREATED' | string;
+/**
+ * Partner solution status values.
+ * Known value: "INITIATED"
+ */
+type PartnerSolutionStatus = 'INITIATED' | string;
+interface PartnerSolutionsValue {
+  /** Type of partner solution event */
+  event: PartnerSolutionEvent;
+  /** Unique identifier for the partner solution */
+  solution_id: string;
+  /** Current status of the partner solution */
+  solution_status: PartnerSolutionStatus;
+}
+interface PartnerSolutionsWebhookValue {
+  field: 'partner_solutions';
+  value: PartnerSolutionsValue;
+}
+//#endregion
+//#region src/core/webhook/types/payments.d.ts
+interface PaymentConfigurationUpdateValue {
+  /** Name of the payment configuration */
+  configuration_name: string;
+  /** Payment provider name (e.g. "razorpay") */
+  provider_name: string;
+  /** Merchant ID assigned by the payment provider */
+  provider_mid: string;
+  /**
+   * Current status of the payment configuration.
+   * Known values: "Needs Testing"
+   */
+  status: string;
+  /** Unix timestamp of when the configuration was created */
+  created_timestamp: number;
+  /** Unix timestamp of when the configuration was last updated */
+  updated_timestamp: number;
+}
+interface PaymentConfigurationUpdateWebhookValue {
+  field: 'payment_configuration_update';
+  value: PaymentConfigurationUpdateValue;
+}
 //#endregion
 //#region src/core/webhook/types/phoneNumber.d.ts
 /**
@@ -2615,6 +3261,37 @@ interface MessageTemplateQualityUpdateWebhookValue {
   field: 'message_template_quality_update';
   value: MessageTemplateQualityUpdateValue;
 }
+interface MessageTemplateComponentsUpdateValue {
+  /** Numeric ID of the message template */
+  message_template_id: number;
+  /** Name of the message template */
+  message_template_name: string;
+  /** Language code of the message template (e.g. "en_US") */
+  message_template_language: string;
+  /** Event describing what changed */
+  event: string;
+  [key: string]: unknown;
+}
+interface MessageTemplateComponentsUpdateWebhookValue {
+  field: 'message_template_components_update';
+  value: MessageTemplateComponentsUpdateValue;
+}
+interface TemplateCorrectCategoryDetectionValue {
+  /** Numeric ID of the affected message template */
+  message_template_id: number;
+  /** Name of the affected message template */
+  message_template_name: string;
+  /** Language code of the affected message template (e.g. "en_US") */
+  message_template_language: string;
+  /** The category WhatsApp determined the template should belong to */
+  suggested_category: TemplateCategory;
+  /** The template's current (approved) category */
+  current_category: TemplateCategory;
+}
+interface TemplateCorrectCategoryDetectionWebhookValue {
+  field: 'template_correct_category_detection';
+  value: TemplateCorrectCategoryDetectionValue;
+}
 //#endregion
 //#region src/core/webhook/types/index.d.ts
 /**
@@ -2649,7 +3326,7 @@ type WebhookValue = MessageWebhookValue | StatusWebhookValue | ErrorWebhookValue
 /**
  * Union type for all webhook field values
  */
-type WebhookFieldValue = AccountUpdateWebhookValue | AccountReviewUpdateWebhookValue | AccountAlertsWebhookValue | BusinessCapabilityUpdateWebhookValue | PhoneNumberNameUpdateWebhookValue | PhoneNumberQualityUpdateWebhookValue | MessageTemplateStatusUpdateWebhookValue | TemplateCategoryUpdateWebhookValue | MessageTemplateQualityUpdateWebhookValue | FlowsWebhookValue | SecurityWebhookValue | HistoryWebhookValue | SmbMessageEchoesWebhookValue | SmbAppStateSyncWebhookValue;
+type WebhookFieldValue = AccountUpdateWebhookValue | AccountReviewUpdateWebhookValue | AccountAlertsWebhookValue | AccountSettingsUpdateWebhookValue | AutomaticEventsWebhookValue | BusinessCapabilityUpdateWebhookValue | BusinessStatusUpdateWebhookValue | CallsWebhookValue | FlowsWebhookValue | GroupLifecycleUpdateWebhookValue | GroupParticipantsUpdateWebhookValue | GroupSettingsUpdateWebhookValue | GroupStatusUpdateWebhookValue | HistoryWebhookValue | MessageEchoesWebhookValue | MessageTemplateComponentsUpdateWebhookValue | MessageTemplateQualityUpdateWebhookValue | MessageTemplateStatusUpdateWebhookValue | MessagingHandoversWebhookValue | PartnerSolutionsWebhookValue | PaymentConfigurationUpdateWebhookValue | PhoneNumberNameUpdateWebhookValue | PhoneNumberQualityUpdateWebhookValue | SecurityWebhookValue | SmbAppStateSyncWebhookValue | SmbMessageEchoesWebhookValue | StandbyWebhookValue | TemplateCategoryUpdateWebhookValue | TemplateCorrectCategoryDetectionWebhookValue | TrackingEventsWebhookValue | UserPreferencesWebhookValue;
 interface WebhookPayload {
   object: 'whatsapp_business_account';
   entry: Array<{