All notable changes to this project will be documented in this file.
- Support for new version 3.7.
- New method
request_welcome_messagein customer-api v3.6 and v3.7. - New method
delete_eventin customer-api v3.6. - New methods in configuration-api v3.6 for greetings:
create_greeting,delete_greeting,get_greeting,update_greeting,list_greetings. - New methods in agent-api v3.6:
send_thinking_indicator,send_message_preview. - New methods in configuration-api v3.7 for canned responses:
create_canned_response,update_canned_response,list_canned_responses,delete_canned_response. - New method
request_thread_summaryin agent-api v3.6 and v3.7. - New flag
name_is_defaultin methodupdate_customerin customer-api v3.6 and v3.7. - New method in reports-api v3.7: report
campaigns_conversion.
- Udated python version from 3.8 to 3.13.0 (version 3.8 was unsupported since 2024-10-07).
- Updated urllib3 dependency to a version which fixes a potential vulnerability.
- Updated dependencies: websocket-client, certifi, exceptiongroup, h11, h2, hpack, httpcore, hyperframe.
- Config now points to v3.6 as a stable and 3.7 as a dev-preview version.
- Improved websocket response collection + extended logging in the websocket client.
- Fixed version in websocket url for customer-api v3.4 and v3.6.
- Fixed passing query params in customer-api WEB client for httpx v0.28.0 compatibility.
- Support for version 3.3.
- Removed support for billing-api.
- Support
get_predicted_agentin customer-api v3.7. - Support for
create_customermethod removed in agent-api v3.6 and later. - Support for
incoming_customerwebhook removed in v3.6 and later.
- New
groups,queued_visitors,queued_visitors_left,unique_visitorsmethods in reports-api v3.6.
- Corrected the
surveysreport toformsin reports-api v3.5 & v3.6.
- New
get_company_details,list_customer_bansandunban_customermethods in configuration-api v3.6. - Added
response_timeoutparameter inopen_connectionmethods. - New
get_license_infomethod in agent-api v3.5. - New
update_sessionmethod in agent-api v3.6 (rtm). - Allow passing custom header for websocket handshake.
- Added missing top-level arguments to
update_auto_accessmethod in configuration-api. - Updated outdated packages.
- Changed pre-commit flake8 URL
- New methods in configuration-api v3.5, v3.6 for bot management:
create_bot_template,delete_bot_template,update_bot_template,list_bot_templates,issue_bot_token,reset_bot_secret,reset_bot_template_secret.
- Updated outdated packages.
- Enhanced error logging for improved troubleshooting: Automatically includes response headers in the log for server errors, providing detailed information (such as x-debug-id) for more effective issue diagnosis.
- Enhanced timeouts for the RTM and WEB clients.
- Introduced
AccessTokenstructure which allows keeping token type in separate field. Previous way of passing tokens as a string of formattype: tokenremains supported for backwards compatibility.
- Enabled instantiation for
CustomerRtmV36within the 3.6 version of the Customer RTM API. - Adjusted the return types in
get_clientmethod across RTM and WEB clients. - Fixed an issue where messages in the WebSocket client were incorrectly shared across all instances.
- Fixed
upload_filemethod in agent-api v3.4/v3.5/v3.6 classes.
- Support for
logoutmethod in agent-api v3.6 web class. - Support for
agent_idparameter in agent-api v3.6logoutmethod.
- Implemented truncation of request params in logging for large data.
- Allow sending rtm events as a bot by adding
author_idparam.
reactivate_emailandupdate_company_detailsactions in configuration-api v3.6 class.disable_loggingflag for web based clients.
- Loguru used for logging.
- Required packages to currently newest versions.
- Fix HTTP request type for
get_product_sourcemethod in Configuration API v3.5 and v3.6. - Fix an issue related to fetching responses in RTM.
- Added support for billing-api.
- New
highest_availableoption forcustomer_monitoring_levelin agent-apiloginmethod.
- Fix
customer_monitoring_levelparameter inloginmethod in agent-api v3.3/v3.4/v3.5 classes. - Fix
httpxversion in setup.cfg
- Support for
list_customersmethod in agent-api v3.6 classes.
- Support for new batch methods in configuration-api v3.5:
batch_create_bots,batch_delete_bots,batch_update_bots. - Support for new version 3.6.
- Config now points to v3.5 as stable and 3.6 as dev-preview version.
- New methods in configuration-api v3.5:
list_groups_properties,get_product_source. - Support for
default_group_priorityparameter increate_botandupdate_botmethods in configuration-api v3.3/v3.4/v3.5 classes. - Support for
job_titleparameter increate_botmethod in configuration-api v3.3/v3.4/v3.5 classes. - Support for
proxiesandverifyparameters for web base clients.
- Renamed method
tag_chat_usagetochat_usagein reports-api v3.5. - Internal documentation main page and structure.
- Fix paths for
response_timeandfirst_response_timemethods in reports-api v3.4/v3.5 classes. - Fix
upload_filemethod in agent-api v3.4/v3.5 classes.
- Support for
list_group_properties,get_license_idandget_organization_idmethod in configuration-api v3.5 class. - Support for
webhookparameter increate_botandupdate_botmethods in configuration-api v3.3/v3.4/v3.5 classes.
- Support for new batch methods in configuration-api v3.5:
batch_create_agents,batch_delete_agents,batch_update_agents,batch_approve_agents,batch_suspend_agents,batch_unsuspend_agents.
- Updated requirements.txt.
- Fix HTTP method in
get_dynamic_configuration,get_configuration,get_localization,list_group_properties,list_license_propertiesanddelete_event_properties. - Fix
upload_filemethod by changing the way of uploading files; using HTTP multipart encoding.
- Webhooks support. Allows to easily convert webhook's body into parsed data classes.
- Updated httpx dependency to a version which fixes a potential vulnerability.
- Updated readme file and extended examples with getting pushes from the websocket client.
- New methods in configuration-api v3.5 for tags management:
create_tag,list_tags,update_tag,delete_tag. - New method in reports-api v3.5 for getting tags usage statistics in chats:
tags_chat_usage.
- Major refactoring: classes with API methods for each version are now held in separate modules
This is possibly breaking change, please make sure if your imports point to
livechat.<service>.<transport>.base). When in doubt, please compare with the updatedexamplesdirectory. - Added new param
owner_client_idin Configuration APIcreate_botfor Interface and v3.5 classes. - Added new methods related to product information (
list_channels,check_product_limits) in Configuration API v3.5.
- Handling of configuration file.
- API stable version 3.4 as a default.
- API dev preview version 3.5 support.
- Proxy support to web interfaces.
- RtmResponse structure for RTM clients.
- Added new methods related to greetings conversion, chat surveys, and response time in reports-api v3.4.
- Added new methods for organization/license ID lookup in configuration v3.4.
- Fixed methods for uploading files.
- Renamed
reorder_auto_accesstoupdate_auto_access
- Added logging for web interface
- Support for
organization_idin Customer(rtm/web) v3.4.
- Added type hints support
- Added support for reports-api.
- Refactored ws_client module - new client extends WebSocketApp from websocket-client package.
- Handling for
pushesparam inloginof agent RTM.
- websocket-client package to version 1.2.1.
- urllib package to version 1.26.6.
- Support for HTTP/2 protocol within the following clients: Agent(web), Customer(web), Configuration.
- requests to httpx package.
- Handle new destructive action flags (
ignore_requester_presence,ignore_agents_availability) in v3.4.
- Include essential subpackages
- Api version 3.4 support.
- Example usages of following clients: Agent(rtm/web), Customer(rtm/web), Configuration.
add_user_to_chatandsend_typing_indicatormethods to v3.4 class with a support of visibility arg.- Custom header handling for the following clients: Agent(web), Customer(web), Configuration.
- Support for
grant_chat_accessandrevoke_chat_accessmethods in v3.4 class. - Flag
require_active_threadin methodadd_user_to_chat.
- urllib package to version 1.26.5.
- New header manipulation/retrieval methods.
- Changelog file.
- Simple usage example in
readme.md.
agent,configurationandcustomerpackages now have common rootlivechat.- rename
ConfigurationApimethod for obtaining client toget_clientfor consistency with other clients.