@automate.ax/integration-contracts 0.55.0

package/dist/whatsapp/schemas.d.ts

@@ -0,0 +1,926 @@
+import { z } from "zod";
+/** Provider-native WhatsApp webhook envelope. */
+export declare const WHATSAPP_WEBHOOK_SCHEMA: z.ZodObject<{
+    entry: z.ZodArray<z.ZodObject<{
+        changes: z.ZodArray<z.ZodObject<{
+            field: z.ZodLiteral<"messages">;
+            value: z.ZodObject<{
+                contacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    profile: z.ZodObject<{
+                        name: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>;
+                    wa_id: z.ZodString;
+                }, z.core.$strip>>>;
+                messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    audio: z.ZodOptional<z.ZodObject<{
+                        id: z.ZodString;
+                        mime_type: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    button: z.ZodOptional<z.ZodObject<{
+                        payload: z.ZodString;
+                        text: z.ZodString;
+                    }, z.core.$strip>>;
+                    contacts: z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>;
+                    context: z.ZodOptional<z.ZodObject<{
+                        forwarded: z.ZodOptional<z.ZodBoolean>;
+                        from: z.ZodOptional<z.ZodString>;
+                        id: z.ZodString;
+                    }, z.core.$strip>>;
+                    document: z.ZodOptional<z.ZodObject<{
+                        caption: z.ZodOptional<z.ZodString>;
+                        filename: z.ZodOptional<z.ZodString>;
+                        id: z.ZodString;
+                        mime_type: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        code: z.ZodNumber;
+                        error_data: z.ZodOptional<z.ZodObject<{
+                            details: z.ZodOptional<z.ZodString>;
+                            messaging_product: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                        error_subcode: z.ZodOptional<z.ZodNumber>;
+                        fbtrace_id: z.ZodOptional<z.ZodString>;
+                        message: z.ZodString;
+                        title: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    from: z.ZodString;
+                    id: z.ZodString;
+                    image: z.ZodOptional<z.ZodObject<{
+                        caption: z.ZodOptional<z.ZodString>;
+                        id: z.ZodString;
+                        mime_type: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    interactive: z.ZodOptional<z.ZodObject<{
+                        button_reply: z.ZodOptional<z.ZodObject<{
+                            id: z.ZodString;
+                            title: z.ZodString;
+                        }, z.core.$strip>>;
+                        list_reply: z.ZodOptional<z.ZodObject<{
+                            description: z.ZodOptional<z.ZodString>;
+                            id: z.ZodString;
+                            title: z.ZodString;
+                        }, z.core.$strip>>;
+                        type: z.ZodEnum<{
+                            button_reply: "button_reply";
+                            list_reply: "list_reply";
+                        }>;
+                    }, z.core.$strip>>;
+                    location: z.ZodOptional<z.ZodObject<{
+                        address: z.ZodOptional<z.ZodString>;
+                        latitude: z.ZodNumber;
+                        longitude: z.ZodNumber;
+                        name: z.ZodOptional<z.ZodString>;
+                        url: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    order: z.ZodOptional<z.ZodJSONSchema>;
+                    reaction: z.ZodOptional<z.ZodObject<{
+                        emoji: z.ZodString;
+                        message_id: z.ZodString;
+                    }, z.core.$strip>>;
+                    referral: z.ZodOptional<z.ZodJSONSchema>;
+                    sticker: z.ZodOptional<z.ZodObject<{
+                        id: z.ZodString;
+                        mime_type: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    system: z.ZodOptional<z.ZodJSONSchema>;
+                    text: z.ZodOptional<z.ZodObject<{
+                        body: z.ZodString;
+                    }, z.core.$strip>>;
+                    timestamp: z.ZodString;
+                    type: z.ZodEnum<{
+                        unknown: "unknown";
+                        text: "text";
+                        system: "system";
+                        location: "location";
+                        image: "image";
+                        video: "video";
+                        reaction: "reaction";
+                        audio: "audio";
+                        button: "button";
+                        contacts: "contacts";
+                        document: "document";
+                        interactive: "interactive";
+                        order: "order";
+                        sticker: "sticker";
+                        unsupported: "unsupported";
+                    }>;
+                    unknown: z.ZodOptional<z.ZodJSONSchema>;
+                    unsupported: z.ZodOptional<z.ZodJSONSchema>;
+                    video: z.ZodOptional<z.ZodObject<{
+                        caption: z.ZodOptional<z.ZodString>;
+                        id: z.ZodString;
+                        mime_type: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>>;
+                messaging_product: z.ZodLiteral<"whatsapp">;
+                metadata: z.ZodObject<{
+                    display_phone_number: z.ZodString;
+                    phone_number_id: z.ZodString;
+                }, z.core.$strip>;
+                statuses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    biz_opaque_callback_data: z.ZodOptional<z.ZodString>;
+                    conversation: z.ZodOptional<z.ZodObject<{
+                        expiration_timestamp: z.ZodOptional<z.ZodString>;
+                        id: z.ZodString;
+                        origin: z.ZodObject<{
+                            type: z.ZodString;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>>;
+                    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        code: z.ZodNumber;
+                        error_data: z.ZodOptional<z.ZodObject<{
+                            details: z.ZodOptional<z.ZodString>;
+                            messaging_product: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                        error_subcode: z.ZodOptional<z.ZodNumber>;
+                        fbtrace_id: z.ZodOptional<z.ZodString>;
+                        message: z.ZodString;
+                        title: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>>;
+                    id: z.ZodString;
+                    pricing: z.ZodOptional<z.ZodObject<{
+                        billable: z.ZodOptional<z.ZodBoolean>;
+                        category: z.ZodString;
+                        pricing_model: z.ZodEnum<{
+                            CBP: "CBP";
+                            PMP: "PMP";
+                        }>;
+                        type: z.ZodOptional<z.ZodEnum<{
+                            regular: "regular";
+                            free_customer_service: "free_customer_service";
+                            free_entry_point: "free_entry_point";
+                        }>>;
+                    }, z.core.$strip>>;
+                    recipient_id: z.ZodString;
+                    status: z.ZodEnum<{
+                        delivered: "delivered";
+                        failed: "failed";
+                        sent: "sent";
+                        read: "read";
+                        played: "played";
+                    }>;
+                    timestamp: z.ZodString;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        id: z.ZodString;
+    }, z.core.$strip>>;
+    object: z.ZodLiteral<"whatsapp_business_account">;
+}, z.core.$strip>;
+/** Normalized incoming WhatsApp message event. */
+export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_SCHEMA: z.ZodObject<{
+    businessAccountId: z.ZodString;
+    displayPhoneNumber: z.ZodString;
+    message: z.ZodObject<{
+        content: z.ZodOptional<z.ZodJSONSchema>;
+        context: z.ZodOptional<z.ZodObject<{
+            forwarded: z.ZodOptional<z.ZodBoolean>;
+            from: z.ZodOptional<z.ZodString>;
+            messageId: z.ZodString;
+        }, z.core.$strip>>;
+        id: z.ZodString;
+        timestamp: z.ZodString;
+        type: z.ZodEnum<{
+            unknown: "unknown";
+            text: "text";
+            system: "system";
+            location: "location";
+            image: "image";
+            video: "video";
+            reaction: "reaction";
+            audio: "audio";
+            button: "button";
+            contacts: "contacts";
+            document: "document";
+            interactive: "interactive";
+            order: "order";
+            sticker: "sticker";
+            unsupported: "unsupported";
+        }>;
+    }, z.core.$strip>;
+    phoneNumberId: z.ZodString;
+    providerEvent: z.ZodObject<{
+        audio: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            mime_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        button: z.ZodOptional<z.ZodObject<{
+            payload: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strip>>;
+        contacts: z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>;
+        context: z.ZodOptional<z.ZodObject<{
+            forwarded: z.ZodOptional<z.ZodBoolean>;
+            from: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+        }, z.core.$strip>>;
+        document: z.ZodOptional<z.ZodObject<{
+            caption: z.ZodOptional<z.ZodString>;
+            filename: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            mime_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodNumber;
+            error_data: z.ZodOptional<z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                messaging_product: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            error_subcode: z.ZodOptional<z.ZodNumber>;
+            fbtrace_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        from: z.ZodString;
+        id: z.ZodString;
+        image: z.ZodOptional<z.ZodObject<{
+            caption: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            mime_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        interactive: z.ZodOptional<z.ZodObject<{
+            button_reply: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strip>>;
+            list_reply: z.ZodOptional<z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                id: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strip>>;
+            type: z.ZodEnum<{
+                button_reply: "button_reply";
+                list_reply: "list_reply";
+            }>;
+        }, z.core.$strip>>;
+        location: z.ZodOptional<z.ZodObject<{
+            address: z.ZodOptional<z.ZodString>;
+            latitude: z.ZodNumber;
+            longitude: z.ZodNumber;
+            name: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        order: z.ZodOptional<z.ZodJSONSchema>;
+        reaction: z.ZodOptional<z.ZodObject<{
+            emoji: z.ZodString;
+            message_id: z.ZodString;
+        }, z.core.$strip>>;
+        referral: z.ZodOptional<z.ZodJSONSchema>;
+        sticker: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            mime_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        system: z.ZodOptional<z.ZodJSONSchema>;
+        text: z.ZodOptional<z.ZodObject<{
+            body: z.ZodString;
+        }, z.core.$strip>>;
+        timestamp: z.ZodString;
+        type: z.ZodEnum<{
+            unknown: "unknown";
+            text: "text";
+            system: "system";
+            location: "location";
+            image: "image";
+            video: "video";
+            reaction: "reaction";
+            audio: "audio";
+            button: "button";
+            contacts: "contacts";
+            document: "document";
+            interactive: "interactive";
+            order: "order";
+            sticker: "sticker";
+            unsupported: "unsupported";
+        }>;
+        unknown: z.ZodOptional<z.ZodJSONSchema>;
+        unsupported: z.ZodOptional<z.ZodJSONSchema>;
+        video: z.ZodOptional<z.ZodObject<{
+            caption: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            mime_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    sender: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Normalized WhatsApp message status event. */
+export declare const WHATSAPP_MESSAGE_STATUS_EVENT_SCHEMA: z.ZodObject<{
+    businessAccountId: z.ZodString;
+    callbackData: z.ZodOptional<z.ZodString>;
+    conversation: z.ZodOptional<z.ZodObject<{
+        expirationTimestamp: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        originType: z.ZodString;
+    }, z.core.$strip>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodNumber;
+        details: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        subcode: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    messageId: z.ZodString;
+    phoneNumberId: z.ZodString;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodString;
+        model: z.ZodEnum<{
+            CBP: "CBP";
+            PMP: "PMP";
+        }>;
+        type: z.ZodOptional<z.ZodEnum<{
+            regular: "regular";
+            free_customer_service: "free_customer_service";
+            free_entry_point: "free_entry_point";
+        }>>;
+    }, z.core.$strip>>;
+    providerEvent: z.ZodObject<{
+        biz_opaque_callback_data: z.ZodOptional<z.ZodString>;
+        conversation: z.ZodOptional<z.ZodObject<{
+            expiration_timestamp: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            origin: z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodNumber;
+            error_data: z.ZodOptional<z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                messaging_product: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            error_subcode: z.ZodOptional<z.ZodNumber>;
+            fbtrace_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        id: z.ZodString;
+        pricing: z.ZodOptional<z.ZodObject<{
+            billable: z.ZodOptional<z.ZodBoolean>;
+            category: z.ZodString;
+            pricing_model: z.ZodEnum<{
+                CBP: "CBP";
+                PMP: "PMP";
+            }>;
+            type: z.ZodOptional<z.ZodEnum<{
+                regular: "regular";
+                free_customer_service: "free_customer_service";
+                free_entry_point: "free_entry_point";
+            }>>;
+        }, z.core.$strip>>;
+        recipient_id: z.ZodString;
+        status: z.ZodEnum<{
+            delivered: "delivered";
+            failed: "failed";
+            sent: "sent";
+            read: "read";
+            played: "played";
+        }>;
+        timestamp: z.ZodString;
+    }, z.core.$strip>;
+    recipientId: z.ZodString;
+    status: z.ZodEnum<{
+        delivered: "delivered";
+        failed: "failed";
+        sent: "sent";
+        read: "read";
+        played: "played";
+    }>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+export declare const WHATSAPP_MESSAGE_SENT_EVENT_SCHEMA: z.ZodObject<{
+    businessAccountId: z.ZodString;
+    callbackData: z.ZodOptional<z.ZodString>;
+    conversation: z.ZodOptional<z.ZodObject<{
+        expirationTimestamp: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        originType: z.ZodString;
+    }, z.core.$strip>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodNumber;
+        details: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        subcode: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    messageId: z.ZodString;
+    phoneNumberId: z.ZodString;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodString;
+        model: z.ZodEnum<{
+            CBP: "CBP";
+            PMP: "PMP";
+        }>;
+        type: z.ZodOptional<z.ZodEnum<{
+            regular: "regular";
+            free_customer_service: "free_customer_service";
+            free_entry_point: "free_entry_point";
+        }>>;
+    }, z.core.$strip>>;
+    recipientId: z.ZodString;
+    timestamp: z.ZodString;
+    providerEvent: z.ZodObject<{
+        biz_opaque_callback_data: z.ZodOptional<z.ZodString>;
+        conversation: z.ZodOptional<z.ZodObject<{
+            expiration_timestamp: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            origin: z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodNumber;
+            error_data: z.ZodOptional<z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                messaging_product: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            error_subcode: z.ZodOptional<z.ZodNumber>;
+            fbtrace_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        id: z.ZodString;
+        pricing: z.ZodOptional<z.ZodObject<{
+            billable: z.ZodOptional<z.ZodBoolean>;
+            category: z.ZodString;
+            pricing_model: z.ZodEnum<{
+                CBP: "CBP";
+                PMP: "PMP";
+            }>;
+            type: z.ZodOptional<z.ZodEnum<{
+                regular: "regular";
+                free_customer_service: "free_customer_service";
+                free_entry_point: "free_entry_point";
+            }>>;
+        }, z.core.$strip>>;
+        recipient_id: z.ZodString;
+        timestamp: z.ZodString;
+        status: z.ZodLiteral<"sent">;
+    }, z.core.$strip>;
+    status: z.ZodLiteral<"sent">;
+}, z.core.$strip>;
+export declare const WHATSAPP_MESSAGE_DELIVERED_EVENT_SCHEMA: z.ZodObject<{
+    businessAccountId: z.ZodString;
+    callbackData: z.ZodOptional<z.ZodString>;
+    conversation: z.ZodOptional<z.ZodObject<{
+        expirationTimestamp: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        originType: z.ZodString;
+    }, z.core.$strip>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodNumber;
+        details: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        subcode: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    messageId: z.ZodString;
+    phoneNumberId: z.ZodString;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodString;
+        model: z.ZodEnum<{
+            CBP: "CBP";
+            PMP: "PMP";
+        }>;
+        type: z.ZodOptional<z.ZodEnum<{
+            regular: "regular";
+            free_customer_service: "free_customer_service";
+            free_entry_point: "free_entry_point";
+        }>>;
+    }, z.core.$strip>>;
+    recipientId: z.ZodString;
+    timestamp: z.ZodString;
+    providerEvent: z.ZodObject<{
+        biz_opaque_callback_data: z.ZodOptional<z.ZodString>;
+        conversation: z.ZodOptional<z.ZodObject<{
+            expiration_timestamp: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            origin: z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodNumber;
+            error_data: z.ZodOptional<z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                messaging_product: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            error_subcode: z.ZodOptional<z.ZodNumber>;
+            fbtrace_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        id: z.ZodString;
+        pricing: z.ZodOptional<z.ZodObject<{
+            billable: z.ZodOptional<z.ZodBoolean>;
+            category: z.ZodString;
+            pricing_model: z.ZodEnum<{
+                CBP: "CBP";
+                PMP: "PMP";
+            }>;
+            type: z.ZodOptional<z.ZodEnum<{
+                regular: "regular";
+                free_customer_service: "free_customer_service";
+                free_entry_point: "free_entry_point";
+            }>>;
+        }, z.core.$strip>>;
+        recipient_id: z.ZodString;
+        timestamp: z.ZodString;
+        status: z.ZodLiteral<"delivered">;
+    }, z.core.$strip>;
+    status: z.ZodLiteral<"delivered">;
+}, z.core.$strip>;
+export declare const WHATSAPP_MESSAGE_READ_EVENT_SCHEMA: z.ZodObject<{
+    businessAccountId: z.ZodString;
+    callbackData: z.ZodOptional<z.ZodString>;
+    conversation: z.ZodOptional<z.ZodObject<{
+        expirationTimestamp: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        originType: z.ZodString;
+    }, z.core.$strip>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodNumber;
+        details: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        subcode: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    messageId: z.ZodString;
+    phoneNumberId: z.ZodString;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodString;
+        model: z.ZodEnum<{
+            CBP: "CBP";
+            PMP: "PMP";
+        }>;
+        type: z.ZodOptional<z.ZodEnum<{
+            regular: "regular";
+            free_customer_service: "free_customer_service";
+            free_entry_point: "free_entry_point";
+        }>>;
+    }, z.core.$strip>>;
+    recipientId: z.ZodString;
+    timestamp: z.ZodString;
+    providerEvent: z.ZodObject<{
+        biz_opaque_callback_data: z.ZodOptional<z.ZodString>;
+        conversation: z.ZodOptional<z.ZodObject<{
+            expiration_timestamp: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            origin: z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodNumber;
+            error_data: z.ZodOptional<z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                messaging_product: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            error_subcode: z.ZodOptional<z.ZodNumber>;
+            fbtrace_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        id: z.ZodString;
+        pricing: z.ZodOptional<z.ZodObject<{
+            billable: z.ZodOptional<z.ZodBoolean>;
+            category: z.ZodString;
+            pricing_model: z.ZodEnum<{
+                CBP: "CBP";
+                PMP: "PMP";
+            }>;
+            type: z.ZodOptional<z.ZodEnum<{
+                regular: "regular";
+                free_customer_service: "free_customer_service";
+                free_entry_point: "free_entry_point";
+            }>>;
+        }, z.core.$strip>>;
+        recipient_id: z.ZodString;
+        timestamp: z.ZodString;
+        status: z.ZodLiteral<"read">;
+    }, z.core.$strip>;
+    status: z.ZodLiteral<"read">;
+}, z.core.$strip>;
+export declare const WHATSAPP_MESSAGE_FAILED_EVENT_SCHEMA: z.ZodObject<{
+    businessAccountId: z.ZodString;
+    callbackData: z.ZodOptional<z.ZodString>;
+    conversation: z.ZodOptional<z.ZodObject<{
+        expirationTimestamp: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        originType: z.ZodString;
+    }, z.core.$strip>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodNumber;
+        details: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        subcode: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    messageId: z.ZodString;
+    phoneNumberId: z.ZodString;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodString;
+        model: z.ZodEnum<{
+            CBP: "CBP";
+            PMP: "PMP";
+        }>;
+        type: z.ZodOptional<z.ZodEnum<{
+            regular: "regular";
+            free_customer_service: "free_customer_service";
+            free_entry_point: "free_entry_point";
+        }>>;
+    }, z.core.$strip>>;
+    recipientId: z.ZodString;
+    timestamp: z.ZodString;
+    providerEvent: z.ZodObject<{
+        biz_opaque_callback_data: z.ZodOptional<z.ZodString>;
+        conversation: z.ZodOptional<z.ZodObject<{
+            expiration_timestamp: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            origin: z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodNumber;
+            error_data: z.ZodOptional<z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                messaging_product: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            error_subcode: z.ZodOptional<z.ZodNumber>;
+            fbtrace_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        id: z.ZodString;
+        pricing: z.ZodOptional<z.ZodObject<{
+            billable: z.ZodOptional<z.ZodBoolean>;
+            category: z.ZodString;
+            pricing_model: z.ZodEnum<{
+                CBP: "CBP";
+                PMP: "PMP";
+            }>;
+            type: z.ZodOptional<z.ZodEnum<{
+                regular: "regular";
+                free_customer_service: "free_customer_service";
+                free_entry_point: "free_entry_point";
+            }>>;
+        }, z.core.$strip>>;
+        recipient_id: z.ZodString;
+        timestamp: z.ZodString;
+        status: z.ZodLiteral<"failed">;
+    }, z.core.$strip>;
+    status: z.ZodLiteral<"failed">;
+}, z.core.$strip>;
+export declare const WHATSAPP_MESSAGE_PLAYED_EVENT_SCHEMA: z.ZodObject<{
+    businessAccountId: z.ZodString;
+    callbackData: z.ZodOptional<z.ZodString>;
+    conversation: z.ZodOptional<z.ZodObject<{
+        expirationTimestamp: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        originType: z.ZodString;
+    }, z.core.$strip>>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodNumber;
+        details: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        subcode: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    messageId: z.ZodString;
+    phoneNumberId: z.ZodString;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodString;
+        model: z.ZodEnum<{
+            CBP: "CBP";
+            PMP: "PMP";
+        }>;
+        type: z.ZodOptional<z.ZodEnum<{
+            regular: "regular";
+            free_customer_service: "free_customer_service";
+            free_entry_point: "free_entry_point";
+        }>>;
+    }, z.core.$strip>>;
+    recipientId: z.ZodString;
+    timestamp: z.ZodString;
+    providerEvent: z.ZodObject<{
+        biz_opaque_callback_data: z.ZodOptional<z.ZodString>;
+        conversation: z.ZodOptional<z.ZodObject<{
+            expiration_timestamp: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            origin: z.ZodObject<{
+                type: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodNumber;
+            error_data: z.ZodOptional<z.ZodObject<{
+                details: z.ZodOptional<z.ZodString>;
+                messaging_product: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            error_subcode: z.ZodOptional<z.ZodNumber>;
+            fbtrace_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        id: z.ZodString;
+        pricing: z.ZodOptional<z.ZodObject<{
+            billable: z.ZodOptional<z.ZodBoolean>;
+            category: z.ZodString;
+            pricing_model: z.ZodEnum<{
+                CBP: "CBP";
+                PMP: "PMP";
+            }>;
+            type: z.ZodOptional<z.ZodEnum<{
+                regular: "regular";
+                free_customer_service: "free_customer_service";
+                free_entry_point: "free_entry_point";
+            }>>;
+        }, z.core.$strip>>;
+        recipient_id: z.ZodString;
+        timestamp: z.ZodString;
+        status: z.ZodLiteral<"played">;
+    }, z.core.$strip>;
+    status: z.ZodLiteral<"played">;
+}, z.core.$strip>;
+/**
+ * Flattens one verified provider callback into independently ingestible events.
+ *
+ * @param input - Untrusted WhatsApp webhook envelope.
+ */
+export declare function normalizeWhatsAppWebhook(input: unknown): {
+    messages: {
+        businessAccountId: string;
+        displayPhoneNumber: string;
+        message: {
+            id: string;
+            timestamp: string;
+            type: "unknown" | "text" | "system" | "location" | "image" | "video" | "reaction" | "audio" | "button" | "contacts" | "document" | "interactive" | "order" | "sticker" | "unsupported";
+            content?: z.core.util.JSONType | undefined;
+            context?: {
+                messageId: string;
+                forwarded?: boolean | undefined;
+                from?: string | undefined;
+            } | undefined;
+        };
+        phoneNumberId: string;
+        providerEvent: {
+            from: string;
+            id: string;
+            timestamp: string;
+            type: "unknown" | "text" | "system" | "location" | "image" | "video" | "reaction" | "audio" | "button" | "contacts" | "document" | "interactive" | "order" | "sticker" | "unsupported";
+            audio?: {
+                id: string;
+                mime_type?: string | undefined;
+            } | undefined;
+            button?: {
+                payload: string;
+                text: string;
+            } | undefined;
+            contacts?: z.core.util.JSONType[] | undefined;
+            context?: {
+                id: string;
+                forwarded?: boolean | undefined;
+                from?: string | undefined;
+            } | undefined;
+            document?: {
+                id: string;
+                caption?: string | undefined;
+                filename?: string | undefined;
+                mime_type?: string | undefined;
+            } | undefined;
+            errors?: {
+                code: number;
+                message: string;
+                error_data?: {
+                    details?: string | undefined;
+                    messaging_product?: string | undefined;
+                } | undefined;
+                error_subcode?: number | undefined;
+                fbtrace_id?: string | undefined;
+                title?: string | undefined;
+            }[] | undefined;
+            image?: {
+                id: string;
+                caption?: string | undefined;
+                mime_type?: string | undefined;
+            } | undefined;
+            interactive?: {
+                type: "button_reply" | "list_reply";
+                button_reply?: {
+                    id: string;
+                    title: string;
+                } | undefined;
+                list_reply?: {
+                    id: string;
+                    title: string;
+                    description?: string | undefined;
+                } | undefined;
+            } | undefined;
+            location?: {
+                latitude: number;
+                longitude: number;
+                address?: string | undefined;
+                name?: string | undefined;
+                url?: string | undefined;
+            } | undefined;
+            order?: z.core.util.JSONType | undefined;
+            reaction?: {
+                emoji: string;
+                message_id: string;
+            } | undefined;
+            referral?: z.core.util.JSONType | undefined;
+            sticker?: {
+                id: string;
+                mime_type?: string | undefined;
+            } | undefined;
+            system?: z.core.util.JSONType | undefined;
+            text?: {
+                body: string;
+            } | undefined;
+            unknown?: z.core.util.JSONType | undefined;
+            unsupported?: z.core.util.JSONType | undefined;
+            video?: {
+                id: string;
+                caption?: string | undefined;
+                mime_type?: string | undefined;
+            } | undefined;
+        };
+        sender: {
+            id: string;
+            name?: string | undefined;
+        };
+    }[];
+    statuses: {
+        businessAccountId: string;
+        messageId: string;
+        phoneNumberId: string;
+        providerEvent: {
+            id: string;
+            recipient_id: string;
+            status: "delivered" | "failed" | "sent" | "read" | "played";
+            timestamp: string;
+            biz_opaque_callback_data?: string | undefined;
+            conversation?: {
+                id: string;
+                origin: {
+                    type: string;
+                };
+                expiration_timestamp?: string | undefined;
+            } | undefined;
+            errors?: {
+                code: number;
+                message: string;
+                error_data?: {
+                    details?: string | undefined;
+                    messaging_product?: string | undefined;
+                } | undefined;
+                error_subcode?: number | undefined;
+                fbtrace_id?: string | undefined;
+                title?: string | undefined;
+            }[] | undefined;
+            pricing?: {
+                category: string;
+                pricing_model: "CBP" | "PMP";
+                billable?: boolean | undefined;
+                type?: "regular" | "free_customer_service" | "free_entry_point" | undefined;
+            } | undefined;
+        };
+        recipientId: string;
+        status: "delivered" | "failed" | "sent" | "read" | "played";
+        timestamp: string;
+        callbackData?: string | undefined;
+        conversation?: {
+            id: string;
+            originType: string;
+            expirationTimestamp?: string | undefined;
+        } | undefined;
+        errors?: {
+            code: number;
+            message: string;
+            details?: string | undefined;
+            subcode?: number | undefined;
+            title?: string | undefined;
+            traceId?: string | undefined;
+        }[] | undefined;
+        pricing?: {
+            category: string;
+            model: "CBP" | "PMP";
+            billable?: boolean | undefined;
+            type?: "regular" | "free_customer_service" | "free_entry_point" | undefined;
+        } | undefined;
+    }[];
+};