CHANGELOG.md

📝 Changelog

NOTE: pywa follows the semver versioning standard.

4.3.1 (2026-08-17) Latest

• [callback] treat missing message context as no reply_to_message
• [types] deprecate caller and callee properties as part of BSUID changes
• [sent_update] better recipient type resolving
• [enums] adding copy-paste-compatible repr for UploadedBy and UserIdentifier

4.3.0 (2026-08-07)

• [filters] make Filter class generic
• [signups] adding support for creating listing and updating signups
• [templates] add documentation and strict typing for ContactInfoRequestButton
• [message] deprecate sender and recipient properties and update user identifier priority
• [cli] move uvicorn import to runtime and improve error handling
• [errors] add more error codes for throttling, sending, and migration, and fix template error code

4.2.1 (2026-07-01)

• [others] fix parsing contact with field request contact
• [others] fix parsing contact without name
• [client] fix parsing get_reserved_usernames()
• [api] using json instead of data for encryption and template requests

4.2.0 (2026-06-19)

• [filters] allowing filters.new to be used as decorator:
• [contacts] adding first_wa_id property to ContactList
• [api] fix recipient_type in send_marketing_message

4.1.0 (2026-06-16)

• [client] add archive_templates and unarchive_templates methods for template archival management
• [client] add force_transfer option to set_username method for username management
• [client] add request_contact_info method to request customer contact information
• [listners] add wait_for_contact_info method to wait for contact info requests
• [filters] add webhook_fields filter for filtering raw updates by fields
• [cli] improve error handling during CLI command execution
• [handlers] improve handler typing and inline documentation examples
• [api] add internal utility methods for filtering None values and joining fields

4.0.0 (2026-06-09)

• User Identity & BSUID Readiness:
  • Full support for BSUIDs (Business-Scoped User IDs), parent BSUIDs, usernames, and country_code.
  • types.User.wa_id is now optional (users who enable usernames may no longer expose a phone-number-based WhatsApp ID).
  • types.User.preferred_id resolves IDs using the new WhatsApp(user_identifier_priority=...) priority configuration.
  • filters.from_users(...) now accepts BSUIDs, parent BSUIDs, WA IDs, and formatted phone numbers.
  • Phone number change updates now expose BSUID-related fields (new_user_id, new_parent_id).
• Groups & Chat-Aware Updates:
  • Full group management support: create, update, delete, fetch groups, manage invite links, handle join requests, and add/remove participants.
  • Incoming messages now expose msg.chat (a Chat object with id and type) to distinguish private chats from groups.
  • Added filters.private, filters.group, and filters.from_groups(...).
  • Added GroupMessageStatusesHandler and wa.on_group_message_statuses(...) for group status updates.
  • Sent messages now expose sent.chat and support pinning/unpinning.
• Webhooks, CLI, & Local Development:
  • Added the built-in server workflow: pywa dev (auto-reload), pywa run (production-style), and WhatsApp.run() (quick scripts).
  • Added utils.start_ngrok_tunnel(...) for easy local webhook testing.
  • Support for custom webhook subscription fields with utils.WebhookFields via webhook_fields.
  • Refactored webhook validation and endpoint registration to work consistently across built-in Starlette app, FastAPI, Flask, and manual integrations.
  • Listeners now warn when no timeout is provided and prevent usage with multiple Uvicorn workers.
• Messages, Media, Callbacks, & Account Updates:
  • Added EditedMessage, DeletedMessage, OutgoingEditedMessage, and OutgoingDeletedMessage updates for coexistence support.
  • Added AccountUpdate and related enums for account updates.
  • Media objects now store their caption, and media upload internals support async pending uploads with PendingMedia.
  • Added ContactInfoRequestButton, ContactList, and carousel message support (send_carousel, reply_carousel).
• Business Management & Templates:
  • Retrieve shared/owned WABAs, create/verify phone numbers, and manage usernames (set_username, etc.).
  • Added WABA settings updates, including degrees_of_freedom_spec.
  • Enhanced template validation, lookup, parameter introspection (param_names), and error reporting.
  • Support for target_waba_id in Template.duplicate(...) and helper states in CreativeFeaturesSpec.

4.0.0b7 (2026-04-30)

