# CHO CLAUDE ĐỌC: Bước 7. Hộp thư tên miền riêng trên Lark Mail

> Tài liệu này viết cho Claude Code của học viên. Người học chỉ cần dán câu lệnh bên dưới vào Claude, Claude đọc file này rồi làm.
> Thuộc hệ thống triển khai AI 20 bước của Trương Minh Kiên. Trang bước này: https://trienkhaimail.truongminhkien.vn

## Việc cần làm

lienhe@tenmiencuaban.vn có SPF, DKIM để không rơi vào spam, gửi tự động được bằng lark-cli.

Câu lệnh học viên dán vào Claude:

```
Tải gói https://trienkhaimail.truongminhkien.vn/mail-ten-mien.zip, giải nén, đọc CHO-CLAUDE-DOC.md rồi tạo cho tôi hộp thư ten@tenmiencuatoi trên Lark Mail, cấu hình MX/SPF/DKIM, gửi thử một thư cho tôi sau khi tôi xác nhận
```

## Luật khi làm

1. Đọc hết file này, kể cả phần bẫy, trước khi chạy lệnh nào.
2. Việc cần mật khẩu, mã OTP, token hay thanh toán thì dừng lại để học viên tự làm, không nhập hộ.
3. Không xoá dữ liệu, bản ghi DNS hay file cũ của học viên. Chỉ thêm.
4. Khoá bí mật chỉ nằm trong `.env` (đã có trong `.gitignore`), không ghi vào mã, wiki hay kết quả.
5. Xong mỗi bước thì kiểm tra thật (chạy thử, đọc lại) rồi mới báo xong.
6. Gói này chạy trên máy của học viên, không phải máy người soạn. Mọi đường dẫn tính từ thư mục giải nén hoặc thư mục vault của học viên; hỏi học viên nếu cần. Skill nào nhắc tới file `output/...` hay trang `wiki/...` mà vault học viên chưa có thì đó chỉ là nguồn tham khảo của người soạn: bỏ qua, dùng nội dung ngay trong skill. Riêng `wiki/concepts/bo-mau-thuong-hieu.md`: nếu chưa có, chép từ `mau/bo-mau-thuong-hieu.md` trong gói rồi hỏi học viên để điền.

## Skill trong gói

- `lark-mail`
- `lark-shared`

Cách cài skill: chép từng thư mục trong `.claude/skills/` của gói vào `.claude/skills/` của vault Obsidian (bước 1). Tên thư mục phải trùng tên skill, file chính tên `SKILL.md`.

## Cách cài đặt từng bước (làm theo thứ tự)

### Tạo hộp thư theo tên miền riêng trên Lark Mail và gửi thư tự động bằng lark-cli

> **Tệp này viết cho Claude ở một máy khác đọc.** Người dùng sẽ thả tệp này vào Claude và nói *"làm theo tệp này"*.
> Claude: đọc trọn tệp trước khi làm gì. Mục 0 nói máy cần có gì; mục 1–6 là việc làm theo thứ tự; mục 7 là các bẫy
> đã gặp thật — đọc trước khi bắt đầu để khỏi dẫm lại. Mọi giá trị trong ngoặc nhọn `{…}` là chỗ thay bằng dữ liệu của người dùng.
>
> Kết quả cuối: một địa chỉ dạng `{ten-hop}@{ten-mien}` (ví dụ `lienhe@congty.vn`), gửi đi hiện tên đẹp
> (ví dụ **"Công ty ABC <lienhe@congty.vn>"**), có SPF + DKIM để Gmail không xếp vào spam, và một hàm Python gửi thư
> từ địa chỉ đó bằng `lark-cli`.
>
> Bản này rút từ việc đã làm thật ngày 20/09/2026 (tên miền mua ở Mắt Bão, Lark tenant gói Standard). Tổng thời gian ~30 phút,
> trong đó chờ DNS 1–10 phút.

---

## 0. Máy này cần có gì — kiểm trước, thiếu thì dừng và hỏi người dùng

