@apostlejs/whatsapp 0.0.0 → 0.0.3

package/dist/index.d.cts

@@ -1,21 +1,5 @@
 import { z } from 'zod';
 
-type WhatsappSDKSettings = {
-    GRAPH_API_VERSION: string;
-    META_APP_ACCESS_TOKEN: string;
-    META_APP_ID: string;
-    META_APP_SECRET: string;
-    WHATSAPP_MESSAGE_NAMESPACE: string;
-    WHATSAPP_WEBHOOK_KEY: string;
-    WHATSAPP_NUMBER_ID: string;
-    WHATSAPP_ACCOUNT_ID: string;
-    WHATSAPP_ACCOUNT_ENCRYPTION_PUBLIC_KEY: string;
-    WHATSAPP_ACCOUNT_ENCRYPTION_PRIVATE_KEY: string;
-    WHATSAPP_ACCOUNT_ENCRYPTION_PASSPHRASE: string;
-    WHATSAPP_FLOWS_MODE: string;
-    WHATSAPP_UNNOFICIAL_AUTHENTICATION_STRING: string;
-};
-
 type AnyType = any;
 type Defined<T> = Exclude<T, undefined>;
 
@@ -35,6 +19,158 @@ type Endpoint<Url extends string, Method extends HttpMethod, Req extends IReques
     response?: Res;
 };
 