• [helpers] fix incoming updates in fastapi and starlette
• [helpers] hide webhook endpoints from OpenAPI schema
• [ci] streamline publish workflow for PyPI

4.0.0b6 (2026-04-25)

• [client] add run method to start the webhook server and listen for updates
• [server] refactor webhook handling to include validation and improve endpoint management
• [user] make profile temporary optional for testing
• [utils] add start_ngrok_tunnel function to facilitate local webhook testing
• [templates] enhance duplicate method to include target_waba_id parameter for template creation
• [templates] add validation for URL variables in URLButton to enforce constraints on example and variable usage

4.0.0b5 (2026-04-17)

• [client] add methods for creating and verifying phone numbers on WhatsApp Business Account
• [templates] enhance Template and TemplateDetails with new methods for component retrieval and validation
• [templates] add param_names property for introspection of named parameters
• [templates] enhance error handling for positional and named examples in HeaderText and BodyText
• [templates] enhance CreativeFeaturesSpec with new attributes for improved media handling and text optimization
• [templates] remove TemplateSubCategory class and update sub_category type to string
• [message] fix reply to message in EditedMessage and DeletedMessage

4.0.0b4 (2026-04-11)

• [client] update webhook_fields type to support utils.WebhookFields and enhance handling logic
• [client] replace business_account_id with waba_id across the codebase
• [client] add methods to retrieve shared and owned WABAs
• [message] add OutgoingMessage, OutgoingEditedMessage and OutgoingDeletedMessage classes for message updates
• [message] add EditedMessage and DeletedMessage classes for message updates
• [contacts] add ContactList class for shared contacts handling
• [media] store caption inside media objects
• [groups] add GroupOperation class and update group-related methods to return operation responses
• [callback] update VoiceCallButton to support timedelta for ttl_minutes
• [errors] add raw error field and new group/template error classes

4.0.0b3 (2026-04-01)

• [client] add SUPPORTS_BSUID_API flag and update user identifier resolution logic
• [templates] fix summary fields in TemplatesResult
• [ci] update checkout action to use workflow_run head_sha reference

4.0.0b1 (2026-03-30)

• [user] implement BSUID changes
• [user] added country_code field
• [groups] add group management features
• [handlers] implement GroupMessageStatuses class and handler for group message status updates
• [message_status] add new PricingCategory: general_purpose_ai
• [filters] update from_countries to support country_code
• [filters] add filters for private and group chat messages
• [templates] add ContactInfoRequestButton component
• [templates] add to CreativeFeaturesSpec two classmethods: all_enabled and all_disabled
• [others] add BlockedUser and UnblockedUser for user blocking functionality
• [types] remove ChatOpened references and related code

3.9.0 (2026-03-11) Latest

• [base_update] edit reply_template to accept Template obj
• [templates] fix template params validation in async
• [templates] fix filters import in wait_until_approved
• [templates] add auto_promotion_tag field to CreativeFeaturesSpec

3.8.0 (2026-01-23)

• [templates] enhance template parameters validation and improve component handling
• [types] update BusinessProfile to allow optional 'about' field

3.7.0 (2026-01-11)

• [media] allow to override the default 1-hour TTL for No Storage-enabled business phone numbers
• [types] add QRCodeImageType and enhance QRCode methods for image handling
• [templates] adding product_extensions and text_formatting_optimization to CreativeFeaturesSpec
• [api] add method to exchange Embedded Signup token for business access token
• [ci] update GitHub Actions workflows for improved publishing and testing
• [core] support Python 3.14

3.6.1 (2025-12-11)

• [helpers] fix media URL in template param
• [tests] test resolve_media_param

3.6.0 (2025-11-27)