| # | Cần | Cách kiểm | Nếu thiếu |
|---|---|---|---|
| 1 | **Tài khoản Lark** và người dùng là **quản trị viên** (người sáng lập hoặc được cấp quyền) của tổ chức đó | Mở `https://{tenant}.larksuite.com/admin/index` (hoặc `https://www.larksuite.com/admin`) — vào được trang "Tổng quan tổ chức" là đủ | Xin quyền quản trị; không có thì không làm được |
| 2 | **Tên miền** đã mua, người dùng đăng nhập được vào trang quản lý DNS của nhà đăng ký (Mắt Bão, PA, Tenten, GoDaddy, Cloudflare…) | `nslookup -type=NS {ten-mien} 8.8.8.8` → biết DNS ở đâu | Người dùng phải tự đăng nhập — Claude **không** nhập mật khẩu, không quét QR thay |
| 3 | **lark-cli** cài sẵn và đã đăng nhập bằng tài khoản người dùng | `lark-cli --profile {ho-so} mail user_mailboxes accessible_mailboxes --user-mailbox-id me --as user` → `"ok": true` | Cài: `npm i -g @larksuiteoapi/lark-cli` (hoặc theo hướng dẫn của Lark), rồi `lark-cli auth login --domain mail --scope mail:user_mailbox:send` |
| 4 | **Python 3.10+** (để gửi thư có tên hiển thị — mục 6) | `python --version` | Cài Python |
| 5 | Trình duyệt mà Claude điều khiển được (Claude in Chrome / trình duyệt tích hợp), **đã đăng nhập** Lark và trang nhà đăng ký | — | Nếu Claude không điều khiển được trình duyệt thì hướng dẫn người dùng bấm tay theo mục 1–5, Claude chỉ làm mục 6 |

**Hỏi người dùng ba thứ trước khi bắt đầu:** (a) tên miền, (b) tên hộp thư muốn tạo (`{ten-hop}`), (c) tên hiển thị khi gửi (`{ten-hien-thi}`).

---

## 1. Thêm tên miền vào Lark Mail — lấy các bản ghi DNS

Trong Lark Admin: **Cài đặt sản phẩm › Email › Quản lý Dịch vụ › Quản lý tên miền** (đường dẫn thường là
`/admin/email/setup/domainManagement`). Bấm **Thêm tên miền mới** → gõ `{ten-mien}` → **Xác nhận** → chọn
**"Trực tiếp kích hoạt dịch vụ email mới"** (không di chuyển lịch sử).

Lark hiện bảng DNS. **Chép nguyên văn** ra — thường gồm:

| Host | Loại | Giá trị | Ưu tiên |
|---|---|---|---|
| @ | TXT | `verification-code-site-App_lark={mã}` | |
| @ | TXT | `v=spf1 +include:spf.onlarksuite.com -all` | |
| @ | MX | `mx1.larksuite.com` | 1 |
| @ | MX | `mx2.larksuite.com` | 5 |
| @ | MX | `mx3.larksuite.com` | 10 |

**Chưa bấm "Xác minh ngay"** — sang mục 2 trước. Giữ tab này mở (hoặc quay lại sau qua nút "Tiếp tục Thiết lập").

---

## 2. Khai DNS ở nhà đăng ký tên miền

Người dùng đăng nhập trang quản lý tên miền (Claude không đăng nhập thay). Vào **Bản ghi DNS** của `{ten-mien}`.

**Nguyên tắc:** chỉ **thêm**, không xoá bản ghi đang có (A, CNAME `www`, NS là của website — đụng vào là sập web).

**Nếu tên miền đã có MX/TXT của dịch vụ mail khác (Google, Zoho, mail hosting):** dừng lại hỏi người dùng — chuyển sang Lark
nghĩa là mail cũ ngừng nhận. Không tự quyết.

Thêm 5 bản ghi ở bảng mục 1. **Đọc bẫy 7.1 trước** — nhiều nhà đăng ký (Mắt Bão chắc chắn) gộp các bản ghi cùng
Host + cùng Loại thành **một dòng nhiều giá trị**: tạo "bản ghi mới" @ MX lần thứ hai sẽ **đè** cái thứ nhất. Cách đúng:
tạo @ MX một lần → mở dòng đó › **Thêm giá trị** → điền tiếp mx2, mx3. TXT cũng vậy: một dòng @ TXT chứa cả mã xác minh
lẫn SPF.

