Kết nối Lark với VNe

1Chọn cách nối Lark

Cách nối phụ thuộc vào bạn thuộc tổ chức Lark nào.

1. Công ty bạn dùng Lark cho nhân viên — quản trị viên kết nối ứng dụng Lark của công ty (mục 2–4). Nhân viên mở VNe từ Lark một chạm, bot báo thư, tin nhắn, việc cho từng người.
2. Bạn ở tổ chức Lark khác, hoặc chỉ cần cho riêng mình — dùng webhook cá nhân (mục 5). Dùng được với mọi tổ chức Lark, không cần quản trị viên duyệt.
3. Người ở tổ chức Lark khác vẫn đăng nhập VNe bằng Google hoặc mã gửi qua email như bình thường — chỉ phần thông báo đi qua webhook.

Bật cả hai thì thông báo đến ở cả hai nơi. Chọn một cho gọn.

2Quản trị viên: ứng dụng Lark

Làm một lần, khoảng 10 phút, bằng tài khoản quản trị Lark của công ty. Ứng dụng nằm trong tổ chức Lark của công ty bạn, nên chỉ nhân viên công ty mới mở được.

1. Trong VNe, mở Quản lý → Lark và chọn Lark hoặc Feishu (Phi Thư) đúng với công ty bạn.
2. Bấm Mở Lark Developer → Create Custom App, đặt tên VNe rồi tạo.
3. Ở Add Features, thêm tính năng Bot.
4. Vào Permissions & Scopes → Batch import/export scopes, dán đoạn JSON mà VNe hiển thị rồi tiếp tục để thêm quyền. Đoạn này gồm quyền Tenant token (bot gửi tin, tra người theo email) và User token (đọc email của người đăng nhập).
5. Vào Security Settings → Redirect URLs, thêm Redirect URL mà VNe hiển thị.
6. Vào Version Management & Release → Create Version, điền ghi chú rồi gửi duyệt. Quản trị viên Lark duyệt xong thì ứng dụng dùng được.
7. Ở Credentials & Basic Info, chép App ID và App Secret, dán vào bước 5 trên trang Lark của VNe rồi bấm Kết nối Lark.

App Secret chỉ ghi vào VNe — được mã hoá khi lưu và không hiện lại. Nếu VNe báo Lark không chấp nhận App ID / App Secret này, kiểm tra cặp khoá và chắc rằng phiên bản ứng dụng đã được duyệt.

3Đưa VNe lên Lark của nhân viên

Kết nối xong, VNe cho bạn một Địa chỉ mở VNe. Đặt nó ở nơi nhân viên bấm hằng ngày.

1. Trong trang Lark của VNe, chép Địa chỉ mở VNe.
2. Trong Lark Admin, thêm địa chỉ đó làm liên kết trong Workplace để nhân viên thấy VNe ngay trong Lark.
3. Nhân viên bấm một lần: Lark xác nhận họ là ai, VNe mở thẳng hộp thư của họ — không cần mật khẩu hay tài khoản Google.

VNe khớp người theo email Lark với địa chỉ hộp thư, hoặc với email đã được cấp hộp. Ai không khớp thì VNe báo chưa nối được và để họ đăng nhập cách thường.

4Đồng bộ người Lark

Bot chỉ biết những nhân viên đã đăng nhập từ Lark. Đồng bộ để nối sẵn cả công ty, nhân viên nhận thông báo mà không cần đăng nhập trước.

1. Mở trang Lark của VNe, mục Đồng bộ người Lark.
2. Bấm Đồng bộ ngay. VNe tra ở Lark email của mọi hộp thư và của những người được cấp hộp.
3. Đọc kết quả: Đã tra … email · … người khớp hộp thư · … người Lark không khớp hộp nào.

Có người mới? Bấm lại bất cứ lúc nào (cách nhau một phút). VNe chỉ nối người có email được cấp hộp — đây là chủ ý, để thông báo không đến nhầm người.

5Thành viên: webhook cá nhân

Không cần ứng dụng, không cần quản trị viên, khoảng 2 phút. Dùng được ở bất kỳ tổ chức Lark nào.

1. Trong Lark, tạo nhóm mới chỉ có mình bạn, ví dụ Thông báo VNe.
2. Mở nhóm → ⋯ → Settings → Group bots → Add bot → Custom bot. Đặt tên bot rồi bấm Add.
3. Chép Webhook URL — dạng https://open.larksuite.com/open-apis/bot/v2/hook/…
4. Trong VNe: Cài đặt → Thông báo → thẻ Lark → Kết nối Lark, dán URL rồi bấm Kết nối và gửi thẻ thử.
5. Một thẻ thử tới nhóm Lark của bạn là xong. Chọn loại thông báo muốn nhận: thư mới, tin nhắn và @nhắc, việc / lịch / sự kiện khác.

Giữ kín URL webhook — ai có nó đều gửi được vào nhóm của bạn. Bot bật Custom keywords hoặc IP allowlist thì Lark chặn thẻ của VNe: tắt hai tuỳ chọn đó. Bot bật Signature verification thì dán khoá ký ở mục Nâng cao.

6Gặp lỗi?

Các lỗi thường gặp và cách xử lý.

1. Lark không chấp nhận App ID / App Secret này — kiểm tra lại cặp khoá, và chắc rằng phiên bản ứng dụng đã được quản trị viên Lark duyệt.
2. Lark từ chối chữ ký — bot đang bật Signature verification: dán đúng khoá ký ở mục Nâng cao.
3. Bot bật Từ khoá tuỳ chỉnh — tắt Custom keywords của bot rồi thử lại.
4. Bot bật danh sách IP cho phép — tắt IP allowlist của bot rồi thử lại.
5. Đã tạm dừng gửi vào Lark — Lark không nhận webhook nhiều lần liên tiếp, thường vì bot đã bị xoá khỏi nhóm. Bấm Kết nối lại và dán URL mới.
6. Ứng dụng chưa bật Bot — đăng nhập vẫn chạy nhưng thông báo thì không: thêm tính năng Bot ở Lark Developer rồi phát hành lại.
7. Nhân viên không vào được hộp thư từ Lark — email Lark của họ phải khớp địa chỉ hộp thư hoặc email đã được cấp hộp. Kiểm tra ở Nhân viên, hoặc nhờ họ đăng nhập cách thường.

7Quyền riêng tư và bảo mật

Thông báo đi qua máy chủ của Lark, nên VNe để bạn kiểm soát nội dung trong thẻ.

1. Tắt Hiện nội dung trong thẻ: thẻ chỉ ghi tiêu đề chung (ví dụ Bạn được giao việc), không có tên người, tiêu đề thư hay nội dung.
2. App Secret và URL webhook được mã hoá khi lưu và không bao giờ hiện lại trên màn hình.
3. Ứng dụng Lark của công ty chỉ đăng nhập được cho người trong tổ chức Lark đó, và chỉ mở hộp thư của đúng tổ chức VNe đã kết nối.
4. Ngắt kết nối bất cứ lúc nào — hộp thư và dữ liệu không bị ảnh hưởng.

Webhook cá nhân chỉ gửi được vào nhóm bạn đã tạo. VNe không đọc được tin trong nhóm Lark của bạn.