• [client] allow any media type in update_business_profile(profile_picture=...) arg`
• [sent_message] adding new SentReaction type for replying and reacting to the original message
• [media] allowing usage in context manager to delete media after use
• [templates] moving TemplateStatusUpdate fields into objects
• [message_status] fixing MessageStatus.pricing.type parsing
• [utils] bump flow_data_api to 4.0

3.5.2 (2025-11-17)

• [message] adding voice shortcut
• [sent_message] adding wait_for_call_permission and wait_for_incoming_voice_call listeners and validate interactive types
• [templates] added category to TemplateStatusUpdate
• [filters] Fix filters template_status_approved, template_status_rejected

3.5.1 (2025-11-08)

• [helpers] Fix get_media_msg with buttons
• [message] Fix copy_message with buttons

3.5.0 (2025-11-08)

• [client] adding send_voice and wait_until_played listener
• [listeners] adding wait_for_location when sending location request
• [sent] adding SentMediaMessage with uploaded_media attr for sent messages
• [message] adding unsupported attr
• [message] adding support for copy voice message
• [base_update] add identity_key_hash parameter to message methods for identity verification
• [templates] adding text_extraction_for_headline and text_extraction_for_tap_target to CreativeFeaturesSpec
• [flows] fixing index in FlowCompletion.get_media

3.4.0 (2025-10-26)

• [templates] adding support for HeaderGIF
• [templates] override mimetype when sending template with media
• [helpers] fix closing file

3.3.0 (2025-10-26)

• [templates] allowing to override header example mime-type
• [helpers] stream template examples when possible (sync/async)
• [helpers] fix template example resolving for Media type

3.2.0 (2025-10-24)

• [media] adding uploaded_by, uploaded_at and more helpers to Media type
• [client] implementing Identity Change Check
• [client] adding get_media_bytes and stream_media
• [client] adding support for voice messages
• [client] updating update_business_phone_number_settings method to take specific settings
• [base_update] adding method to handle the update again
• [message] fix typing of buttons for copy and remove 'copy' system message
• • [templates] adding image_background_gen option to CreativeFeaturesSpec
• [sent_update] moving the input from user to the SentMessage level
• [helpers] stream downloads and uploads
• [utils] bump GRAPH_API version to 24.0

3.1.1 (2025-09-21)

• [server] Fix filter updates

3.1.0 (2025-09-21)

• [types] adding RawUpdate type
• [flows] update enabled and required fields to use Condition type
• [flows] added support for DataExchangeAction in DataSource (on_select_action and on_unselect_action)
• [flows] update FLOW_JSON version to 7.3
• [client] refactoring media resolving
• [templates] adding filename when sending document
• [media] allow to re-upload media to another phone id

3.0.0 (2025-08-22)

This release is a major update with significant improvements, new features, and some breaking changes. Please review the migration guide before upgrading.

• [templates] Complete refactor of template support: creation, retrieval, sending, deleting, and status updates
• [calls] Added full support for calls: making and receiving calls, call status updates, and call settings management
• [user_preferences] Added full support for user preferences
• [listeners] Unified listener handling with better safety checks
• [system] Restructured system updates into PhoneNumberChange and IdentityChange
• [client]
  • upload_media now returns a Media object
  • mark_message_as_read and other update... methods now return SuccessResult instead of bool
  • New methods: delete_media, get_business_phone_number_settings, update_business_phone_number_settings, update_display_name, get_business_account, deregister_phone_number
  • Support for mm-lite-api when sending templates
  • Support for getting and setting StorageConfiguration
• [callback]
  • Added is_quick_reply to CallbackButton
  • Stricter dataclass validation (no kw_only)
• [updates]
  • All user updates now include waba_id
  • Message include new referral field
• [types]
  • Added is_on_biz_app to BusinessPhoneNumber
  • SuccessResult introduced for extensibility
• [security] Fixed XSS vulnerability
• [api] httpx.RequestError now suggests providing a custom httpx.Client
• [errors] Error messages are now more descriptive
• [utils]
  • Enum values handled case-sensitively
  • Return FlowRequestDecryptedMedia object instead of raw tuple
  • New APIObject helper for dataclasses
• [deprecations] All previously deprecated attributes and types have been removed
• [docs] New pywa logo 🚀

3.0.0-rc.3 (2025-08-06)

• [templates] params is now can be called on class level
• [templates] adding support for library_input when creating library templates
• [templates] adding support for degrees_of_freedom_spec when creating template
• [listeners] handling old to parameter in listen and update migration guide

3.0.0-rc.2 (2025-08-04)

• [client] allowing to use mm-lite-api when sending a template
• [templates] allowing to set app-depplinks in URLButton's
• [templates] adding TopBlockReasonType enum
• [client] adding get_business_account method
• [client] adding deregister_phone_number method
• [client] allowing to get and set StorageConfiguration
• [callback] adding is_quick_reply to CallbackButton
• [callback] validate not kw_only in dataclasses
• [client] fix creating LibraryTemplate
• [system] support old customer_changed_number sys type
• [docs] new logo for pywa!

3.0.0-rc.1 (2025-07-31)

• [templates] refactored and improved templates support
• [calls] added full support for calls
• [user_preferences] added full support for user preferences
• [server] continued handling if listener is not using the update
• [system] moved system messages to PhoneNumberChange and IdentityChange updates
• [client] forced keyword-only for context args in send_message, send_image, and other send_... methods
• [types] returned SuccessResult instead of bool to allow future extension with other attributes
• [client] upload_media returns Media object
• [client] added get_business_phone_number_settings and update_business_phone_number_settings to get and update calling settings
• [client] added update_display_name method to update the WhatsApp display name
• [security] fixed XSS vulnerability
• [api] suggest to provide custom httpx.Client on httpx.RequestError
• [handlers] added on_completion decorator to flow request callback wrapper
• [errors] show more descriptive error messages
• [base_update] added waba_id for all user updates
• [message] added referral field
• [types] support is_on_biz_app in BusinessPhoneNumber
• [client] added delete_media method
• [listeners] check if server exists before starting to listen
• [utils] handled enum values case-sensitively
• [utils] returned FlowRequestDecryptedMedia instead of (media_id, filename, data) tuple
• [utils] new APIObject to get fields from datacls
• [deprecations] removed attrs and types marked as deprecated

2.11.0 (2025-06-17)

• [flows] adding support for ImageCarousel
• [flows] adding with_params to FlowPreview to configure the interactive web preview
• [client] adding get_business_phone_numbers method
• [types] adding all method to Result and fix next and previous to return empty result
• [sent_message] fix wait_for_click to wait only for reply-clicks and not to same data
• [api] fix update_conversational_automation request
• [utils] try to import cryptography globally
• [utils] bump graph-api version to 23.0

2.10.0 (2025-05-14)

• [client] allow to migrate flows from one WABA to another
• [client] improve mime-type handling when downloading media
• [message_status] adding support for per-message pricing
• [base_update] shortcuts to un/block user in update level
• [tests] test the same docstring in async

2.9.0 (2025-05-04)

• [updates] add timezone (UTC) information to timestamps
• [client] get qr-codes and flow-assets inside Result to allow pagination
• [docs] update examples

2.8.0 (2025-04-27)

• [client] indicate text typing status when preparing a message
• [client] adding methods to block/unblock and get blocked users
• [types] adding Result and Pagination classes to help paginate results in some methods
• [user] adding .block() and .unblock() shortcuts
• [user] adding input field, available when sending a message to a user
• [flows] adding label_variant to TextInput and TextArea
• [flows] adding generics to prevent type errors when using ScreenData and Components as refs
• [flows] adding CalendarRangeValues to use when CalendarPicker mode is range
• [utils] update Version FLOW_JSON to 7.0 and GRAPH_API to 22.0

2.7.0 (2025-01-18)

• [flows] adding support for ChipsSelector component
• [flows] flow_name instead of flow_id while sending. flow_token is now optional
• [client] allowing to create flow with flow json and publish it with one request
• [utils] update flow json latest version to 6.3

2.6.0 (2025-01-11)

• [base_update] adding shared_data to help sharing context between handlers & filters
• [flows] adding FlowStr - A helper class to create strings containing vars and math expressions without escaping and quoting them

2.5.2 (2025-01-07)

• [handlers] sub-handlers ignoring flow requests with errors when call_on_error set to False
• [handlers] fix WhatsApp.on_flow_request on class level to mark the FlowRequestHandler instance
• [callback] callback data generic can be str

2.5.1 (2025-01-02)

• [project] hot fix to include missing files in the package

2.5.0 (2025-01-02)

• [handlers] adding on_init, on_data_exchange and on_back decorators for flow request callback wrapper
• [flows] FlowRequest.respond defaults to request flow token
• [flows] adding FlowRequest.token_no_longer_valid shortcut
• [flows] deprecate FlowRequest.is_health_check and FlowRequestActionType.PING

2.4.0 (2024-12-14)

• [sent_message] adding SentTemplate with SentTemplateStatus
• [flows] adding pattern for TextInput
• [flows] adding support for NavigationList
• [flows] defaulting action's payload to empty dict
• [flows] deprecating ActionNext and ActionNextType

2.3.0 (2024-11-30)

• [client] allowing to specify the callback url scope
• [client] expose methods to override callback url in waba and phone scopes
• [flows] typing DataSource to accept Refs

2.2.0 (2024-11-29)

• [flows] adding ScreenDataUpdate to use in UpdateDataAction
• [flows] using math operators between math objs
• [flows] renaming ActionNext to Next and ActionNextType to NextType

2.1.0 (2024-11-24)

• [flows] adding CalendarPicker component
• [flows] allow string concatenation with refs
• [flows] adding support for math expressions
• [flows] allowing to use condition in visible
• [flows] new action: open url
• [flows] new action: update data
• [flows] init_value available outside form
• [flows] allow to use screen/ref as shortcut for .ref_in(screen)
• [flows] separating Action and adding on_unselect_action

2.0.5 (2024-11-10)

• [client] fix send_template return type SentMessage

2.0.4 (2024-11-08)

• [client] fix reply_to_message

2.0.3 (2024-11-02)

• [client] override _flow_req_cls
• [handlers] descriptive repr for Handler

2.0.2 (2024-10-30)

• [server] rely on update hash instead of update id to avid duplicate updates

2.0.1 (2024-10-30)

• [server] fix skip update in process (async)

2.0.0 (2024-10-30)

BREAKING CHANGES!! READ THE MIGRATION GUIDE

• [listeners]: Listeners are a new way to handle incoming user updates (messages, callbacks, etc.). They are more flexible, faster, and easier to use than handlers.
• [sent_message]: The SentMessage object returned by send_message, send_image, etc., contains the message ID and allows to act on the sent message with methods like reply_x, wait_for_x etc.
• [filters]: Filters are now objects that can be combined using logical operators. They are more powerful and flexible than the previous filter system.
• [handlers] allow to register callbacks without WhatsApp instance
• [flows] allow pythonic conditionals in If component
• [flows]: A new method FlowCompletion.get_media(types.Image, key="img") allows you to construct a media object and perform actions like .download() on it.
• [flows]: Decrypt media directly from FlowRequest using .decrypt_media(key, index).
• [flows] rename .data_key and .from_ref to .ref
• [client]: The client can run without a token but won’t allow API operations (only webhook listening).
• [callback] allow to override callback data id
• [utils] bump graph-api version to 21.0

1.26.0 (2024-09-22)

• [flows] adding support of RichText
• [flows] adding support of markdown in TextBody and TextCaption
• [flows] adding sensitive attr to Screen, allowing to hide specific fields from the response summary
• [client] adding reply_to_message arg to send_location, request_location, send_sticker, and send_audio
• [message] adding reply_location_request

1.25.0 (2024-08-15)

• [handlers] adding priority
• [client] adding QR methods (create update get and delete)
• [client] adding get_flow_metrics method
• [flows] adding to DataSource support for images/colors
• [flows] support datetime objs in DatePicker
• [flows] support Screen when using .data_key_of(...) and .form_ref_of(...)
• [flows] update flow json with indent and without ensuring ascii
• [flows] adding health_status to FlowDetails

1.24.0 (2024-07-26)

• [server] validating X-Hub-Signature-256 header
• [requirements] removing requests
• [server] default callback url registration delay to 3 sec

1.23.0 (2024-07-14)

• [client] allowing to manage multiple numbers from the same client (Partner solutions)
• [flows] adding .respond() shortcut for FlowRequest
• [flows] allowing body in FlowResponseError subclasses

1.22.0 (2024-06-16)

• [handlers] introducing FlowRequestCallbackWrapper to help split flow endpoint logic to multiple handlers
• [client] adding add_flow_request_handler method to register FlowRequestHandlers
• [flows] pop flow_token from FlowCompletion.response
• [docs] update examples

1.21.0 (2024-06-14)

• [flows] added new components PhotoPicker, DocumentPicker, If and Switch
• [flows] added .data_key_of and .form_ref_of to refer from other screens
• [flows] added description to CheckboxGroup and to RadioButtonsGroup
• [utils] adding flow_request_media_decryptor function to decrypt medias from flow requests
• [client] allow updating flow application id with update_flow_metadata
• [server] remove event loop
• [docs] update examples
• [version] bump FLOW_JSON version to 4.0

1.20.2 (2024-06-02)

• [server] improve continue/stop handling

1.20.1 (2024-06-02)

• [api] fix downloading media content-type

1.20.0 (2024-06-02)

• [client] adding official support for async (limited support for now)

1.19.0-rc.3 (2024-05-23)

• [api] fix uploads
• [server] expose webhook_challenge_handler, webhook_update_handler and flow_request_handler

1.19.0-rc.2 (2024-05-17)

• [client] adding skip_duplicate_updates when callbacks take too long to return (~25s), defaults to True
• [client,handlers] allow to override continue_handling
• [message] fix async constructors
• [api] remove requests_toolbelt from deps
• [handlers] fix dynamic field name when factory_before_filters

1.19.0-rc.1 (2024-05-08)

• [async] adding beta support for async!

1.18.1 (2024-05-05)

• [client] fix document filename

1.18.0 (2024-05-02)

• [client] allow to modify token and remove handlers/callbacks
• [tests] test client methods

1.17.0 (2024-04-30)

• [client,message_status] Added param tracker to all send-message-methods in order to track the message status, allowing to pass CallbackData subclasses totracker param
• [client,api] adding update_conversational_automation and get_business_phone_number to add and get commands, ice_breakers and enable ChatOpened events
• [filters] adding send_to_me filters shortcut and replays_to filters. mark as deprecated all match-specific-type filters and create generic matches, regex filters for all text containing updates
• [flows] adding updated_at to FlowDetails
• [message] fix from_user in system messages
• [errors] adding optionals error_subcode and type to all errors
• [logging] improve loggers performance
• [utils] bump graph api version to 19.0 and expose Version in the package level
• [docs] switch readme to markdown

1.16.2 (2024-02-15)

• [client] fix sending single contact
• [filters] prioritize / over ! in filters.command(...) and filters.is_command

1.16.0 (2024-01-22)

• [chat_opened] adding a new type: ChatOpened
• [server] improve handlers and logs
• [types] warning on missing enum constant
• [flows] handle cases where there is no flow_token in FlowCompletion (When the flow completion sent from iOS)
• [tests] adding more tests

1.15.0 (2024-01-14)

• [client] Added register_phone_number method
• [client] mark the body arg in send image/video/doc as deprecated. use caption instead
• [utils] bump FLOW_JSON version to 3.1
• [flows] allow DataSource in FlowResponse data
• [flows] Image .src can be dynamic
• [flows] default ActionNext to SCREEN
• [flows] adding .success for screen and adding in-docs examples

1.14.0 (2024-01-01)

• [flows] define Form init_values from children init_value
• [flows] adding a new ScreenData type to be used in screen .data
• [flows] adding .form_ref and .form_ref_of(form_name) to form components
• [docs] adding s real-world example for a complex flow

1.13.0 (2023-12-22)

• [flows] adding full support for WhatsApp Flows!
• [client] adding request_location method to WhatsApp client
• [base_update] adding .raw attr to hold the original update
• [utils] adding Version to provide the latest versions to the api & flows, and to perform min checks

1.13.0-rc.6 (2023-12-20)

• [utils] adding Version to provide the latest versions to the api & flows, and to perform min checks

1.13.0-rc.5 (2023-12-18)

• [flows] add supported types for Layout and Form .children and fix FlowPreview.expires_at
• [webhook] validate cryptography is installed when using the default flows decryptor/encryptor

1.13.0-rc.4 (2023-12-16)

• [client] expose set_business_public_key
• [flows] adding DataKey and FormRef to use when building a FlowJSON
• [template] adding support to create and send template with FlowButton
• [errors] remove FlowInvalidError (Too broad error code)

1.13.0-rc.3 (2023-12-15)

• [errors] adding flows specific errors
• [flows] allow to @on_flow_request callbacks to return or raise FlowResponseError subclasses

1.13.0-rc.2 (2023-12-14)

• [base_update] adding .raw attr to hold the original update
• [requirements] set cryptography as extra dependency

1.13.0-rc.1 (2023-12-14)

• [flows] Adding beta support for WhatsApp Flows!

1.12.1 (2023-11-29)

• [filters] adding new filter called sent_to to filter updates even if WhatsApp(..., filter_updates=False)
• [webhook] renaming route callbacks names to allow multiple WhatsApp instances to use the same server
• [message_type] default missing to UNKNOWN
• [bugs] fix bug on interactive message without data

1.12.0 (2023-11-20)

• [reply_to_msg] adding ReferredProduct to message context
• [filters] adding filter for messages that has referred_product in their context
• [types] unfrozen editable types
• [base_update] hash updates by their update ID
• [client] adding dl_session param of type requests.Session to .upload_media when uploading locally from URL
• [errors] adding more template and flow exceptions; fix typo in TooManyMessages

1.11.1 (2023-11-07)

• [reaction] hot-fix for reaction when "unreacting" to a message
• [filters] adding .extensions(...) filter for all media filters

1.11.0 (2023-11-01)

• [callback] adding support for Optional[x] annotation in CallbackData subclasses
• [media] allowing to pass pathlib.Path as a media file path
• [system] make all fields nullable in system update

1.10.0 (2023-10-29)

• [template] adding support for OtpType.ZERO_TAP in new authentication template
• [callback] adding support for optional fields in CallbackData
• [tests] update CallbackData tests

1.9.0 (2023-10-25)

• [handlers] add StopHandling to raise if you want to stop handling the update
• [errors] include requests.Response with all api errors
• [client] mark keyboard argument in .send_message as deprecated. use buttons instead

1.8.0 (2023-10-20)

• [webhook] allow to register callback url by @david-lev in #18

1.7.3 (2023-10-18)

• [callback] Treat the Template's QuickReplyButtonData as an incoming CallbackButton (Reported by @bcombes in #17)
• [handlers] adding @functools.wraps to all on_x decorators to preserve callbacks metadata

1.7.2 (2023-10-12)

• [reply] reply to CallbackButton.id instead of to .reply_to_message by @yehuda-lev in #16
• [callback] change default CallbackData separators to unused characters (¶ for clb sep, ~ for data sep and § for True boolean

1.7.1 (2023-10-12)

• [callback] hot-fix for last booleans fields on CallbackData (WhatsApp Cloud API consider "1: " and "1:" as duplicate datas)

1.7.0 (2023-10-12)

• [types] new ButtonUrl type
• [client] allowing to provide mime_type when sending media as bytes, open file or file path without extensions

1.6.0 (2023-10-11)

• [handlers] apply callback data factory before filters by setting factory_before_filters to True when registering the handler

1.5.4 (2023-10-08)

• [template] fix media key

1.5.3 (2023-10-03)

• [webhook] faster field-to-handler matching
• [message-status] make .pricing_model optional

1.5.2 (2023-10-03)

• [callback] better typing for callback_data and factory

1.5.1 (2023-10-02)

• [build] Fix package imports

1.5.0 (2023-10-02)

• [callback] allowing to override separators in CallbackData subclasses
• [tests] starting to adding tests
• [message] reaction messages are also replays (.is_reply)
• [api] bump api version to 18.0
• [template] new update type - TemplateStatus; remove deprecated headers
• [build] move to pyproject.toml
• [docs] tips and improvements

1.4.1 (2023-09-12)

• [reaction] Fix ReactionFilter and TextFilter by @yehuda-lev in #12

1.4.0 (2023-09-10)

• [callback] allowing to provide factory to construct callback data (Button and Selection) into custom object.
• [callback] adding type-safe CallbackData interface in order to send and receive typed callback data.
• [webhook] add protocols for supported web frameworks.

1.3.0 (2023-09-06)

• [template] adding support for CopyCodeButton and add Language enum for better typing
• [filters] adding from_countries filter
• [typing] fix typos by @nallon in #10

1.2.0 (2023-08-21)

• [template] adding support for MPMButton and CatalogButton.
• [template] rename and mark as deprecated template headers.

1.1.0 (2023-08-20)

• [template] adding support for sending and creating template messages
• [errors] adding more errors

1.0.0 (2023-08-16)

• FIRST STABLE RELEASE - VERSION 1.0.0