meta-cloud-api 2.2.0 → 2.4.0

package/dist/index.d.ts

@@ -2881,43 +2881,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';
@@ -2967,6 +3059,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
 /**
@@ -3094,6 +3224,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
 /**
@@ -3143,6 +3388,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
@@ -3433,6 +3837,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
@@ -3488,6 +3961,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
 /**
@@ -3638,6 +4284,74 @@ 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/webhookFields.d.ts
+declare const WebhookField: {
+  readonly Messages: "messages";
+  readonly AccountUpdate: "account_update";
+  readonly AccountReviewUpdate: "account_review_update";
+  readonly AccountAlerts: "account_alerts";
+  readonly AccountSettingsUpdate: "account_settings_update";
+  readonly BusinessCapabilityUpdate: "business_capability_update";
+  readonly BusinessStatusUpdate: "business_status_update";
+  readonly PhoneNumberNameUpdate: "phone_number_name_update";
+  readonly PhoneNumberQualityUpdate: "phone_number_quality_update";
+  readonly MessageTemplateStatusUpdate: "message_template_status_update";
+  readonly MessageTemplateQualityUpdate: "message_template_quality_update";
+  readonly MessageTemplateComponentsUpdate: "message_template_components_update";
+  readonly TemplateCategoryUpdate: "template_category_update";
+  readonly TemplateCorrectCategoryDetection: "template_correct_category_detection";
+  readonly Flows: "flows";
+  readonly Security: "security";
+  readonly History: "history";
+  readonly SmbMessageEchoes: "smb_message_echoes";
+  readonly SmbAppStateSync: "smb_app_state_sync";
+  readonly AutomaticEvents: "automatic_events";
+  readonly TrackingEvents: "tracking_events";
+  readonly Calls: "calls";
+  readonly GroupLifecycleUpdate: "group_lifecycle_update";
+  readonly GroupParticipantsUpdate: "group_participants_update";
+  readonly GroupSettingsUpdate: "group_settings_update";
+  readonly GroupStatusUpdate: "group_status_update";
+  readonly MessageEchoes: "message_echoes";
+  readonly MessagingHandovers: "messaging_handovers";
+  readonly PartnerSolutions: "partner_solutions";
+  readonly PaymentConfigurationUpdate: "payment_configuration_update";
+  readonly Standby: "standby";
+  readonly UserPreferences: "user_preferences";
+};
+type WebhookFieldType = (typeof WebhookField)[keyof typeof WebhookField];
 //#endregion
 //#region src/core/webhook/types/index.d.ts
 /**
@@ -3672,7 +4386,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<{
@@ -6632,6 +7346,74 @@ type ProcessedSmbAppStateSync = {
   wabaId: string;
   value: SmbAppStateSyncWebhookValue['value'];
 };
+type ProcessedAccountSettingsUpdate = {
+  wabaId: string;
+  value: AccountSettingsUpdateWebhookValue['value'];
+};
+type ProcessedAutomaticEvents = {
+  wabaId: string;
+  value: AutomaticEventsWebhookValue['value'];
+};
+type ProcessedBusinessStatusUpdate = {
+  wabaId: string;
+  value: BusinessStatusUpdateWebhookValue['value'];
+};
+type ProcessedCalls = {
+  wabaId: string;
+  value: CallsWebhookValue['value'];
+};
+type ProcessedGroupLifecycleUpdate = {
+  wabaId: string;
+  value: GroupLifecycleUpdateWebhookValue['value'];
+};
+type ProcessedGroupParticipantsUpdate = {
+  wabaId: string;
+  value: GroupParticipantsUpdateWebhookValue['value'];
+};
+type ProcessedGroupSettingsUpdate = {
+  wabaId: string;
+  value: GroupSettingsUpdateWebhookValue['value'];
+};
+type ProcessedGroupStatusUpdate = {
+  wabaId: string;
+  value: GroupStatusUpdateWebhookValue['value'];
+};
+type ProcessedMessageEchoes = {
+  wabaId: string;
+  value: MessageEchoesWebhookValue['value'];
+};
+type ProcessedMessageTemplateComponentsUpdate = {
+  wabaId: string;
+  value: MessageTemplateComponentsUpdateWebhookValue['value'];
+};
+type ProcessedMessagingHandovers = {
+  wabaId: string;
+  value: MessagingHandoversWebhookValue['value'];
+};
+type ProcessedPartnerSolutions = {
+  wabaId: string;
+  value: PartnerSolutionsWebhookValue['value'];
+};
+type ProcessedPaymentConfigurationUpdate = {
+  wabaId: string;
+  value: PaymentConfigurationUpdateWebhookValue['value'];
+};
+type ProcessedStandby = {
+  wabaId: string;
+  value: StandbyWebhookValue['value'];
+};
+type ProcessedTemplateCorrectCategoryDetection = {
+  wabaId: string;
+  value: TemplateCorrectCategoryDetectionWebhookValue['value'];
+};
+type ProcessedTrackingEvents = {
+  wabaId: string;
+  value: TrackingEventsWebhookValue['value'];
+};
+type ProcessedUserPreferences = {
+  wabaId: string;
+  value: UserPreferencesWebhookValue['value'];
+};
 type TextProcessedMessage = ProcessedMessage & {
   message: Extract<WhatsAppMessage, {
     type: MessageTypesEnum.Text;
@@ -6700,6 +7482,7 @@ type SystemProcessedMessage = ProcessedMessage & {
 type MessageHandler = (whatsapp: WhatsApp, processed: ProcessedMessage) => void | Promise<void>;
 type StatusHandler = (whatsapp: WhatsApp, processed: ProcessedStatus) => void | Promise<void>;
 type FlowHandler = (whatsapp: WhatsApp, request: FlowEndpointRequest) => any | Promise<any>;
+type RawWebhookHandler = (whatsapp: WhatsApp, payload: WebhookPayload) => void | Promise<void>;
 type AccountUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedAccountUpdate) => void | Promise<void>;
 type AccountReviewUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedAccountReviewUpdate) => void | Promise<void>;
 type AccountAlertsHandler = (whatsapp: WhatsApp, processed: ProcessedAccountAlerts) => void | Promise<void>;
@@ -6714,6 +7497,23 @@ type SecurityHandler = (whatsapp: WhatsApp, processed: ProcessedSecurity) => voi
 type HistoryHandler = (whatsapp: WhatsApp, processed: ProcessedHistory) => void | Promise<void>;
 type SmbMessageEchoesHandler = (whatsapp: WhatsApp, processed: ProcessedSmbMessageEchoes) => void | Promise<void>;
 type SmbAppStateSyncHandler = (whatsapp: WhatsApp, processed: ProcessedSmbAppStateSync) => void | Promise<void>;
+type AccountSettingsUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedAccountSettingsUpdate) => void | Promise<void>;
+type AutomaticEventsHandler = (whatsapp: WhatsApp, processed: ProcessedAutomaticEvents) => void | Promise<void>;
+type BusinessStatusUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedBusinessStatusUpdate) => void | Promise<void>;
+type CallsHandler = (whatsapp: WhatsApp, processed: ProcessedCalls) => void | Promise<void>;
+type GroupLifecycleUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedGroupLifecycleUpdate) => void | Promise<void>;
+type GroupParticipantsUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedGroupParticipantsUpdate) => void | Promise<void>;
+type GroupSettingsUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedGroupSettingsUpdate) => void | Promise<void>;
+type GroupStatusUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedGroupStatusUpdate) => void | Promise<void>;
+type MessageEchoesHandler = (whatsapp: WhatsApp, processed: ProcessedMessageEchoes) => void | Promise<void>;
+type MessageTemplateComponentsUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedMessageTemplateComponentsUpdate) => void | Promise<void>;
+type MessagingHandoversHandler = (whatsapp: WhatsApp, processed: ProcessedMessagingHandovers) => void | Promise<void>;
+type PartnerSolutionsHandler = (whatsapp: WhatsApp, processed: ProcessedPartnerSolutions) => void | Promise<void>;
+type PaymentConfigurationUpdateHandler = (whatsapp: WhatsApp, processed: ProcessedPaymentConfigurationUpdate) => void | Promise<void>;
+type StandbyHandler = (whatsapp: WhatsApp, processed: ProcessedStandby) => void | Promise<void>;
+type TemplateCorrectCategoryDetectionHandler = (whatsapp: WhatsApp, processed: ProcessedTemplateCorrectCategoryDetection) => void | Promise<void>;
+type TrackingEventsHandler = (whatsapp: WhatsApp, processed: ProcessedTrackingEvents) => void | Promise<void>;
+type UserPreferencesHandler = (whatsapp: WhatsApp, processed: ProcessedUserPreferences) => void | Promise<void>;
 type TextMessageHandler = (whatsapp: WhatsApp, processed: TextProcessedMessage) => void | Promise<void>;
 type ImageMessageHandler = (whatsapp: WhatsApp, processed: ImageProcessedMessage) => void | Promise<void>;
 type VideoMessageHandler = (whatsapp: WhatsApp, processed: VideoProcessedMessage) => void | Promise<void>;
@@ -6735,6 +7535,8 @@ declare function processWebhookMessages(request: Request, whatsapp: WhatsApp, ha
   statusHandler?: StatusHandler;
   preProcessHandler?: MessageHandler;
   postProcessHandler?: MessageHandler;
+  rawHandler?: RawWebhookHandler;
+  rawHandlerFields?: WebhookFieldType[];
   accountUpdateHandler?: AccountUpdateHandler;
   accountReviewUpdateHandler?: AccountReviewUpdateHandler;
   accountAlertsHandler?: AccountAlertsHandler;
@@ -6749,6 +7551,23 @@ declare function processWebhookMessages(request: Request, whatsapp: WhatsApp, ha
   historyHandler?: HistoryHandler;
   smbMessageEchoesHandler?: SmbMessageEchoesHandler;
   smbAppStateSyncHandler?: SmbAppStateSyncHandler;
+  accountSettingsUpdateHandler?: AccountSettingsUpdateHandler;
+  automaticEventsHandler?: AutomaticEventsHandler;
+  businessStatusUpdateHandler?: BusinessStatusUpdateHandler;
+  callsHandler?: CallsHandler;
+  groupLifecycleUpdateHandler?: GroupLifecycleUpdateHandler;
+  groupParticipantsUpdateHandler?: GroupParticipantsUpdateHandler;
+  groupSettingsUpdateHandler?: GroupSettingsUpdateHandler;
+  groupStatusUpdateHandler?: GroupStatusUpdateHandler;
+  messageEchoesHandler?: MessageEchoesHandler;
+  messageTemplateComponentsUpdateHandler?: MessageTemplateComponentsUpdateHandler;
+  messagingHandoversHandler?: MessagingHandoversHandler;
+  partnerSolutionsHandler?: PartnerSolutionsHandler;
+  paymentConfigurationUpdateHandler?: PaymentConfigurationUpdateHandler;
+  standbyHandler?: StandbyHandler;
+  templateCorrectCategoryDetectionHandler?: TemplateCorrectCategoryDetectionHandler;
+  trackingEventsHandler?: TrackingEventsHandler;
+  userPreferencesHandler?: UserPreferencesHandler;
 }): Promise<Response>;
 /**
  * Handle flow requests
@@ -6775,6 +7594,7 @@ declare class WebhookProcessor {
   private statusHandler;
   private preProcessHandler;
   private postProcessHandler;
+  private rawHandler;
   private flowHandlers;
   private accountUpdateHandler;
   private accountReviewUpdateHandler;
@@ -6790,6 +7610,23 @@ declare class WebhookProcessor {
   private historyHandler;
   private smbMessageEchoesHandler;
   private smbAppStateSyncHandler;
+  private accountSettingsUpdateHandler;
+  private automaticEventsHandler;
+  private businessStatusUpdateHandler;
+  private callsHandler;
+  private groupLifecycleUpdateHandler;
+  private groupParticipantsUpdateHandler;
+  private groupSettingsUpdateHandler;
+  private groupStatusUpdateHandler;
+  private messageEchoesHandler;
+  private messageTemplateComponentsUpdateHandler;
+  private messagingHandoversHandler;
+  private partnerSolutionsHandler;
+  private paymentConfigurationUpdateHandler;
+  private standbyHandler;
+  private templateCorrectCategoryDetectionHandler;
+  private trackingEventsHandler;
+  private userPreferencesHandler;
   constructor(config: WhatsAppConfig);
   processVerification(mode: string | null, token: string | null, challenge: string | null): Promise<WebhookResponse>;
   processWebhook(request: Request): Promise<WebhookResponse>;
@@ -6798,6 +7635,7 @@ declare class WebhookProcessor {
   onStatus(handler: StatusHandler): void;
   onMessagePreProcess(handler: MessageHandler): void;
   onMessagePostProcess(handler: MessageHandler): void;
+  onRaw(handler: RawWebhookHandler, fields?: WebhookFieldType[]): void;
   onFlow(type: FlowTypeEnum, handler: FlowHandler): void;
   /**
    * Register a handler for text messages
@@ -6934,6 +7772,80 @@ declare class WebhookProcessor {
    * @see https://developers.facebook.com/docs/graph-api/webhooks/reference/whatsapp-business-account#smb_app_state_sync
    */
   onSmbAppStateSync(handler: SmbAppStateSyncHandler): void;