Kiểm sau khi lưu (không cần chờ lan truyền, hỏi thẳng máy chủ DNS của nhà đăng ký):

```bash
nslookup -type=MX  {ten-mien} {ns1-cua-nha-dang-ky}
nslookup -type=TXT {ten-mien} {ns1-cua-nha-dang-ky}
```

Phải thấy đủ 3 MX `larksuite.com` và 2 TXT. Thấy thiếu → mở lại dòng xem có bị đè không.

---

## 3. Xác minh tên miền trên Lark

Quay lại tab Lark (Quản lý tên miền › `{ten-mien}` › **Tiếp tục Thiết lập**) → **Xác minh ngay**. Thường xanh ngay
("Đã xác minh") vì Lark hỏi thẳng máy chủ DNS gốc. Nếu đỏ: chờ 5–10 phút, bấm lại; vẫn đỏ thì so từng ký tự bản ghi.

Bấm **Tiếp**. Màn kế tiếp hỏi "Cấu hình địa chỉ email doanh nghiệp cho các thành viên" — **bỏ qua** (không đổi email chính
của ai), đi thẳng sang mục 4.

---

## 4. Tạo hộp thư

Hai cách, chọn theo mục đích:

| Cách | Khi nào | Đường đi |
|---|---|---|
| **Hộp thư công khai** (public mailbox) — *khuyên dùng* | Địa chỉ đại diện tổ chức (`lienhe@`, `bni@`, `hotro@`), nhiều người cùng xem, gửi tự động bằng máy | Lark Admin › Email › **Quản lý địa chỉ › Hộp thư công khai › Tạo**: Tên = `{ten-hien-thi}`, Địa chỉ = `{ten-hop}` (đuôi tự chọn `@{ten-mien}`), **Chọn thành viên** = người sẽ gửi bằng lark-cli (bắt buộc — không là thành viên thì lark-cli không thấy hộp), IMAP/SMTP: Tắt (không cần) → **Tạo** |
| Bí danh (alias) trên hộp cá nhân | Muốn thư trả lời về thẳng hộp cá nhân | Quản lý tên miền › "Thêm biệt danh tên miền mới", hoặc Thành viên › email › thêm bí danh |

Kiểm bằng lark-cli — địa chỉ mới phải xuất hiện:

```bash
lark-cli --profile {ho-so} mail user_mailboxes accessible_mailboxes --user-mailbox-id me --as user
```

---

## 5. Bật DKIM (để Gmail/Outlook tin thư — làm luôn, 3 phút)

Lark Admin › Email › **Bảo mật và chống thư rác › Xác thực DKIM** › dòng `{ten-mien}` › **Bật** › độ dài khoá 2048 › **Tiếp**.
Lark hiện một bản ghi:

| Host | Loại | Giá trị |
|---|---|---|
| `lark{số}._domainkey` | TXT | `v=DKIM1; k=rsa; p={chuỗi dài}` |

Thêm vào DNS nhà đăng ký y như mục 2 (host là chuỗi `lark…._domainkey`, **không** thêm tên miền phía sau; giá trị chép
nguyên, kể cả dấu `;`). Kiểm: `nslookup -type=TXT lark{số}._domainkey.{ten-mien} {ns1}` thấy `DKIM1`. Quay lại Lark bấm
**Xác minh** — trạng thái chuyển "Bật".

---

## 6. Gửi thư từ địa chỉ mới bằng lark-cli — có tên hiển thị

**Cách nhanh nhưng mất tên hiển thị:**

```bash
lark-cli --profile {ho-so} mail +send --as user --mailbox {ten-hop}@{ten-mien} --from {ten-hop}@{ten-mien} \
  --to ai@do.com --subject "Chủ đề" --body-file ./thu.html --no-signature --confirm-send
```

Gửi được, nhưng Gmail hiện người gửi là **"{ten-hop}"** (chữ thường, chỉ phần trước @) vì lark-cli bỏ trống tên trong
dòng `From`. Đặt `--from "{ten-hien-thi} <{ten-hop}@{ten-mien}>"` → lỗi `sender check fail`. (Bẫy 7.2.)

