CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0 - 2026-02-04

Added

• Initial release of Lark Integration for Home Assistant
• Config flow UI for easy setup
• Support for sending text messages to Lark
• Support for sending images to Lark
• Support for interactive cards with action buttons
• Webhook handler for receiving messages from Lark
• Webhook handler for button callbacks
• Event system for triggering automations from Lark messages
• Automatic execution of HA services from button clicks
• Multi-language support (English, 繁體中文, 简体中文)
• Token caching with automatic refresh
• Support for multiple notification targets
• HACS compatibility
• Comprehensive documentation and examples

Features

• HA → Lark Notifications

  • Text messages
  • Image messages (from URL)
  • Interactive cards with buttons
  • Multiple target support (DMs and group chats)

• Lark → HA Commands

  • Webhook endpoint for receiving messages
  • lark_command event for message-based automations
  • lark_button_callback event for button interactions
  • Automatic service execution from button clicks

• Configuration

  • UI-based setup via config flow
  • Automatic chat discovery
  • Options flow for updating settings

Technical Details

• Async/await throughout for optimal performance
• aiohttp for all HTTP requests
• Token caching with 2-hour expiry
• Proper error handling and logging
• Home Assistant 2023.1.0+ compatibility

[Unreleased]

Planned Features

• Support for rich text/post messages
• Support for file attachments
• Voice message support
• Message templates
• Rate limiting protection
• Retry logic for failed messages
• Support for message replies
• Support for @mentions in messages
• Card templates library
• Integration with HA's notification system
• Support for multiple Lark apps

---