Releases: line/line-bot-sdk-python
Release list
v3.24.0 Support rich menu summary API and daily report API
What's Changed
This release supports the new Rich Menu inshgit APIs.
line/line-openapi#128
- Rich Menu summary
- Retrieves aggregate statistics for the specified period, such as the number of users who viewed the rich menu and how many times it was viewed. The aggregation process of these statistics is usually completed within the next day.
- Rich Menu daily report
- Retrieves daily statistics for the specified period, such as the number of users who viewed the rich menu and how many times it was viewed. The aggregation process of these statistics is usually completed within the next day.
For details on the API, please see below.
- https://developers.line.biz/en/reference/messaging-api/#get-rich-menu-insight-summary
- https://developers.line.biz/en/reference/messaging-api/#get-rich-menu-insight-daily
line-openapi updates
- chore(deps): update line-openapi digest to 82f108c by @renovate[bot] in #1024
- Support rich menu summary and daily report & remove null from
AudienceGroupFailedTypeemum by @github-actions[bot] in #1027
Dependency updates
- chore(deps): update actions/checkout action to v7 by @renovate[bot] in #1023
- chore(deps): update actions/setup-python action to v6.3.0 by @renovate[bot] in #1028
Other Changes
- Use pebble instead of mustache by @Yang-33 in #1021
- Remove pytest-pep8 incompatible with pytest 9.1 by @mokuzon in #1025
Full Changelog: v3.23.1...v3.24.0
This release is prepared by @mokuzon
Contributors
Assets 3
v3.23.1 Add missing developers.line.biz urls
What's Changed
- Add missing developers.line.biz urls by @github-actions[bot] in #1020
Some classes have developers.line.biz url, but others don't have it. This change adds missing urls.
Developer can get the latest information from the documentation, and search related information.
(original PR is line/line-openapi#122)
line-openapi updates
- Make body in setRichMenuImage required by @github-actions[bot] in #987
Dependency updates
- chore(deps): update dependency pytest to v9.0.3 [security] by @renovate[bot] in #988
- chore(deps): update pypa/gh-action-pypi-publish action to v1.14.0 by @renovate[bot] in #993
- chore(deps): update dependency tox to v4.52.1 by @renovate[bot] in #994
- chore(deps): update actions/upload-artifact action to v7.0.1 by @renovate[bot] in #996
- chore(deps): update dependency tox to v4.53.0 by @renovate[bot] in #997
- chore(deps): update actions/setup-node action to v6.4.0 by @renovate[bot] in #998
- chore(deps): update dependency wheel to v0.47.0 by @renovate[bot] in #999
- fix(deps): update dependency org.openapitools:openapi-generator to v7.22.0 by @renovate[bot] in #1000
- chore(deps): update dependency tox to v4.53.1 by @renovate[bot] in #1001
- chore(deps): update dependency tox to v4.54.0 by @renovate[bot] in #1002
- chore(deps): update dependency org.apache.maven.plugins:maven-enforcer-plugin to v3.6.3 by @renovate[bot] in #1003
- chore(deps): update dependency black to v26.5.0 by @renovate[bot] in #1004
- chore(deps): update dependency black to v26.5.1 by @renovate[bot] in #1005
- chore(deps): update actions/stale action to v10.3.0 by @renovate[bot] in #1006
- chore(deps): update dependency responses to v0.26.1 by @renovate[bot] in #1007
- chore(deps): update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.6 by @renovate[bot] in #1008
- chore(deps): update suzuki-shunsuke/pinact-action action to v3 by @renovate[bot] in #1009
- chore(deps): update dependency pytest-asyncio to v1.4.0 by @renovate[bot] in #1010
- fix(deps): update logback monorepo to v1.5.33 by @renovate[bot] in #1011
- chore(deps): update dependency tox to v4.55.0 by @renovate[bot] in #1012
- fix(deps): update logback monorepo to v1.5.34 by @renovate[bot] in #1014
- chore(deps): update actions/checkout action to v6.0.3 by @renovate[bot] in #1015
- chore(deps): update dependency tox to v4.55.1 by @renovate[bot] in #1016
- chore(deps): update dependency pytest-aiohttp to v1.1.1 by @renovate[bot] in #1018
- fix(deps): update openapi-generator-version to v7.23.0 by @renovate[bot] in #1019
Other Changes
Full Changelog: v3.23.0...v3.23.1
This release is prepared by @Yang-33
Contributors
Assets 3
v3.23.0 Add wrapper methods for JWT assertion and client secret authentication
What's Changed
Added feature
This release adds wrapper methods for ChannelAccessToken#issue_stateless_channel_token, making stateless channel access token issuance simpler for both JWT assertion and client secret authentication. With this release, you don't have to pass empty strings ('') for unused parameters.
- token = api.issue_stateless_channel_token(
- grant_type='client_credentials',
- client_assertion_type='urn:ietf:params:oauth:client-assertion-type:jwt-bearer',
- client_assertion=client_assertion,
- client_id='',
- client_secret='',
- )
+ token = api.issue_stateless_channel_token_by_jwt_assertion(
+ client_assertion=client_assertion,
+ )- token = api.issue_stateless_channel_token(
- grant_type='client_credentials',
- client_assertion_type='',
- client_assertion='',
- client_id=client_id,
- client_secret=client_secret,
- )
+ token = api.issue_stateless_channel_token_by_client_secret(
+ client_id=client_id,
+ client_secret=client_secret,
+ )line-openapi updates
- chore(deps): update line-openapi digest to c601805 by @renovate[bot] in #972
- chore(deps): update line-openapi digest to 982bad2 by @renovate[bot] in #979
Dependency updates
- chore(deps): update actions/setup-node action to v6.2.0 by @renovate[bot] in #921
- chore(deps): update dependency wheel to v0.46.2 [security] by @renovate[bot] in #922
- chore(deps): update actions/checkout action to v6.0.2 by @renovate[bot] in #923
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.25 by @renovate[bot] in #924
- chore(deps): update dependency black to v26 by @renovate[bot] in #925
- fix(deps): update dependency org.openapitools:openapi-generator to v7.19.0 by @renovate[bot] in #926
- chore(deps): update actions/setup-python action to v6.2.0 by @renovate[bot] in #927
- chore(deps): update dependency wheel to v0.46.3 by @renovate[bot] in #928
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.26 by @renovate[bot] in #929
- chore(deps): update dependency org.apache.maven.plugins:maven-compiler-plugin to v3.15.0 by @renovate[bot] in #930
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.27 by @renovate[bot] in #931
- chore(deps): update suzuki-shunsuke/pinact-action action to v1.4.0 by @renovate[bot] in #932
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.28 by @renovate[bot] in #934
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.29 by @renovate[bot] in #935
- chore(deps): update actions/stale action to v10.2.0 by @renovate[bot] in #936
- chore(deps): update dependency tox to v4.35.0 by @renovate[bot] in #937
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.30 by @renovate[bot] in #938
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.31 by @renovate[bot] in #939
- chore(deps): update dependency tox to v4.36.0 by @renovate[bot] in #940
- fix(deps): update dependency org.openapitools:openapi-generator to v7.20.0 by @renovate[bot] in #942
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.32 by @renovate[bot] in #941
- chore(deps): update dependency tox to v4.36.1 by @renovate[bot] in #943
- chore(deps): update dependency tox to v4.37.0 by @renovate[bot] in #944
- chore(deps): update dependency tox to v4.38.0 by @renovate[bot] in #945
- chore(deps): update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.5 by @renovate[bot] in #946
- chore(deps): update dependency tox to v4.39.0 by @renovate[bot] in #947
- chore(deps): update dependency tox to v4.40.0 by @renovate[bot] in #948
- chore(deps): update dependency responses to v0.26.0 by @renovate[bot] in #949
- chore(deps): update dependency tox to v4.41.0 by @renovate[bot] in #950
- chore(deps): update dependency tox to v4.42.0 by @renovate[bot] in #951
- chore(deps): update dependency tox to v4.44.0 by @renovate[bot] in #952
- chore(deps): update dependency tox to v4.45.0 by @renovate[bot] in #954
- chore(deps): update actions/download-artifact action to v8 by @renovate[bot] in #955
- chore(deps): update dependency tox to v4.46.0 by @renovate[bot] in #956
- chore(deps): update dependency tox to v4.46.1 by @renovate[bot] in #957
- chore(deps): update dependency tox to v4.46.3 by @renovate[bot] in #958
- chore(deps): update actions/upload-artifact action to v7 by @renovate[bot] in #959
- chore(deps): update dependency tox to v4.47.0 by @renovate[bot] in #960
- chore(deps): update actions/setup-node action to v6.3.0 by @renovate[bot] in #961
- chore(deps): update dependency tox to v4.47.1 by @renovate[bot] in #962
- chore(deps): update dependency tox to v4.47.2 by @renovate[bot] in #963
- chore(deps): update dependency tox to v4.47.3 by @renovate[bot] in #964
- chore(deps): update dependency black to v26.3.1 [security] by @renovate[bot] in #965
- chore(deps): update dependency tox to v4.48.0 by @renovate[bot] in #966
- chore(deps): update dependency tox to v4.48.1 by @renovate[bot] in #967
- chore(deps): update dependency tox to v4.49.0 by @renovate[bot] in #968
- chore(deps): update dependency tox to v4.49.1 by @renovate[bot] in #969
- chore(deps): update actions/download-artifact action to v8.0.1 by @renovate[bot] in #970
- chore(deps): update dependency pypandoc to v1.17 by @renovate[bot] in #971
- chore(deps): update dependency tox to v4.50.0 by @renovate[bot] in #973
- chore(deps): update dependency tox to v4.50.2 by @renovate[bot] in #975
- chore(deps): update dependency tox to v4.50.3 by @renovate[bot] in #976
- chore(deps): update dependency pytest-cov to v7.1.0 by @renovate[bot] in #978
- fix(deps): update dependency org.openapitools:openapi-generator to v7.21.0 by @renovate[bot] in #980
- chore(deps): update dependency tox to v4.51.0 by @renovate[bot] in #983
- chore(deps): update dependency tox to v4.52.0 by @renovate[bot] in #984
Other Changes
- chore(deps): update dependency tox to v4.50.1 by @renovate[bot] in #974
- chore(deps): update suzuki-shunsuke/pinact-action action to v2 by @renovate[bot] in #977
- Add test for verifyChannelTokenByJWT and getsAllValidChannelAccessTokenKeyIds by @Yang-33 in #982
Full Changelog: v3.22.0...v3.23.0
This release is prepared by @habara-k
Contributors
Assets 3
v3.22.0 Support new AudienceGroupType TRACKINGTAG_WEBTRAFFIC to Audience Group API
What's Changed
- Add new AudienceGroupType TRACKINGTAG_WEBTRAFFIC to Audience Group API by @github-actions[bot] in #920
Add TRACKINGTAG_WEBTRAFFIC to AudienceGroupType Enum
We have supported for the new audience‑group type TRACKINGTAG_WEBTRAFFIC (Tracking Tag Webtraffic audience) to the OpenAPI schema.
Changes Made
-
Updated
AudienceGroupTypeenumeration- New value:
TRACKINGTAG_WEBTRAFFIC - Description: Audience groups generated from Tracking Tag Webtraffic.
- New value:
Purpose
This update enables correct identification and handling of audience groups built from Tracking Tag Webtraffric.
Documents and Reference
For more information, please refer to the links provided above.
(original PR is line/line-openapi#118)
line-openapi updates
Dependency updates
- chore(deps): update dependency pypandoc to v1.16 by @renovate[bot] in #881
- chore(deps): update dependency black to v25.11.0 by @renovate[bot] in #883
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.21 by @renovate[bot] in #885
- chore(deps): update dependency org.apache.maven.plugins:maven-jar-plugin to v3.5.0 by @renovate[bot] in #886
- chore(deps): update actions/checkout action to v5.0.1 by @renovate[bot] in #887
- chore(deps): update dependency pypandoc to v1.16.2 by @renovate[bot] in #888
- chore(deps): update actions/checkout action to v6 by @renovate[bot] in #889
- chore(deps): update actions/setup-python action to v6.1.0 by @renovate[bot] in #890
- chore(deps): update dependency tox to v4.32.0 by @renovate[bot] in #875
- chore(deps): update dependency pytest-asyncio to v1.3.0 by @renovate[bot] in #884
- chore(deps): update dependency pytest to v9 by @renovate[bot] in #882
- chore(deps): update actions/checkout action to v6.0.1 by @renovate[bot] in #892
- chore(deps): update actions/stale action to v10.1.1 by @renovate[bot] in #893
- chore(deps): update actions/setup-node action to v6.1.0 by @renovate[bot] in #894
- chore(deps): update dependency pytest to v9.0.2 by @renovate[bot] in #895
- chore(deps): update dependency black to v25.12.0 by @renovate[bot] in #896
- chore(deps): update dependency sphinx to v9 by @renovate[bot] in #891
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.22 by @renovate[bot] in #900
- chore(deps): update github artifact actions (major) by @renovate[bot] in #901
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.23 by @renovate[bot] in #903
- fix(deps): update dependency org.openapitools:openapi-generator to v7.18.0 by @renovate[bot] in #904
- chore(deps): update suzuki-shunsuke/pinact-action action to v1.0.1 by @renovate[bot] in #906
- chore(deps): update suzuki-shunsuke/pinact-action action to v1.1.0 by @renovate[bot] in #907
- chore(deps): update suzuki-shunsuke/pinact-action action to v1.2.0 by @renovate[bot] in #909
- chore(deps): update suzuki-shunsuke/pinact-action action to v1.3.0 by @renovate[bot] in #910
- chore(deps): update suzuki-shunsuke/pinact-action action to v1.3.1 by @renovate[bot] in #911
- chore(deps): update dependency tox to v4.33.0 by @renovate[bot] in #913
- chore(deps): update dependency sphinx-rtd-theme to v3.1.0rc2 by @renovate[bot] in #915
- chore(deps): update dependency tox to v4.34.0 by @renovate[bot] in #916
- chore(deps): update dependency tox to v4.34.1 by @renovate[bot] in #917
- chore(deps): update dependency sphinx-rtd-theme to v3.1.0 by @renovate[bot] in #919
Other Changes
- Unsupport Python 3.9 by @mokuzon in #879
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.24 by @renovate[bot] in #914
Full Changelog: v3.21.0...v3.22.0
This release is prepared by @eucyt
Contributors
Assets 3
v3.21.0 Support mark as read by token API
What's Changed
- Support mark as read by token API by @github-actions[bot] in #880
Support for "Mark as Read" by Token API
We have released a new Mark as Read API that allows developers to mark a user’s messages as read.
Previously, this functionality was available only to partners, but it is now publicly available.
When your server receives a user message via Webhook, the MessageContent will include a new field: markAsReadToken.
By calling the Mark as Read API with this token, all messages in the chat room up to and including that message will be marked as read.
Note: This feature assumes that your service uses the chat feature through Official Account Manager.
If chat is not enabled, messages from users are automatically marked as read, making this API unnecessary.
For more details, please refer to the release note: https://developers.line.biz/en/news/2025/11/05/mark-as-read/
(original PR is line/line-openapi#115)
Example
line_bot_api.mark_messages_as_read_by_token(
MarkMessagesAsReadByTokenRequest(
mark_as_read_token=event.message.mark_as_read_token
)
)line-openapi updates
Dependency updates
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.20 by @renovate[bot] in #874
- chore(deps): update github artifact actions (major) by @renovate[bot] in #876
- fix(deps): update dependency org.openapitools:openapi-generator to v7.17.0 by @renovate[bot] in #878
Full Changelog: v3.20.0...v3.21.0
This release is prepared by @habara-k
Contributors
Assets 3
v3.20.0 Add forbidPartialDelivery option to the Narrowcast Limit Object
What's Changed
- Add forbidPartialDelivery option to the Narrowcast Limit Object by @github-actions[bot] in #873
Add forbidPartialDelivery option to the Narrowcast Limit Object
We add a new forbidPartialDelivery option to the Narrowcast Limit Object.
When set to true, this option prevents messages from being delivered to only a subset of the target audience.
If partial delivery occurs, the narrowcast request will succeed but fail asynchronously.
You can verify whether the message delivery was canceled by checking the narrowcast message progress.
This property can only be set to true when upToRemainingQuota is also true.
For more details, see the https://developers.line.biz/en/news/2025/10/21/narrowcast-message-update/.
Example:
line_bot_api.narrowcast(
NarrowcastRequest(
messages=[TextMessage(text=event.message.text)],
limit=Limit(
max=1000,
upToRemainingQuota=True,
forbidPartialDelivery=True
)
)
)(original PR is line/line-openapi#114)
Use cases
Previously, when upToRemainingQuota was set to true, messages could be partially delivered if the remaining message quota was smaller than the target audience size.
With the new forbidPartialDelivery option, you can now ensure that such partial deliveries do not occur.
- Ensuring that a campaign message is sent only if it can reach the full target audience, avoiding incomplete distributions.
line-openapi updates
Full Changelog: v3.19.2...v3.20.0
This release is prepared by @habara-k
Contributors
Assets 3
v3.19.2 Support Python 3.14
What's Changed
- Support Python 3.14
Dependency updates
- chore(deps): update dependency pytest-asyncio to v1.2.0 by @renovate[bot] in #858
- chore(deps): update dependency org.apache.maven.plugins:maven-compiler-plugin to v3.14.1 by @renovate[bot] in #859
- chore(deps): update dependency black to v25.9.0 by @renovate[bot] in #860
- chore(deps): update dependency org.apache.maven.plugins:maven-enforcer-plugin to v3.6.2 by @renovate[bot] in #862
- fix(deps): update dependency org.openapitools:openapi-generator to v7.16.0 by @renovate[bot] in #861
- fix(deps): update dependency ch.qos.logback:logback-classic to v1.5.19 by @renovate[bot] in #863
- chore(deps): update dependency tox to v4.30.3 by @renovate[bot] in #865
- chore(deps): update actions/stale action to v10.1.0 by @renovate[bot] in #867
- chore(deps): update actions/setup-node action to v6 by @renovate[bot] in #869
- chore(deps): update dependency tox to v4.31.0 by @renovate[bot] in #868
Other Changes
- Use github actor id instead of bot name to avoid renaming issues by @Yang-33 in #857
- Prevent command injection when creating release notes by @Yang-33 in #866
- Support Python 3.14 by @mokuzon in #871
Full Changelog: v3.19.1...v3.19.2
This release is prepared by @mokuzon
Contributors
Assets 3
v3.19.1 Add an Option to Skip Webhook Signature Verification
What's Changed
✨ Add an Option to Skip Webhook Signature Verification
With this release, developers can now optionally skip signature verification when parsing incoming webhook requests. This new capability is especially useful in scenarios where the channel secret may change, potentially causing temporary signature mismatches.
Example Usage:
parser = linebot.v3.WebhookParser(
'YOUR_CHANNEL_SECRET',
skip_signature_verification=lambda: True # Skip verification
)When signature verification is skipped, the signatureValidator will not be invoked. This allows webhook requests to be processed even if their signatures do not match the current channel secret used for verification.
This feature is particularly helpful in high-availability systems where avoiding downtime or message loss during configuration updates is critical.
Dependency updates
- chore(deps): update dependency tox to v4.29.0 by @renovate[bot] in #843
- chore(deps): update dependency pytest to v8.4.2 by @renovate[bot] in #844
- chore(deps): update actions/github-script action to v7.1.0 by @renovate[bot] in #845
- chore(deps): update dependency tox to v4.30.2 by @renovate[bot] in #847
- chore(deps): update dependency pytest-cov to v6.3.0 by @renovate[bot] in #846
- chore(deps): update pypa/gh-action-pypi-publish action to v1.13.0 by @renovate[bot] in #849
- chore(deps): update dependency twine to v6.2.0 by @renovate[bot] in #848
- chore(deps): update actions/github-script action to v8 by @renovate[bot] in #850
- chore(deps): update actions/setup-node action to v5 by @renovate[bot] in #851
- chore(deps): update actions/setup-python action to v6 by @renovate[bot] in #852
- chore(deps): update actions/stale action to v10 by @renovate[bot] in #853
- chore(deps): update dependency pytest-cov to v7 by @renovate[bot] in #855
- chore(deps): update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.4 by @renovate[bot] in #856
Other Changes
Full Changelog: v3.19.0...v3.19.1
Contributors
Assets 3
v3.19.0 Support new AudienceGroupType POP_AD_IMP to Audience Group API
What's Changed
Support new AudienceGroupType POP_AD_IMP to Audience Group API
- Add new AudienceGroupType POP_AD_IMP to Audience Group API by @github-actions[bot] in #842
We have supported for the new audience‑group type POP_AD_IMP (POP ad impression audience) to the OpenAPI schema.
Changes Made
-
Updated
AudienceGroupTypeenumeration- New value:
POP_AD_IMP - Description: Audience groups generated from impressions of LINE Beacon Network (POP) ads.
- Region: Taiwan‑only at launch
- New value:
Purpose
This update enables correct identification and handling of audience groups built from POP ad impressions, a feature that will be released for the Taiwan market.
Documents and Reference
For more information, please refer to the links provided above.
(original PR is line/line-openapi#113)
Dependency updates
- fix(deps): update dependency org.openapitools:openapi-generator to v7.15.0 by @renovate[bot] in #841
Full Changelog: v3.18.1...v3.19.0
This release is prepared by @eucyt
Contributors
Assets 2
v3.18.1 Clean up webhook code for line things
What's Changed
LINE Things has been closed. In this release we removed the following LINE Things related webhook code
ThingsEventThingsContentLinkThingsContentUnlinkThingsContentScenarioResultThingsContentScenarioResultActionResult
As noted in the README, deletions tied to a business shutdown are shipped as a patch version, not a major version. If your code still references any of these code, they will never be emitted again, so you should remove them.
Dependency updates
- chore(deps): update dependency responses to v0.25.8 by @renovate[bot] in #836
- chore(deps): update actions/checkout action to v4.3.0 by @renovate[bot] in #837
- chore(deps): update actions/checkout action to v5 by @renovate[bot] in #838
Full Changelog: v3.18.0...v3.18.1
This release is prepared by @Yang-33