+/**
+ * This follows the BCP 47 language tag format.
+ */
+declare enum LanguageTag {
+    AR_SA = "ar-SA",
+    BN_BD = "bn-BD",
+    BN_IN = "bn-IN",
+    CS_CZ = "cs-CZ",
+    DA_DK = "da-DK",
+    DE_AT = "de-AT",
+    DE_CH = "de-CH",
+    DE_DE = "de-DE",
+    EL_GR = "el-GR",
+    EN_AU = "en-AU",
+    EN_CA = "en-CA",
+    EN_GB = "en-GB",
+    EN_IE = "en-IE",
+    EN_IN = "en-IN",
+    EN_NZ = "en-NZ",
+    EN_US = "en-US",
+    EN_ZA = "en-ZA",
+    ES_AR = "es-AR",
+    ES_CL = "es-CL",
+    ES_CO = "es-CO",
+    ES_ES = "es-ES",
+    ES_MX = "es-MX",
+    ES_US = "es-US",
+    FI_FI = "fi-FI",
+    FR_BE = "fr-BE",
+    FR_CA = "fr-CA",
+    FR_CH = "fr-CH",
+    FR_FR = "fr-FR",
+    HE_IL = "he-IL",
+    HI_IN = "hi-IN",
+    HU_HU = "hu-HU",
+    ID_ID = "id-ID",
+    IT_CH = "it-CH",
+    IT_IT = "it-IT",
+    JA_JP = "ja-JP",
+    KO_KR = "ko-KR",
+    NL_BE = "nl-BE",
+    NL_NL = "nl-NL",
+    NO_NO = "no-NO",
+    PL_PL = "pl-PL",
+    PT_BR = "pt-BR",
+    PT_PT = "pt-PT",
+    RO_RO = "ro-RO",
+    RU_RU = "ru-RU",
+    SK_SK = "sk-SK",
+    SV_SE = "sv-SE",
+    TA_IN = "ta-IN",
+    TA_LK = "ta-LK",
+    TH_TH = "th-TH",
+    TR_TR = "tr-TR",
+    ZH_CN = "zh-CN",
+    ZH_HK = "zh-HK",
+    ZH_TW = "zh-TW"
+}
+
+declare const flowMediaData: z.ZodObject<{
+    media_id: z.ZodString;
+    cdn_url: z.ZodString;
+    file_name: z.ZodString;
+    encryption_metadata: z.ZodObject<{
+        encrypted_hash: z.ZodString;
+        iv: z.ZodString;
+        encryption_key: z.ZodString;
+        hmac_key: z.ZodString;
+        plaintext_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        encrypted_hash: string;
+        iv: string;
+        encryption_key: string;
+        hmac_key: string;
+        plaintext_hash: string;
+    }, {
+        encrypted_hash: string;
+        iv: string;
+        encryption_key: string;
+        hmac_key: string;
+        plaintext_hash: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    media_id: string;
+    cdn_url: string;
+    file_name: string;
+    encryption_metadata: {
+        encrypted_hash: string;
+        iv: string;
+        encryption_key: string;
+        hmac_key: string;
+        plaintext_hash: string;
+    };
+}, {
+    media_id: string;
+    cdn_url: string;
+    file_name: string;
+    encryption_metadata: {
+        encrypted_hash: string;
+        iv: string;
+        encryption_key: string;
+        hmac_key: string;
+        plaintext_hash: string;
+    };
+}>;
+type FlowMediaData = z.infer<typeof flowMediaData>;
+
+declare function decryptFlowMedia(media: FlowMediaData[]): Promise<Buffer<ArrayBufferLike>[]>;
+
+declare function encryptFlowResponse(data: AnyType, encryptionMetadata: {
+    aesKeyBuffer: Buffer;
+    initialVectorBuffer: Buffer;
+}): string;
+
+declare const flowAction: z.ZodEnum<["INIT", "BACK", "data_exchange", "navigate", "ping"]>;
+type FlowAction = z.infer<typeof flowAction>;
+
+declare const flowScreen: z.ZodUnion<[z.ZodLiteral<"SUCCESS">, z.ZodString]>;
+type FlowScreen = z.infer<typeof flowScreen>;
+
+interface WhatsappFlowDecryptedWebhookBody {
+    version: "3.0";
+    screen: FlowScreen;
+    action: FlowAction;
+    data: Record<string, AnyType>;
+    flow_token: string;
+}
+interface WhatsappFlowResponse {
+    screen: FlowScreen;
+    data: Record<string, AnyType>;
+}
+interface WhatsappFlowPingResponse {
+    data: {
+        status: "active";
+    };
+}
+interface WhatsappFlowEncryptionData {
+    aesKeyBuffer: Buffer;
+    initialVectorBuffer: Buffer;
+}
+interface WhatsappFlowEncryptedWebhookBody {
+    encrypted_aes_key: string;
+    encrypted_flow_data: string;
+    initial_vector: string;
+}
+type WhatsappFlowErrorMessages<T> = Partial<Record<keyof T, string>>;
+interface WhatsappFlowInfo {
+    id: string;
+    mode: "draft" | "published";
+    name: string;
+}
+
 declare const endpoints: {
     flows: {
         create: Endpoint<"/{waba_id}/flows", "post", {
@@ -217,59 +353,8 @@ declare const flowsEndpoints: {
     publish: Endpoint<"/{flow_id}/publish", "post", IRequest, WhatsappPublishFlowResponse>;
 };
 
-declare const flowAction: z.ZodEnum<["INIT", "BACK", "data_exchange", "navigate", "ping"]>;
-type FlowAction = z.infer<typeof flowAction>;
-
 type FlowData<K extends string = string> = Record<K, AnyType>;
 
-declare const flowMediaData: z.ZodObject<{
-    media_id: z.ZodString;
-    cdn_url: z.ZodString;
-    file_name: z.ZodString;
-    encryption_metadata: z.ZodObject<{
-        encrypted_hash: z.ZodString;
-        iv: z.ZodString;
-        encryption_key: z.ZodString;
-        hmac_key: z.ZodString;
-        plaintext_hash: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        encrypted_hash: string;
-        iv: string;
-        encryption_key: string;
-        hmac_key: string;
-        plaintext_hash: string;
-    }, {
-        encrypted_hash: string;
-        iv: string;
-        encryption_key: string;
-        hmac_key: string;
-        plaintext_hash: string;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    media_id: string;
-    cdn_url: string;
-    file_name: string;
-    encryption_metadata: {
-        encrypted_hash: string;
-        iv: string;
-        encryption_key: string;
-        hmac_key: string;
-        plaintext_hash: string;
-    };
-}, {
-    media_id: string;
-    cdn_url: string;
-    file_name: string;
-    encryption_metadata: {
-        encrypted_hash: string;
-        iv: string;
-        encryption_key: string;
-        hmac_key: string;
-        plaintext_hash: string;
-    };
-}>;
-type FlowMediaData = z.infer<typeof flowMediaData>;
-
 declare const flowMetadata: z.ZodObject<{
     name: z.ZodString;
     categories: z.ZodArray<z.ZodEnum<["SIGN_UP", "SIGN_IN", "APPOINTMENT_BOOKING", "LEAD_GENERATION", "CONTACT_US", "CUSTOMER_SUPPORT", "SURVEY", "OTHER"]>, "many">;
@@ -288,11 +373,8 @@ declare const flowMetadata: z.ZodObject<{
 }>;
 type FlowMetadata = z.infer<typeof flowMetadata>;
 
-declare const flowScreen: z.ZodUnion<[z.ZodLiteral<"SUCCESS">, z.ZodString]>;
-type FlowScreen = z.infer<typeof flowScreen>;
-
 type WaOutgoingContactsMessage = Array<{
-    addresses: Array<Partial<{
+    addresses?: Array<Partial<{
         street: string;
         city: string;
         state: string;
@@ -301,8 +383,8 @@ type WaOutgoingContactsMessage = Array<{
         country_code: string;
         type: string;
     }>>;
-    birthday: `${number}${number}${number}${number}-${number}${number}-${number}${number}`;
-    emails: Array<Partial<{
+    birthday?: `${number}${number}${number}${number}-${number}${number}-${number}${number}`;
+    emails?: Array<Partial<{
         email: string;
         type: string;
     }>>;
@@ -314,17 +396,17 @@ type WaOutgoingContactsMessage = Array<{
         prefix?: string;
         suffix?: string;
     };
-    org: Partial<{
+    org?: Partial<{
         company: string;
         department: string;
         title: string;
     }>;
-    phones: Array<Partial<{
+    phones: Array<{
         phone: string;
-        type: string;
-        wa_id: string;
-    }>>;
-    urls: Array<Partial<{
+        type?: string;
+        wa_id?: string;
+    }>;
+    urls?: Array<Partial<{
         url: string;
         type: string;
     }>>;
@@ -349,10 +431,8 @@ type WaOutgoingDocumentMessage = {
 };
 type WaOutgoingAudioMessage = {
     id: string;
-    caption?: string;
 } | {
     link: string;
-    caption?: string;
 };
 type WaOutgoingVideoMessage = {
     id: string;
@@ -384,8 +464,10 @@ interface WaInteractiveAction {
     button?: string;
     buttons?: Array<{
         type: "reply";
-        title: string;
-        id: string;
+        reply: {
+            title: string;
+            id: string;
+        };
     }>;
     catalog_id?: string;
     product_retailer_id?: string;
@@ -416,13 +498,7 @@ interface WaInteractiveHeader {
     type: "text" | "video" | "image" | "document";
 }
 type WaInteractiveActionType = "button" | "catalog_message" | "list" | "product" | "product_list" | "flow";
-declare class WaInteractiveBase {
-    constructor({ type, body, footer, header, }: {
-        type: WaInteractiveActionType;
-        body?: WaInteractiveBody;
-        footer?: WaInteractiveFooter;
-        header?: WaInteractiveHeader;
-    });
+interface WaInteractiveBase {
     type: WaInteractiveActionType;
     body?: WaInteractiveBody;
     footer?: WaInteractiveFooter;
@@ -444,10 +520,12 @@ interface WaOutgoingReactionMessage {
     emoji: string;
 }
 
+type WhatsappLanguageTag = "af" | "sq" | "ar" | "az" | "bn" | "bg" | "ca" | "zh_CN" | "zh_HK" | "zh_TW" | "hr" | "cs" | "da" | "nl" | "en" | "en_GB" | "en_US" | "et" | "fil" | "fi" | "fr" | "de" | "el" | "gu" | "ha" | "he" | "hi" | "hu" | "id" | "ga" | "it" | "ja" | "kn" | "kk" | "ko" | "lo" | "lv" | "lt" | "mk" | "ms" | "ml" | "mr" | "nb" | "fa" | "pl" | "pt_PT" | "pt_BR" | "pa" | "ro" | "ru" | "sr" | "sk" | "sl" | "es" | "es_AR" | "es_ES" | "es_MX" | "sw" | "sv" | "ta" | "te" | "th" | "tr" | "uk" | "ur" | "uz" | "vi" | "zu";
+
 type WaOutgoingTemplateMessage = {
     name: string;
     language: {
-        code: string;
+        code: WhatsappLanguageTag;
     };
     namespace?: string;
     components?: Array<{
@@ -503,7 +581,9 @@ type WaIncomingContacts = Array<WaIncomingContactObject>;
 type WhatsappSendMessageRequestConfig = {
     to: string;
     preview_url?: boolean;
-    context?: string;
+    context?: {
+        message_id: string;
+    };
     biz_opaque_callback_data?: string;
     recipient_type?: "individual";
     messaging_product?: "whatsapp";
@@ -749,92 +829,1056 @@ type WhatsappApplicationWebhookBody = {
     }>;
 };
 
-interface WhatsappFlowDecryptedWebhookBody {
-    version: "3.0";
-    screen: FlowScreen;
-    action: FlowAction;
-    data: Record<string, AnyType>;
-    flow_token: string;
-}
-interface WhatsappFlowResponse {
-    screen: FlowScreen;
-    data: Record<string, AnyType>;
-}
-interface WhatsappFlowPingResponse {
-    data: {
-        status: "active";
-    };
-}
-interface WhatsappFlowEncryptionData {
-    aesKeyBuffer: Buffer;
-    initialVectorBuffer: Buffer;
-}
-interface WhatsappFlowEncryptedWebhookBody {
-    encrypted_aes_key: string;
-    encrypted_flow_data: string;
-    initial_vector: string;
-}
-type WhatsappFlowErrorMessages<T> = Partial<Record<keyof T, string>>;
-interface WhatsappFlowInfo {
-    id: string;
-    mode: "draft" | "published";
-    name: string;
-}
-
-declare function _delete(flow_id: string): Promise<WhatsappDeleteFlowResponse>;
-
-declare function verifyFlowIntegrity(flowID: string): Promise<string | void>;
-
-declare const unnoficial_verifyFlowIntegrity: typeof verifyFlowIntegrity;
-declare namespace unnoficial {
-  export { unnoficial_verifyFlowIntegrity as verifyFlowIntegrity };
-}
-
-type WaSDKButtonMessage = Omit<WaInteractiveBase, "type"> & {
-    type: "button";
-    buttons: Array<{
-        id: string;
-        text: string;
-    }>;
-};
-
-interface FlowPayload {
-    screen: string;
-    data?: Record<string, AnyType>;
-}
-interface BaseFlowConfig {
-    name: string;
-    buttonText: string;
-    parameters?: Record<string, string | number>;
-    mode?: "draft" | "published";
-}
-interface NavigateFlowConfig extends BaseFlowConfig {
-    action?: "navigate";
-    payload: FlowPayload;
-}
-interface DataExchangeFlowConfig extends BaseFlowConfig {
-    action?: "data_exchange";
-    payload?: FlowPayload;
-}
-type FlowConfig = NavigateFlowConfig | DataExchangeFlowConfig;
-type WaSDKOutgoingFlowMessage = Omit<WaInteractiveBase, "type"> & {
-    type: "flow";
-    flow: FlowConfig;
-};
-
-type WaSDKOutgoingListMessage = Omit<WaInteractiveBase, "type"> & {
-    type: "list";
-    list: {
-        buttonText: string;
-        sections: Array<{
-            rows: Array<{
-                id: string;
-                title: string;
-                description?: string;
-            }>;
-            title: string;
-        }>;
-    };
+/**
+ * Cloud API Error Codes
+ *
+ * Enum representing specific error codes returned by the Cloud API.
+ */
+declare enum WhatsappErrorCode {
+    /**
+     * Error Code: 0
+     *
+     * Details:
+     * AuthException
+     *
+     * Description:
+     * We were unable to authenticate the app user. Typically this means the included access token has expired, been invalidated, or the app user has changed a setting to prevent all apps from accessing their data.
+     *
+     * Solution:
+     * We recommend that you get a new access token from the app user.
+     *
+     * HTTP Response:
+     * 401 - Unauthorized
+     */
+    e0AuthException = 0,
+    /**
+     * Error Code: 3
+     *
+     * Details:
+     * API Method
+     *
+     * Description:
+     * Capability or permissions issue.
+     *
+     * Solution:
+     * Use the access token debugger to verify that your app has been granted the permissions required by the endpoint.
+     *
+     * HTTP Response:
+     * 500 - Internal Server Error
+     */
+    e3ApiMethod = 3,
+    /**
+     * Error Code: 10
+     *
+     * Details:
+     * Permission Denied
+     *
+     * Description:
+     * Permission is either not granted or has been removed.
+     *
+     * Solution:
+     * Use the access token debugger to verify that your app has been granted the permissions required by the endpoint. Ensure that the phone number used to set the business public key is allowlisted.
+     *
+     * HTTP Response:
+     * 403 - Forbidden
+     */
+    e10PermissionDenied = 10,
+    /**
+     * Error Code: 190
+     *
+     * Details:
+     * Access token has expired
+     *
+     * Description:
+     * Your access token has expired.
+     *
+     * Solution:
+     * Get a new access token.
+     *
+     * HTTP Response:
+     * 401 - Unauthorized
+     */
+    e190AccessTokenExpired = 190,
+    /**
+     * Error Code: 200-299
+     *
+     * Details:
+     * API Permission
+     *
+     * Description:
+     * Permission is either not granted or has been removed within the 200-299 range of API Permission errors.
+     *
+     * Solution:
+     * Use the access token debugger to verify that your app has been granted the permissions required by the endpoint.
+     *
+     * HTTP Response:
+     * 403 - Forbidden
+     */
+    e2xxApiPermission = 200,
+    /**
+     * Error Code: 368
+     *
+     * Details:
+     * Temporarily blocked for policies violations
+     *
+     * Description:
+     * The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.
+     *
+     * Solution:
+     * See the Policy Enforcement document to learn about policy violations and how to resolve them.
+     *
+     * HTTP Response:
+     * 403 - Forbidden
+     */
+    e368TemporarilyBlockedForPolicyViolations = 368,
+    /**
+     * Error Code: 130497
+     *
+     * Details:
+     * Business account is restricted from messaging users in this country.
+     *
+     * Description:
+     * The WhatsApp Business Account is restricted from messaging to users in certain countries.
+     *
+     * Solution:
+     * See WhatsApp Business Messaging Policy for details on allowed countries for messaging in your business category.
+     *
+     * HTTP Response:
+     * 403 - Forbidden
+     */
+    e130497BusinessAccountRestrictedByCountry = 130497,
+    /**
+     * Error Code: 131031
+     *
+     * Details:
+     * Account has been locked
+     *
+     * Description:
+     * The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy, or we were unable to verify data included in the request against data set on the WhatsApp Business Account (e.g, the two-step pin included in the request is incorrect).
+     *
+     * Solution:
+     * See the Policy Enforcement document to learn about policy violations and how to resolve them. You can also use the Health Status API, which may provide additional insight into the reason or reasons for the account lock.
+     *
+     * HTTP Response:
+     * 403 - Forbidden
+     */
+    e131031AccountLocked = 131031,
+    /**
+     * Error Code: 1
+     *
+     * Details:
+     * API Unknown
+     *
+     * Description:
+     * Invalid request or possible server error.
+     *
+     * Solution:
+     * Check the WhatsApp Business Platform Status page to see API status information. If there are no server outages, check the endpoint reference and verify that your request is formatted correctly and meets all endpoint requirements.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e1ApiUnknown = 1,
+    /**
+     * Error Code: 2
+     *
+     * Details:
+     * API Service
+     *
+     * Description:
+     * Temporary due to downtime or due to being overloaded.
+     *
+     * Solution:
+     * Check the WhatsApp Business Platform Status page to see API status information before trying again.
+     *
+     * HTTP Response:
+     * 503 - Service Unavailable
+     */
+    e2ApiService = 2,
+    /**
+     * Error Code: 33
+     *
+     * Details:
+     * Parameter value is not valid
+     *
+     * Description:
+     * The business phone number has been deleted.
+     *
+     * Solution:
+     * Verify that the business phone number is correct.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e33ParameterValueNotValid = 33,
+    /**
+     * Error Code: 100
+     *
+     * Details:
+     * Invalid parameter
+     *
+     * Description:
+     * The request included one or more unsupported or misspelled parameters.
+     *
+     * Solution:
+     * See the endpoint's reference to determine which parameters are supported and how they are spelled. Ensure when setting the business public key, it is a valid 2048-bit RSA public key in PEM format. Ensure there is no mismatch between the phone number id you are registering and a previously stored phone number id. Ensure your parameter is under any length restriction for the type.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e100InvalidParameter = 100,
+    /**
+     * Error Code: 130472
+     *
+     * Details:
+     * User's number is part of an experiment
+     *
+     * Description:
+     * Message was not sent as part of an experiment.
+     *
+     * Solution:
+     * See Marketing Message Experiment.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e130472UserNumberPartOfExperiment = 130472,
+    /**
+     * Error Code: 131000
+     *
+     * Details:
+     * Something went wrong
+     *
+     * Description:
+     * Message failed to send due to an unknown error. When setting a business public key, it either failed to calculate the signature, call the GraphQL endpoint, or the GraphQL endpoint returned an error.
+     *
+     * Solution:
+     * Try again. If the error persists, open a Direct Support ticket.
+     *
+     * HTTP Response:
+     * 500 - Internal Server Error
+     */
+    e131000SomethingWentWrong = 131000,
+    /**
+     * Error Code: 131005
+     *
+     * Details:
+     * Access denied
+     *
+     * Description:
+     * Permission is either not granted or has been removed.
+     *
+     * Solution:
+     * Use the access token debugger to verify that your app has been granted the permissions required by the endpoint.
+     *
+     * HTTP Response:
+     * 403 - Forbidden
+     */
+    e131005AccessDenied = 131005,
+    /**
+     * Error Code: 131008
+     *
+     * Details:
+     * Required parameter is missing
+     *
+     * Description:
+     * The request is missing a required parameter.
+     *
+     * Solution:
+     * See the endpoint's reference to determine which parameters are required.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131008RequiredParameterMissing = 131008,
+    /**
+     * Error Code: 131009
+     *
+     * Details:
+     * Parameter value is not valid
+     *
+     * Description:
+     * One or more parameter values are invalid.
+     *
+     * Solution:
+     * See the endpoint's reference to determine which values are supported for each parameter, and see Phone Numbers to learn how to add a phone number to a WhatsApp Business Account.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131009ParameterValueNotValid = 131009,
+    /**
+     * Error Code: 131016
+     *
+     * Details:
+     * Service unavailable
+     *
+     * Description:
+     * A service is temporarily unavailable.
+     *
+     * Solution:
+     * Check the WhatsApp Business Platform Status page to see API status information before trying again.
+     *
+     * HTTP Response:
+     * 500 - Internal Server Error
+     */
+    e131016ServiceUnavailable = 131016,
+    /**
+     * Error Code: 131021
+     *
+     * Details:
+     * Recipient cannot be sender
+     *
+     * Description:
+     * The sender and recipient phone numbers are the same.
+     *
+     * Solution:
+     * Send a message to a different phone number than the sender.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131021RecipientCannotBeSender = 131021,
+    /**
+     * Error Code: 131026
+     *
+     * Details:
+     * Message Undeliverable
+     *
+     * Description:
+     * Unable to deliver message. Reasons can include: The recipient phone number is not a WhatsApp phone number. Recipient has not accepted our new Terms of Service and Privacy Policy. Recipient using an old WhatsApp version; must use the following WhatsApp version or greater: Android: 2.21.15.15, SMBA: 2.21.15.15, iOS: 2.21.170.4, SMBI: 2.21.170.4, KaiOS: 2.2130.10, Web: 2.2132.6.
+     *
+     * Solution:
+     * Using a non-WhatsApp communication method, ask the WhatsApp user to: Confirm that they can actually send a message to your WhatsApp business phone number. Confirm that they have accepted our latest Terms of Service (Settings > Help, or Settings > Application information will prompt them to accept the latest terms/policies if they haven't done so already). Update to the latest version of the WhatsApp client.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131026MessageUndeliverable = 131026,
+    /**
+     * Error Code: 131030
+     *
+     * Details:
+     * Recipient not allowed in list
+     *
+     * Description:
+     * Recipient phone number not in allowed list.
+     *
+     * Solution:
+     * Add recipient phone number to recipient list and try again.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131030RecipientNotAllowedInList = 131030,
+    /**
+     * Error Code: 131037
+     *
+     * Details:
+     * WhatsApp provided number needs display name approval before message can be sent.
+     *
+     * Description:
+     * The 555 business phone number used to send the request does not have an approved display name.
+     *
+     * Solution:
+     * Change the 555 business phone number's display name. See our How to change your WhatsApp Business display name Help Center article to learn how.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131037DisplayNameApprovalNeeded = 131037,
+    /**
+     * Error Code: 131042
+     *
+     * Details:
+     * Business eligibility payment issue
+     *
+     * Description:
+     * There was an error related to your payment method.
+     *
+     * Solution:
+     * See About Billing For Your WhatsApp Business Account and verify that you have set up billing correctly. Common problems: Payment account is not attached to a WhatsApp Business Account, Credit line is over the limit, Credit line (Payment Account) not set or active, WhatsApp Business Account is deleted, WhatsApp Business Account is suspended, Timezone not set, Currency not set, MessagingFor request (On Behalf Of) is pending or declined.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131042BusinessEligibilityPaymentIssue = 131042,
+    /**
+     * Error Code: 131045
+     *
+     * Details:
+     * Incorrect certificate
+     *
+     * Description:
+     * Message failed to send due to a phone number registration error.
+     *
+     * Solution:
+     * Register the phone number before trying again.
+     *
+     * HTTP Response:
+     * 500 - Internal Server Error
+     */
+    e131045IncorrectCertificate = 131045,
+    /**
+     * Error Code: 131047
+     *
+     * Details:
+     * Re-engagement message
+     *
+     * Description:
+     * More than 24 hours have passed since the recipient last replied to the sender number.
+     *
+     * Solution:
+     * Send the recipient a business-initiated message using a message template instead.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131047ReEngagementMessage = 131047,
+    /**
+     * Error Code: 131049
+     *
+     * Details:
+     * Meta chose not to deliver.
+     *
+     * Description:
+     * This message was not delivered to maintain healthy ecosystem engagement.
+     *
+     * Solution:
+     * Do not retry immediately if you do receive this error code and suspect it is due to the limit. Instead, retry in increasing larger time increments until the message is delivered, since the limit may be in effect for differing periods of time. See Per-User Marketing Template Message Limits for additional information.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131049MetaChoseNotToDeliver = 131049,
+    /**
+     * Error Code: 131050
+     *
+     * Details:
+     * User has stopped receipt of marketing messages.
+     *
+     * Description:
+     * Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business.
+     *
+     * Solution:
+     * Do not retry sending messages to this user as they will not be received. To be notified whenever a WhatsApp user stops or resumes delivery of marketing template messages from your business, subscribe to the user_preferences webhook.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131050UserStoppedMarketingMessages = 131050,
+    /**
+     * Error Code: 131051
+     *
+     * Details:
+     * Unsupported message type
+     *
+     * Description:
+     * Unsupported message type.
+     *
+     * Solution:
+     * See Messages for supported message types before trying again with a supported message type.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131051UnsupportedMessageType = 131051,
+    /**
+     * Error Code: 131052
+     *
+     * Details:
+     * Media download error
+     *
+     * Description:
+     * Unable to download the media sent by the user.
+     *
+     * Solution:
+     * We were unable to download media included in the WhatsApp user's message. For more information, refer to the error.error_data.details value in any messages webhooks triggered when this message was received. Ask the WhatsApp user to send you the media file using a non-WhatsApp method.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131052MediaDownloadError = 131052,
+    /**
+     * Error Code: 131053
+     *
+     * Details:
+     * Media upload error
+     *
+     * Description:
+     * Unable to upload the media used in the message.
+     *
+     * Solution:
+     * We were unable to upload the media for one or more reasons, such as an unsupported media type. For more information, refer to the error.error_data.details value in any messages webhooks triggered when this message fails to send. We recommend that you inspect any media files that are causing errors and confirm that they are in fact supported. For example, in UNIX you can use file inspection via the command line to determine its MIME type: file -I rejected-file.mov You can then confirm if its MIME type is supported. See Supported Media Types.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131053MediaUploadError = 131053,
+    /**
+     * Error Code: 131057
+     *
+     * Details:
+     * Account in maintenance mode
+     *
+     * Description:
+     * Business Account is in maintenance mode. The WhatsApp Business Account is in maintenance mode. One reason for this could be that the account is undergoing a throughput upgrade.
+     *
+     * Solution:
+     * (No specific solution provided, implies waiting or contact support.)
+     *
+     * HTTP Response:
+     * 500 - Bad Request
+     */
+    e131057AccountInMaintenanceMode = 131057,
+    /**
+     * Error Code: 132000
+     *
+     * Details:
+     * Template Param Count Mismatch
+     *
+     * Description:
+     * The number of variable parameter values included in the request did not match the number of variable parameters defined in the template.
+     *
+     * Solution:
+     * See Message Template Guidelines and make sure the request includes all of the variable parameter values that have been defined in the template.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132000TemplateParamCountMismatch = 132000,
+    /**
+     * Error Code: 132001
+     *
+     * Details:
+     * Template does not exist
+     *
+     * Description:
+     * The template does not exist in the specified language or the template has not been approved.
+     *
+     * Solution:
+     * Make sure your template has been approved and the template name and language locale are correct. Please ensure you follow message template guidelines.
+     *
+     * HTTP Response:
+     * 404 - Not Found
+     */
+    e132001TemplateDoesNotExist = 132001,
+    /**
+     * Error Code: 132005
+     *
+     * Details:
+     * Template Hydrated Text Too Long
+     *
+     * Description:
+     * Translated text is too long.
+     *
+     * Solution:
+     * Check the WhatsApp Manager to verify that your template has been translated. See Quality Rating and Template Status.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132005TemplateHydratedTextTooLong = 132005,
+    /**
+     * Error Code: 132007
+     *
+     * Details:
+     * Template Format Character Policy Violated
+     *
+     * Description:
+     * Template content violates a WhatsApp policy.
+     *
+     * Solution:
+     * See Rejection Reasons to determine possible reasons for violation.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132007TemplateFormatCharacterPolicyViolated = 132007,
+    /**
+     * Error Code: 132012
+     *
+     * Details:
+     * Template Parameter Format Mismatch
+     *
+     * Description:
+     * Variable parameter values formatted incorrectly.
+     *
+     * Solution:
+     * The variable parameter values included in the request are not using the format specified in the template. See Message Template Guidelines.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132012TemplateParameterFormatMismatch = 132012,
+    /**
+     * Error Code: 132015
+     *
+     * Details:
+     * Template is Paused
+     *
+     * Description:
+     * Template is paused due to low quality so it cannot be sent in a template message.
+     *
+     * Solution:
+     * Edit the template to improve its quality and try again once it is approved.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132015TemplateIsPaused = 132015,
+    /**
+     * Error Code: 132016
+     *
+     * Details:
+     * Template is Disabled
+     *
+     * Description:
+     * Template has been paused too many times due to low quality and is now permanently disabled.
+     *
+     * Solution:
+     * Create a new template with different content.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132016TemplateIsDisabled = 132016,
+    /**
+     * Error Code: 132068
+     *
+     * Details:
+     * Flow is blocked
+     *
+     * Description:
+     * Flow is in blocked state.
+     *
+     * Solution:
+     * Correct the Flow.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132068FlowIsBlocked = 132068,
+    /**
+     * Error Code: 132069
+     *
+     * Details:
+     * Flow is throttled
+     *
+     * Description:
+     * Flow is in throttled state and 10 messages using this flow were already sent in the last hour.
+     *
+     * Solution:
+     * Correct the Flow.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e132069FlowIsThrottled = 132069,
+    /**
+     * Error Code: 133000
+     *
+     * Details:
+     * Incomplete Deregistration
+     *
+     * Description:
+     * A previous deregistration attempt failed.
+     *
+     * Solution:
+     * Deregister the number again before registering.
+     *
+     * HTTP Response:
+     * 500 - Internal Server Error
+     */
+    e133000IncompleteDeregistration = 133000,
+    /**
+     * Error Code: 133004
+     *
+     * Details:
+     * Server Temporarily Unavailable
+     *
+     * Description:
+     * Server is temporarily unavailable.
+     *
+     * Solution:
+     * Check the WhatsApp Business Platform Status page to see API status information and check the response details value before trying again.
+     *
+     * HTTP Response:
+     * 503 - Service Unavailable
+     */
+    e133004ServerTemporarilyUnavailable = 133004,
+    /**
+     * Error Code: 133005
+     *
+     * Details:
+     * Two step verification PIN Mismatch
+     *
+     * Description:
+     * Two-step verification PIN incorrect.
+     *
+     * Solution:
+     * Verify that the two-step verification PIN included in the request is correct. To reset the two-step verification PIN: Disable two-step verification. Send a POST request that includes the new PIN to the Phone Number endpoint.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e133005TwoStepVerificationPinMismatch = 133005,
+    /**
+     * Error Code: 133006
+     *
+     * Details:
+     * Phone number re-verification needed
+     *
+     * Description:
+     * Phone number needs to be verified before registering.
+     *
+     * Solution:
+     * Verify the phone number before registering it.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e133006PhoneNumberReVerificationNeeded = 133006,
+    /**
+     * Error Code: 133008
+     *
+     * Details:
+     * Too Many two step verification PIN Guesses
+     *
+     * Description:
+     * Too many two-step verification PIN guesses for this phone number.
+     *
+     * Solution:
+     * Try again after the amount of time specified in the details response value.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e133008TooManyTwoStepVerificationPinGuesses = 133008,
+    /**
+     * Error Code: 133009
+     *
+     * Details:
+     * Two step verification PIN Guessed Too Fast
+     *
+     * Description:
+     * Two-step verification PIN was entered too quickly.
+     *
+     * Solution:
+     * Check the details response value before trying again.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e133009TwoStepVerificationPinGuessedTooFast = 133009,
+    /**
+     * Error Code: 133010
+     *
+     * Details:
+     * Phone number Not Registered
+     *
+     * Description:
+     * Phone number not registered on the WhatsApp Business Platform.
+     *
+     * Solution:
+     * Register the phone number before trying again.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e133010PhoneNumberNotRegistered = 133010,
+    /**
+     * Error Code: 133015
+     *
+     * Details:
+     * Please wait a few minutes before attempting to register this phone number
+     *
+     * Description:
+     * The phone number you are attempting to register was recently deleted, and deletion has not yet completed.
+     *
+     * Solution:
+     * Wait 5 minutes before re-trying the request.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e133015PhoneNumberDeletionPending = 133015,
+    /**
+     * Error Code: 134011
+     *
+     * Details:
+     * WhatsApp Payments terms of service has not been accepted
+     *
+     * Description:
+     * Message failed to send because WhatsApp Payments terms of service acceptance is pending for this WhatsApp Business Account.
+     *
+     * Solution:
+     * Accept the WhatsApp Payments terms of service using the link provided in the error message before trying again.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e134011PaymentsTermsNotAccepted = 134011,
+    /**
+     * Error Code: 135000
+     *
+     * Details:
+     * Generic user error
+     *
+     * Description:
+     * Message failed to send because of an unknown error with your request parameters.
+     *
+     * Solution:
+     * See the endpoint's reference to determine if you are querying the endpoint using the correct syntax. Contact customer support if you continue receiving this error code in response.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e135000GenericUserError = 135000,
+    /**
+     * Error Code: 2593107
+     *
+     * Details:
+     * Synchronization Request limit exceeded
+     *
+     * Description:
+     * You have exceeded the maximum number of times to call the synchronization API for this phone number.
+     *
+     * Solution:
+     * You can only call this endpoint once to synchronize the business phone number contacts and once to synchronize its messaging history. See Onboarding business app users. Offboard the business customer and re-onboard them.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e2593107SynchronizationRequestLimitExceeded = 2593107,
+    /**
+     * Error Code: 2593108
+     *
+     * Details:
+     * Synchronization Request made outside of allowed time window
+     *
+     * Description:
+     * Synchronization request can only be made within 24 hours of onboarding.
+     *
+     * Solution:
+     * You can only initiate contacts and messaging history synchronization of an onboarded WhatsApp Business app user within 24 hours of onboarding the user. See Onboarding business app users. Offboard the user and re-onboard them.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e2593108SynchronizationRequestOutsideTimeWindow = 2593108,
+    /**
+     * Error Code: 4
+     *
+     * Details:
+     * API Too Many Calls
+     *
+     * Description:
+     * The app has reached its API call rate limit.
+     *
+     * Solution:
+     * Load the app in the App Dashboard and view the Application Rate Limit section to verify that the app has reached its rate limit. If it has, try again later or reduce the frequency or amount of API queries the app is making.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e4ApiTooManyCalls = 4,
+    /**
+     * Error Code: 80007
+     *
+     * Details:
+     * Rate limit issues
+     *
+     * Description:
+     * The WhatsApp Business Account has reached its rate limit.
+     *
+     * Solution:
+     * See WhatsApp Business Account Rate Limits. Try again later or reduce the frequency or amount of API queries the app is making.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e80007RateLimitIssues = 80007,
+    /**
+     * Error Code: 130429
+     *
+     * Details:
+     * Rate limit hit
+     *
+     * Description:
+     * Cloud API message throughput has been reached.
+     *
+     * Solution:
+     * The app has reached the API's throughput limit. See Throughput. Try again later or reduce the frequency with which the app sends messages.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e130429RateLimitHit = 130429,
+    /**
+     * Error Code: 131048
+     *
+     * Details:
+     * Spam rate limit hit
+     *
+     * Description:
+     * Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam.
+     *
+     * Solution:
+     * Check your quality status in the WhatsApp Manager and see the Quality-Based Rate Limits documentation for more information.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131048SpamRateLimitHit = 131048,
+    /**
+     * Error Code: 131056
+     *
+     * Details:
+     * (Business Account, Consumer Account) pair rate limit hit
+     *
+     * Description:
+     * Too many messages sent from the sender phone number to the same recipient phone number in a short period of time.
+     *
+     * Solution:
+     * Wait and retry the operation, if you intend to send messages to the same phone number. You can still send messages to a different phone number without waiting.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e131056BusinessConsumerPairRateLimitHit = 131056,
+    /**
+     * Error Code: 133016
+     *
+     * Details:
+     * Account register deregister rate limit exceeded
+     *
+     * Description:
+     * Registration or Deregistration failed because there were too many attempts for this phone number in a short period of time.
+     *
+     * Solution:
+     * The business phone number is being blocked because it has reached its registration/deregistration attempt limit. Try again once the number is unblocked. See Limitations in the Registration document.
+     *
+     * HTTP Response:
+     * 400 - Bad Request
+     */
+    e133016AccountRegisterDeregisterRateLimitExceeded = 133016
+}
+
+type WaSDKFlowPayload = WhatsappFlowDecryptedWebhookBody;
+type WaSDKFlowDecryptedWebhookBody = {
+    payload: WaSDKFlowPayload;
+    encryptionMetadata: WhatsappFlowEncryptionData;
+};
+type WaSDKFlowExchangeEventPayload = WaSDKFlowDecryptedWebhookBody & {
+    pingResponse: WhatsappFlowPingResponse;
+};
+
+type FlowUpdateEventPayload = {
+    event: string;
+    message: string;
+    flow_id: string;
+};
+
+interface MessageStatusUpdateEvent {
+    messageId: string;
+    metadata: string;
+    timestamp: number;
+    errors: WaIncomingErrors;
+    status: WaIncomingMessageStatuses;
+}
+
+interface BaseMessageReceivedEventPayload {
+    id: string;
+    type: WaIncomingMessageType;
+    timestamp: number;
+    metadata: {
+        forwarded?: boolean;
+        frequentlyForwarded?: boolean;
+    };
+}
+type MessageReceivedEventPayload = BaseMessageReceivedEventPayload & {
+    chatId: string;
+    text: string | null;
+    reply?: string;
+    interaction?: {
+        button?: {
+            id: string | null;
+            title: string;
+            payload: string | null;
+        };
+        selectedOption?: {
+            id: string;
+            title: string;
+            description: string;
+        };
+        flowResponse?: {
+            flow_token: string;
+            intent: string | null;
+        } & {
+            [key: string]: AnyType;
+        };
+    };
+    media?: {
+        id: string;
+        caption: string | null;
+        mime_type: string;
+        type: "audio" | "document" | "image" | "video";
+        filename?: string;
+        sha256?: string;
+    };
+};
+
+type WaSDKButtonMessage = Omit<WaInteractiveBase, "type"> & {
+    type: "button";
+    buttons: Array<{
+        id: string;
+        text: string;
+    }>;
+};
+
+type WaSDKOutgoingContactMessage = {
+    type: "contact";
+    contacts: WaOutgoingContactsMessage;
+};
+
+interface FlowPayload {
+    screen: string;
+    data?: Record<string, AnyType>;
+}
+interface BaseFlowConfig {
+    name: string;
+    button: string;
+    parameters?: Record<string, string | number>;
+    mode?: "draft" | "published";
+}
+interface NavigateFlowConfig extends BaseFlowConfig {
+    action?: "navigate";
+    payload: FlowPayload;
+}
+interface DataExchangeFlowConfig extends BaseFlowConfig {
+    action?: "data_exchange";
+    payload?: FlowPayload;
+}
+type FlowConfig = NavigateFlowConfig | DataExchangeFlowConfig;
+type WaSDKOutgoingFlowMessage = Omit<WaInteractiveBase, "type"> & {
+    type: "flow";
+    flow: FlowConfig;
+};
+
+type WaSDKOutgoingListMessage = Omit<WaInteractiveBase, "type"> & {
+    type: "list";
+    list: {
+        button: string;
+        sections: Array<{
+            rows: Array<{
+                id: string;
+                title: string;
+                description?: string;
+            }>;
+            title: string;
+        }>;
+    };
 };
 
 type WaSDKOutgoingMediaMessage = {
@@ -859,7 +1903,6 @@ type WaSDKOutgoingMediaMessage = {
     type: "media";
     audio: {
         ref: string;
-        caption?: string;
     };
 } | {
     type: "media";
@@ -871,7 +1914,7 @@ type WaSDKOutgoingMediaMessage = {
 
 type WaSDKOutgoingTemplateMessage = Omit<WaOutgoingTemplateMessage, "namespace" | "language"> & {
     type: "template";
-    language: string;
+    language: `${LanguageTag}`;
 };
 
 type WaSDKOutgoingTextMessage = {
@@ -880,7 +1923,7 @@ type WaSDKOutgoingTextMessage = {
     previewUrl?: boolean;
 };
 
-type WaSDKSendMessageData = WaSDKButtonMessage | WaSDKOutgoingFlowMessage | WaSDKOutgoingListMessage | WaSDKOutgoingTextMessage | WaSDKOutgoingTemplateMessage | WaSDKOutgoingMediaMessage;
+type WaSDKSendMessageData = WaSDKButtonMessage | WaSDKOutgoingFlowMessage | WaSDKOutgoingListMessage | WaSDKOutgoingTextMessage | WaSDKOutgoingTemplateMessage | WaSDKOutgoingMediaMessage | WaSDKOutgoingContactMessage;
 
 interface WaSDKSendMessageConfig {
     showUrlPreviewImage?: boolean;
@@ -892,7 +1935,58 @@ type WaSDKSendMessageBody = WaSDKSendMessageConfig & {
     message: WaSDKSendMessageData;
 };
 
-declare function send(body: WaSDKSendMessageBody): Promise<WhatsappSendMessageResponse>;
+type WaSDKGetFlowWebPreviewPageRequestQuery = {
+    flow_action: "data_exchange" | "navigate";
+    phone_number: string;
+    interactive?: boolean;
+    recipient_id?: string;
+    flow_action_payload?: {
+        screen: string;
+        data: Record<string, AnyType>;
+    };
+    flow_parameters?: FlowParameters;
+};
+type FlowParameters = Record<string, string | number>;
+
+declare function decryptFlowBody(body: WhatsappFlowEncryptedWebhookBody): WaSDKFlowDecryptedWebhookBody;
+
+declare function generateWabaEncryption(): Promise<{
+    passphrase: `${string}-${string}-${string}-${string}-${string}`;
+    publicKey: string;
+    privateKey: string;
+}>;
+
+type WebhookSignatureChallengeArguments = {
+    rawBody: string;
+    untrustedSignature: string;
+};
+declare function verifySignature(request: Request, rawBody: string): Promise<boolean>;
+
+declare function verifyHub(request: Request): string | false;
+
+interface WaSDKEventPayload {
+    healthCheck: string;
+    flowExchange: WaSDKFlowExchangeEventPayload;
+    application: {
+        errors?: WaIncomingErrors[];
+        profileUpdate?: BaseMessageReceivedEventPayload & {
+            identity: WaIncomingIdentityObject;
+            system: WaIncomingSystemObject;
+        }[];
+        messageStatusUpdate?: MessageStatusUpdateEvent[];
+        messageReceived?: MessageReceivedEventPayload[];
+        flowUpdate?: FlowUpdateEventPayload[];
+    };
+}
+type WaSDKEventType = keyof WaSDKEventPayload;
+interface WaSDKEvent<T extends WaSDKEventType = WaSDKEventType> {
+    type: T;
+    payload: WaSDKEventPayload[T];
+}
+
+declare function webhook(request: Request): Promise<WaSDKEvent<"healthCheck"> | WaSDKEvent<"application"> | WaSDKEvent<"flowExchange"> | {
+    error: boolean;
+}>;
 
 declare function uploadWabaEncryption(publicKey: string): Promise<unknown>;
 
@@ -902,12 +1996,15 @@ interface Payload {
 }
 declare function registerNumber({ dataRegion, pin }: Payload): Promise<unknown>;
 
+declare function _delete(flow_id: string): Promise<WhatsappDeleteFlowResponse>;
+
+declare function send(body: WaSDKSendMessageBody): Promise<WhatsappSendMessageResponse>;
+
 declare const actions: {
     messages: {
         send: typeof send;
     };
     flows: {
-        unnoficial: typeof unnoficial;
         create(body: WhatsappCreateFlowRequestBody): Promise<WhatsappCreateFlowResponse>;
         updateMetadata(flow_id: string, body: WhatsappFlowUpdateMetadataRequestBody): Promise<WhatsappFlowUpdateMetadataResponse>;
         updateJson(flow_id: string, json: Record<string, AnyType>): Promise<WhatsappUpdateFlowJsonResponse>;
@@ -927,95 +2024,9 @@ declare const actions: {
     };
 };
 
-interface BaseMessageReceivedEventPayload {
-    id: string;
-    type: WaIncomingMessageType;
-    timestamp: number;
-    metadata: {
-        forwarded?: boolean;
-        frequentlyForwarded?: boolean;
-    };
-}
-type MessageReceivedEventPayload = BaseMessageReceivedEventPayload & {
-    chatId: string;
-    text: string | null;
-    reply?: string;
-    interaction?: {
-        button?: {
-            id: string | null;
-            title: string;
-            payload: string | null;
-        };
-        selectedOption?: {
-            id: string;
-            title: string;
-            description: string;
-        };
-        flowResponse?: {
-            flow_token: string;
-            intent: string | null;
-        } & {
-            [key: string]: AnyType;
-        };
-    };
-    media?: {
-        id: string;
-        caption: string | null;
-        mime_type: string;
-        type: "audio" | "document" | "image" | "video";
-        filename?: string;
-        sha256?: string;
-    };
-};
-
-interface MessageStatusUpdateEvent {
-    messageId: string;
-    metadata: string;
-    timestamp: number;
-    errors: WaIncomingErrors;
-    status: WaIncomingMessageStatuses;
-}
-
-type WaSDKFlowPayload = WhatsappFlowDecryptedWebhookBody;
-type WaSDKFlowDecryptedWebhookBody = {
-    payload: WaSDKFlowPayload;
-    encryptionMetadata: WhatsappFlowEncryptionData;
-};
-type WaSDKFlowExchangeEventPayload = WaSDKFlowDecryptedWebhookBody & {
-    pingResponse: WhatsappFlowPingResponse;
-};
-
-type FlowUpdateEventPayload = {
-    event: string;
-    message: string;
-    flow_id: string;
-};
-
-interface WaSDKEventPayload {
-    healthCheck: string;
-    flowExchange: WaSDKFlowExchangeEventPayload;
-    application: {
-        errors?: WaIncomingErrors[];
-        profileUpdate?: BaseMessageReceivedEventPayload & {
-            identity: WaIncomingIdentityObject;
-            system: WaIncomingSystemObject;
-        }[];
-        messageStatusUpdate?: MessageStatusUpdateEvent[];
-        messageReceived?: MessageReceivedEventPayload[];
-        flowUpdate?: FlowUpdateEventPayload[];
-    };
-}
-type WaSDKEventType = keyof WaSDKEventPayload;
-interface WaSDKEvent<T extends WaSDKEventType = WaSDKEventType> {
-    type: T;
-    payload: WaSDKEventPayload[T];
-}
-
-declare function webhook(request: Request): Promise<WaSDKEvent<"healthCheck"> | WaSDKEvent<"application"> | WaSDKEvent<"flowExchange">>;
-
 declare const parsers: {
     toGraph: {
-        sendMessage: (body: WaSDKSendMessageBody) => WhatsappSendMessageRequestBody<any> | WhatsappSendMessageRequestBody<"interactive"> | WhatsappSendMessageRequestBody<"text"> | WhatsappSendMessageRequestBody<"template">;
+        sendMessage: (body: WaSDKSendMessageBody) => WhatsappSendMessageRequestBody<any> | WhatsappSendMessageRequestBody<"interactive"> | WhatsappSendMessageRequestBody<"text"> | WhatsappSendMessageRequestBody<"template"> | WhatsappSendMessageRequestBody<"contacts">;
         flowResponse: (flow_token: string, response: WhatsappFlowResponse) => WhatsappFlowResponse;
     };
     toSDK: {
@@ -1023,43 +2034,9 @@ declare const parsers: {
     };
 };
 
-type MessageReceivedEvent = Defined<WaSDKEventPayload["application"]["messageReceived"]>[0];
-
-type WaSDKGetFlowWebPreviewPageRequestQuery = {
-    flow_action: "data_exchange" | "navigate";
-    phone_number: string;
-    interactive?: boolean;
-    recipient_id?: string;
-    flow_action_payload?: {
-        screen: string;
-        data: Record<string, AnyType>;
-    };
-    flow_parameters?: FlowParameters;
-};
-type FlowParameters = Record<string, string | number>;
-
-declare function decryptFlowBody(body: WhatsappFlowEncryptedWebhookBody): WaSDKFlowDecryptedWebhookBody;
-
-declare function decryptFlowMedia(media: FlowMediaData[]): Promise<Buffer<ArrayBufferLike>[]>;
+declare const toGraphLanguageTag: (languageTag: `${LanguageTag}`) => WhatsappLanguageTag;
 
-declare function encryptFlowResponse(data: AnyType, encryptionMetadata: {
-    aesKeyBuffer: Buffer;
-    initialVectorBuffer: Buffer;
-}): string;
-
-declare function generateWabaEncryption(): Promise<{
-    passphrase: `${string}-${string}-${string}-${string}-${string}`;
-    publicKey: string;
-    privateKey: string;
-}>;
-
-declare function verifyHub(request: Request): string | false;
-
-type WebhookSignatureChallengeArguments = {
-    rawBody: string;
-    untrustedSignature: string;
-};
-declare function verifySignature(request: Request, rawBody: string): Promise<boolean>;
+type MessageReceivedEvent = Defined<WaSDKEventPayload["application"]["messageReceived"]>[0];
 
 declare const security: {
     verifyHub: typeof verifyHub;
@@ -1104,42 +2081,101 @@ declare const utils: {
     };
 };
 
-type sdk_BaseMessageReceivedEventPayload = BaseMessageReceivedEventPayload;
-type sdk_DataExchangeFlowConfig = DataExchangeFlowConfig;
-type sdk_FlowConfig = FlowConfig;
-type sdk_FlowParameters = FlowParameters;
-type sdk_FlowUpdateEventPayload = FlowUpdateEventPayload;
-type sdk_MessageReceivedEvent = MessageReceivedEvent;
-type sdk_MessageReceivedEventPayload = MessageReceivedEventPayload;
-type sdk_MessageStatusUpdateEvent = MessageStatusUpdateEvent;
-type sdk_NavigateFlowConfig = NavigateFlowConfig;
-type sdk_WaSDKButtonMessage = WaSDKButtonMessage;
-type sdk_WaSDKEvent<T extends WaSDKEventType = WaSDKEventType> = WaSDKEvent<T>;
-type sdk_WaSDKEventPayload = WaSDKEventPayload;
-type sdk_WaSDKEventType = WaSDKEventType;
-type sdk_WaSDKFlowDecryptedWebhookBody = WaSDKFlowDecryptedWebhookBody;
-type sdk_WaSDKFlowExchangeEventPayload = WaSDKFlowExchangeEventPayload;
-type sdk_WaSDKFlowPayload = WaSDKFlowPayload;
-type sdk_WaSDKGetFlowWebPreviewPageRequestQuery = WaSDKGetFlowWebPreviewPageRequestQuery;
-type sdk_WaSDKOutgoingFlowMessage = WaSDKOutgoingFlowMessage;
-type sdk_WaSDKOutgoingListMessage = WaSDKOutgoingListMessage;
-type sdk_WaSDKOutgoingMediaMessage = WaSDKOutgoingMediaMessage;
-type sdk_WaSDKOutgoingTemplateMessage = WaSDKOutgoingTemplateMessage;
-type sdk_WaSDKOutgoingTextMessage = WaSDKOutgoingTextMessage;
-type sdk_WaSDKSendMessageBody = WaSDKSendMessageBody;
-type sdk_WaSDKSendMessageConfig = WaSDKSendMessageConfig;
-type sdk_WaSDKSendMessageData = WaSDKSendMessageData;
-type sdk_WebhookSignatureChallengeArguments = WebhookSignatureChallengeArguments;
-declare const sdk_actions: typeof actions;
-declare const sdk_flows: typeof flows;
-declare const sdk_parsers: typeof parsers;
-declare const sdk_security: typeof security;
-declare const sdk_utils: typeof utils;
-declare namespace sdk {
-  export { type sdk_BaseMessageReceivedEventPayload as BaseMessageReceivedEventPayload, type sdk_DataExchangeFlowConfig as DataExchangeFlowConfig, type sdk_FlowConfig as FlowConfig, type sdk_FlowParameters as FlowParameters, type sdk_FlowUpdateEventPayload as FlowUpdateEventPayload, type sdk_MessageReceivedEvent as MessageReceivedEvent, type sdk_MessageReceivedEventPayload as MessageReceivedEventPayload, type sdk_MessageStatusUpdateEvent as MessageStatusUpdateEvent, type sdk_NavigateFlowConfig as NavigateFlowConfig, type sdk_WaSDKButtonMessage as WaSDKButtonMessage, type sdk_WaSDKEvent as WaSDKEvent, type sdk_WaSDKEventPayload as WaSDKEventPayload, type sdk_WaSDKEventType as WaSDKEventType, type sdk_WaSDKFlowDecryptedWebhookBody as WaSDKFlowDecryptedWebhookBody, type sdk_WaSDKFlowExchangeEventPayload as WaSDKFlowExchangeEventPayload, type sdk_WaSDKFlowPayload as WaSDKFlowPayload, type sdk_WaSDKGetFlowWebPreviewPageRequestQuery as WaSDKGetFlowWebPreviewPageRequestQuery, type sdk_WaSDKOutgoingFlowMessage as WaSDKOutgoingFlowMessage, type sdk_WaSDKOutgoingListMessage as WaSDKOutgoingListMessage, type sdk_WaSDKOutgoingMediaMessage as WaSDKOutgoingMediaMessage, type sdk_WaSDKOutgoingTemplateMessage as WaSDKOutgoingTemplateMessage, type sdk_WaSDKOutgoingTextMessage as WaSDKOutgoingTextMessage, type sdk_WaSDKSendMessageBody as WaSDKSendMessageBody, type sdk_WaSDKSendMessageConfig as WaSDKSendMessageConfig, type sdk_WaSDKSendMessageData as WaSDKSendMessageData, type sdk_WebhookSignatureChallengeArguments as WebhookSignatureChallengeArguments, sdk_actions as actions, sdk_flows as flows, sdk_parsers as parsers, sdk_security as security, sdk_utils as utils };
-}
+type WhatsappSDKSettings = {
+    GRAPH_API_VERSION: string;
+    META_APP_ACCESS_TOKEN: string;
+    META_APP_ID: string;
+    META_APP_SECRET: string;
+    WHATSAPP_MESSAGE_NAMESPACE: string;
+    WHATSAPP_WEBHOOK_KEY: string;
+    WHATSAPP_NUMBER_ID: string;
+    WHATSAPP_ACCOUNT_ID: string;
+    WHATSAPP_ACCOUNT_ENCRYPTION_PUBLIC_KEY: string;
+    WHATSAPP_ACCOUNT_ENCRYPTION_PRIVATE_KEY: string;
+    WHATSAPP_ACCOUNT_ENCRYPTION_PASSPHRASE: string;
+    WHATSAPP_FLOWS_MODE: string;
+};
 
-declare const whatsapp: {
+declare const createWhatsapp: () => {
+    settings: {
+        setup: (stg?: Partial<WhatsappSDKSettings>) => void;
+        get: (key: keyof WhatsappSDKSettings) => string;
+    };
+    sdk: {
+        actions: {
+            messages: {
+                send: typeof send;
+            };
+            flows: {
+                create(body: WhatsappCreateFlowRequestBody): Promise<WhatsappCreateFlowResponse>;
+                updateMetadata(flow_id: string, body: WhatsappFlowUpdateMetadataRequestBody): Promise<WhatsappFlowUpdateMetadataResponse>;
+                updateJson(flow_id: string, json: Record<string, AnyType>): Promise<WhatsappUpdateFlowJsonResponse>;
+                getPreview(flow_id: string, query?: WhatsappGetFlowWebPreviewPageRequestQuery): Promise<string>;
+                get(flow_id: string, query?: {
+                    fields: Array<keyof WhatsappGetFlowsRequestResponse>;
+                }): Promise<WhatsappGetManyFlowsRequestResponse>;
+                getMany(): Promise<WhatsappGetManyFlowsRequestResponse>;
+                publish(flow_id: string): Promise<WhatsappPublishFlowResponse>;
+                delete: typeof _delete;
+            };
+            waba: {
+                registerNumber: typeof registerNumber;
+                encryption: {
+                    upload: typeof uploadWabaEncryption;
+                };
+            };
+        };
+        flows: {
+            createToken: ({ flow_name, flow_parameters, chatId, }: {
+                flow_name: string;
+                flow_parameters?: Record<string, string | number>;
+                chatId: string;
+            }) => string;
+            getName: (token: string) => string;
+            destructureFlowToken: (token: string) => {
+                paramsString: string;
+                flowName: string;
+                chatId: string;
+                flowIdentifier: string;
+                flowParameters: Record<string, string>;
+            };
+        };
+        parsers: {
+            toGraph: {
+                sendMessage: (body: WaSDKSendMessageBody) => WhatsappSendMessageRequestBody<any> | WhatsappSendMessageRequestBody<"interactive"> | WhatsappSendMessageRequestBody<"text"> | WhatsappSendMessageRequestBody<"template"> | WhatsappSendMessageRequestBody<"contacts">;
+                flowResponse: (flow_token: string, response: WhatsappFlowResponse) => WhatsappFlowResponse;
+            };
+            toSDK: {
+                webhook: typeof webhook;
+            };
+        };
+        security: {
+            verifyHub: typeof verifyHub;
+            verifySignature: typeof verifySignature;
+            generateWabaEncryption: typeof generateWabaEncryption;
+            decryptFlowBody: typeof decryptFlowBody;
+            encryptFlowResponse: typeof encryptFlowResponse;
+            decryptFlowMedia: typeof decryptFlowMedia;
+        };
+        utils: {
+            flows: {
+                createToken: ({ flow_name, flow_parameters, chatId, }: {
+                    flow_name: string;
+                    flow_parameters?: Record<string, string | number>;
+                    chatId: string;
+                }) => string;
+                getName: (token: string) => string;
+                destructureFlowToken: (token: string) => {
+                    paramsString: string;
+                    flowName: string;
+                    chatId: string;
+                    flowIdentifier: string;
+                    flowParameters: Record<string, string>;
+                };
+            };
+        };
+        toGraphLanguageTag: (languageTag: `${LanguageTag}`) => WhatsappLanguageTag;
+    };
     graph: {
         endpoints: {
             flows: {
@@ -1175,11 +2211,6 @@ declare const whatsapp: {
             };
         };
     };
-    settings: {
-        setup: (stg?: Partial<WhatsappSDKSettings>) => void;
-        get: (key: keyof WhatsappSDKSettings) => string;
-    };
-    sdk: typeof sdk;
 };
 
-export { type BaseMessageReceivedEventPayload, type ConversationType, type DataExchangeFlowConfig, type FlowAction, type FlowCanSendMessageStatus, type FlowCategory, type FlowConfig, type FlowData, type FlowMediaData, type FlowMetadata, type FlowParameters, type FlowScreen, type FlowStatus, type FlowUpdateEventPayload, type FlowValidationError, type ISOCountryCode, type MediaTypes, type MessageField, type MessageReceivedEvent, type MessageReceivedEventPayload, type MessageStatusUpdateEvent, type MetadataObject, type NavigateFlowConfig, type WaIncomingAudioObject, type WaIncomingButtonObject, type WaIncomingContactObject, type WaIncomingContacts, type WaIncomingContextObject, type WaIncomingDocumentObject, type WaIncomingErrorObject, type WaIncomingErrors, type WaIncomingIdentityObject, type WaIncomingImageObject, type WaIncomingInteractiveObject, type WaIncomingMessageStatus, type WaIncomingMessageStatuses, type WaIncomingMessageType, type WaIncomingMessages, type WaIncomingOrderObject, type WaIncomingReferralObject, type WaIncomingStickerObject, type WaIncomingSystemObject, type WaIncomingTextObject, type WaIncomingVideoObject, type WaInteractiveAction, type WaInteractiveActionType, WaInteractiveBase, type WaInteractiveBody, type WaInteractiveFooter, type WaInteractiveHeader, type WaMessageType, type WaOutgoingAudioMessage, type WaOutgoingContactsMessage, type WaOutgoingDocumentMessage, type WaOutgoingImageMessage, type WaOutgoingInteractiveMessage, type WaOutgoingLocationMessage, type WaOutgoingMessage, type WaOutgoingReactionMessage, type WaOutgoingStickerMessage, type WaOutgoingTemplateMessage, type WaOutgoingTextMessage, type WaOutgoingVideoMessage, type WaSDKButtonMessage, type WaSDKEvent, type WaSDKEventPayload, type WaSDKEventType, type WaSDKFlowDecryptedWebhookBody, type WaSDKFlowExchangeEventPayload, type WaSDKFlowPayload, type WaSDKGetFlowWebPreviewPageRequestQuery, type WaSDKOutgoingFlowMessage, type WaSDKOutgoingListMessage, type WaSDKOutgoingMediaMessage, type WaSDKOutgoingTemplateMessage, type WaSDKOutgoingTextMessage, type WaSDKSendMessageBody, type WaSDKSendMessageConfig, type WaSDKSendMessageData, type WebhookSignatureChallengeArguments, type WhatsappApplicationWebhookBody, type WhatsappCreateFlowRequestBody, type WhatsappCreateFlowResponse, type WhatsappDeleteFlowResponse, type WhatsappFlowDecryptedWebhookBody, type WhatsappFlowEncryptedWebhookBody, type WhatsappFlowEncryptionData, type WhatsappFlowErrorMessages, type WhatsappFlowInfo, type WhatsappFlowPingResponse, type WhatsappFlowResponse, type WhatsappFlowUpdateMetadataRequestBody, type WhatsappFlowUpdateMetadataResponse, type WhatsappGetFlowWebPreviewPageRequestQuery, type WhatsappGetFlowWebPreviewURLResponse, type WhatsappGetFlowsRequestQuery, type WhatsappGetFlowsRequestResponse, type WhatsappGetManyFlowsRequestResponse, type WhatsappPublishFlowResponse, type WhatsappRegisterPhoneNumberRequestBody, type WhatsappSendMessageRequestBody, type WhatsappSendMessageRequestConfig, type WhatsappSendMessageResponse, type WhatsappUpdateFlowJsonRequestBody, type WhatsappUpdateFlowJsonResponse, type WhatsappWabaUploadEncryptionRequestBody, actions, endpoints, flowAction, flowCanSendMessageStatus, flowCategory, flowMediaData, flowMetadata, flowScreen, flowStatus, flowValidationError, flows, flowsEndpoints, messagesEndpoints, parsers, security, utils, wabaEndpoints, whatsapp };
+export { type BaseMessageReceivedEventPayload, type ConversationType, type DataExchangeFlowConfig, type FlowAction, type FlowCanSendMessageStatus, type FlowCategory, type FlowConfig, type FlowData, type FlowMediaData, type FlowMetadata, type FlowParameters, type FlowScreen, type FlowStatus, type FlowUpdateEventPayload, type FlowValidationError, type ISOCountryCode, type MediaTypes, type MessageField, type MessageReceivedEvent, type MessageReceivedEventPayload, type MessageStatusUpdateEvent, type MetadataObject, type NavigateFlowConfig, type Payload, type WaIncomingAudioObject, type WaIncomingButtonObject, type WaIncomingContactObject, type WaIncomingContacts, type WaIncomingContextObject, type WaIncomingDocumentObject, type WaIncomingErrorObject, type WaIncomingErrors, type WaIncomingIdentityObject, type WaIncomingImageObject, type WaIncomingInteractiveObject, type WaIncomingMessageStatus, type WaIncomingMessageStatuses, type WaIncomingMessageType, type WaIncomingMessages, type WaIncomingOrderObject, type WaIncomingReferralObject, type WaIncomingStickerObject, type WaIncomingSystemObject, type WaIncomingTextObject, type WaIncomingVideoObject, type WaInteractiveAction, type WaInteractiveActionType, type WaInteractiveBase, type WaInteractiveBody, type WaInteractiveFooter, type WaInteractiveHeader, type WaMessageType, type WaOutgoingAudioMessage, type WaOutgoingContactsMessage, type WaOutgoingDocumentMessage, type WaOutgoingImageMessage, type WaOutgoingInteractiveMessage, type WaOutgoingLocationMessage, type WaOutgoingMessage, type WaOutgoingReactionMessage, type WaOutgoingStickerMessage, type WaOutgoingTemplateMessage, type WaOutgoingTextMessage, type WaOutgoingVideoMessage, type WaSDKButtonMessage, type WaSDKEvent, type WaSDKEventPayload, type WaSDKEventType, type WaSDKFlowDecryptedWebhookBody, type WaSDKFlowExchangeEventPayload, type WaSDKFlowPayload, type WaSDKGetFlowWebPreviewPageRequestQuery, type WaSDKOutgoingContactMessage, type WaSDKOutgoingFlowMessage, type WaSDKOutgoingListMessage, type WaSDKOutgoingMediaMessage, type WaSDKOutgoingTemplateMessage, type WaSDKOutgoingTextMessage, type WaSDKSendMessageBody, type WaSDKSendMessageConfig, type WaSDKSendMessageData, type WebhookSignatureChallengeArguments, type WhatsappApplicationWebhookBody, type WhatsappCreateFlowRequestBody, type WhatsappCreateFlowResponse, type WhatsappDeleteFlowResponse, WhatsappErrorCode, type WhatsappFlowDecryptedWebhookBody, type WhatsappFlowEncryptedWebhookBody, type WhatsappFlowEncryptionData, type WhatsappFlowErrorMessages, type WhatsappFlowInfo, type WhatsappFlowPingResponse, type WhatsappFlowResponse, type WhatsappFlowUpdateMetadataRequestBody, type WhatsappFlowUpdateMetadataResponse, type WhatsappGetFlowWebPreviewPageRequestQuery, type WhatsappGetFlowWebPreviewURLResponse, type WhatsappGetFlowsRequestQuery, type WhatsappGetFlowsRequestResponse, type WhatsappGetManyFlowsRequestResponse, type WhatsappLanguageTag, type WhatsappPublishFlowResponse, type WhatsappRegisterPhoneNumberRequestBody, type WhatsappSendMessageRequestBody, type WhatsappSendMessageRequestConfig, type WhatsappSendMessageResponse, type WhatsappUpdateFlowJsonRequestBody, type WhatsappUpdateFlowJsonResponse, type WhatsappWabaUploadEncryptionRequestBody, actions, createWhatsapp, endpoints, flowAction, flowCanSendMessageStatus, flowCategory, flowMediaData, flowMetadata, flowScreen, flowStatus, flowValidationError, flows, flowsEndpoints, messagesEndpoints, parsers, security, toGraphLanguageTag, utils, wabaEndpoints };