**Cách đúng — dựng thư thô rồi gửi qua API** (Python, dùng lark-cli làm cầu gọi API nên không cần token riêng):

```python
### gui_thu.py — gửi một thư HTML từ hộp thư tên miền, có tên hiển thị
import base64, json, subprocess, os
from email.message import EmailMessage
from email.header import Header

HO_SO = "{ho-so}"                     # hồ sơ lark-cli đã đăng nhập
DIA_CHI = "{ten-hop}@{ten-mien}"       # hộp thư vừa tạo (người dùng lark-cli phải là thành viên)
TEN = "{ten-hien-thi}"                 # tên hiện cạnh địa chỉ

def lark(*args, data=None):
    cmd = ["lark-cli.cmd" if os.name == "nt" else "lark-cli", "--profile", HO_SO, *args]
    if data is not None:
        with open("_body.json", "w", encoding="utf-8") as f:
            json.dump(data, f, ensure_ascii=False)
        cmd += ["--data", "@./_body.json"]          # lark-cli bắt buộc đường dẫn tương đối
    out = subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8",
                         env=dict(os.environ, MSYS_NO_PATHCONV="1")).stdout
    return json.loads(out[out.index("{"):])

def gui_thu(den, tieu_de, html, chi_nhap=False):
    msg = EmailMessage()
    msg["From"] = str(Header(TEN, "utf-8")) + f" <{DIA_CHI}>"
    msg["To"] = den
    msg["Subject"] = tieu_de
    msg.set_content("Thư này ở dạng HTML.")
    msg.add_alternative(html, subtype="html")
    raw = base64.urlsafe_b64encode(msg.as_bytes()).decode().rstrip("=")
    r = lark("api", "POST", f"/open-apis/mail/v1/user_mailboxes/{DIA_CHI}/drafts", data={"raw": raw})
    if not r.get("ok"):
        return r
    did = r["data"]["draft"]["id"]
    if chi_nhap:
        return r                                     # chỉ để nháp trong hộp thư
    return lark("api", "POST", f"/open-apis/mail/v1/user_mailboxes/{DIA_CHI}/drafts/{did}/send", data={})

if __name__ == "__main__":
    print(gui_thu("{email-cua-nguoi-dung}", "[THỬ] Tên hiển thị", "<p>Thử từ hộp thư tên miền.</p>"))
```

Chạy `python gui_thu.py`, bảo người dùng mở Gmail: người gửi phải hiện **"{ten-hien-thi}"**, không có dấu chấm hỏi cạnh
tên, và nằm ở Hộp thư đến. Đủ ba điều đó là xong.

Muốn chạy tự động theo lịch (Task Scheduler / cron): gọi đúng tệp Python này; trên Windows, đọc bẫy 7.5.

---

## 7. Bẫy đã gặp thật — đọc trước khi làm