+  /**
+   * Register a handler for account_settings_update webhook field
+   */
+  onAccountSettingsUpdate(handler: AccountSettingsUpdateHandler): void;
+  /**
+   * Register a handler for automatic_events webhook field
+   */
+  onAutomaticEvents(handler: AutomaticEventsHandler): void;
+  /**
+   * Register a handler for business_status_update webhook field
+   */
+  onBusinessStatusUpdate(handler: BusinessStatusUpdateHandler): void;
+  /**
+   * Register a handler for calls webhook field
+   * @see https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/reference/
+   */
+  onCalls(handler: CallsHandler): void;
+  /**
+   * Register a handler for group_lifecycle_update webhook field
+   * @see https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/reference/
+   */
+  onGroupLifecycleUpdate(handler: GroupLifecycleUpdateHandler): void;
+  /**
+   * Register a handler for group_participants_update webhook field
+   * @see https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/reference/
+   */
+  onGroupParticipantsUpdate(handler: GroupParticipantsUpdateHandler): void;
+  /**
+   * Register a handler for group_settings_update webhook field
+   * @see https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/reference/
+   */
+  onGroupSettingsUpdate(handler: GroupSettingsUpdateHandler): void;
+  /**
+   * Register a handler for group_status_update webhook field
+   * @see https://developers.facebook.com/documentation/business-messaging/whatsapp/groups/reference/
+   */
+  onGroupStatusUpdate(handler: GroupStatusUpdateHandler): void;
+  /**
+   * Register a handler for message_echoes webhook field
+   * @see https://developers.facebook.com/docs/graph-api/webhooks/reference/whatsapp-business-account#message_echoes
+   */
+  onMessageEchoes(handler: MessageEchoesHandler): void;
+  /**
+   * Register a handler for message_template_components_update webhook field
+   */
+  onMessageTemplateComponentsUpdate(handler: MessageTemplateComponentsUpdateHandler): void;
+  /**
+   * Register a handler for messaging_handovers webhook field
+   */
+  onMessagingHandovers(handler: MessagingHandoversHandler): void;
+  /**
+   * Register a handler for partner_solutions webhook field
+   */
+  onPartnerSolutions(handler: PartnerSolutionsHandler): void;
+  /**
+   * Register a handler for payment_configuration_update webhook field
+   */
+  onPaymentConfigurationUpdate(handler: PaymentConfigurationUpdateHandler): void;
+  /**
+   * Register a handler for standby webhook field
+   */
+  onStandby(handler: StandbyHandler): void;
+  /**
+   * Register a handler for template_correct_category_detection webhook field
+   */
+  onTemplateCorrectCategoryDetection(handler: TemplateCorrectCategoryDetectionHandler): void;
+  /**
+   * Register a handler for tracking_events webhook field
+   */
+  onTrackingEvents(handler: TrackingEventsHandler): void;
+  /**
+   * Register a handler for user_preferences webhook field
+   */
+  onUserPreferences(handler: UserPreferencesHandler): void;
   getClient(): WhatsApp;
   getConfig(): WabaConfigType;
 }