{"id":30226837,"url":"https://github.com/smarthomeblack/zalo_bot","last_synced_at":"2026-04-02T15:11:39.115Z","repository":{"id":304021520,"uuid":"1017521072","full_name":"smarthomeblack/zalo_bot","owner":"smarthomeblack","description":"Zalo Bot In Home Assistant","archived":false,"fork":false,"pushed_at":"2026-03-21T04:01:18.000Z","size":7871,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-21T19:59:33.362Z","etag":null,"topics":["custom-component","hacs","homeassistant","zalo","zalo-bot"],"latest_commit_sha":null,"homepage":"https://github.com/smarthomeblack/zalo_bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smarthomeblack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-10T16:57:04.000Z","updated_at":"2026-03-21T03:58:49.000Z","dependencies_parsed_at":"2025-08-02T18:14:18.130Z","dependency_job_id":"b4f3ab08-9cf9-465c-9edf-233b2e9acf46","html_url":"https://github.com/smarthomeblack/zalo_bot","commit_stats":null,"previous_names":["smarthomeblack/zalo_bot"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/smarthomeblack/zalo_bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarthomeblack%2Fzalo_bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarthomeblack%2Fzalo_bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarthomeblack%2Fzalo_bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarthomeblack%2Fzalo_bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smarthomeblack","download_url":"https://codeload.github.com/smarthomeblack/zalo_bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarthomeblack%2Fzalo_bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31308722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-component","hacs","homeassistant","zalo","zalo-bot"],"created_at":"2025-08-14T17:02:22.009Z","updated_at":"2026-04-02T15:11:39.102Z","avatar_url":"https://github.com/smarthomeblack.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ❓ Nhóm Support:\n- Zalo: https://zalo.me/g/alvkgn274\n- Telegram: https://t.me/smarthomeblack\n\n---\n\n# Zalo Bot cho Home Assistant\n\n## Giới thiệu\n\nDự án này cung cấp một bot Zalo tích hợp cho Home Assistant, giúp bạn gửi, nhận thông báo và điều khiển thiết bị qua Zalo một cách tiện lợi!\n\n\n## Hướng dẫn cài đặt\n\n### 1. Cài đặt qua HACS(Khuyến nghị)\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=smarthomeblack\u0026repository=zalo_bot)\n\n- Tải về sau đó khởi động lại Home Assistant\n\n### 2. Cài đặt thủ công\n\nNếu không sử dụng HACS, bạn có thể cài đặt thủ công như sau:\n\n- Tải mã nguồn repo này về máy.\n- Sao chép thư mục `custom_components/zalo_bot` vào thư mục `custom_components` trong thư mục cấu hình Home Assistant của bạn.\n- Khởi động lại Home Assistant.\n- Vào Cài đặt \u003e Thiết bị \u0026 Dịch vụ \u003e Thêm tích hợp mới \u003e Chọn \"Zalo Bot\" và cấu hình theo hướng dẫn.\n\n### 3. Cấu hình\n\n- Nếu cài Server Zalo Bot bằng Addon thì mặc định zalo_server để nguyên\n- user và pass điền admin\n\n\u003cimg title=\"Zalo Bot\" src=\"https://raw.githubusercontent.com/smarthomeblack/zalo_bot/refs/heads/main/img/3.png\" width=\"100%\"\u003e\u003c/img\u003e\n\n\u003cimg title=\"Zalo Bot\" src=\"https://raw.githubusercontent.com/smarthomeblack/zalo_bot/refs/heads/main/img/4.png\" width=\"100%\"\u003e\u003c/img\u003e\n\n - Nếu kết nối thành công và đăng nhập zalo bot thành công thì sẽ có cảm biến báo đã kết nối, các cảm biến sẽ cập nhập 1 phút 1 lần để cho biết trạng thái đăng nhập Zalo bot, có thể tạo tự động hóa để thông báo nếu như zalo bot bị đăng xuất hoặc cần đăng nhập lại, \n\n\u003cimg title=\"Zalo Bot\" src=\"https://raw.githubusercontent.com/smarthomeblack/zalo_bot/refs/heads/main/img/8.png\" width=\"100%\"\u003e\u003c/img\u003e\n\n### 4. Hướng Dẫn Sử Dụng\n- Có 2 dịch vụ chính để dùng tự động hóa là zalo_bot.send_image và zalo_bot.send_message\n- Vào trang quản lý ZALO BOT, Chọn Theo dõi tin nhắn và lấy Thread ID \n- Sau đó dùng tài khoản bất kỳ gửi tin nhắn cho Acc Bot hoặc thêm Acc bot vào trong 1 nhóm, sau đó gửi tin nhắn từ tài khoản chính vào nhóm\n- Dùng Thread ID để điền vào cấu hình tự động hóa, như gửi ảnh, gửi tin nhắn\n- Nếu gửi cho tài khoản cá nhân thì type để user, còn gửi vào trong nhóm thì type để Group\n\n\u003cimg title=\"Zalo Bot\" src=\"https://raw.githubusercontent.com/smarthomeblack/zalo_bot/refs/heads/main/img/5.png\" width=\"100%\"\u003e\u003c/img\u003e\n\n### 5. Hướng Dẫn Tạo Hội Thoại Và Tự Động Hóa\n\n- [▶️ Xem video hướng dẫn trên YouTube](https://www.youtube.com/watch?v=xdl0oUv1LDg)\n\n- code\n\n```yaml\nalias: zalo bot\ndescription: \"\"\ntriggers:\n  - allowed_methods:\n      - POST\n      - PUT\n      - GET\n      - HEAD\n    local_only: false\n    webhook_id: \"-kckRb3xuIlUYoMHgbwIwPMKq\"\n    trigger: webhook\nconditions:\n  - condition: template\n    value_template: \u003e\n      {{ '@Blackbot' in trigger.json.data.content and trigger.json.data.uidFrom\n      == '85276xxxxxxxxx203115' }}\nactions:\n  - variables:\n      user_message: \"{{ trigger.json.data.content }}\"\n      conversation_id: \"{{ trigger.json.data.uidFrom }}\"\n  - data:\n      text: \"{{ user_message }}\"\n      agent_id: conversation.google_ai_conversation\n      conversation_id: \"{{ conversation_id }}\"\n    response_variable: convo_response\n    action: conversation.process\n  - action: zalo_bot.send_message\n    data:\n      type: \"1\"\n      thread_id: \"{{ trigger.json.data.idTo }}\"\n      account_selection: \"+84123456789\"\n      message: \"Bot-Hass: {{ convo_response.response.speech.plain.speech }}\"\n      quote: |\n        {% if trigger.json.data.msgType == 'webchat' %}\n          {{ {'content': trigger.json.data.content, 'uidFrom': trigger.json.data.uidFrom, 'cliMsgId': trigger.json.data.cliMsgId} }}\n        {% else %}\n          {{ {'content': trigger.json.data.content, 'msgType': trigger.json.data.msgType, 'uidFrom': trigger.json.data.uidFrom, 'cliMsgId': trigger.json.data.cliMsgId} }}\n        {% endif %}\nmode: single\n\n```\n\nThay 85276xxxxxxxxx203115 bằng uidFrom của bạn, thay @Blackbot thành tên bot của bạn, thay +84123456789 thành sdt của bot.\n\n## Tính năng\n\n### Tính năng cơ bản\n- Nhận thông báo từ Home Assistant qua Zalo\n- Gửi tin nhắn văn bản đến người dùng hoặc nhóm\n- Gửi hình ảnh, file, sticker, video, tin nhắn thoại\n- Điều khiển thiết bị Home Assistant bằng tin nhắn Zalo\n- Tự động phản hồi tin nhắn thông qua tích hợp với các dịch vụ AI\n\n### Quản lý tin nhắn\n- Thêm, xem, cập nhật và xóa tin nhắn nhanh (Quick Message)\n- Thả cảm xúc vào tin nhắn (like, heart, haha, wow, cry, angry và nhiều loại khác)\n- Thu hồi tin nhắn đã gửi\n- Xóa tin nhắn (chỉ ở phía mình hoặc với tất cả)\n- Chuyển tiếp tin nhắn đến nhiều người dùng hoặc nhóm cùng lúc\n- Gửi liên kết với preview tự động\n- Gửi danh thiếp người dùng\n- Gửi tin nhắn có định dạng (in đậm, in nghiêng)\n- Trả lời/trích dẫn tin nhắn\n- Gửi sự kiện \"đang gõ\", \"đã nhận\", \"đã xem\" tin nhắn\n\n### Quản lý nhóm\n- Tạo nhóm mới với nhiều thành viên\n- Thêm/xóa thành viên khỏi nhóm\n- Thay đổi tên nhóm và ảnh đại diện\n- Thêm/xóa phó nhóm\n- Chuyển quyền sở hữu nhóm\n- Giải tán nhóm\n- Bật/tắt liên kết tham gia nhóm\n- Tham gia nhóm qua link mời\n- Rời khỏi nhóm (im lặng hoặc thông báo)\n- Cài đặt nhóm nâng cao (chặn thay đổi tên/ảnh, chặn tạo bình chọn/ghi chú/nhắc hẹn, chặn gửi tin nhắn)\n- Xem thông tin chi tiết của nhóm và thành viên\n\n### Quản lý liên hệ\n- Tìm kiếm người dùng qua số điện thoại\n- Lấy thông tin chi tiết người dùng\n- Gửi/chấp nhận/thu hồi lời mời kết bạn\n- Chặn/bỏ chặn người dùng\n- Hủy kết bạn\n- Thay đổi/xóa biệt danh của bạn bè\n- Chặn/bỏ chặn xem nhật ký\n- Lấy danh sách tất cả bạn bè\n- Lấy danh sách lời mời kết bạn đã nhận/đã gửi\n- Lấy danh sách biệt danh đã đặt\n\n### Tính năng tiện ích nhóm\n- Tạo và quản lý ghi chú nhóm (thêm, sửa, ghim)\n- Tạo và quản lý bình chọn trong nhóm (tạo, xem chi tiết, khóa)\n- Tạo, chỉnh sửa, xóa và quản lý nhắc hẹn\n- Xem phản hồi cho nhắc hẹn (tham gia/từ chối)\n- Lấy danh sách các mục trên bảng tin của nhóm\n\n### Quản lý cuộc trò chuyện\n- Tắt/bật thông báo cho cuộc trò chuyện (1 giờ, 4 giờ hoặc vĩnh viễn)\n- Ghim/bỏ ghim cuộc trò chuyện\n- Đánh dấu/bỏ đánh dấu chưa đọc\n- Xóa cuộc trò chuyện\n- Lấy danh sách cuộc trò chuyện đã lưu trữ\n- Bật/tắt tự động xóa tin nhắn (1 ngày, 7 ngày)\n- Ẩn/hiện cuộc trò chuyện bằng mã PIN\n- Đặt/thay đổi/xóa mã PIN cho cuộc trò chuyện ẩn\n- Lấy danh sách cuộc trò chuyện đã ghim, đã tắt thông báo, đã đánh dấu chưa đọc\n\n### Tùy chỉnh tài khoản\n- Cập nhật thông tin cá nhân (tên, ngày sinh, giới tính)\n- Cập nhật cài đặt riêng tư (trạng thái online, trạng thái đã xem, nhận tin nhắn, tìm kiếm bằng SĐT)\n- Thay đổi ảnh đại diện (tải lên mới hoặc dùng lại ảnh cũ)\n- Lấy danh sách ảnh đại diện đã sử dụng\n- Xóa ảnh đại diện khỏi album\n- Xem thời gian hoạt động cuối của người dùng\n- Thay đổi ngôn ngữ\n\n### Tính năng quản trị\n- Quản lý webhook cho tài khoản (thêm, xem, cập nhật, xóa)\n- Quản lý proxy (thêm, xóa, xem danh sách)\n- Báo cáo người dùng vi phạm (nhạy cảm, làm phiền, lừa đảo)\n\n### Tính năng nhãn (Label)\n- Lấy danh sách các nhãn\n- Cập nhật danh sách nhãn (thêm/xóa/sửa nhãn)\n- Thêm/xóa cuộc trò chuyện khỏi nhãn\n\n---\n\n## Đóng góp\nMọi đóng góp, báo lỗi hoặc ý tưởng mới đều được hoan nghênh qua GitHub Issues hoặc Pull Request.\n\n---\n\n**Chúc bạn trải nghiệm vui vẻ với Zalo Bot cho Home Assistant!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmarthomeblack%2Fzalo_bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmarthomeblack%2Fzalo_bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmarthomeblack%2Fzalo_bot/lists"}