| # | Bẫy | Dấu hiệu | Cách tránh |
|---|---|---|---|
| 7.1 | **Nhà đăng ký gộp bản ghi cùng Host + Loại** (Mắt Bão; nhiều nơi khác tương tự) | Thêm MX thứ hai xong, bảng chỉ còn một MX; "Số lượng bản ghi" không tăng | Một dòng @ MX có 3 giá trị, một dòng @ TXT có 2 giá trị — dùng **Thêm giá trị** trong dòng cũ. Sửa SPF sẽ hiện cảnh báo, bấm Đồng ý |
| 7.2 | `lark-cli mail +send` **bỏ trống tên người gửi**; `--from "Tên <địa chỉ>"` báo `sender check fail` | Gmail hiện "bni"/"lienhe" thay vì tên đẹp | Dựng MIME thô + `drafts` → `drafts/{id}/send` (mục 6). Tên hộp thư đặt trong Lark Admin **không** đi theo thư |
| 7.3 | lark-cli không thấy hộp thư mới | `accessible_mailboxes` không có địa chỉ | Người dùng lark-cli chưa được thêm làm **thành viên** hộp thư công khai — vào Lark Admin sửa hộp thư, thêm người |
| 7.4 | `nslookup` qua 8.8.8.8 chưa thấy gì | Bản ghi mới lưu, DNS công cộng còn cache | Hỏi thẳng NS của nhà đăng ký (`nslookup … ns1.{nha-dang-ky}`); Lark cũng hỏi thẳng nên xác minh được ngay |
| 7.5 | (Windows) Task Scheduler chạy lark-cli bằng **token cũ**, dù Claude vừa đăng nhập lại | Thư gửi tay được, chạy theo lịch thì lỗi 99991668/ hết hạn | Token lark-cli nằm ở registry `HKCU\Software\LarkCli\keychain\lark-cli`; lệnh chạy từ công cụ của Claude ghi vào một lớp registry khác. Đăng nhập lại bằng một task tạm: `schtasks /Create /SC ONCE … /TR "cmd /c lark-cli --profile {ho-so} auth login --domain mail --scope mail:user_mailbox:send > _login.txt"`, lấy link trong `_login.txt` cho người dùng bấm |
| 7.6 | Khách **trả lời** thư | Không thấy trả lời trong hộp cá nhân | Trả lời về **hộp thư công khai** — xem trong Lark Mail, mục hộp thư công khai; hoặc thêm `Reply-To` vào MIME nếu muốn về hộp cá nhân |
| 7.7 | Claude bị yêu cầu đăng nhập / quét QR / nhập mật khẩu | Trang đăng nhập nhà đăng ký, Lark, mail | **Không làm.** Dừng, bảo người dùng tự đăng nhập trên tab đang mở, rồi tiếp |
| 7.8 | Tên miền đang có mail ở dịch vụ khác | `nslookup -type=MX` ra máy chủ Google/Zoho/hosting | Hỏi người dùng trước khi đổi MX — đổi là mail cũ ngừng nhận |

---

## 8. Bảng kiểm cuối — đủ 6 dấu ✅ là xong

- [ ] Lark Admin › Quản lý tên miền: `{ten-mien}` trạng thái **Đã xác minh / Có hiệu lực**
- [ ] `nslookup -type=MX {ten-mien} 8.8.8.8` ra `mx1/mx2/mx3.larksuite.com`
- [ ] `nslookup -type=TXT {ten-mien} 8.8.8.8` có `spf.onlarksuite.com`
- [ ] Lark Admin › Xác thực DKIM: `{ten-mien}` **Bật**
- [ ] `lark-cli … accessible_mailboxes` liệt kê `{ten-hop}@{ten-mien}`
- [ ] Thư thử về Gmail người dùng: người gửi hiện **"{ten-hien-thi}"**, vào Hộp thư đến, không dấu chấm hỏi

Báo lại người dùng đúng 6 dòng này, kèm tệp `gui_thu.py` đã điền sẵn để họ dùng tiếp.


## Hướng dẫn chi tiết và các bẫy đã gặp

(Bản đầy đủ có hình và nút bấm: https://trienkhaimail.truongminhkien.vn)

**Đã chạy thật ngày 20/09/2026** với tên miền truongminhkien.vn (DNS ở iNET, tổ chức Lark gói Standard): thư thử tới Gmail nằm ở Hộp thư đến, đúng tên người gửi, DKIM/SPF/DMARC đều đạt; chiều nhận (khách trả lời vào hộp thư công khai) cũng đã kiểm. Toàn bộ mất khoảng 30 phút, trong đó chờ DNS 1-10 phút.

Yêu cầu trước khi bắt đầu

- Đã xong [Bước 4: Cài Lark](https://trienkhailark.truongminhkien.vn/) (cần quyền quản trị viên Lark: người sáng lập tổ chức là đủ)
- Đã xong [Bước 6: Tên miền về Cloudflare](https://trienkhaitenmien.truongminhkien.vn/) và đăng nhập được trang quản lý DNS của tên miền
- Python 3.10 trở lên

## Các bước

1

### Thêm tên miền vào Lark Mail và chép các bản ghi DNS

Lark Admin → Email → Quản lý Dịch vụ → Quản lý tên miền. Nếu thấy màn "Chào mừng bạn đến với Lark Mail", bấm **Thiết lập ngay**. Nhập tên miền → Xác nhận → chọn **"Trực tiếp kích hoạt dịch vụ email mới"**. Lark hiện 5 bản ghi, chép nguyên văn:

- `@` TXT — `verification-code-site-App_lark=<mã>`
- `@` TXT — `v=spf1 +include:spf.onlarksuite.com -all`
- `@` MX — `mx1.larksuite.com` (ưu tiên 1), `mx2` (5), `mx3` (10)

**Chưa bấm "Xác minh ngay"** — sang bước 2 trước.

2

### Khai 5 bản ghi ở nơi quản lý DNS — chỉ THÊM

Nếu tên miền đã có MX/TXT của dịch vụ mail khác (Google, Zoho, mail hosting), **dừng lại và hỏi**: chuyển sang Lark nghĩa là mail cũ ngừng nhận. Không có thì thêm đủ 5 bản ghi, rồi kiểm ngay bằng lệnh hỏi thẳng máy chủ tên của nơi quản lý DNS:

nslookup -type=MX  \<tên-miền\> \<ns1-của-nơi-quản-lý\>\
nslookup -type=TXT \<tên-miền\> \<ns1-của-nơi-quản-lý\>

Phải thấy đủ 3 MX `larksuite.com` và 2 TXT.

3

### Xác minh trên Lark

Quay lại Lark → **Xác minh ngay**; thường xanh ngay ("Đã xác minh"). Màn kế tiếp bắt "cấu hình email doanh nghiệp cho thành viên" với nút Xác nhận màu xám — **bỏ qua**, đi thẳng sang Quản lý địa chỉ → Hộp thư công khai. Đừng đổi email chính của ai ở bước này.

4

### Tạo hộp thư công khai

Quản lý địa chỉ → Hộp thư công khai → Tạo: Tên = tên hiển thị bạn muốn khách thấy; Địa chỉ = phần trước @ (ví dụ `lienhe`); **Chọn thành viên** = người sẽ gửi thư bằng lark-cli (bắt buộc); IMAP/SMTP để Tắt. Hộp thư công khai hợp cho địa chỉ đại diện (`lienhe@`, `hotro@`), nhiều người cùng xem, gửi tự động bằng máy.

5

### Bật DKIM để Gmail/Outlook tin thư

Bảo mật và chống thư rác → Xác thực DKIM → dòng tên miền → **Bật** → độ dài khoá 2048 → Tiếp. Lark hiện 1 bản ghi TXT tên dạng `lark<số>._domainkey` với giá trị `v=DKIM1; k=rsa; p=…`. Thêm vào DNS: tên **không** kèm tên miền phía sau, giá trị chép nguyên kể cả dấu `;`. Kiểm bằng `nslookup -type=TXT lark<số>._domainkey.<tên-miền>` thấy `DKIM1`, rồi quay lại Lark bấm **Xác minh** → trạng thái chuyển "Bật".

6

### Gửi thư từ địa chỉ mới, có tên hiển thị đẹp

Lệnh nhanh `lark-cli mail +send` gửi được nhưng khách thấy tên người gửi là chữ thường phần trước @ (xem bẫy 2). Cách đúng: dựng thư thô rồi gửi qua API nháp. Claude AI viết giúp bạn đoạn dưới (điền 3 giá trị đầu):

import base64, json, subprocess, os\
from email.message import EmailMessage\
from email.header import Header\
\
HO_SO   = "ho-so-lark-cli"            # hồ sơ lark-cli đã đăng nhập (auth login --domain mail)\
DIA_CHI = "lienhe@tenmiencuaban.vn"   # hộp thư công khai vừa tạo\
TEN     = "Tên hiển thị của bạn"      # tên hiện cạnh địa chỉ khi khách nhận thư\
\
def lark(\*args, data=None):\
    cmd = \["lark-cli.cmd" if os.name == "nt" else "lark-cli", "--profile", HO_SO, \*args, "--as", "user"\]\
    if data is not None:\
        open("\_body.json", "w", encoding="utf-8").write(json.dumps(data, ensure_ascii=False))\
        cmd += \["--data", "@./\_body.json"\]        # lark-cli chỉ nhận đường dẫn tương đối\
    p = subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8")\
    out = p.stdout if "{" in p.stdout else p.stderr\
    return json.loads(out\[out.index("{"):\])\
\
def gui_thu(den, tieu_de, html):\
    msg = EmailMessage()\
    msg\["From"\] = str(Header(TEN, "utf-8")) + f" \<{DIA_CHI}\>"   # dựng thư thô để có tên hiển thị\
    msg\["To"\], msg\["Subject"\] = den, tieu_de\
    msg.set_content("Thư này ở dạng HTML.")\
    msg.add_alternative(html, subtype="html")\
    raw = base64.urlsafe_b64encode(msg.as_bytes()).decode().rstrip("=")\
    base = f"/open-apis/mail/v1/user_mailboxes/{DIA_CHI}/drafts"\
    r = lark("api", "POST", base, data={"raw": raw})\
    if not r.get("ok"): return r\
    did = r\["data"\]\["draft"\]\["id"\]\
    r2 = lark("api", "POST", f"{base}/{did}/send", data={})\
    if not r2.get("ok"): lark("api", "DELETE", f"{base}/{did}")   # gửi hỏng thì xoá nháp\
    return r2

Trên Windows đặt biến môi trường `PYTHONUTF8=1` trước khi chạy để in tiếng Việt không lỗi. **Chỉ gửi thư thật khi bạn đã xác nhận người nhận và nội dung.** Thư thử đầu tiên gửi về chính Gmail của bạn: tên người gửi phải hiện đúng, thư nằm ở Hộp thư đến, không có dấu chấm hỏi cạnh tên.

7

### Đọc thư khách trả lời

Khách bấm Trả lời sẽ về hộp thư công khai. Đọc bằng dòng lệnh:

lark-cli --profile \<hồ-sơ\> mail +triage --mailbox lienhe@tenmiencuaban.vn --as user --max 20

Muốn đọc ngay trong app Lark, cần cấp cho bạn 1 email doanh nghiệp: Lark Admin → Thành viên và Bộ phận → chọn bạn → Chỉnh sửa → **Email doanh nghiệp** = `ten@tenmiencuaban.vn` → Lưu. Đây là thay đổi danh tính Lark của bạn nên **hỏi trước khi làm**; email đăng nhập không đổi.

Câu lệnh — dán vào Claude AI

Sao chép

Tạo cho tôi hộp thư \[ten-hop\]@\[ten-mien\] trên Lark Mail, tên hiển thị "\[tên hiển thị\]", làm theo trang https://trienkhaimail.truongminhkien.vn/ .\
Kiểm điều kiện trước (lark-cli đã đăng nhập, Python, tôi là quản trị viên Lark). Nếu tên miền đã có MX của dịch vụ mail khác thì DỪNG và hỏi tôi. Chỉ THÊM bản ghi DNS, không xoá bản ghi đang có. Nếu bạn không gõ được vào trang DNS thì in bảng bản ghi nguyên văn cho tôi gõ tay rồi chỉ kiểm bằng nslookup. Mọi đăng nhập/quét mã tôi tự làm. Chỉ gửi thư thử về Gmail của tôi sau khi tôi xác nhận địa chỉ và nội dung. Ngôn ngữ: tiếng Việt.

## ⚠ Bẫy đã gặp + cách gỡ

1\. Thêm MX thứ hai xong, bảng chỉ còn 1 MX (gặp ở nhà đăng ký Mắt Bão)

Một số nơi gộp các bản ghi cùng tên và cùng loại thành 1 dòng nhiều giá trị: tạo "bản ghi mới" cùng tên sẽ đè bản trước. (Ở iNET thì không bị: mỗi bản ghi 1 dòng riêng.)

**Cách gỡ:** tạo 1 dòng MX rồi dùng **Thêm giá trị** trong dòng đó cho mx2, mx3; TXT cũng vậy. Kiểm bằng nslookup sau mỗi lần thêm.

🔴 2. Thư gửi ra hiện tên là "lienhe" chữ thường thay vì tên đẹp

`lark-cli mail +send` bỏ trống tên người gửi, và đặt `--from "Tên <địa chỉ>"` thì báo lỗi `sender check fail`. Tên đặt cho hộp thư trong Lark Admin cũng không đi theo thư.

**Cách gỡ:** dựng thư thô có dòng `From` mã hoá tên rồi gửi qua nháp (đoạn mã ở bước 6). Đã kiểm thật: Gmail hiện đúng tên.

3\. Danh sách hộp thư của lark-cli rỗng dù đã tạo hộp thư công khai

Tổ chức Lark mới chưa ai có email doanh nghiệp thì lệnh `accessible_mailboxes` rỗng và `profile me` trả địa chỉ trống. Việc gửi **không** bị chặn: hộp thư công khai vẫn gọi được bằng địa chỉ trực tiếp.

**Cách gỡ:** dùng địa chỉ đầy đủ ở mọi lệnh; hoặc cấp email doanh nghiệp cho bạn (bước 7) — sau đó danh sách liệt kê cả hộp chính lẫn hộp công khai.

4\. Lark cảnh báo sẽ xoá dữ liệu email khi gửi tên miền

Nếu thành viên nào đã liên kết email bên thứ ba vào Lark Mail, việc gửi tên miền sẽ hủy liên kết và xoá dữ liệu email liên quan.

**Cách gỡ:** hỏi chắc trong tổ chức có ai liên kết Gmail/Outlook chưa **trước khi** tích "Tôi hiểu".

5\. AI không gõ được bản ghi vào trang quản lý DNS

Một số công cụ hoặc nhà đăng ký chặn thao tác gõ tự động vào ô nội dung DNS. Đã gặp ở iNET.

**Cách gỡ:** không thử quá 2 lần; in bảng bản ghi nguyên văn cho bạn gõ tay, AI chỉ kiểm lại bằng `nslookup`. Đây là cách làm bình thường, không phải thất bại.

6\. lark-cli báo thiếu token người dùng

Danh tính "user" của hồ sơ chưa đăng nhập với quyền Mail.

**Cách gỡ:** chạy `lark-cli auth login --domain mail --no-wait --json`, mở đường dẫn hoặc quét mã QR, bấm đồng ý, rồi hoàn tất bằng `--device-code`. Không dùng lại đường dẫn cũ vì hết hạn sau khoảng 10 phút.

7\. Lỗi nhỏ nhưng tốn thời gian trên Windows

\(a\) `mail +triage --limit` báo "unknown flag": cờ đúng là `--max`. (b) In tiếng Việt ra console báo `UnicodeEncodeError` (cp1252): đặt `PYTHONUTF8=1`. (c) Lệnh `.cmd` cắt đường dẫn có ký tự `&`: chạy những lệnh đó qua Git Bash. (d) `nslookup` hiện TXT dài thành 2 đoạn trong dấu nháy (cắt ở 255 ký tự): so khớp bằng cách ghép các đoạn trong dấu nháy, đừng so từng dòng.

⚠ Chưa kiểm: SPF ở tên miền gốc có ảnh hưởng thư gửi qua dịch vụ khác không

Bản ghi SPF của Lark kết thúc bằng `-all`. Nếu cùng tên miền đang gửi email qua dịch vụ khác (ví dụ Resend cho email ebook), sau khi xong hãy gửi thử 1 thư từ dịch vụ đó để chắc thư vẫn tới. Chúng tôi chưa chạy phép thử này.

Bước tiếp theo

Đã có hộp thư riêng, sang bước kế tiếp: biến file ghi âm hoặc video (buổi học, cuộc họp) thành chữ ngay trên máy để dùng làm tư liệu.

[Sang bước 8: Ghi âm → Chữ →](https://trienkhaighiam.truongminhkien.vn/)

## Bẫy mới (14/10/2026): Lark báo DKIM không hợp lệ dù DNS đúng

Mail Assistant báo "Cấu hình DKIM không hợp lệ" nhiều ngày, Lark Admin › Email › Bảo mật và chống thư rác › Xác thực DKIM ghi "Lỗi xác minh", nhưng bản ghi `lark<số>._domainkey` trên DNS vẫn đúng. Cách gỡ: kiểm `nslookup -type=TXT lark<số>._domainkey.<tên-miền>` ở máy chủ tên miền; đúng thì bấm **Khôi phục** › **Xác minh lại**, trạng thái về "Bật". Không bấm "Tạo khoá mới" (đổi khoá, phải sửa DNS). Nguyên nhân chưa rõ (nghi do đổi tên miền Lark của tổ chức hoặc DNS chập chờn lúc Lark kiểm).
